@sandbank.dev/boxlite 0.1.1 → 0.3.0

package/dist/client.js

@@ -1,21 +1,21 @@
-export function createBoxLiteClient(config) {
+/**
+ * Create a BoxLite REST client for communicating with a BoxRun REST API.
+ * Used in remote mode.
+ */
+export function createBoxLiteRestClient(config) {
     const { apiUrl } = config;
-    const prefix = config.prefix ?? 'default';
+    const prefix = config.prefix ?? '';
     const baseUrl = apiUrl.replace(/\/$/, '') + '/v1';
     // --- Token management ---
     let token = config.apiToken ?? '';
     let tokenExpiresAt = 0;
     async function ensureToken() {
-        // If a static token was provided, always use it
         if (config.apiToken)
             return config.apiToken;
-        // If we have a valid cached token, use it
+        if (!config.clientId || !config.clientSecret)
+            return '';
         if (token && Date.now() < tokenExpiresAt)
             return token;
-        // Acquire token via OAuth2 client credentials
-        if (!config.clientId || !config.clientSecret) {
-            throw new Error('BoxLite: either apiToken or clientId+clientSecret must be provided');
-        }
         const response = await fetch(`${baseUrl}/oauth/tokens`, {
             method: 'POST',
             headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
@@ -31,21 +31,20 @@ export function createBoxLiteClient(config) {
         }
         const data = await response.json();
         token = data.access_token;
-        // Refresh 60s before expiry
         tokenExpiresAt = Date.now() + (data.expires_in - 60) * 1000;
         return token;
     }
     async function request(path, options = {}, rawResponse = false) {
         const bearerToken = await ensureToken();
-        const url = `${baseUrl}/${prefix}${path}`;
-        const response = await fetch(url, {
-            ...options,
-            headers: {
-                'Authorization': `Bearer ${bearerToken}`,
-                'Content-Type': 'application/json',
-                ...options.headers,
-            },
-        });
+        const url = prefix ? `${baseUrl}/${prefix}${path}` : `${baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            ...options.headers,
+        };
+        if (bearerToken) {
+            headers['Authorization'] = `Bearer ${bearerToken}`;
+        }
+        const response = await fetch(url, { ...options, headers });
         if (rawResponse)
             return response;
         if (!response.ok) {
@@ -57,57 +56,7 @@ export function createBoxLiteClient(config) {
             return {};
         return JSON.parse(text);
     }
-    /**
-     * Parse SSE data field — may be JSON `{"data":"<base64>"}` or raw base64.
-     */
-    function decodeSSEData(raw) {
-        try {
-            const parsed = JSON.parse(raw);
-            if (parsed.data)
-                return atob(parsed.data);
-        }
-        catch {
-            // Fall through to raw base64
-        }
-        return atob(raw);
-    }
-    /**
-     * Consume an SSE stream from BoxLite exec output.
-     * SSE events: stdout/stderr data is base64-encoded, exit event has exit_code.
-     */
-    function parseSSE(text) {
-        let stdout = '';
-        let stderr = '';
-        let exitCode = 0;
-        const lines = text.split('\n');
-        let currentEvent = '';
-        for (const line of lines) {
-            if (line.startsWith('event:')) {
-                currentEvent = line.slice(6).trim();
-            }
-            else if (line.startsWith('data:')) {
-                const data = line.slice(5).trim();
-                if (currentEvent === 'stdout') {
-                    stdout += decodeSSEData(data);
-                }
-                else if (currentEvent === 'stderr') {
-                    stderr += decodeSSEData(data);
-                }
-                else if (currentEvent === 'exit') {
-                    try {
-                        const parsed = JSON.parse(data);
-                        exitCode = parsed.exit_code;
-                    }
-                    catch {
-                        exitCode = parseInt(data, 10) || 0;
-                    }
-                }
-            }
-        }
-        return { stdout, stderr, exitCode };
-    }
     return {
-        // --- Box lifecycle ---
         async createBox(params) {
             return request('/boxes', {
                 method: 'POST',
@@ -125,6 +74,8 @@ export function createBoxLiteClient(config) {
                 params.set('page_size', String(pageSize));
             const qs = params.toString();
             const data = await request(`/boxes${qs ? `?${qs}` : ''}`);
+            if (Array.isArray(data))
+                return data;
             return data.boxes ?? [];
         },
         async deleteBox(boxId, force = false) {
@@ -138,84 +89,81 @@ export function createBoxLiteClient(config) {
         async stopBox(boxId) {
             await request(`/boxes/${boxId}/stop`, { method: 'POST' });
         },
-        // --- Exec ---
         async exec(boxId, req) {
-            // 1. POST /exec to start execution
             const execution = await request(`/boxes/${boxId}/exec`, {
                 method: 'POST',
                 body: JSON.stringify(req),
             });
-            // 2. GET /executions/{id}/output — SSE stream
-            const response = await request(`/boxes/${boxId}/executions/${execution.execution_id}/output`, { headers: { 'Accept': 'text/event-stream' } }, true);
-            if (!response.ok) {
-                const body = await response.text();
-                throw new Error(`BoxLite API error ${response.status}: ${body}`);
+            if (execution.exit_code !== null && execution.exit_code !== undefined) {
+                return {
+                    stdout: execution.stdout ?? '',
+                    stderr: execution.stderr ?? '',
+                    exitCode: execution.exit_code,
+                };
+            }
+            const timeoutMs = (req.timeout_seconds ?? 300) * 1000;
+            const startTime = Date.now();
+            let pollInterval = 100;
+            while (Date.now() - startTime < timeoutMs) {
+                await new Promise(r => setTimeout(r, pollInterval));
+                pollInterval = Math.min(pollInterval * 2, 2000);
+                const result = await request(`/boxes/${boxId}/executions/${execution.id}`);
+                if (result.exit_code !== null && result.exit_code !== undefined) {
+                    return {
+                        stdout: result.stdout ?? '',
+                        stderr: result.stderr ?? '',
+                        exitCode: result.exit_code,
+                    };
+                }
             }
-            const sseText = await response.text();
-            return parseSSE(sseText);
+            throw new Error('BoxLite exec timed out waiting for completion');
         },
         async execStream(boxId, req) {
-            // 1. POST /exec to start execution
             const execution = await request(`/boxes/${boxId}/exec`, {
                 method: 'POST',
                 body: JSON.stringify(req),
             });
-            // 2. GET /executions/{id}/output — return raw SSE stream
-            const response = await request(`/boxes/${boxId}/executions/${execution.execution_id}/output`, { headers: { 'Accept': 'text/event-stream' } }, true);
-            if (!response.ok) {
-                const body = await response.text();
-                throw new Error(`BoxLite API error ${response.status}: ${body}`);
-            }
-            if (!response.body) {
-                throw new Error('BoxLite exec stream: no response body');
-            }
-            // Transform SSE events into decoded data chunks
-            const decoder = new TextDecoder();
-            let buffer = '';
-            return response.body.pipeThrough(new TransformStream({
-                transform(chunk, controller) {
-                    buffer += decoder.decode(chunk, { stream: true });
-                    const lines = buffer.split('\n');
-                    buffer = lines.pop() ?? '';
-                    let currentEvent = '';
-                    for (const line of lines) {
-                        if (line.startsWith('event:')) {
-                            currentEvent = line.slice(6).trim();
-                        }
-                        else if (line.startsWith('data:')) {
-                            const data = line.slice(5).trim();
-                            if (currentEvent === 'stdout' || currentEvent === 'stderr') {
-                                const decoded = decodeSSEData(data);
-                                controller.enqueue(new TextEncoder().encode(decoded));
-                            }
-                        }
+            const encoder = new TextEncoder();
+            const self = { request };
+            return new ReadableStream({
+                async start(controller) {
+                    if (execution.exit_code !== null && execution.exit_code !== undefined) {
+                        if (execution.stdout)
+                            controller.enqueue(encoder.encode(execution.stdout));
+                        if (execution.stderr)
+                            controller.enqueue(encoder.encode(execution.stderr));
+                        controller.close();
+                        return;
                     }
-                },
-                flush(controller) {
-                    if (buffer) {
-                        const lines = buffer.split('\n');
-                        let currentEvent = '';
-                        for (const line of lines) {
-                            if (line.startsWith('event:')) {
-                                currentEvent = line.slice(6).trim();
-                            }
-                            else if (line.startsWith('data:')) {
-                                const data = line.slice(5).trim();
-                                if (currentEvent === 'stdout' || currentEvent === 'stderr') {
-                                    const decoded = decodeSSEData(data);
-                                    controller.enqueue(new TextEncoder().encode(decoded));
-                                }
+                    const timeoutMs = (req.timeout_seconds ?? 300) * 1000;
+                    const startTime = Date.now();
+                    let pollInterval = 100;
+                    while (Date.now() - startTime < timeoutMs) {
+                        await new Promise(r => setTimeout(r, pollInterval));
+                        pollInterval = Math.min(pollInterval * 2, 2000);
+                        try {
+                            const result = await self.request(`/boxes/${boxId}/executions/${execution.id}`);
+                            if (result.exit_code !== null && result.exit_code !== undefined) {
+                                if (result.stdout)
+                                    controller.enqueue(encoder.encode(result.stdout));
+                                if (result.stderr)
+                                    controller.enqueue(encoder.encode(result.stderr));
+                                controller.close();
+                                return;
                             }
                         }
+                        catch (err) {
+                            controller.error(err);
+                            return;
+                        }
                     }
-                    controller.terminate();
+                    controller.error(new Error('BoxLite exec stream timed out'));
                 },
-            }));
+            });
         },
-        // --- Files (native tar API) ---
         async uploadFiles(boxId, path, tarData) {
             const bearerToken = await ensureToken();
-            const url = `${baseUrl}/${prefix}/boxes/${boxId}/files?path=${encodeURIComponent(path)}`;
+            const url = `${baseUrl}${prefix ? `/${prefix}` : ''}/boxes/${boxId}/files?path=${encodeURIComponent(path)}`;
             const response = await fetch(url, {
                 method: 'PUT',
                 headers: {
@@ -231,7 +179,7 @@ export function createBoxLiteClient(config) {
         },
         async downloadFiles(boxId, path) {
             const bearerToken = await ensureToken();
-            const url = `${baseUrl}/${prefix}/boxes/${boxId}/files?path=${encodeURIComponent(path)}`;
+            const url = `${baseUrl}${prefix ? `/${prefix}` : ''}/boxes/${boxId}/files?path=${encodeURIComponent(path)}`;
             const response = await fetch(url, {
                 headers: {
                     'Authorization': `Bearer ${bearerToken}`,
@@ -247,7 +195,6 @@ export function createBoxLiteClient(config) {
             }
             return response.body;
         },
-        // --- Snapshots ---
         async createSnapshot(boxId, name) {
             return request(`/boxes/${boxId}/snapshots`, {
                 method: 'POST',

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { BoxLiteAdapter } from './adapter.js';
-export type { BoxLiteAdapterConfig } from './types.js';
+export type { BoxLiteAdapterConfig, BoxLiteRemoteConfig, BoxLiteLocalConfig, BoxLiteClient, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,2 +1,2 @@
-// @sandbank.dev/boxlite — BoxLite bare-metal sandbox adapter
+// @sandbank.dev/boxlite — BoxLite sandbox adapter (remote REST API + local Python SDK)
 export { BoxLiteAdapter } from './adapter.js';

package/dist/local-client.d.ts

@@ -0,0 +1,7 @@
+import type { BoxLiteClient, BoxLiteLocalConfig } from './types.js';
+/**
+ * Create a BoxLite local client that communicates with the boxlite Python SDK
+ * via a JSON-line subprocess bridge.
+ */
+export declare function createBoxLiteLocalClient(config: BoxLiteLocalConfig): BoxLiteClient;
+//# sourceMappingURL=local-client.d.ts.map

package/dist/local-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-client.d.ts","sourceRoot":"","sources":["../src/local-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,aAAa,EAGb,kBAAkB,EAEnB,MAAM,YAAY,CAAA;AAwRnB;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAgRlF"}