@aerol-ai/aerolvm-sdk 0.1.4 → 0.1.6

package/dist/internal/client.d.ts

@@ -32,6 +32,19 @@ export declare class APIClient {
     uploadFile(id: string, targetPath: string, data: BinaryLike): Promise<void>;
     downloadFile(id: string, targetPath: string): Promise<Uint8Array>;
     exposePort(id: string, port: number): Promise<string>;
+    /**
+     * Publish a raw TCP port through caddy-l4. The returned URL is in
+     * `tcp://<host>:<port>` form and works directly with `psql`, `redis-cli`,
+     * `mysql`, `mongosh`, and any other native-protocol client.
+     */
+    exposeTCPPort(id: string, port: number): Promise<string>;
+    /**
+     * Publish a TCP port behind the shared TLS-SNI multiplexer. Returns
+     * `tls://<id>-<port>.<domain>:<l4-port>`. Requires the daemon to have a
+     * domain configured AND `SB_L4_TLS_LISTEN` set.
+     */
+    exposeTLSPort(id: string, port: number): Promise<string>;
+    private exposePortWithProtocol;
     unexposePort(id: string, port: number): Promise<void>;
     reconcile(): Promise<void>;
     health(): Promise<HealthStatus>;
@@ -82,6 +95,8 @@ export declare class SandboxResource implements Sandbox {
     uploadFile(targetPath: string, data: BinaryLike): Promise<void>;
     downloadFile(targetPath: string): Promise<Uint8Array>;
     exposePort(port: number): Promise<string>;
+    exposeTCPPort(port: number): Promise<string>;
+    exposeTLSPort(port: number): Promise<string>;
     unexposePort(port: number): Promise<void>;
     start(): Promise<this>;
     stop(): Promise<this>;

package/dist/internal/client.js

@@ -93,7 +93,27 @@ export class APIClient {
         return new Uint8Array(await response.arrayBuffer());
     }
     async exposePort(id, port) {
-        const response = await this.doJSON("POST", `/v1/sandboxes/${id}/ports/${port}`);
+        return this.exposePortWithProtocol(id, port);
+    }
+    /**
+     * Publish a raw TCP port through caddy-l4. The returned URL is in
+     * `tcp://<host>:<port>` form and works directly with `psql`, `redis-cli`,
+     * `mysql`, `mongosh`, and any other native-protocol client.
+     */
+    async exposeTCPPort(id, port) {
+        return this.exposePortWithProtocol(id, port, "tcp");
+    }
+    /**
+     * Publish a TCP port behind the shared TLS-SNI multiplexer. Returns
+     * `tls://<id>-<port>.<domain>:<l4-port>`. Requires the daemon to have a
+     * domain configured AND `SB_L4_TLS_LISTEN` set.
+     */
+    async exposeTLSPort(id, port) {
+        return this.exposePortWithProtocol(id, port, "tls");
+    }
+    async exposePortWithProtocol(id, port, protocol) {
+        const body = protocol ? { protocol } : undefined;
+        const response = await this.doJSON("POST", `/v1/sandboxes/${id}/ports/${port}`, body);
         return response.public_url;
     }
     async unexposePort(id, port) {
@@ -202,6 +222,12 @@ export class SandboxResource {
     async exposePort(port) {
         return this.client.exposePort(this.id, port);
     }
+    async exposeTCPPort(port) {
+        return this.client.exposeTCPPort(this.id, port);
+    }
+    async exposeTLSPort(port) {
+        return this.client.exposeTLSPort(this.id, port);
+    }
     async unexposePort(port) {
         await this.client.unexposePort(this.id, port);
     }
@@ -471,6 +497,12 @@ function describeWSClose(event) {
         parts.push(`wasClean=${e.wasClean}`);
     return parts.join(" ");
 }
+function toWebSocketBinaryFrame(data) {
+    const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
+    const frame = new Uint8Array(bytes.byteLength);
+    frame.set(bytes);
+    return frame;
+}
 function openExecStream(baseURL, patToken, sandboxID, options) {
     const wsURL = baseURL.replace(/^http/, "ws") + `/v1/sandboxes/${encodeURIComponent(sandboxID)}/toolbox/process/exec/stream`;
     const WS = globalThis.WebSocket;
@@ -561,8 +593,7 @@ function openExecStream(baseURL, patToken, sandboxID, options) {
         failWith(detail !== "" ? `websocket error: ${detail}` : "websocket error");
     });
     const sendBinary = (data) => {
-        const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
-        ws.send(bytes);
+        ws.send(toWebSocketBinaryFrame(data));
     };
     return {
         write: sendBinary,
@@ -661,8 +692,7 @@ function openSessionAttach(baseURL, patToken, sandboxID, sessionID, options) {
         failWith(detail !== "" ? `websocket error: ${detail}` : "websocket error");
     });
     const sendBinary = (data) => {
-        const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
-        ws.send(bytes);
+        ws.send(toWebSocketBinaryFrame(data));
     };
     return {
         write: sendBinary,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aerol-ai/aerolvm-sdk",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -20,8 +20,8 @@
     "test": "tsc -p tsconfig.test.json --outDir dist-test && node --test dist-test/*.test.js"
   },
   "devDependencies": {
-    "@types/node": "^22.15.17",
-    "typescript": "^5.8.3",
+    "@types/node": "^25.6.2",
+    "typescript": "^6.0.3",
     "tsx": "^4.21.0"
   }
 }