@verycloud/cli 0.1.0

package/dist/commands/apps.d.ts

@@ -0,0 +1 @@
+export declare function appsCommand(): Promise<void>;

package/dist/commands/apps.js

@@ -0,0 +1,71 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appsCommand = appsCommand;
+const config_js_1 = require("../lib/config.js");
+const api_js_1 = require("../lib/api.js");
+const logger = __importStar(require("../lib/logger.js"));
+async function appsCommand() {
+    const config = (0, config_js_1.loadConfig)();
+    if (!config) {
+        logger.error("Not logged in. Run 'vc login' first.");
+        process.exit(1);
+    }
+    try {
+        const apps = await (0, api_js_1.apiRequest)("/api/apps");
+        if (!apps || apps.length === 0) {
+            logger.info("No apps found. Deploy one with 'vc deploy'");
+            return;
+        }
+        console.log();
+        console.log(`  ${logger.bold("NAME".padEnd(25))} ${logger.bold("STATUS".padEnd(12))} ${logger.bold("FRAMEWORK".padEnd(12))} ${logger.bold("DOMAIN")}`);
+        console.log(`  ${"─".repeat(75)}`);
+        for (const app of apps) {
+            const statusDisplay = app.status === "running"
+                ? logger.green(app.status)
+                : app.status === "building"
+                    ? logger.yellow(app.status)
+                    : app.status;
+            console.log(`  ${app.name.padEnd(25)} ${statusDisplay.padEnd(
+            // Account for ANSI escape codes in padding
+            12 + (statusDisplay.length - app.status.length))} ${app.framework.padEnd(12)} ${app.domain}`);
+        }
+        console.log();
+    }
+    catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/commands/deploy.d.ts

@@ -0,0 +1,4 @@
+export declare function deployCommand(options: {
+    yes?: boolean;
+    name?: string;
+}): Promise<void>;

package/dist/commands/deploy.js

@@ -0,0 +1,129 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deployCommand = deployCommand;
+const readline = __importStar(require("node:readline"));
+const config_js_1 = require("../lib/config.js");
+const api_js_1 = require("../lib/api.js");
+const detector_js_1 = require("../lib/detector.js");
+const deploy_js_1 = require("../lib/deploy.js");
+const logger = __importStar(require("../lib/logger.js"));
+function confirm(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() !== "n");
+        });
+    });
+}
+async function deployCommand(options) {
+    const config = (0, config_js_1.loadConfig)();
+    if (!config) {
+        logger.error("Not logged in. Run 'vc login' first.");
+        process.exit(1);
+    }
+    // Detect project
+    const project = (0, detector_js_1.detectProject)();
+    if (!project.gitURL) {
+        logger.error("No git remote found. Initialize a git repo with a remote first.");
+        process.exit(1);
+    }
+    const appName = options.name || project.name;
+    // Show summary
+    const summary = {
+        App: appName,
+        Git: project.gitURL.replace(/https?:\/\//, ""),
+        Branch: project.gitBranch,
+        Framework: project.framework,
+    };
+    if (project.database) {
+        summary["Database"] = `${project.database.type} (auto-detected)`;
+    }
+    console.log();
+    logger.box(summary);
+    console.log();
+    // Confirm
+    if (!options.yes) {
+        const ok = await confirm("Deploy? (Y/n) ");
+        if (!ok) {
+            logger.info("Cancelled.");
+            return;
+        }
+    }
+    const spin = logger.spinner("Deploying...");
+    try {
+        const body = {
+            name: appName,
+            git_url: project.gitURL,
+            git_branch: project.gitBranch,
+            framework: project.framework,
+        };
+        if (project.database) {
+            body.database = project.database;
+        }
+        const result = await (0, api_js_1.apiRequest)("/api/deploy/oneshot", {
+            method: "POST",
+            body,
+        });
+        // Poll deployment status
+        const appId = result.app.id;
+        const depId = result.deployment.id;
+        const status = await (0, deploy_js_1.waitForDeployment)(appId, depId);
+        spin.stop();
+        if (status === "running") {
+            console.log();
+            logger.success(`Deployed! ${logger.cyan(result.url)}`);
+            if (result.service) {
+                logger.info(`Database: ${result.service.type} (${result.service.name})`);
+            }
+            if (result.database_url) {
+                logger.dim(`DATABASE_URL set automatically`);
+            }
+        }
+        else {
+            logger.error("Deployment failed. Check logs with 'vc logs " + appName + "'");
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        spin.stop();
+        logger.error(`Deploy failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/commands/login.d.ts

@@ -0,0 +1,4 @@
+export declare function loginCommand(options: {
+    server?: string;
+    github?: boolean;
+}): Promise<void>;

package/dist/commands/login.js

@@ -0,0 +1,168 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loginCommand = loginCommand;
+const http = __importStar(require("node:http"));
+const url = __importStar(require("node:url"));
+const node_child_process_1 = require("node:child_process");
+const config_js_1 = require("../lib/config.js");
+const logger = __importStar(require("../lib/logger.js"));
+function openBrowser(url) {
+    const platform = process.platform;
+    const cmd = platform === "darwin"
+        ? "open"
+        : platform === "win32"
+            ? "start"
+            : "xdg-open";
+    (0, node_child_process_1.exec)(`${cmd} "${url}"`);
+}
+function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = http.createServer();
+        server.listen(0, () => {
+            const addr = server.address();
+            if (addr && typeof addr === "object") {
+                const port = addr.port;
+                server.close(() => resolve(port));
+            }
+            else {
+                reject(new Error("Failed to find free port"));
+            }
+        });
+    });
+}
+async function loginCommand(options) {
+    const serverURL = (options.server || config_js_1.DEFAULT_SERVER_URL).replace(/\/+$/, "");
+    const provider = options.github ? "github" : "google";
+    const port = await findFreePort();
+    const spin = logger.spinner("Waiting for browser authentication...");
+    // Start temporary HTTP server to receive OAuth callback
+    const tokenPromise = new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            server.close();
+            reject(new Error("Authentication timed out (30s)"));
+        }, 30000);
+        const server = http.createServer((req, res) => {
+            const parsed = url.parse(req.url || "", true);
+            if (parsed.pathname === "/callback") {
+                const accessToken = parsed.query.access_token;
+                const refreshToken = parsed.query.refresh_token;
+                if (accessToken && refreshToken) {
+                    res.writeHead(200, { "Content-Type": "text/html" });
+                    res.end(`
+              <html>
+                <body style="font-family: system-ui, sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #0a0a0a; color: #fafafa;">
+                  <div style="text-align: center;">
+                    <h2>Authentication Successful</h2>
+                    <p>You can close this window and return to the terminal.</p>
+                  </div>
+                </body>
+              </html>
+            `);
+                    clearTimeout(timeout);
+                    server.close();
+                    resolve({ access_token: accessToken, refresh_token: refreshToken });
+                }
+                else {
+                    res.writeHead(400, { "Content-Type": "text/html" });
+                    res.end(`
+              <html>
+                <body style="font-family: system-ui, sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #0a0a0a; color: #fafafa;">
+                  <div style="text-align: center;">
+                    <h2>Authentication Failed</h2>
+                    <p>Missing tokens. Please try again.</p>
+                  </div>
+                </body>
+              </html>
+            `);
+                    clearTimeout(timeout);
+                    server.close();
+                    reject(new Error("Missing tokens in callback"));
+                }
+            }
+            else {
+                res.writeHead(404);
+                res.end("Not Found");
+            }
+        });
+        server.listen(port, () => {
+            const authURL = `${serverURL}/api/auth/${provider}?cli_port=${port}`;
+            logger.info(`Opening browser for ${provider} login...`);
+            openBrowser(authURL);
+        });
+    });
+    try {
+        const tokens = await tokenPromise;
+        // Create API key using the access token
+        const keyResp = await fetch(`${serverURL}/api/settings/api-keys`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${tokens.access_token}`,
+            },
+            body: JSON.stringify({ name: "CLI Key" }),
+        });
+        if (!keyResp.ok) {
+            throw new Error("Failed to create API key");
+        }
+        const keyData = (await keyResp.json());
+        const apiKey = keyData.data.key;
+        // Get user email
+        const meResp = await fetch(`${serverURL}/api/auth/me`, {
+            headers: { Authorization: `Bearer ${tokens.access_token}` },
+        });
+        const meData = (await meResp.json());
+        const userEmail = meData.data.email;
+        // Save config
+        (0, config_js_1.saveConfig)({
+            server_url: serverURL,
+            api_key: apiKey,
+            user_email: userEmail,
+        });
+        spin.stop();
+        logger.success(`Logged in as ${logger.bold(userEmail)}`);
+        // Register MCP server
+        const mcpRegistered = (0, config_js_1.registerMCP)();
+        if (mcpRegistered) {
+            logger.success("Claude Code MCP server registered");
+            logger.dim('Claude Code를 재시작하면 "배포해줘"로 바로 배포할 수 있습니다.');
+        }
+    }
+    catch (err) {
+        spin.stop();
+        logger.error(`Login failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/commands/logs.d.ts

@@ -0,0 +1 @@
+export declare function logsCommand(appName?: string): Promise<void>;

package/dist/commands/logs.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logsCommand = logsCommand;
+const config_js_1 = require("../lib/config.js");
+const api_js_1 = require("../lib/api.js");
+const app_js_1 = require("../lib/app.js");
+const logger = __importStar(require("../lib/logger.js"));
+async function logsCommand(appName) {
+    const config = (0, config_js_1.loadConfig)();
+    if (!config) {
+        logger.error("Not logged in. Run 'vc login' first.");
+        process.exit(1);
+    }
+    try {
+        const app = await (0, app_js_1.getAppByName)(appName);
+        if (!app) {
+            logger.error(`App '${appName || "current directory"}' not found`);
+            process.exit(1);
+        }
+        // Get latest deployment
+        const deployments = await (0, api_js_1.apiRequest)(`/api/apps/${app.id}/deployments`);
+        if (!deployments || deployments.length === 0) {
+            logger.info("No deployments found");
+            return;
+        }
+        const latest = deployments[0];
+        // Get build log
+        const logData = await (0, api_js_1.apiRequest)(`/api/apps/${app.id}/deployments/${latest.id}/log`);
+        logger.info(`Deployment v${latest.version} (${latest.status})`);
+        console.log();
+        if (logData.log) {
+            console.log(logData.log);
+        }
+        else {
+            logger.dim("No logs available yet");
+        }
+    }
+    catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/commands/status.d.ts

@@ -0,0 +1 @@
+export declare function statusCommand(appName?: string): Promise<void>;

package/dist/commands/status.js

@@ -0,0 +1,72 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusCommand = statusCommand;
+const config_js_1 = require("../lib/config.js");
+const app_js_1 = require("../lib/app.js");
+const logger = __importStar(require("../lib/logger.js"));
+async function statusCommand(appName) {
+    const config = (0, config_js_1.loadConfig)();
+    if (!config) {
+        logger.error("Not logged in. Run 'vc login' first.");
+        process.exit(1);
+    }
+    try {
+        const app = await (0, app_js_1.getAppByName)(appName);
+        if (!app) {
+            logger.error(`App '${appName || "current directory"}' not found`);
+            process.exit(1);
+        }
+        const statusIcon = app.status === "running"
+            ? logger.green("● running")
+            : app.status === "building"
+                ? logger.yellow("◐ building")
+                : "○ " + app.status;
+        console.log();
+        logger.box({
+            App: app.name,
+            Status: statusIcon,
+            Framework: app.framework,
+            Domain: app.domain,
+            Git: app.git_url?.replace(/https?:\/\//, "") || "(none)",
+            Branch: app.git_branch,
+        });
+        console.log();
+    }
+    catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const login_js_1 = require("./commands/login.js");
+const deploy_js_1 = require("./commands/deploy.js");
+const status_js_1 = require("./commands/status.js");
+const logs_js_1 = require("./commands/logs.js");
+const apps_js_1 = require("./commands/apps.js");
+const server_js_1 = require("./mcp/server.js");
+const program = new commander_1.Command();
+program
+    .name("vc")
+    .description("VeryCloud CLI - Deploy apps with one command")
+    .version("0.1.0");
+program
+    .command("login")
+    .description("Log in to VeryCloud via browser OAuth")
+    .option("-s, --server <url>", "Custom server URL (for development)")
+    .option("-g, --github", "Use GitHub instead of Google for login")
+    .action(login_js_1.loginCommand);
+program
+    .command("deploy")
+    .description("Deploy current project to VeryCloud")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .option("-n, --name <name>", "App name (default: directory name)")
+    .action(deploy_js_1.deployCommand);
+program
+    .command("status [app-name]")
+    .description("Show app status")
+    .action(status_js_1.statusCommand);
+program
+    .command("logs [app-name]")
+    .description("Show deployment logs")
+    .action(logs_js_1.logsCommand);
+program
+    .command("apps")
+    .description("List all apps")
+    .action(apps_js_1.appsCommand);
+program
+    .command("mcp")
+    .description("Start MCP server (stdio) for AI tool integration")
+    .action(() => {
+    (0, server_js_1.startMCPServer)();
+});
+program.parse();

package/dist/lib/api.d.ts

@@ -0,0 +1,8 @@
+interface RequestOptions {
+    method?: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+    token?: string;
+}
+export declare function apiRequest<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+export {};

package/dist/lib/api.js

@@ -0,0 +1,74 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiRequest = apiRequest;
+const config_js_1 = require("./config.js");
+const logger = __importStar(require("./logger.js"));
+async function apiRequest(path, options = {}) {
+    const config = (0, config_js_1.loadConfig)();
+    if (!config && !options.token) {
+        logger.error("Not logged in. Run 'vc login' first.");
+        process.exit(1);
+    }
+    const serverURL = config?.server_url || "";
+    const url = `${serverURL}${path}`;
+    const headers = {
+        "Content-Type": "application/json",
+        ...options.headers,
+    };
+    if (options.token) {
+        headers["Authorization"] = `Bearer ${options.token}`;
+    }
+    else if (config?.api_key) {
+        headers["X-API-Key"] = config.api_key;
+    }
+    const fetchOptions = {
+        method: options.method || "GET",
+        headers,
+    };
+    if (options.body) {
+        fetchOptions.body = JSON.stringify(options.body);
+    }
+    const resp = await fetch(url, fetchOptions);
+    if (resp.status === 204) {
+        return undefined;
+    }
+    const json = (await resp.json());
+    if (!resp.ok || json.error) {
+        const msg = json.error?.message || `HTTP ${resp.status}`;
+        throw new Error(msg);
+    }
+    return json.data;
+}