sandbox0 0.9.7 → 0.10.0

package/dist/apispec/src/models/VolumeBackend.js

@@ -1,43 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-/**
- * Sandbox0 API
- * Public HTTP APIs exposed by Sandbox0 regional gateways and the global gateway.
- *
- * The version of the OpenAPI document: 0.1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-/**
- * Storage backend for a SandboxVolume. s0fs is the default durable Sandbox0 volume backend. s3 mounts an existing S3-compatible prefix through the volume portal and supports mount-s3-like object projection.
- * @export
- */
-export const VolumeBackend = {
-    S0fs: 's0fs',
-    S3: 's3'
-};
-export function instanceOfVolumeBackend(value) {
-    for (const key in VolumeBackend) {
-        if (Object.prototype.hasOwnProperty.call(VolumeBackend, key)) {
-            if (VolumeBackend[key] === value) {
-                return true;
-            }
-        }
-    }
-    return false;
-}
-export function VolumeBackendFromJSON(json) {
-    return VolumeBackendFromJSONTyped(json, false);
-}
-export function VolumeBackendFromJSONTyped(json, ignoreDiscriminator) {
-    return json;
-}
-export function VolumeBackendToJSON(value) {
-    return value;
-}
-export function VolumeBackendToJSONTyped(value, ignoreDiscriminator) {
-    return value;
-}

package/dist/apispec/src/models/VolumeFileArchiveImportResponse.d.ts

@@ -1,51 +0,0 @@
-/**
- * Sandbox0 API
- * Public HTTP APIs exposed by Sandbox0 regional gateways and the global gateway.
- *
- * The version of the OpenAPI document: 0.1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-/**
- *
- * @export
- * @interface VolumeFileArchiveImportResponse
- */
-export interface VolumeFileArchiveImportResponse {
-    /**
-     *
-     * @type {number}
-     * @memberof VolumeFileArchiveImportResponse
-     */
-    files: number;
-    /**
-     *
-     * @type {number}
-     * @memberof VolumeFileArchiveImportResponse
-     */
-    directories: number;
-    /**
-     *
-     * @type {number}
-     * @memberof VolumeFileArchiveImportResponse
-     */
-    symlinks: number;
-    /**
-     *
-     * @type {number}
-     * @memberof VolumeFileArchiveImportResponse
-     */
-    bytes: number;
-}
-/**
- * Check if a given object implements the VolumeFileArchiveImportResponse interface.
- */
-export declare function instanceOfVolumeFileArchiveImportResponse(value: object): value is VolumeFileArchiveImportResponse;
-export declare function VolumeFileArchiveImportResponseFromJSON(json: any): VolumeFileArchiveImportResponse;
-export declare function VolumeFileArchiveImportResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): VolumeFileArchiveImportResponse;
-export declare function VolumeFileArchiveImportResponseToJSON(json: any): VolumeFileArchiveImportResponse;
-export declare function VolumeFileArchiveImportResponseToJSONTyped(value?: VolumeFileArchiveImportResponse | null, ignoreDiscriminator?: boolean): any;
-//# sourceMappingURL=VolumeFileArchiveImportResponse.d.ts.map

package/dist/apispec/src/models/VolumeFileArchiveImportResponse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VolumeFileArchiveImportResponse.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/VolumeFileArchiveImportResponse.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC5C;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,+BAA+B,CAMjH;AAED,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,GAAG,GAAG,+BAA+B,CAElG;AAED,wBAAgB,4CAA4C,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,+BAA+B,CAWrI;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,GAAG,GAAG,+BAA+B,CAEhG;AAED,wBAAgB,0CAA0C,CAAC,KAAK,CAAC,EAAE,+BAA+B,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAYpJ"}

package/dist/apispec/src/models/VolumeFileArchiveImportResponse.js

@@ -1,55 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-/**
- * Sandbox0 API
- * Public HTTP APIs exposed by Sandbox0 regional gateways and the global gateway.
- *
- * The version of the OpenAPI document: 0.1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-/**
- * Check if a given object implements the VolumeFileArchiveImportResponse interface.
- */
-export function instanceOfVolumeFileArchiveImportResponse(value) {
-    if (!('files' in value) || value['files'] === undefined)
-        return false;
-    if (!('directories' in value) || value['directories'] === undefined)
-        return false;
-    if (!('symlinks' in value) || value['symlinks'] === undefined)
-        return false;
-    if (!('bytes' in value) || value['bytes'] === undefined)
-        return false;
-    return true;
-}
-export function VolumeFileArchiveImportResponseFromJSON(json) {
-    return VolumeFileArchiveImportResponseFromJSONTyped(json, false);
-}
-export function VolumeFileArchiveImportResponseFromJSONTyped(json, ignoreDiscriminator) {
-    if (json == null) {
-        return json;
-    }
-    return {
-        'files': json['files'],
-        'directories': json['directories'],
-        'symlinks': json['symlinks'],
-        'bytes': json['bytes'],
-    };
-}
-export function VolumeFileArchiveImportResponseToJSON(json) {
-    return VolumeFileArchiveImportResponseToJSONTyped(json, false);
-}
-export function VolumeFileArchiveImportResponseToJSONTyped(value, ignoreDiscriminator = false) {
-    if (value == null) {
-        return value;
-    }
-    return {
-        'files': value['files'],
-        'directories': value['directories'],
-        'symlinks': value['symlinks'],
-        'bytes': value['bytes'],
-    };
-}

package/dist/apispec/src/models/VolumeMountSpec.d.ts

@@ -1,45 +0,0 @@
-/**
- * Sandbox0 API
- * Public HTTP APIs exposed by Sandbox0 regional gateways and the global gateway.
- *
- * The version of the OpenAPI document: 0.1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-/**
- *
- * @export
- * @interface VolumeMountSpec
- */
-export interface VolumeMountSpec {
-    /**
-     *
-     * @type {string}
-     * @memberof VolumeMountSpec
-     */
-    name: string;
-    /**
-     *
-     * @type {string}
-     * @memberof VolumeMountSpec
-     */
-    mountPath: string;
-    /**
-     *
-     * @type {boolean}
-     * @memberof VolumeMountSpec
-     */
-    readOnly?: boolean;
-}
-/**
- * Check if a given object implements the VolumeMountSpec interface.
- */
-export declare function instanceOfVolumeMountSpec(value: object): value is VolumeMountSpec;
-export declare function VolumeMountSpecFromJSON(json: any): VolumeMountSpec;
-export declare function VolumeMountSpecFromJSONTyped(json: any, ignoreDiscriminator: boolean): VolumeMountSpec;
-export declare function VolumeMountSpecToJSON(json: any): VolumeMountSpec;
-export declare function VolumeMountSpecToJSONTyped(value?: VolumeMountSpec | null, ignoreDiscriminator?: boolean): any;
-//# sourceMappingURL=VolumeMountSpec.d.ts.map

package/dist/apispec/src/models/VolumeMountSpec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VolumeMountSpec.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/VolumeMountSpec.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAIjF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe,CAElE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,eAAe,CAUrG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe,CAEhE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAWpH"}

package/dist/apispec/src/models/VolumeMountSpec.js

@@ -1,49 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-/**
- * Sandbox0 API
- * Public HTTP APIs exposed by Sandbox0 regional gateways and the global gateway.
- *
- * The version of the OpenAPI document: 0.1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-/**
- * Check if a given object implements the VolumeMountSpec interface.
- */
-export function instanceOfVolumeMountSpec(value) {
-    if (!('name' in value) || value['name'] === undefined)
-        return false;
-    if (!('mountPath' in value) || value['mountPath'] === undefined)
-        return false;
-    return true;
-}
-export function VolumeMountSpecFromJSON(json) {
-    return VolumeMountSpecFromJSONTyped(json, false);
-}
-export function VolumeMountSpecFromJSONTyped(json, ignoreDiscriminator) {
-    if (json == null) {
-        return json;
-    }
-    return {
-        'name': json['name'],
-        'mountPath': json['mountPath'],
-        'readOnly': json['readOnly'] == null ? undefined : json['readOnly'],
-    };
-}
-export function VolumeMountSpecToJSON(json) {
-    return VolumeMountSpecToJSONTyped(json, false);
-}
-export function VolumeMountSpecToJSONTyped(value, ignoreDiscriminator = false) {
-    if (value == null) {
-        return value;
-    }
-    return {
-        'name': value['name'],
-        'mountPath': value['mountPath'],
-        'readOnly': value['readOnly'],
-    };
-}

package/dist/resources/volumes.d.ts

@@ -1,31 +0,0 @@
-import type { CreateSandboxVolumeRequest, FileInfo, ForkVolumeRequest, CreateSnapshotRequest, SandboxVolume, Snapshot, SuccessCreatedResponse, SuccessDeletedResponse, SuccessRestoreResponse, SuccessMovedResponse, VolumeFileArchiveImportResponse, SuccessWrittenResponse } from "../apispec/src/models/index.js";
-import type { Client } from "../client.js";
-import { VolumeSession } from "../sessions.js";
-import { FileWatchStream } from "../sandbox.js";
-export declare class Volumes {
-    private readonly client;
-    constructor(client: Client);
-    create(request: CreateSandboxVolumeRequest): Promise<SandboxVolume>;
-    open(request: CreateSandboxVolumeRequest): Promise<VolumeSession>;
-    list(): Promise<SandboxVolume[]>;
-    get(volumeId: string): Promise<SandboxVolume>;
-    delete(volumeId: string, options?: {
-        force?: boolean;
-    }): Promise<SuccessDeletedResponse>;
-    fork(volumeId: string, request?: ForkVolumeRequest): Promise<SandboxVolume>;
-    createSnapshot(volumeId: string, request: CreateSnapshotRequest): Promise<Snapshot>;
-    listSnapshots(volumeId: string): Promise<Snapshot[]>;
-    getSnapshot(volumeId: string, snapshotId: string): Promise<Snapshot>;
-    deleteSnapshot(volumeId: string, snapshotId: string): Promise<SuccessDeletedResponse>;
-    restoreSnapshot(volumeId: string, snapshotId: string): Promise<SuccessRestoreResponse>;
-    readFile(volumeId: string, path: string): Promise<Uint8Array>;
-    statFile(volumeId: string, path: string): Promise<FileInfo>;
-    listFiles(volumeId: string, path: string): Promise<FileInfo[]>;
-    writeFile(volumeId: string, path: string, data: Uint8Array | string): Promise<SuccessWrittenResponse>;
-    importArchive(volumeId: string, path: string, archive: Blob | Uint8Array | ArrayBuffer | string): Promise<VolumeFileArchiveImportResponse>;
-    mkdir(volumeId: string, path: string, recursive?: boolean): Promise<SuccessCreatedResponse>;
-    deleteFile(volumeId: string, path: string): Promise<SuccessDeletedResponse>;
-    moveFile(volumeId: string, source: string, destination: string): Promise<SuccessMovedResponse>;
-    watchFiles(volumeId: string, path: string, recursive?: boolean): Promise<FileWatchStream>;
-}
-//# sourceMappingURL=volumes.d.ts.map

package/dist/resources/volumes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"volumes.d.ts","sourceRoot":"","sources":["../../src/resources/volumes.ts"],"names":[],"mappings":"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"}

package/dist/resources/volumes.js

@@ -1,222 +0,0 @@
-import { models } from "../apispec_compat.js";
-import { APIError } from "../errors.js";
-import { ensureData, ensureModel } from "../response.js";
-import { wrapApiCall } from "../errors.js";
-import { VolumeSession } from "../sessions.js";
-import { FileWatchStream } from "../sandbox.js";
-import { WebSocketClient } from "../ws_client.js";
-export class Volumes {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    async create(request) {
-        const response = await wrapApiCall(() => this.client.apispec.sandboxVolumes.apiV1SandboxvolumesPost({
-            createSandboxVolumeRequest: request,
-        }));
-        return ensureData(response, "create volume returned empty response");
-    }
-    async open(request) {
-        const volume = await this.create(request);
-        return new VolumeSession(volume, async () => {
-            await this.delete(volume.id);
-        });
-    }
-    async list() {
-        const response = await wrapApiCall(() => this.client.apispec.sandboxVolumes.apiV1SandboxvolumesGet());
-        const data = ensureData(response, "list volumes returned empty response");
-        return data;
-    }
-    async get(volumeId) {
-        const response = await wrapApiCall(() => this.client.apispec.sandboxVolumes.apiV1SandboxvolumesIdGet({ id: volumeId }));
-        return ensureData(response, "get volume returned empty response");
-    }
-    async delete(volumeId, options) {
-        const response = await wrapApiCall(() => this.client.apispec.sandboxVolumes.apiV1SandboxvolumesIdDelete({
-            id: volumeId,
-            force: options?.force,
-        }));
-        return ensureModel(response, "delete volume returned empty response");
-    }
-    async fork(volumeId, request) {
-        const response = await wrapApiCall(() => this.client.apispec.sandboxVolumes.apiV1SandboxvolumesIdForkPost({
-            id: volumeId,
-            forkVolumeRequest: request,
-        }));
-        return ensureData(response, "fork volume returned empty response");
-    }
-    async createSnapshot(volumeId, request) {
-        const response = await wrapApiCall(() => this.client.apispec.snapshots.apiV1SandboxvolumesIdSnapshotsPost({
-            id: volumeId,
-            createSnapshotRequest: request,
-        }));
-        return ensureData(response, "create snapshot returned empty response");
-    }
-    async listSnapshots(volumeId) {
-        const response = await wrapApiCall(() => this.client.apispec.snapshots.apiV1SandboxvolumesIdSnapshotsGet({ id: volumeId }));
-        const data = ensureData(response, "list snapshots returned empty response");
-        return data;
-    }
-    async getSnapshot(volumeId, snapshotId) {
-        const response = await wrapApiCall(() => this.client.apispec.snapshots.apiV1SandboxvolumesIdSnapshotsSnapshotIdGet({
-            id: volumeId,
-            snapshotId,
-        }));
-        return ensureData(response, "get snapshot returned empty response");
-    }
-    async deleteSnapshot(volumeId, snapshotId) {
-        const response = await wrapApiCall(() => this.client.apispec.snapshots.apiV1SandboxvolumesIdSnapshotsSnapshotIdDelete({
-            id: volumeId,
-            snapshotId,
-        }));
-        return ensureModel(response, "delete snapshot returned empty response");
-    }
-    async restoreSnapshot(volumeId, snapshotId) {
-        const response = await wrapApiCall(() => this.client.apispec.snapshots.apiV1SandboxvolumesIdSnapshotsSnapshotIdRestorePost({
-            id: volumeId,
-            snapshotId,
-        }));
-        return ensureModel(response, "restore snapshot returned empty response");
-    }
-    async readFile(volumeId, path) {
-        const response = await wrapApiCall(() => this.client.apispec.files.apiV1SandboxvolumesIdFilesGetRaw({
-            id: volumeId,
-            path,
-        }));
-        const contentType = response.raw.headers.get("content-type")?.toLowerCase() ?? "";
-        if (contentType.includes("application/json")) {
-            const payload = (await response.raw.json());
-            const data = ensureData(payload, "read volume file returned empty response");
-            const content = data.content ?? "";
-            const encoding = data.encoding;
-            if (encoding && encoding !== models.FileContentResponseEncodingEnum.Base64) {
-                throw new APIError({
-                    statusCode: response.raw.status,
-                    code: "unsupported_encoding",
-                    message: `unsupported file encoding: ${encoding}`,
-                });
-            }
-            return Buffer.from(content, "base64");
-        }
-        const blob = await response.value();
-        const buffer = await blob.arrayBuffer();
-        return new Uint8Array(buffer);
-    }
-    async statFile(volumeId, path) {
-        const response = await wrapApiCall(() => this.client.apispec.files.apiV1SandboxvolumesIdFilesStatGet({
-            id: volumeId,
-            path,
-        }));
-        return ensureData(response, "stat volume file returned empty response");
-    }
-    async listFiles(volumeId, path) {
-        const response = await wrapApiCall(() => this.client.apispec.files.apiV1SandboxvolumesIdFilesListGet({
-            id: volumeId,
-            path,
-        }));
-        const data = ensureData(response, "list volume files returned empty response");
-        return data.entries ?? [];
-    }
-    async writeFile(volumeId, path, data) {
-        const payload = typeof data === "string" ? Buffer.from(data) : data;
-        const response = await wrapApiCall(() => this.client.apispec.files.apiV1SandboxvolumesIdFilesPost({
-            id: volumeId,
-            path,
-            body: new Blob([payload]),
-        }));
-        return ensureModel(response, "write volume file returned empty response");
-    }
-    async importArchive(volumeId, path, archive) {
-        const body = archive instanceof Blob ? archive : new Blob([archive]);
-        const response = await wrapApiCall(() => this.client.apispec.files.apiV1SandboxvolumesIdFilesArchivePut({
-            id: volumeId,
-            path,
-            body,
-        }));
-        return ensureData(response, "import volume archive returned empty response");
-    }
-    async mkdir(volumeId, path, recursive = false) {
-        const response = await wrapApiCall(() => this.client.apispec.files.apiV1SandboxvolumesIdFilesPost({
-            id: volumeId,
-            path,
-            mkdir: true,
-            recursive: recursive || undefined,
-            body: new Blob([]),
-        }));
-        return ensureModel(response, "mkdir volume path returned empty response");
-    }
-    async deleteFile(volumeId, path) {
-        const response = await wrapApiCall(() => this.client.apispec.files.apiV1SandboxvolumesIdFilesDelete({
-            id: volumeId,
-            path,
-        }));
-        return ensureModel(response, "delete volume file returned empty response");
-    }
-    async moveFile(volumeId, source, destination) {
-        const response = await wrapApiCall(() => this.client.apispec.files.apiV1SandboxvolumesIdFilesMovePost({
-            id: volumeId,
-            moveFileRequest: { source, destination },
-        }));
-        return ensureModel(response, "move volume file returned empty response");
-    }
-    async watchFiles(volumeId, path, recursive = false) {
-        const wsUrl = this.client.websocketUrl(`/api/v1/sandboxvolumes/${volumeId}/files/watch`);
-        const headers = await this.client.wsHeaders();
-        const socket = await WebSocketClient.connect(wsUrl, { headers });
-        await socket.waitForOpen();
-        socket.send(JSON.stringify({ action: "subscribe", path, recursive: !!recursive }));
-        const firstRaw = await socket.waitForMessage();
-        const first = firstRaw ? parseWsMessage(firstRaw) : null;
-        if (!first) {
-            socket.close();
-            throw new APIError({
-                statusCode: 0,
-                code: "watch_failed",
-                message: "watch subscribe failed: empty response",
-            });
-        }
-        if (first.type === "error") {
-            socket.close();
-            throw new APIError({
-                statusCode: 0,
-                code: "watch_failed",
-                message: `watch subscribe failed: ${first.error ?? ""}`,
-            });
-        }
-        if (first.type !== "subscribed" || !first.watch_id) {
-            socket.close();
-            throw new APIError({
-                statusCode: 0,
-                code: "watch_failed",
-                message: `unexpected watch response: ${first.type ?? ""}`,
-            });
-        }
-        const stream = new FileWatchStream(socket);
-        stream.watchId = String(first.watch_id);
-        return stream;
-    }
-}
-function parseWsMessage(data) {
-    try {
-        let text;
-        if (typeof data === "string") {
-            text = data;
-        }
-        else if (Buffer.isBuffer(data)) {
-            text = data.toString("utf-8");
-        }
-        else if (Array.isArray(data)) {
-            text = Buffer.concat(data).toString("utf-8");
-        }
-        else if (data instanceof ArrayBuffer) {
-            text = Buffer.from(data).toString("utf-8");
-        }
-        else {
-            text = Buffer.from(data).toString("utf-8");
-        }
-        return JSON.parse(text);
-    }
-    catch {
-        return null;
-    }
-}