@spheron/sandbox 0.0.0-stage → 0.1.0

package/dist/commands.js

@@ -0,0 +1,223 @@
+import { CommandExitError, SandboxUnreachableError, TimeoutError } from './errors.js';
+import { sleep } from './http.js';
+import { FINAL_STATUSES } from './types.js';
+/** How long one output read may be held open by the server waiting for new output (it allows up to 60). */
+const LONG_POLL_SEC = 25;
+/** How long run()'s first request may wait for the command to finish (the server allows up to 60). */
+const RUN_WAIT_SEC = 50;
+/** The server's own default command timeout, used to bound run()'s wait when none is given. */
+const DEFAULT_TIMEOUT_SEC = 600;
+/** run() waits this long past the command's timeout before giving up on hearing back (an unreachable instance). */
+const RUN_WAIT_GRACE_MS = 5 * 60_000;
+const byteLength = (s) => new TextEncoder().encode(s).length;
+/** A command on the sandbox, running or finished. Get one from `sandbox.commands.start()` or `.get()`. */
+export class CommandHandle {
+    http;
+    base;
+    pollIntervalMs;
+    id;
+    currentStatus = 'queued';
+    currentExitCode;
+    /** Byte offset of the next output to read. */
+    offset = 0;
+    output = '';
+    last;
+    /** @internal Use sandbox.commands.start() or .get(). */
+    constructor(http, base, commandId, pollIntervalMs, view) {
+        this.http = http;
+        this.base = base;
+        this.pollIntervalMs = pollIntervalMs;
+        this.id = commandId;
+        if (view)
+            this.absorb(view);
+    }
+    /** Last status seen: queued, running, done, failed, killed or expired. */
+    get status() {
+        return this.currentStatus;
+    }
+    /** Set once the command has exited. */
+    get exitCode() {
+        return this.currentExitCode;
+    }
+    /** The command has finished (done, failed, killed or expired). */
+    get finished() {
+        return FINAL_STATUSES.has(this.currentStatus);
+    }
+    /** Output this handle has collected so far. */
+    get outputSoFar() {
+        return this.output;
+    }
+    /** Takes in an answer and returns its new output. The server reads from our offset, so new output starts there. */
+    absorb(view) {
+        this.last = view;
+        this.currentStatus = view.status;
+        if (typeof view.exitCode === 'number')
+            this.currentExitCode = view.exitCode;
+        if (view.outputOffset !== this.offset || !view.output)
+            return '';
+        this.offset = view.nextOffset ?? view.outputOffset + byteLength(view.output);
+        this.output += view.output;
+        return view.output;
+    }
+    result() {
+        const v = this.last;
+        return {
+            commandId: this.id,
+            status: this.currentStatus,
+            exitCode: this.currentExitCode,
+            ok: this.currentStatus === 'done' && this.currentExitCode === 0,
+            output: this.output,
+            outputTruncated: !!v?.outputTruncated,
+            logPath: v?.logPath,
+            error: v?.error,
+        };
+    }
+    /** Reads the status and any new output once. With waitSec, the server holds the answer until there is some. */
+    async poll(opts = {}) {
+        const waitSec = opts.waitSec ?? 0;
+        const view = await this.http.request('GET', `${this.base}/commands/${encodeURIComponent(this.id)}`, {
+            query: { offset: this.offset, waitSec: waitSec > 0 ? waitSec : undefined },
+            timeoutMs: waitSec * 1000 + 30_000,
+            signal: opts.signal,
+        });
+        return this.absorb(view);
+    }
+    /** New output until the command finishes, reading at most once per poll interval. */
+    async *follow(signal) {
+        while (!this.finished) {
+            const started = Date.now();
+            const chunk = await this.poll({ waitSec: LONG_POLL_SEC, signal });
+            if (chunk)
+                yield chunk;
+            if (this.finished)
+                return;
+            // Also when the server answers at once (output flowing).
+            const left = this.pollIntervalMs - (Date.now() - started);
+            if (left > 0)
+                await sleep(left, signal);
+        }
+    }
+    /**
+     * Output as it arrives, until the command finishes: first what this handle already has, then each new piece.
+     * The command keeps running if you stop iterating.
+     *
+     * ```ts
+     * for await (const chunk of handle.stream()) process.stdout.write(chunk);
+     * ```
+     */
+    async *stream(opts = {}) {
+        if (this.output)
+            yield this.output;
+        yield* this.follow(opts.signal);
+        return this.result();
+    }
+    /** Wait for the command to finish and return everything it printed. */
+    async wait(opts = {}) {
+        if (opts.signal?.aborted)
+            throw opts.signal.reason;
+        const ac = new AbortController();
+        const onAbort = () => ac.abort(opts.signal.reason);
+        opts.signal?.addEventListener('abort', onAbort, { once: true });
+        const timer = opts.timeoutMs !== undefined ? setTimeout(() => ac.abort(new TimeoutError('timeout')), opts.timeoutMs) : undefined;
+        try {
+            if (this.output)
+                opts.onOutput?.(this.output);
+            for await (const chunk of this.follow(ac.signal))
+                opts.onOutput?.(chunk);
+        }
+        catch (error) {
+            if (ac.signal.reason instanceof TimeoutError && error === ac.signal.reason) {
+                throw new TimeoutError(`Command ${this.id} did not finish within ${opts.timeoutMs} ms. It is still ${this.currentStatus} on the instance.`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+            opts.signal?.removeEventListener('abort', onAbort);
+        }
+        const result = this.result();
+        if (opts.check)
+            assertSucceeded(result);
+        return result;
+    }
+    /** Stop the command and everything it started. Safe on one that already finished. */
+    async kill() {
+        const out = await this.http.request('POST', `${this.base}/commands/${encodeURIComponent(this.id)}/kill`, {
+            idempotent: true,
+        });
+        this.currentStatus = out.status;
+        return out.status;
+    }
+}
+function assertSucceeded(r) {
+    if (r.ok)
+        return;
+    // A non-zero exit comes back as failed with its exit code; a timeout or a kill also carries an error.
+    const why = typeof r.exitCode === 'number' && r.exitCode !== 0
+        ? `exited with code ${r.exitCode}${r.error ? ` (${r.error})` : ''}`
+        : `ended as ${r.status}${r.error ? `: ${r.error}` : ''}`;
+    throw new CommandExitError(`Command ${r.commandId} ${why}`, { commandId: r.commandId, exitCode: r.exitCode, status: r.status, output: r.output });
+}
+/** Shell commands on the sandbox. Use it as `sandbox.commands`. */
+export class Commands {
+    http;
+    base;
+    pollIntervalMs;
+    /** @internal */
+    constructor(http, base, pollIntervalMs) {
+        this.http = http;
+        this.base = base;
+        this.pollIntervalMs = pollIntervalMs;
+    }
+    /**
+     * Run a command with bash, as the login user (with sudo), and wait for it to finish.
+     *
+     * ```ts
+     * const r = await sandbox.commands.run('nvidia-smi');
+     * console.log(r.exitCode, r.output);
+     * ```
+     *
+     * It is killed after timeoutSec (default 600): pass a larger one, up to 86400, for long jobs, or use start().
+     * Throws SandboxUnreachableError (with the command id and a recovery command) when the instance cannot be reached;
+     * the command then stays queued and runs once the sandbox is back, unless you kill it.
+     */
+    async run(command, opts = {}) {
+        // With onOutput, answer at once and stream; otherwise let the first request wait for a short command to end.
+        const waitSec = opts.onOutput ? 0 : RUN_WAIT_SEC;
+        const view = await this.http.request('POST', `${this.base}/commands`, {
+            body: { command, cwd: opts.cwd, env: opts.env, timeoutSec: opts.timeoutSec, waitSec },
+            timeoutMs: waitSec * 1000 + 30_000,
+            signal: opts.signal,
+        });
+        if (!FINAL_STATUSES.has(view.status) && view.recovery)
+            throw unreachable(view);
+        const handle = new CommandHandle(this.http, this.base, view.commandId, this.pollIntervalMs, view);
+        const waitTimeoutMs = opts.waitTimeoutMs ?? (opts.timeoutSec ?? DEFAULT_TIMEOUT_SEC) * 1000 + RUN_WAIT_GRACE_MS;
+        return handle.wait({ onOutput: opts.onOutput, timeoutMs: waitTimeoutMs, check: opts.check, signal: opts.signal });
+    }
+    /**
+     * Start a command in the background and return right away. Use the handle to stream output, wait or kill it.
+     *
+     * ```ts
+     * const job = await sandbox.commands.start('python train.py');
+     * for await (const chunk of job.stream()) process.stdout.write(chunk);
+     * ```
+     */
+    async start(command, opts = {}) {
+        const view = await this.http.request('POST', `${this.base}/commands`, {
+            body: { command, cwd: opts.cwd, env: opts.env, timeoutSec: opts.timeoutSec, background: true, waitSec: 0 },
+        });
+        return new CommandHandle(this.http, this.base, view.commandId, this.pollIntervalMs, view);
+    }
+    /** A handle on a command started earlier, for example from another process. */
+    async get(commandId) {
+        const handle = new CommandHandle(this.http, this.base, commandId, this.pollIntervalMs);
+        await handle.poll();
+        return handle;
+    }
+}
+function unreachable(view) {
+    const message = `${view.recovery.message} Command ${view.commandId} is queued and runs once the sandbox is back, unless you kill it.`;
+    return new SandboxUnreachableError(503, message, { recovery: view.recovery, commandId: view.commandId, body: view });
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,108 @@
+/** What to do when Spheron cannot reach the sandbox program on the instance. */
+export interface Recovery {
+    message: string;
+    /** A one-line command to run over SSH on the instance. It brings the sandbox back. Expires within 30 minutes. */
+    command?: string;
+}
+/** Base class for every error this SDK throws. */
+export declare class SpheronError extends Error {
+    /** The instance this error is about, when one was already created (it bills until it is terminated). */
+    deploymentId?: string;
+    constructor(message: string);
+}
+/** The Spheron API refused a request. */
+export declare class SpheronApiError extends SpheronError {
+    /** HTTP status. */
+    readonly status: number;
+    /** Stable error code from the API (for example `insufficient_credits`), when it sent one. */
+    readonly code?: string;
+    /** The response's X-Request-Id: quote it when asking Spheron support about a failure. */
+    readonly requestId?: string;
+    /** The parsed response body. */
+    readonly body: unknown;
+    constructor(status: number, message: string, opts?: {
+        code?: string;
+        requestId?: string;
+        body?: unknown;
+    });
+}
+/** 401 or 403 on the API key: missing, wrong, expired, an Inference key, or used from an address it does not allow. */
+export declare class AuthenticationError extends SpheronApiError {
+}
+/** 404: no such instance on this account, no sandbox on it, or it was deployed by someone else on the team. */
+export declare class NotFoundError extends SpheronApiError {
+}
+/** 429: too many requests (or too many file transfers at once). The SDK already retried before throwing this. */
+export declare class RateLimitError extends SpheronApiError {
+    /** Seconds the API asked to wait, when it said. */
+    readonly retryAfterSec?: number;
+    constructor(status: number, message: string, opts?: {
+        code?: string;
+        requestId?: string;
+        body?: unknown;
+        retryAfterSec?: number;
+    });
+}
+/** 409: the instance is stopped, terminated or failed. Start it (or deploy a new one) to use the sandbox again. */
+export declare class InstanceNotRunningError extends SpheronApiError {
+}
+/** 409: the sandbox program is still being installed. `Sandbox.waitUntilReady()` waits for this to pass. */
+export declare class SandboxNotReadyError extends SpheronApiError {
+}
+/**
+ * Spheron cannot reach the sandbox program on the instance. `recovery.command` is a one-line command to run over SSH
+ * on the instance to bring it back. From commands.run(), `commandId` names the command, which stays queued and runs
+ * once the sandbox is back unless it is killed.
+ */
+export declare class SandboxUnreachableError extends SpheronApiError {
+    readonly recovery?: Recovery;
+    readonly commandId?: string;
+    constructor(status: number, message: string, opts?: {
+        code?: string;
+        requestId?: string;
+        body?: unknown;
+        recovery?: Recovery;
+        commandId?: string;
+    });
+}
+/** A wait in the SDK (for the sandbox to be ready, or for a command to finish) ran out of time. */
+export declare class TimeoutError extends SpheronError {
+}
+/** `Sandbox.create()` found no offer it could deploy with the sandbox. */
+export declare class NoOfferError extends SpheronError {
+    /** Why each offer that was tried was refused. */
+    readonly attempts: {
+        offerId: string;
+        provider: string;
+        reason: string;
+    }[];
+    constructor(message: string, attempts?: {
+        offerId: string;
+        provider: string;
+        reason: string;
+    }[]);
+}
+/** The sandbox install failed or the sandbox was removed. `recoveryCommand` brings it back when present. */
+export declare class SandboxFailedError extends SpheronError {
+    readonly state: string;
+    readonly failureReason?: string;
+    readonly recoveryCommand?: string;
+    constructor(message: string, opts: {
+        state: string;
+        failureReason?: string;
+        recoveryCommand?: string;
+    });
+}
+/** A command finished with a non-zero exit code, from `run(..., { check: true })`. */
+export declare class CommandExitError extends SpheronError {
+    readonly commandId: string;
+    readonly exitCode?: number;
+    readonly status: string;
+    readonly output: string;
+    constructor(message: string, opts: {
+        commandId: string;
+        exitCode?: number;
+        status: string;
+        output: string;
+    });
+}

package/dist/errors.js

@@ -0,0 +1,101 @@
+/** Base class for every error this SDK throws. */
+export class SpheronError extends Error {
+    /** The instance this error is about, when one was already created (it bills until it is terminated). */
+    deploymentId;
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+/** The Spheron API refused a request. */
+export class SpheronApiError extends SpheronError {
+    /** HTTP status. */
+    status;
+    /** Stable error code from the API (for example `insufficient_credits`), when it sent one. */
+    code;
+    /** The response's X-Request-Id: quote it when asking Spheron support about a failure. */
+    requestId;
+    /** The parsed response body. */
+    body;
+    constructor(status, message, opts = {}) {
+        super(message);
+        this.status = status;
+        this.code = opts.code;
+        this.requestId = opts.requestId;
+        this.body = opts.body;
+    }
+}
+/** 401 or 403 on the API key: missing, wrong, expired, an Inference key, or used from an address it does not allow. */
+export class AuthenticationError extends SpheronApiError {
+}
+/** 404: no such instance on this account, no sandbox on it, or it was deployed by someone else on the team. */
+export class NotFoundError extends SpheronApiError {
+}
+/** 429: too many requests (or too many file transfers at once). The SDK already retried before throwing this. */
+export class RateLimitError extends SpheronApiError {
+    /** Seconds the API asked to wait, when it said. */
+    retryAfterSec;
+    constructor(status, message, opts = {}) {
+        super(status, message, opts);
+        this.retryAfterSec = opts.retryAfterSec;
+    }
+}
+/** 409: the instance is stopped, terminated or failed. Start it (or deploy a new one) to use the sandbox again. */
+export class InstanceNotRunningError extends SpheronApiError {
+}
+/** 409: the sandbox program is still being installed. `Sandbox.waitUntilReady()` waits for this to pass. */
+export class SandboxNotReadyError extends SpheronApiError {
+}
+/**
+ * Spheron cannot reach the sandbox program on the instance. `recovery.command` is a one-line command to run over SSH
+ * on the instance to bring it back. From commands.run(), `commandId` names the command, which stays queued and runs
+ * once the sandbox is back unless it is killed.
+ */
+export class SandboxUnreachableError extends SpheronApiError {
+    recovery;
+    commandId;
+    constructor(status, message, opts = {}) {
+        super(status, message, opts);
+        this.recovery = opts.recovery;
+        this.commandId = opts.commandId;
+    }
+}
+/** A wait in the SDK (for the sandbox to be ready, or for a command to finish) ran out of time. */
+export class TimeoutError extends SpheronError {
+}
+/** `Sandbox.create()` found no offer it could deploy with the sandbox. */
+export class NoOfferError extends SpheronError {
+    /** Why each offer that was tried was refused. */
+    attempts;
+    constructor(message, attempts = []) {
+        super(message);
+        this.attempts = attempts;
+    }
+}
+/** The sandbox install failed or the sandbox was removed. `recoveryCommand` brings it back when present. */
+export class SandboxFailedError extends SpheronError {
+    state;
+    failureReason;
+    recoveryCommand;
+    constructor(message, opts) {
+        super(message);
+        this.state = opts.state;
+        this.failureReason = opts.failureReason;
+        this.recoveryCommand = opts.recoveryCommand;
+    }
+}
+/** A command finished with a non-zero exit code, from `run(..., { check: true })`. */
+export class CommandExitError extends SpheronError {
+    commandId;
+    exitCode;
+    status;
+    output;
+    constructor(message, opts) {
+        super(message);
+        this.commandId = opts.commandId;
+        this.exitCode = opts.exitCode;
+        this.status = opts.status;
+        this.output = opts.output;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/files.d.ts

@@ -0,0 +1,32 @@
+import type { HttpClient } from './http.js';
+import type { FileEntry } from './types.js';
+/** The most one read or write moves. Larger data: download it on the instance with commands.run (curl, git, huggingface-cli). */
+export declare const MAX_FILE_BYTES: number;
+export declare function toBase64(bytes: Uint8Array): string;
+export declare function fromBase64(b64: string): Uint8Array;
+/**
+ * Files on the sandbox. Use it as `sandbox.files`. Each read or write moves up to 5 MB. An account moves at most two
+ * files at once: this sandbox runs two at a time and queues the rest, and a 429 from transfers elsewhere is retried.
+ */
+export declare class Files {
+    private readonly http;
+    private readonly base;
+    private readonly slots;
+    /** @internal */
+    constructor(http: HttpClient, base: string);
+    /** Read a text file (UTF-8). Throws for anything that is not valid UTF-8: use readBytes for binary files. */
+    read(path: string): Promise<string>;
+    /** Read a file's raw bytes, up to 5 MB. */
+    readBytes(path: string): Promise<Uint8Array>;
+    /** Write a file, replacing it if it exists. Strings are written as UTF-8. mode is octal, like '0755'. */
+    write(path: string, data: string | Uint8Array | ArrayBuffer, opts?: {
+        mode?: string;
+    }): Promise<{
+        path: string;
+        size: number;
+    }>;
+    /** List a directory: each entry's name, type (file, dir or other) and size. */
+    list(path: string): Promise<FileEntry[]>;
+    /** Whether a path exists on the instance. Other failures, such as permission denied, are thrown. */
+    exists(path: string): Promise<boolean>;
+}

package/dist/files.js

@@ -0,0 +1,144 @@
+import { SpheronApiError, SpheronError } from './errors.js';
+/** The most one read or write moves. Larger data: download it on the instance with commands.run (curl, git, huggingface-cli). */
+export const MAX_FILE_BYTES = 5 * 1024 * 1024;
+/** How long a file operation may wait for the instance (the server allows up to 60). */
+const FILE_WAIT_SEC = 50;
+/** The API moves at most two files at once per account; more from one sandbox would only queue on 429s. */
+const TRANSFER_SLOTS = 2;
+/** What a missing path answers with (a failed file operation): the instance's own error text. */
+const MISSING = /no such file or directory|not a directory/i;
+/** Lets at most `size` callers run at once; the rest wait their turn. */
+class Slots {
+    free;
+    waiting = [];
+    constructor(size) {
+        this.free = size;
+    }
+    async run(fn) {
+        if (this.free > 0)
+            this.free--;
+        else
+            await new Promise((resolve) => this.waiting.push(resolve));
+        try {
+            return await fn();
+        }
+        finally {
+            const next = this.waiting.shift();
+            if (next)
+                next();
+            else
+                this.free++;
+        }
+    }
+}
+export function toBase64(bytes) {
+    const B = globalThis.Buffer;
+    if (B)
+        return B.from(bytes).toString('base64');
+    let bin = '';
+    for (let i = 0; i < bytes.length; i += 0x8000)
+        bin += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+    return btoa(bin);
+}
+export function fromBase64(b64) {
+    const B = globalThis.Buffer;
+    if (B)
+        return new Uint8Array(B.from(b64, 'base64'));
+    const bin = atob(b64);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++)
+        out[i] = bin.charCodeAt(i);
+    return out;
+}
+function toBytes(data) {
+    if (typeof data === 'string')
+        return new TextEncoder().encode(data);
+    if (data instanceof Uint8Array)
+        return data;
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    throw new SpheronError('data must be a string, a Uint8Array or an ArrayBuffer');
+}
+function checkPath(path) {
+    if (typeof path !== 'string' || !path.startsWith('/'))
+        throw new SpheronError(`path must be absolute, like /root/data.txt (got ${JSON.stringify(path)})`);
+}
+/**
+ * Files on the sandbox. Use it as `sandbox.files`. Each read or write moves up to 5 MB. An account moves at most two
+ * files at once: this sandbox runs two at a time and queues the rest, and a 429 from transfers elsewhere is retried.
+ */
+export class Files {
+    http;
+    base;
+    slots = new Slots(TRANSFER_SLOTS);
+    /** @internal */
+    constructor(http, base) {
+        this.http = http;
+        this.base = base;
+    }
+    /** Read a text file (UTF-8). Throws for anything that is not valid UTF-8: use readBytes for binary files. */
+    async read(path) {
+        const bytes = await this.readBytes(path);
+        try {
+            return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+        }
+        catch {
+            throw new SpheronError(`${path} is not a UTF-8 text file. Use files.readBytes() for binary files.`);
+        }
+    }
+    /** Read a file's raw bytes, up to 5 MB. */
+    async readBytes(path) {
+        checkPath(path);
+        const out = await this.slots.run(() => this.http.request('POST', `${this.base}/files/read`, {
+            body: { path, waitSec: FILE_WAIT_SEC },
+            timeoutMs: FILE_WAIT_SEC * 1000 + 30_000,
+            idempotent: true,
+        }));
+        return fromBase64(out.contentB64 ?? '');
+    }
+    /** Write a file, replacing it if it exists. Strings are written as UTF-8. mode is octal, like '0755'. */
+    async write(path, data, opts = {}) {
+        checkPath(path);
+        const bytes = toBytes(data);
+        if (bytes.length > MAX_FILE_BYTES) {
+            throw new SpheronError(`${path} is ${bytes.length} bytes; one write moves at most 5 MB. Download large data on the instance instead, for example with commands.run('curl -L -o ${path} <url>').`);
+        }
+        if (opts.mode !== undefined && !/^[0-7]{3,4}$/.test(opts.mode))
+            throw new SpheronError(`mode must be octal, like '0644' (got ${JSON.stringify(opts.mode)})`);
+        return this.slots.run(() => this.http.request('POST', `${this.base}/files/write`, {
+            body: { path, contentB64: toBase64(bytes), mode: opts.mode, waitSec: FILE_WAIT_SEC },
+            timeoutMs: FILE_WAIT_SEC * 1000 + 60_000,
+            // Writing the same bytes again leaves the same file.
+            idempotent: true,
+        }));
+    }
+    /** List a directory: each entry's name, type (file, dir or other) and size. */
+    async list(path) {
+        checkPath(path);
+        const out = await this.http.request('POST', `${this.base}/files/list`, {
+            body: { path, waitSec: FILE_WAIT_SEC },
+            timeoutMs: FILE_WAIT_SEC * 1000 + 30_000,
+            idempotent: true,
+        });
+        return out.entries ?? [];
+    }
+    /** Whether a path exists on the instance. Other failures, such as permission denied, are thrown. */
+    async exists(path) {
+        checkPath(path);
+        const trimmed = path.replace(/\/+$/, '');
+        const slash = trimmed.lastIndexOf('/');
+        const name = trimmed.slice(slash + 1);
+        if (!name)
+            return true;
+        try {
+            return (await this.list(slash <= 0 ? '/' : trimmed.slice(0, slash))).some((e) => e.name === name);
+        }
+        catch (error) {
+            // A missing parent (or a parent that is a file) means the path does not exist either.
+            if (error instanceof SpheronApiError && error.status === 400 && MISSING.test(error.message))
+                return false;
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

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