@castari/sdk 0.1.2 → 0.1.3

package/dist/client.d.ts

@@ -24,6 +24,12 @@ export interface ClientOptions extends Partial<QueryConfig> {
     platformUrl?: string;
     /** Optional sessionId to resume */
     resume?: string;
+    /**
+     * Use the platform API as a WebSocket proxy instead of connecting directly to the sandbox.
+     * Useful when your network blocks the sandbox preview domains.
+     * Defaults to false.
+     */
+    useProxy?: boolean;
 }
 export declare class CastariClient {
     private ws?;

package/dist/client.js

@@ -150,11 +150,30 @@ export class CastariClient {
             const errorText = await response.text();
             throw new Error(`Failed to start sandbox: ${errorText}`);
         }
-        const { id, url, authHeaders, authParams } = await response.json();
+        const { id, url, proxyUrl, authHeaders, authParams } = await response.json();
         this.sandboxId = id;
+        const useProxy = this.options.useProxy ?? (process.env.CASTARI_USE_PROXY === 'true');
         if (this.options.debug) {
             console.log(`✅ Sandbox started: ${id} at ${url}`);
+            if (useProxy && proxyUrl) {
+                console.log(`🔀 Using proxy mode via ${proxyUrl}`);
+            }
+        }
+        // If proxy mode is enabled and we have a proxy URL, use it
+        if (useProxy && proxyUrl) {
+            // Proxy mode: connect through platform API
+            const proxyConfigUrl = `${platformUrl}/proxy/${id}/config`;
+            const proxyWsUrl = proxyUrl;
+            return {
+                configUrl: proxyConfigUrl,
+                wsUrl: proxyWsUrl,
+                // No auth headers/params needed - proxy handles sandbox auth
+                cleanup: async () => {
+                    await this.stop({ delete: true });
+                }
+            };
         }
+        // Direct mode: connect to sandbox directly
         const baseUrl = url.replace(/\/$/, '');
         const configUrl = `${baseUrl.replace('ws://', 'http://').replace('wss://', 'https://')}/config`;
         const wsUrlBase = `${baseUrl.replace('https://', 'wss://').replace('http://', 'ws://')}/ws`;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@castari/sdk",
-    "version": "0.1.2",
+    "version": "0.1.3",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",