@alibaba-group/opensandbox 0.1.0-dev1

package/dist/adapters/sandboxesAdapter.js

@@ -0,0 +1,146 @@
+// Copyright 2026 Alibaba Group Holding Ltd.
+// 
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// 
+//     http://www.apache.org/licenses/LICENSE-2.0
+// 
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { throwOnOpenApiFetchError } from "./openapiError.js";
+function encodeMetadataFilter(metadata) {
+    // The Lifecycle API expects a single `metadata` query parameter whose value is `k=v&k2=v2`.
+    // The query serializer will URL-encode the value (e.g. `=` -> %3D and `&` -> %26).
+    const parts = [];
+    for (const [k, v] of Object.entries(metadata)) {
+        parts.push(`${k}=${v}`);
+    }
+    return parts.join("&");
+}
+export class SandboxesAdapter {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    parseIsoDate(field, v) {
+        if (typeof v !== "string" || !v) {
+            throw new Error(`Invalid ${field}: expected ISO string, got ${typeof v}`);
+        }
+        const d = new Date(v);
+        if (Number.isNaN(d.getTime())) {
+            throw new Error(`Invalid ${field}: ${v}`);
+        }
+        return d;
+    }
+    mapSandboxInfo(raw) {
+        return {
+            ...(raw ?? {}),
+            createdAt: this.parseIsoDate("createdAt", raw?.createdAt),
+            expiresAt: this.parseIsoDate("expiresAt", raw?.expiresAt),
+        };
+    }
+    async createSandbox(req) {
+        // Make the OpenAPI contract explicit so backend schema changes surface quickly.
+        const body = req;
+        const { data, error, response } = await this.client.POST("/sandboxes", {
+            body,
+        });
+        throwOnOpenApiFetchError({ error, response }, "Create sandbox failed");
+        const raw = data;
+        if (!raw || typeof raw !== "object") {
+            throw new Error("Create sandbox failed: unexpected response shape");
+        }
+        return {
+            ...(raw ?? {}),
+            createdAt: this.parseIsoDate("createdAt", raw?.createdAt),
+            expiresAt: this.parseIsoDate("expiresAt", raw?.expiresAt),
+        };
+    }
+    async getSandbox(sandboxId) {
+        const { data, error, response } = await this.client.GET("/sandboxes/{sandboxId}", {
+            params: { path: { sandboxId } },
+        });
+        throwOnOpenApiFetchError({ error, response }, "Get sandbox failed");
+        const ok = data;
+        if (!ok || typeof ok !== "object") {
+            throw new Error("Get sandbox failed: unexpected response shape");
+        }
+        return this.mapSandboxInfo(ok);
+    }
+    async listSandboxes(params = {}) {
+        const query = {};
+        if (params.states?.length)
+            query.state = params.states;
+        if (params.metadata && Object.keys(params.metadata).length) {
+            query.metadata = encodeMetadataFilter(params.metadata);
+        }
+        if (params.page != null)
+            query.page = params.page;
+        if (params.pageSize != null)
+            query.pageSize = params.pageSize;
+        const { data, error, response } = await this.client.GET("/sandboxes", {
+            params: { query },
+        });
+        throwOnOpenApiFetchError({ error, response }, "List sandboxes failed");
+        const raw = data;
+        if (!raw || typeof raw !== "object") {
+            throw new Error("List sandboxes failed: unexpected response shape");
+        }
+        const itemsRaw = raw.items;
+        if (!Array.isArray(itemsRaw))
+            throw new Error("List sandboxes failed: unexpected items shape");
+        return {
+            ...(raw ?? {}),
+            items: itemsRaw.map((x) => this.mapSandboxInfo(x)),
+        };
+    }
+    async deleteSandbox(sandboxId) {
+        const { error, response } = await this.client.DELETE("/sandboxes/{sandboxId}", {
+            params: { path: { sandboxId } },
+        });
+        throwOnOpenApiFetchError({ error, response }, "Delete sandbox failed");
+    }
+    async pauseSandbox(sandboxId) {
+        const { error, response } = await this.client.POST("/sandboxes/{sandboxId}/pause", {
+            params: { path: { sandboxId } },
+        });
+        throwOnOpenApiFetchError({ error, response }, "Pause sandbox failed");
+    }
+    async resumeSandbox(sandboxId) {
+        const { error, response } = await this.client.POST("/sandboxes/{sandboxId}/resume", {
+            params: { path: { sandboxId } },
+        });
+        throwOnOpenApiFetchError({ error, response }, "Resume sandbox failed");
+    }
+    async renewSandboxExpiration(sandboxId, req) {
+        const body = req;
+        const { data, error, response } = await this.client.POST("/sandboxes/{sandboxId}/renew-expiration", {
+            params: { path: { sandboxId } },
+            body,
+        });
+        throwOnOpenApiFetchError({ error, response }, "Renew sandbox expiration failed");
+        const raw = data;
+        if (!raw || typeof raw !== "object") {
+            throw new Error("Renew sandbox expiration failed: unexpected response shape");
+        }
+        return {
+            ...(raw ?? {}),
+            expiresAt: raw?.expiresAt ? this.parseIsoDate("expiresAt", raw.expiresAt) : undefined,
+        };
+    }
+    async getSandboxEndpoint(sandboxId, port) {
+        const { data, error, response } = await this.client.GET("/sandboxes/{sandboxId}/endpoints/{port}", {
+            params: { path: { sandboxId, port } },
+        });
+        throwOnOpenApiFetchError({ error, response }, "Get sandbox endpoint failed");
+        const ok = data;
+        if (!ok || typeof ok !== "object") {
+            throw new Error("Get sandbox endpoint failed: unexpected response shape");
+        }
+        return ok;
+    }
+}

package/dist/adapters/sse.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Parses an SSE-like stream that may be either:
+ * - standard SSE frames (`data: {...}\n\n`)
+ * - newline-delimited JSON (one JSON object per line)
+ */
+export declare function parseJsonEventStream<T>(res: Response, opts?: {
+    fallbackErrorMessage?: string;
+}): AsyncIterable<T>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/adapters/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/adapters/sse.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,wBAAuB,oBAAoB,CAAC,CAAC,EAC3C,GAAG,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,aAAa,CAAC,CAAC,CAAC,CA2DlB"}

package/dist/adapters/sse.js

@@ -0,0 +1,84 @@
+// Copyright 2026 Alibaba Group Holding Ltd.
+// 
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// 
+//     http://www.apache.org/licenses/LICENSE-2.0
+// 
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { SandboxApiException, SandboxError } from "../core/exceptions.js";
+function tryParseJson(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parses an SSE-like stream that may be either:
+ * - standard SSE frames (`data: {...}\n\n`)
+ * - newline-delimited JSON (one JSON object per line)
+ */
+export async function* parseJsonEventStream(res, opts) {
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        const parsed = tryParseJson(text);
+        const err = parsed && typeof parsed === "object" ? parsed : undefined;
+        const requestId = res.headers.get("x-request-id") ?? undefined;
+        const message = err?.message ?? opts?.fallbackErrorMessage ?? `Stream request failed (status=${res.status})`;
+        const code = err?.code ? String(err.code) : SandboxError.UNEXPECTED_RESPONSE;
+        throw new SandboxApiException({
+            message,
+            statusCode: res.status,
+            requestId,
+            error: new SandboxError(code, err?.message ? String(err.message) : message),
+            rawBody: parsed ?? text,
+        });
+    }
+    if (!res.body) {
+        return;
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder("utf-8");
+    let buf = "";
+    while (true) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        buf += decoder.decode(value, { stream: true });
+        let idx;
+        while ((idx = buf.indexOf("\n")) >= 0) {
+            const rawLine = buf.slice(0, idx);
+            buf = buf.slice(idx + 1);
+            const line = rawLine.trim();
+            if (!line)
+                continue;
+            // Support standard SSE "data:" prefix
+            if (line.startsWith(":"))
+                continue;
+            if (line.startsWith("event:") || line.startsWith("id:") || line.startsWith("retry:"))
+                continue;
+            const jsonLine = line.startsWith("data:") ? line.slice("data:".length).trim() : line;
+            if (!jsonLine)
+                continue;
+            const parsed = tryParseJson(jsonLine);
+            if (!parsed)
+                continue;
+            yield parsed;
+        }
+    }
+    // flush last line if exists
+    const last = buf.trim();
+    if (last) {
+        const jsonLine = last.startsWith("data:") ? last.slice("data:".length).trim() : last;
+        const parsed = tryParseJson(jsonLine);
+        if (parsed)
+            yield parsed;
+    }
+}