connectbase-client 0.3.0 → 0.3.1

package/README.md

@@ -98,6 +98,8 @@ npx connectbase-client deploy ./dist -s <storage-id> -k <api-key>
 | `--storage <id>` | `-s` | Storage ID |
 | `--api-key <key>` | `-k` | API Key |
 | `--base-url <url>` | `-u` | Custom server URL |
+| `--timeout <sec>` | `-t` | Tunnel request timeout in seconds (tunnel only) |
+| `--max-body <MB>` | | Tunnel max body size in MB (tunnel only) |
 | `--help` | `-h` | Show help |
 | `--version` | `-v` | Show version |
 
@@ -112,11 +114,24 @@ npx connectbase-client tunnel 8084 -k <api-key>
 # With environment variable
 export CONNECTBASE_API_KEY=your-api-key
 npx connectbase-client tunnel 8084
+
+# For GPU servers or long-running tasks (e.g., image generation)
+npx connectbase-client tunnel 7860 --timeout 300 --max-body 50
 ```
 
 The tunnel creates a public URL like `https://tunnel.connectbase.world/<tunnel-id>/` that proxies all HTTP requests to your local service.
 
+**Plan-based limits:** Timeout and body size are clamped to your plan's maximum:
+
+| Plan | Max Timeout | Max Body |
+|------|-------------|----------|
+| Free | 60s | 10MB |
+| Starter | 120s | 25MB |
+| Pro | 300s | 50MB |
+| Business | 600s | 100MB |
+
 Features:
+- Per-tunnel timeout and body size configuration
 - Automatic reconnection with exponential backoff
 - Request/response logging in terminal
 - Graceful shutdown with Ctrl+C

package/dist/cli.js

@@ -470,6 +470,13 @@ function createWsCloseFrame(code) {
   header[1] = 128 | 2;
   return Buffer.concat([header, maskKey, masked]);
 }
+function createWsPongFrame() {
+  const maskKey = crypto.randomBytes(4);
+  const header = Buffer.alloc(2);
+  header[0] = 138;
+  header[1] = 128 | 0;
+  return Buffer.concat([header, maskKey]);
+}
 var WsFrameParser = class {
   constructor(handlers) {
     this.buffer = Buffer.alloc(0);
@@ -539,7 +546,7 @@ function getTunnelServerUrl(baseUrl) {
   }
   return baseUrl.replace(/:\d+/, ":8090");
 }
-async function startTunnel(port, config) {
+async function startTunnel(port, config, tunnelOpts) {
   if (!config.apiKey) {
     error("API Key\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. -k \uC635\uC158 \uB610\uB294 CONNECTBASE_API_KEY \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694");
     process.exit(1);
@@ -547,7 +554,13 @@ async function startTunnel(port, config) {
   const tunnelServerUrl = getTunnelServerUrl(config.baseUrl);
   const parsedUrl = new URL(tunnelServerUrl);
   const isHttps = parsedUrl.protocol === "https:";
-  const wsPath = `/v1/tunnel/connect?api_key=${encodeURIComponent(config.apiKey)}`;
+  let wsPath = `/v1/tunnel/connect?api_key=${encodeURIComponent(config.apiKey)}`;
+  if (tunnelOpts?.timeout) {
+    wsPath += `&timeout=${tunnelOpts.timeout}`;
+  }
+  if (tunnelOpts?.maxBody) {
+    wsPath += `&max_body=${tunnelOpts.maxBody}`;
+  }
   let reconnectAttempts = 0;
   const maxReconnectAttempts = 10;
   let shouldReconnect = true;
@@ -608,8 +621,7 @@ ${colors.cyan}ConnectBase Tunnel${colors.reset}`);
           sock.destroy();
         },
         onPing: () => {
-          const pongMsg = JSON.stringify({ type: "pong" });
-          sock.write(createWsTextFrame(pongMsg));
+          sock.write(createWsPongFrame());
         }
       });
       sock.on("data", (chunk) => parser.feed(chunk));
@@ -673,6 +685,9 @@ ${colors.cyan}ConnectBase Tunnel${colors.reset}`);
         success(`\uD130\uB110 \uD65C\uC131\uD654!`);
         log(`${colors.green}\u2192${colors.reset} URL: ${colors.cyan}${msg.url}${colors.reset}`);
         log(`${colors.green}\u2192${colors.reset} \uB85C\uCEEC: ${colors.cyan}http://localhost:${localPort}${colors.reset}`);
+        if (msg.timeout || msg.max_body) {
+          log(`${colors.green}\u2192${colors.reset} \uC124\uC815: timeout=${colors.cyan}${msg.timeout}s${colors.reset}, max-body=${colors.cyan}${msg.max_body}MB${colors.reset}`);
+        }
         log(`
 ${colors.dim}Ctrl+C\uB85C \uC885\uB8CC${colors.reset}
 `);
@@ -696,14 +711,20 @@ ${colors.dim}Ctrl+C\uB85C \uC885\uB8CC${colors.reset}
     const headers = msg.headers || {};
     const bodyBase64 = msg.body;
     const fullPath = query ? `${reqPath}?${query}` : reqPath;
+    const localHeaders = {};
+    for (const [key, value] of Object.entries(headers)) {
+      if (key.toLowerCase() !== "host") {
+        localHeaders[key] = value;
+      }
+    }
+    localHeaders["host"] = `localhost:${localPort}`;
     const reqOptions = {
       hostname: "127.0.0.1",
       port: localPort,
       path: fullPath,
       method,
-      headers: { ...headers, host: `localhost:${localPort}` }
+      headers: localHeaders
     };
-    delete reqOptions.headers["Host"];
     const localReq = http.request(reqOptions, (res) => {
       const chunks = [];
       res.on("data", (chunk) => chunks.push(chunk));
@@ -768,6 +789,8 @@ ${colors.yellow}\uC635\uC158:${colors.reset}
   -s, --storage <id>    \uC2A4\uD1A0\uB9AC\uC9C0 ID
   -k, --api-key <key>   API Key
   -u, --base-url <url>  \uC11C\uBC84 URL (\uAE30\uBCF8: ${DEFAULT_BASE_URL})
+  -t, --timeout <sec>   \uD130\uB110 \uC694\uCCAD \uD0C0\uC784\uC544\uC6C3 (\uCD08, tunnel \uC804\uC6A9)
+  --max-body <MB>       \uD130\uB110 \uCD5C\uB300 \uBC14\uB514 \uD06C\uAE30 (MB, tunnel \uC804\uC6A9)
   -h, --help            \uB3C4\uC6C0\uB9D0 \uD45C\uC2DC
   -v, --version         \uBC84\uC804 \uD45C\uC2DC
 
@@ -778,6 +801,12 @@ ${colors.yellow}\uBE60\uB978 \uC2DC\uC791:${colors.reset}
   ${colors.dim}# 2. \uBC30\uD3EC${colors.reset}
   npm run deploy
 
+  ${colors.dim}# 3. \uD130\uB110 (\uAE30\uBCF8)${colors.reset}
+  npx connectbase-client tunnel 3000
+
+  ${colors.dim}# 4. \uD130\uB110 (GPU \uC11C\uBC84 \uB4F1 \uAE34 \uC751\uB2F5 \uC2DC)${colors.reset}
+  npx connectbase-client tunnel 7860 --timeout 300 --max-body 50
+
 ${colors.yellow}\uD658\uACBD\uBCC0\uC218:${colors.reset}
   CONNECTBASE_API_KEY       API Key
   CONNECTBASE_STORAGE_ID    \uC2A4\uD1A0\uB9AC\uC9C0 ID
@@ -805,6 +834,10 @@ function parseArgs(args) {
       result.options.apiKey = args[++i];
     } else if (arg === "-u" || arg === "--base-url") {
       result.options.baseUrl = args[++i];
+    } else if (arg === "-t" || arg === "--timeout") {
+      result.options.timeout = args[++i];
+    } else if (arg === "--max-body") {
+      result.options.maxBody = args[++i];
     } else if (arg === "-h" || arg === "--help") {
       result.options.help = "true";
     } else if (arg === "-v" || arg === "--version") {
@@ -860,7 +893,16 @@ async function main() {
       error("\uC720\uD6A8\uD55C \uD3EC\uD2B8 \uBC88\uD638\uB97C \uC785\uB825\uD558\uC138\uC694 (1-65535)");
       process.exit(1);
     }
-    await startTunnel(port, config);
+    const tunnelOpts = {};
+    if (parsed.options.timeout) {
+      const t = parseInt(parsed.options.timeout, 10);
+      if (!isNaN(t) && t > 0) tunnelOpts.timeout = t;
+    }
+    if (parsed.options.maxBody) {
+      const m = parseInt(parsed.options.maxBody, 10);
+      if (!isNaN(m) && m > 0) tunnelOpts.maxBody = m;
+    }
+    await startTunnel(port, config, tunnelOpts);
   } else {
     error(`\uC54C \uC218 \uC5C6\uB294 \uBA85\uB839\uC5B4: ${parsed.command}`);
     showHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "connectbase-client",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",