fc-sandbox-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ComputeSDK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,87 @@
+# fc-sandbox-sdk
+
+TypeScript SDK for the `fc-spawn` control plane API.
+
+```ts
+import { FcClient } from "fc-sandbox-sdk";
+
+const fc = new FcClient({
+  apiKey: process.env.FC_API_KEY,
+  baseUrl: "https://fc-spawn.bhautik.in",
+});
+
+const sandbox = await fc.createSandbox({
+  shape: "s-1vcpu-256mb",
+  rootfs: "devbox:1",
+});
+
+const result = await fc.execSandbox(sandbox.id, {
+  cmd: "node",
+  args: ["--version"],
+});
+
+console.log(result.result.stdout);
+```
+
+## Streaming exec
+
+```ts
+for await (const event of fc.execSandboxStream(sandbox.id, {
+  cmd: "bash",
+  args: ["-lc", "for i in 1 2 3; do echo $i; sleep 1; done"],
+})) {
+  if (event.stdout) process.stdout.write(event.stdout);
+  if (event.stderr) process.stderr.write(event.stderr);
+  if (event.exit_code !== undefined) console.log("exit", event.exit_code);
+}
+```
+
+## Files
+
+```ts
+await fc.uploadFile(
+  sandbox.id,
+  "/tmp/hello.txt",
+  new TextEncoder().encode("hello"),
+);
+
+const bytes = await fc.downloadFile(sandbox.id, "/tmp/hello.txt");
+console.log(new TextDecoder().decode(bytes));
+```
+
+## API surface
+
+The client covers the OpenAPI gist endpoints:
+
+- health and readiness: `healthz`, `readyz`
+- catalog: `whoami`, `listShapes`, `listRootfs`, `listHosts`
+- sandboxes: create, list, get, patch, destroy, pause, resume, fork, lookup by IP
+- exec: buffered and NDJSON streaming
+- files: upload and download
+- egress, bandwidth, and disk resize
+- templates and template log streaming
+- networks and sandbox network attachment
+
+## Errors
+
+Non-2xx API responses throw `FcApiError`. The original `Response`, status code,
+and parsed JSend `fail` or `error` envelope are available on the error.
+
+## Publishing
+
+The safest release flow is:
+
+```sh
+npm whoami
+npm version patch
+npm run pack:dry
+npm run publish:dry
+npm run publish:npm
+git push --follow-tags
+```
+
+`prepublishOnly` runs the test and typecheck gates automatically before a real
+`npm publish`.
+
+If publish fails with `E401`, the local npm token is invalid; run
+`npm login --registry=https://registry.npmjs.org/` and try again.

package/dist/client.d.ts

@@ -0,0 +1,46 @@
+import type { BandwidthView, CreateSandboxRequest, CreateSandboxResponse, DestroyedResponse, EgressView, ExecRequest, ExecResponse, ExecStreamEvent, FcClientOptions, ForkSandboxRequest, GetTemplateLogsOptions, GetTemplateOptions, HealthzResponse, HostPublic, Network, NetworkCreateRequest, NetworkEntry, OKResponse, PatchSandboxRequest, PauseAck, ReadyzResponse, RechargeBandwidthRequest, ResumeAck, RequestOptions, ResizeSandboxRequest, ResizeSandboxResponse, RootfsData, SandboxView, SetEgressRequest, ShapesData, TemplateCreateRequest, TemplateLogEvent, TemplatesListResponse, TemplateView, WhoAmIView } from "./types.js";
+export declare class FcClient {
+    private readonly http;
+    constructor(options: FcClientOptions);
+    get baseUrl(): string;
+    healthz(options?: RequestOptions): Promise<HealthzResponse>;
+    readyz(options?: RequestOptions): Promise<ReadyzResponse>;
+    whoami(options?: RequestOptions): Promise<WhoAmIView>;
+    listShapes(options?: RequestOptions): Promise<ShapesData>;
+    listRootfs(options?: RequestOptions): Promise<RootfsData>;
+    listHosts(options?: RequestOptions): Promise<HostPublic[]>;
+    listSandboxes(options?: {
+        limit?: number;
+        status?: string;
+    } & RequestOptions): Promise<SandboxView[]>;
+    createSandbox(body: CreateSandboxRequest, options?: RequestOptions): Promise<CreateSandboxResponse>;
+    getSandbox(id: string, options?: RequestOptions): Promise<SandboxView>;
+    destroySandbox(id: string, options?: RequestOptions): Promise<DestroyedResponse>;
+    patchSandbox(id: string, body: PatchSandboxRequest, options?: RequestOptions): Promise<SandboxView>;
+    pauseSandbox(id: string, options?: RequestOptions): Promise<PauseAck>;
+    resumeSandbox(id: string, options?: RequestOptions): Promise<ResumeAck>;
+    forkSandbox(id: string, body?: ForkSandboxRequest, options?: RequestOptions): Promise<SandboxView>;
+    getSandboxByIP(ip: string, options?: RequestOptions): Promise<SandboxView>;
+    execSandbox(id: string, body: ExecRequest, options?: RequestOptions): Promise<ExecResponse>;
+    execSandboxStream(id: string, body: Omit<ExecRequest, "stream">, options?: RequestOptions): AsyncGenerator<ExecStreamEvent>;
+    uploadFile(id: string, path: string, bytes: BodyInit, options?: RequestOptions): Promise<unknown>;
+    downloadFile(id: string, path: string, options?: RequestOptions): Promise<ArrayBuffer>;
+    getEgress(id: string, options?: RequestOptions): Promise<EgressView>;
+    setEgress(id: string, body: SetEgressRequest, options?: RequestOptions): Promise<EgressView>;
+    getBandwidth(id: string, options?: RequestOptions): Promise<BandwidthView>;
+    rechargeBandwidth(id: string, body: RechargeBandwidthRequest, options?: RequestOptions): Promise<BandwidthView>;
+    resizeSandbox(id: string, body: ResizeSandboxRequest, options?: RequestOptions): Promise<ResizeSandboxResponse>;
+    listTemplates(options?: RequestOptions): Promise<TemplatesListResponse>;
+    submitTemplate(body: TemplateCreateRequest, options?: RequestOptions): Promise<TemplateView>;
+    getTemplate(id: string, options?: GetTemplateOptions): Promise<TemplateView>;
+    deleteTemplate(id: string, options?: RequestOptions): Promise<DestroyedResponse>;
+    getTemplateLogs(id: string, options?: GetTemplateLogsOptions): AsyncGenerator<TemplateLogEvent>;
+    listNetworks(options?: RequestOptions): Promise<Network[]>;
+    createNetwork(body: NetworkCreateRequest, options?: RequestOptions): Promise<Network>;
+    getNetwork(id: string, options?: RequestOptions): Promise<Network>;
+    deleteNetwork(id: string, options?: RequestOptions): Promise<OKResponse>;
+    attachNetwork(id: string, body: NetworkEntry, options?: RequestOptions): Promise<OKResponse>;
+    detachNetwork(id: string, network: string, options?: RequestOptions): Promise<OKResponse>;
+}
+export declare function createClient(options: FcClientOptions): FcClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,160 @@
+import { FcHttp, encodePath } from "./http.js";
+export class FcClient {
+    http;
+    constructor(options) {
+        this.http = new FcHttp(options);
+    }
+    get baseUrl() {
+        return this.http.baseUrl;
+    }
+    healthz(options) {
+        return this.http.request("GET", "/healthz", { ...options, auth: false });
+    }
+    readyz(options) {
+        return this.http.request("GET", "/readyz", { ...options, auth: false });
+    }
+    whoami(options) {
+        return this.http.request("GET", "/v1/whoami", options);
+    }
+    listShapes(options) {
+        return this.http.request("GET", "/v1/shapes", options);
+    }
+    listRootfs(options) {
+        return this.http.request("GET", "/v1/rootfs", options);
+    }
+    listHosts(options) {
+        return this.http.request("GET", "/v1/hosts", options);
+    }
+    listSandboxes(options = {}) {
+        const { limit, status, ...requestOptions } = options;
+        return this.http.request("GET", "/v1/sandboxes", {
+            ...requestOptions,
+            query: { limit, status }
+        });
+    }
+    createSandbox(body, options) {
+        return this.http.request("POST", "/v1/sandboxes", { ...options, body });
+    }
+    getSandbox(id, options) {
+        return this.http.request("GET", `/v1/sandboxes/${encodePath(id)}`, options);
+    }
+    destroySandbox(id, options) {
+        return this.http.request("DELETE", `/v1/sandboxes/${encodePath(id)}`, options);
+    }
+    patchSandbox(id, body, options) {
+        return this.http.request("PATCH", `/v1/sandboxes/${encodePath(id)}`, { ...options, body });
+    }
+    pauseSandbox(id, options) {
+        return this.http.requestWithEmptyFallback("POST", `/v1/sandboxes/${encodePath(id)}/pause`, {
+            options,
+            fallback: { id, status: "paused" }
+        });
+    }
+    resumeSandbox(id, options) {
+        return this.http.requestWithEmptyFallback("POST", `/v1/sandboxes/${encodePath(id)}/resume`, {
+            options,
+            fallback: { id, status: "running" }
+        });
+    }
+    forkSandbox(id, body = {}, options) {
+        return this.http.request("POST", `/v1/sandboxes/${encodePath(id)}/fork`, { ...options, body });
+    }
+    getSandboxByIP(ip, options) {
+        return this.http.request("GET", `/v1/sandboxes/by-ip/${encodePath(ip)}`, options);
+    }
+    execSandbox(id, body, options) {
+        const { stream: _stream, ...bufferedBody } = body;
+        return this.http.request("POST", `/v1/sandboxes/${encodePath(id)}/exec`, {
+            ...options,
+            body: bufferedBody
+        });
+    }
+    execSandboxStream(id, body, options) {
+        return this.http.stream("POST", `/v1/sandboxes/${encodePath(id)}/exec`, {
+            ...options,
+            query: { stream: true },
+            body: { ...body, stream: true }
+        });
+    }
+    async uploadFile(id, path, bytes, options) {
+        return this.http.request("PUT", `/v1/sandboxes/${encodePath(id)}/files`, {
+            ...options,
+            query: { path },
+            rawBody: bytes,
+            contentType: "application/octet-stream"
+        });
+    }
+    async downloadFile(id, path, options) {
+        const response = await this.http.fetchRaw("GET", `/v1/sandboxes/${encodePath(id)}/files`, {
+            ...options,
+            query: { path }
+        });
+        if (!response.ok) {
+            await this.http.throwApiError(response);
+        }
+        return response.arrayBuffer();
+    }
+    getEgress(id, options) {
+        return this.http.request("GET", `/v1/sandboxes/${encodePath(id)}/egress`, options);
+    }
+    setEgress(id, body, options) {
+        return this.http.request("PUT", `/v1/sandboxes/${encodePath(id)}/egress`, { ...options, body });
+    }
+    getBandwidth(id, options) {
+        return this.http.request("GET", `/v1/sandboxes/${encodePath(id)}/bandwidth`, options);
+    }
+    rechargeBandwidth(id, body, options) {
+        return this.http.request("POST", `/v1/sandboxes/${encodePath(id)}/bandwidth/recharge`, {
+            ...options,
+            body
+        });
+    }
+    resizeSandbox(id, body, options) {
+        return this.http.request("POST", `/v1/sandboxes/${encodePath(id)}/resize`, { ...options, body });
+    }
+    listTemplates(options) {
+        return this.http.request("GET", "/v1/templates", options);
+    }
+    submitTemplate(body, options) {
+        return this.http.request("POST", "/v1/templates", { ...options, body });
+    }
+    getTemplate(id, options = {}) {
+        const { include, ...requestOptions } = options;
+        return this.http.request("GET", `/v1/templates/${encodePath(id)}`, {
+            ...requestOptions,
+            query: { include }
+        });
+    }
+    deleteTemplate(id, options) {
+        return this.http.request("DELETE", `/v1/templates/${encodePath(id)}`, options);
+    }
+    getTemplateLogs(id, options = {}) {
+        const { attempt, limit, ...requestOptions } = options;
+        return this.http.stream("GET", `/v1/templates/${encodePath(id)}/logs`, {
+            ...requestOptions,
+            query: { attempt, limit }
+        });
+    }
+    listNetworks(options) {
+        return this.http.request("GET", "/v1/networks", options);
+    }
+    createNetwork(body, options) {
+        return this.http.request("POST", "/v1/networks", { ...options, body });
+    }
+    getNetwork(id, options) {
+        return this.http.request("GET", `/v1/networks/${encodePath(id)}`, options);
+    }
+    deleteNetwork(id, options) {
+        return this.http.request("DELETE", `/v1/networks/${encodePath(id)}`, options);
+    }
+    attachNetwork(id, body, options) {
+        return this.http.request("POST", `/v1/sandboxes/${encodePath(id)}/networks`, { ...options, body });
+    }
+    detachNetwork(id, network, options) {
+        return this.http.request("DELETE", `/v1/sandboxes/${encodePath(id)}/networks/${encodePath(network)}`, options);
+    }
+}
+export function createClient(options) {
+    return new FcClient(options);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+import type { ErrorEnvelope, FailEnvelope } from "./types.js";
+export declare class FcApiError extends Error {
+    readonly statusCode: number;
+    readonly envelope: FailEnvelope | ErrorEnvelope | undefined;
+    readonly response: Response;
+    constructor(message: string, response: Response, envelope?: FailEnvelope | ErrorEnvelope);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,aAAa;CAOzF"}

package/dist/errors.js

@@ -0,0 +1,13 @@
+export class FcApiError extends Error {
+    statusCode;
+    envelope;
+    response;
+    constructor(message, response, envelope) {
+        super(message);
+        this.name = "FcApiError";
+        this.statusCode = response.status;
+        this.response = response;
+        this.envelope = envelope;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,UAAU,CAAS;IACnB,QAAQ,CAA2C;IACnD,QAAQ,CAAW;IAE5B,YAAY,OAAe,EAAE,QAAkB,EAAE,QAAuC;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,29 @@
+import type { FcClientOptions, RequestOptions } from "./types.js";
+export type QueryValue = string | number | boolean | null | undefined;
+export type Query = Record<string, QueryValue>;
+export interface HttpRequestOptions extends RequestOptions {
+    query?: Query;
+    body?: unknown;
+    rawBody?: BodyInit;
+    contentType?: string;
+    auth?: boolean;
+}
+export declare class FcHttp {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    private readonly fetchFn;
+    private readonly defaultHeaders;
+    constructor(options: FcClientOptions);
+    request<T>(method: string, path: string, options?: HttpRequestOptions): Promise<T>;
+    requestWithEmptyFallback<T>(method: string, path: string, input: {
+        options: RequestOptions | undefined;
+        fallback: T;
+    }): Promise<T>;
+    stream<T>(method: string, path: string, options?: HttpRequestOptions): AsyncGenerator<T>;
+    fetchRaw(method: string, path: string, options?: HttpRequestOptions): Promise<Response>;
+    throwApiError(response: Response): Promise<never>;
+    private buildHeaders;
+    private buildUrl;
+}
+export declare function encodePath(value: string): string;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE/C,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,MAAM;IACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAc;gBAEjC,OAAO,EAAE,eAAe;IAgB9B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;IAUtF,wBAAwB,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;QAAE,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;QAAC,QAAQ,EAAE,CAAC,CAAA;KAAE,GAC1D,OAAO,CAAC,CAAC,CAAC;IAcN,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,cAAc,CAAC,CAAC,CAAC;IAcnG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBrF,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC;IAqBvD,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,QAAQ;CAajB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/http.js

@@ -0,0 +1,135 @@
+import { FcApiError } from "./errors.js";
+import { readNdjson } from "./ndjson.js";
+export class FcHttp {
+    baseUrl;
+    apiKey;
+    fetchFn;
+    defaultHeaders;
+    constructor(options) {
+        const fetchFn = options.fetch ?? globalThis.fetch;
+        if (!fetchFn) {
+            throw new Error("A fetch implementation is required.");
+        }
+        if (!options.baseUrl?.trim()) {
+            throw new Error("baseUrl is required.");
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = normalizeBaseUrl(options.baseUrl);
+        this.fetchFn = fetchFn;
+        this.defaultHeaders = options.headers ?? {};
+    }
+    async request(method, path, options = {}) {
+        const response = await this.fetchRaw(method, path, options);
+        if (!response.ok) {
+            await this.throwApiError(response);
+        }
+        return readSuccessEnvelope(response);
+    }
+    async requestWithEmptyFallback(method, path, input) {
+        const response = await this.fetchRaw(method, path, input.options);
+        if (!response.ok) {
+            await this.throwApiError(response);
+        }
+        if (!hasJsonBody(response)) {
+            return input.fallback;
+        }
+        return readSuccessEnvelope(response);
+    }
+    async *stream(method, path, options = {}) {
+        const response = await this.fetchRaw(method, path, options);
+        if (!response.ok) {
+            await this.throwApiError(response);
+        }
+        if (!response.body) {
+            throw new FcApiError("fc-spawn API returned an empty stream.", response);
+        }
+        yield* readNdjson(response.body);
+    }
+    fetchRaw(method, path, options = {}) {
+        const headers = this.buildHeaders(options);
+        const body = buildBody(headers, options);
+        const init = { method, headers };
+        if (body !== undefined) {
+            init.body = body;
+        }
+        if (options.signal !== undefined) {
+            init.signal = options.signal;
+        }
+        return this.fetchFn(this.buildUrl(path, options.query), init);
+    }
+    async throwApiError(response) {
+        if (hasJsonBody(response)) {
+            try {
+                const envelope = (await response.json());
+                if (envelope.status === "fail") {
+                    throw new FcApiError(`fc-spawn request failed with ${response.status}.`, response, envelope);
+                }
+                if (envelope.status === "error") {
+                    throw new FcApiError(envelope.message, response, envelope);
+                }
+            }
+            catch (error) {
+                if (error instanceof FcApiError) {
+                    throw error;
+                }
+            }
+        }
+        throw new FcApiError(`fc-spawn request failed with ${response.status}.`, response);
+    }
+    buildHeaders(options) {
+        const headers = new Headers(this.defaultHeaders);
+        if (options.headers) {
+            new Headers(options.headers).forEach((value, key) => headers.set(key, value));
+        }
+        if (options.auth !== false) {
+            if (!this.apiKey) {
+                throw new Error("An apiKey is required for authenticated fc-spawn requests.");
+            }
+            headers.set("Authorization", `Bearer ${this.apiKey}`);
+        }
+        return headers;
+    }
+    buildUrl(path, query) {
+        const url = new URL(path.replace(/^\/+/, ""), `${this.baseUrl}/`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+}
+export function encodePath(value) {
+    return encodeURIComponent(value);
+}
+function normalizeBaseUrl(baseUrl) {
+    const url = new URL(baseUrl);
+    return url.toString().replace(/\/+$/, "");
+}
+function buildBody(headers, options) {
+    if (options.rawBody !== undefined) {
+        if (options.contentType) {
+            headers.set("Content-Type", options.contentType);
+        }
+        return options.rawBody;
+    }
+    if (options.body !== undefined) {
+        headers.set("Content-Type", "application/json");
+        return JSON.stringify(options.body);
+    }
+    return undefined;
+}
+async function readSuccessEnvelope(response) {
+    const envelope = (await response.json());
+    if (envelope.status === "success") {
+        return envelope.data;
+    }
+    throw new FcApiError("fc-spawn API returned an unsuccessful envelope.", response, envelope);
+}
+function hasJsonBody(response) {
+    const contentType = response.headers.get("content-type") ?? "";
+    return contentType.includes("application/json");
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { FcClient, createClient } from "./client.js";
+export { FcApiError } from "./errors.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { FcClient, createClient } from "./client.js";
+export { FcApiError } from "./errors.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,cAAc,YAAY,CAAC"}

package/dist/ndjson.d.ts

@@ -0,0 +1,2 @@
+export declare function readNdjson<T>(body: ReadableStream<Uint8Array>): AsyncGenerator<T>;
+//# sourceMappingURL=ndjson.d.ts.map

package/dist/ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../src/ndjson.ts"],"names":[],"mappings":"AAAA,wBAAuB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAmCxF"}

package/dist/ndjson.js

@@ -0,0 +1,32 @@
+export async function* readNdjson(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                break;
+            }
+            buffer += decoder.decode(value, { stream: true });
+            let newlineIndex = buffer.indexOf("\n");
+            while (newlineIndex !== -1) {
+                const line = buffer.slice(0, newlineIndex).trim();
+                buffer = buffer.slice(newlineIndex + 1);
+                if (line.length > 0) {
+                    yield JSON.parse(line);
+                }
+                newlineIndex = buffer.indexOf("\n");
+            }
+        }
+        buffer += decoder.decode();
+        const finalLine = buffer.trim();
+        if (finalLine.length > 0) {
+            yield JSON.parse(finalLine);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=ndjson.js.map

package/dist/ndjson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.js","sourceRoot":"","sources":["../src/ndjson.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAAI,IAAgC;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM;YACR,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,IAAI,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAExC,OAAO,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;gBAClD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;gBAExC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;gBAC9B,CAAC;gBAED,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAM,CAAC;QACnC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,253 @@
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export interface SuccessEnvelope<T> {
+    status: "success";
+    data: T;
+}
+export interface FailEnvelope {
+    status: "fail";
+    data: Record<string, unknown>;
+}
+export interface ErrorEnvelope {
+    status: "error";
+    message: string;
+    code: number;
+}
+export type JSendEnvelope<T> = SuccessEnvelope<T> | FailEnvelope | ErrorEnvelope;
+export interface FcClientOptions {
+    apiKey?: string;
+    baseUrl: string;
+    fetch?: typeof fetch;
+    headers?: HeadersInit;
+}
+export interface RequestOptions {
+    signal?: AbortSignal;
+    headers?: HeadersInit;
+}
+export interface Shape {
+    id: string;
+    vcpu: number;
+    mem_mib: number;
+    default_disk_mib: number;
+}
+export interface ShapesData {
+    shapes: Shape[];
+}
+export interface RootfsEntry {
+    name: string;
+    description?: string;
+    deprecated?: boolean;
+    successor?: string;
+}
+export interface RootfsData {
+    rootfs: string[];
+    default: string;
+    entries: RootfsEntry[];
+}
+export type HostStatus = "active" | "draining" | "dead";
+export interface HostPublic {
+    id: string;
+    status: HostStatus;
+    free_mib: number;
+    vm_count: number;
+    rootfses: string[];
+}
+export interface NetworkEntry {
+    id: string;
+}
+export interface CreateSandboxRequest {
+    shape: string;
+    rootfs?: string;
+    name?: string;
+    networks?: NetworkEntry[];
+    disk_mib?: number;
+    egress?: string[];
+    envs?: Record<string, string>;
+    ssh_pubkeys?: string[];
+    bandwidth_quota_bytes?: number;
+    host_id?: string;
+    region?: string;
+}
+export type SandboxSpawnMode = "snapshot" | "cold";
+export interface CreateSandboxResponse {
+    id: string;
+    name: string;
+    ip: string;
+    mode: SandboxSpawnMode;
+    shape: string;
+    rootfs: string;
+    vcpu: number;
+    mem_mib: number;
+    disk_mib: number;
+    spawn_ms: number;
+    egress: string[];
+    bandwidth_quota_bytes: number;
+}
+export type SandboxStatus = "creating" | "running" | "pausing" | "paused" | "resuming" | "forking" | "error" | "destroying" | "destroyed" | "failed";
+export interface SandboxView {
+    id: string;
+    name: string;
+    status: SandboxStatus;
+    ip: string;
+    vcpu: number;
+    mem_mib: number;
+    disk_mib: number;
+    created_at: string;
+    running_at: string | null;
+    destroyed_at: string | null;
+    spawn_ms: number;
+    shape: string;
+    rootfs: string;
+    region: string;
+    egress: string[];
+    envs: string[];
+    ssh_pubkeys: string[];
+    created_by: string;
+    ingress_enabled: boolean;
+    bandwidth_ingress_bytes: number;
+    paused_at: string | null;
+    last_resumed_at: string | null;
+    forked_from?: string;
+}
+export interface ListSandboxesOptions extends RequestOptions {
+    limit?: number;
+    status?: Extract<SandboxStatus, "running" | "creating" | "destroyed" | "failed">;
+}
+export interface PauseAck {
+    id: string;
+    status: "pausing" | "paused";
+}
+export interface ResumeAck {
+    id: string;
+    status: "resuming" | "running";
+}
+export interface ForkSandboxRequest {
+    start_paused?: boolean;
+    ssh_pubkeys?: string[];
+    egress?: string[];
+    ingress_enabled?: boolean;
+    envs?: Record<string, string>;
+    bandwidth_quota_bytes?: number;
+}
+export interface PatchSandboxRequest {
+    ingress_enabled?: boolean;
+}
+export interface ExecRequest {
+    cmd: string;
+    args?: string[];
+    stdin?: string;
+    env?: Record<string, string>;
+    stream?: boolean;
+}
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exit_code: number;
+}
+export interface ExecResponse {
+    result: ExecResult;
+    exec_ms: number;
+}
+export interface ExecStreamEvent {
+    stdout?: string;
+    stderr?: string;
+    exit_code?: number;
+    error?: string;
+    hb?: boolean;
+}
+export interface SetEgressRequest {
+    egress?: string[] | null;
+}
+export interface EgressView {
+    id: string;
+    egress: string[];
+}
+export interface BandwidthView {
+    id: string;
+    quota_bytes: number;
+    used_bytes: number;
+    remaining_bytes: number;
+    capped: boolean;
+}
+export interface RechargeBandwidthRequest {
+    add_bytes: number;
+}
+export interface ResizeSandboxRequest {
+    disk_mib: number;
+}
+export interface ResizeSandboxResponse {
+    id: string;
+    disk_mib: number;
+}
+export interface DestroyedResponse {
+    id: string;
+    status: "destroying" | "destroyed";
+}
+export interface WhoAmIStatsView {
+    running: number;
+    paused: number;
+    other: number;
+    total: number;
+}
+export interface WhoAmIView {
+    user_id: string;
+    stats: WhoAmIStatsView;
+}
+export interface TemplateCreateRequest {
+    name: string;
+    dockerfile: string;
+}
+export type TemplateStatus = "pending" | "building" | "ready" | "failed";
+export interface TemplateView {
+    id: string;
+    name: string;
+    base: string;
+    status: TemplateStatus;
+    ext4_size_bytes: number;
+    created_at: string;
+    built_at: string | null;
+    dockerfile?: string;
+}
+export interface TemplatesListResponse {
+    templates: TemplateView[];
+}
+export interface GetTemplateOptions extends RequestOptions {
+    include?: "dockerfile";
+}
+export interface TemplateLogEvent {
+    ts?: string;
+    level?: string;
+    line?: string;
+    [key: string]: unknown;
+}
+export interface GetTemplateLogsOptions extends RequestOptions {
+    attempt?: number;
+    limit?: number;
+}
+export interface NetworkCreateRequest {
+    name: string;
+}
+export interface NetworkMember {
+    sandbox_id: string;
+    status: string;
+    ip: string;
+    name: string;
+}
+export interface Network {
+    id: string;
+    name: string;
+    created_at: string;
+    member_count?: number;
+    members?: NetworkMember[];
+}
+export interface OKResponse {
+    ok: boolean;
+}
+export interface HealthzResponse {
+    up: boolean;
+}
+export interface ReadyzResponse {
+    ready: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "fc-sandbox-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the fc-spawn control plane API.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "pack:dry": "npm pack --dry-run",
+    "publish:check": "npm whoami && npm run pack:dry",
+    "prepublishOnly": "npm run test && npm run typecheck",
+    "publish:dry": "npm run publish:check && npm publish --dry-run",
+    "publish:npm": "npm run publish:check && npm publish",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "fc-spawn",
+    "sandbox",
+    "sdk",
+    "compute"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  }
+}