connectbase-client 0.1.1 → 0.1.3

package/README.md

@@ -51,6 +51,83 @@ const state = await gameClient.createRoom({
 - **Push Notifications**: Cross-platform push notification support
 - **WebRTC**: Real-time audio/video communication
 - **Payments**: Subscription and one-time payment support
+- **CLI**: Command-line tool for deploying web storage
+
+## CLI
+
+Deploy your web application to Connect Base Web Storage with a single command.
+
+### Basic Usage
+
+```bash
+# Deploy a directory
+npx connectbase-client deploy ./dist -s <storage-id> -k <api-key>
+
+# Deploy current directory
+npx connectbase-client deploy . -s <storage-id> -k <api-key>
+```
+
+### Options
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--storage <id>` | `-s` | Storage ID (required) |
+| `--api-key <key>` | `-k` | API Key (required) |
+| `--base-url <url>` | `-u` | Custom server URL |
+| `--help` | `-h` | Show help |
+| `--version` | `-v` | Show version |
+
+### Environment Variables
+
+You can set credentials via environment variables:
+
+```bash
+export CONNECTBASE_API_KEY=your-api-key
+export CONNECTBASE_STORAGE_ID=your-storage-id
+
+# Then deploy without options
+npx connectbase-client deploy ./dist
+```
+
+### Configuration File
+
+Create a `.connectbaserc` file in your project root:
+
+```json
+{
+  "apiKey": "your-api-key",
+  "storageId": "your-storage-id"
+}
+```
+
+Then deploy:
+
+```bash
+npx connectbase-client deploy ./dist
+```
+
+### npm Scripts
+
+Add to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "deploy": "connectbase-client deploy ./dist"
+  }
+}
+```
+
+Then run:
+
+```bash
+npm run deploy
+```
+
+### Requirements
+
+- `index.html` must exist in the root of the deploy directory
+- Supported file types: `.html`, `.css`, `.js`, `.json`, `.svg`, `.png`, `.jpg`, `.gif`, `.webp`, `.woff`, `.woff2`, `.ttf`, `.mp3`, `.mp4`, `.pdf`, `.wasm`, etc.
 
 ## API Reference
 

package/dist/cli.js

@@ -0,0 +1,368 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var https = __toESM(require("https"));
+var http = __toESM(require("http"));
+var VERSION = "0.1.3";
+var DEFAULT_BASE_URL = "https://api.connectbase.world";
+var colors = {
+  reset: "\x1B[0m",
+  green: "\x1B[32m",
+  red: "\x1B[31m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  cyan: "\x1B[36m",
+  dim: "\x1B[2m"
+};
+function log(message) {
+  console.log(message);
+}
+function success(message) {
+  console.log(`${colors.green}\u2713${colors.reset} ${message}`);
+}
+function error(message) {
+  console.error(`${colors.red}\u2717${colors.reset} ${message}`);
+}
+function info(message) {
+  console.log(`${colors.blue}\u2139${colors.reset} ${message}`);
+}
+function warn(message) {
+  console.log(`${colors.yellow}\u26A0${colors.reset} ${message}`);
+}
+var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".html",
+  ".htm",
+  ".css",
+  ".js",
+  ".mjs",
+  ".json",
+  ".svg",
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".webp",
+  ".avif",
+  ".ico",
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".eot",
+  ".otf",
+  ".mp3",
+  ".wav",
+  ".ogg",
+  ".mp4",
+  ".webm",
+  ".pdf",
+  ".zip",
+  ".txt",
+  ".xml",
+  ".webmanifest",
+  ".map",
+  ".wasm"
+]);
+var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".webp",
+  ".avif",
+  ".ico",
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".eot",
+  ".otf",
+  ".mp3",
+  ".wav",
+  ".ogg",
+  ".mp4",
+  ".webm",
+  ".pdf",
+  ".zip",
+  ".wasm"
+]);
+function loadConfig() {
+  const config = {
+    apiKey: process.env.CONNECTBASE_API_KEY,
+    storageId: process.env.CONNECTBASE_STORAGE_ID,
+    baseUrl: process.env.CONNECTBASE_BASE_URL || DEFAULT_BASE_URL
+  };
+  const rcPath = path.join(process.cwd(), ".connectbaserc");
+  if (fs.existsSync(rcPath)) {
+    try {
+      const rcContent = JSON.parse(fs.readFileSync(rcPath, "utf-8"));
+      if (rcContent.apiKey) config.apiKey = rcContent.apiKey;
+      if (rcContent.storageId) config.storageId = rcContent.storageId;
+      if (rcContent.baseUrl) config.baseUrl = rcContent.baseUrl;
+    } catch {
+      warn(".connectbaserc \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
+    }
+  }
+  return config;
+}
+function collectFiles(dir, baseDir = dir) {
+  const files = [];
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    const relativePath = path.relative(baseDir, fullPath);
+    if (entry.isDirectory()) {
+      if (!entry.name.startsWith(".")) {
+        files.push(...collectFiles(fullPath, baseDir));
+      }
+    } else if (entry.isFile()) {
+      const ext = path.extname(entry.name).toLowerCase();
+      if (!ALLOWED_EXTENSIONS.has(ext)) {
+        continue;
+      }
+      if (entry.name.startsWith(".")) {
+        continue;
+      }
+      const isBinary = BINARY_EXTENSIONS.has(ext);
+      let content;
+      if (isBinary) {
+        content = fs.readFileSync(fullPath).toString("base64");
+      } else {
+        content = fs.readFileSync(fullPath, "utf-8");
+      }
+      files.push({
+        path: relativePath.replace(/\\/g, "/"),
+        // Windows 경로 변환
+        content,
+        isBinary
+      });
+    }
+  }
+  return files;
+}
+function makeRequest(url, method, headers, body) {
+  return new Promise((resolve2, reject) => {
+    const parsedUrl = new URL(url);
+    const isHttps = parsedUrl.protocol === "https:";
+    const lib = isHttps ? https : http;
+    const options = {
+      hostname: parsedUrl.hostname,
+      port: parsedUrl.port || (isHttps ? 443 : 80),
+      path: parsedUrl.pathname + parsedUrl.search,
+      method,
+      headers: {
+        ...headers,
+        "Content-Type": "application/json"
+      }
+    };
+    const req = lib.request(options, (res) => {
+      let data = "";
+      res.on("data", (chunk) => data += chunk);
+      res.on("end", () => {
+        try {
+          resolve2({
+            status: res.statusCode || 0,
+            data: data ? JSON.parse(data) : null
+          });
+        } catch {
+          resolve2({ status: res.statusCode || 0, data });
+        }
+      });
+    });
+    req.on("error", reject);
+    if (body) {
+      req.write(body);
+    }
+    req.end();
+  });
+}
+async function deploy(directory, config) {
+  const dir = path.resolve(directory);
+  if (!fs.existsSync(dir)) {
+    error(`\uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${dir}`);
+    process.exit(1);
+  }
+  if (!fs.statSync(dir).isDirectory()) {
+    error(`${dir}\uB294 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC544\uB2D9\uB2C8\uB2E4`);
+    process.exit(1);
+  }
+  const indexPath = path.join(dir, "index.html");
+  if (!fs.existsSync(indexPath)) {
+    error("index.html \uD30C\uC77C\uC774 \uD544\uC694\uD569\uB2C8\uB2E4");
+    process.exit(1);
+  }
+  info(`\uBC30\uD3EC \uC900\uBE44 \uC911... ${dir}`);
+  const files = collectFiles(dir);
+  if (files.length === 0) {
+    error("\uBC30\uD3EC\uD560 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4");
+    process.exit(1);
+  }
+  log(`${colors.dim}${files.length}\uAC1C \uD30C\uC77C \uBC1C\uACAC${colors.reset}`);
+  const url = `${config.baseUrl}/v1/storages/webs/${config.storageId}/deploy`;
+  info("\uBC30\uD3EC \uC911...");
+  try {
+    const response = await makeRequest(
+      url,
+      "POST",
+      {
+        "X-API-Key": config.apiKey
+      },
+      JSON.stringify({
+        files: files.map((f) => ({
+          path: f.path,
+          content: f.content,
+          is_binary: f.isBinary
+        }))
+      })
+    );
+    if (response.status >= 200 && response.status < 300) {
+      success("\uBC30\uD3EC \uC644\uB8CC!");
+      const data = response.data;
+      if (data?.url) {
+        log(`
+${colors.cyan}URL: ${data.url}${colors.reset}
+`);
+      }
+    } else {
+      const data = response.data;
+      error(`\uBC30\uD3EC \uC2E4\uD328: ${data?.message || data?.error || "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958"}`);
+      process.exit(1);
+    }
+  } catch (err) {
+    error(`\uB124\uD2B8\uC6CC\uD06C \uC624\uB958: ${err instanceof Error ? err.message : err}`);
+    process.exit(1);
+  }
+}
+function showHelp() {
+  log(`
+${colors.cyan}connectbase-client${colors.reset} - Connect Base SDK & CLI
+
+${colors.yellow}\uC0AC\uC6A9\uBC95:${colors.reset}
+  npx connectbase-client <command> [options]
+
+${colors.yellow}\uBA85\uB839\uC5B4:${colors.reset}
+  deploy <directory>    \uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0\uC5D0 \uD30C\uC77C \uBC30\uD3EC
+
+${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})
+  -h, --help            \uB3C4\uC6C0\uB9D0 \uD45C\uC2DC
+  -v, --version         \uBC84\uC804 \uD45C\uC2DC
+
+${colors.yellow}\uD658\uACBD\uBCC0\uC218:${colors.reset}
+  CONNECTBASE_API_KEY       API Key
+  CONNECTBASE_STORAGE_ID    \uC2A4\uD1A0\uB9AC\uC9C0 ID
+  CONNECTBASE_BASE_URL      \uC11C\uBC84 URL
+
+${colors.yellow}\uC124\uC815 \uD30C\uC77C (.connectbaserc):${colors.reset}
+  {
+    "apiKey": "your-api-key",
+    "storageId": "your-storage-id"
+  }
+
+${colors.yellow}\uC608\uC2DC:${colors.reset}
+  ${colors.dim}# \uAE30\uBCF8 \uBC30\uD3EC${colors.reset}
+  npx connectbase-client deploy ./dist -s <storage-id> -k <api-key>
+
+  ${colors.dim}# \uD658\uACBD\uBCC0\uC218 \uC0AC\uC6A9${colors.reset}
+  export CONNECTBASE_API_KEY=your-api-key
+  export CONNECTBASE_STORAGE_ID=your-storage-id
+  npx connectbase-client deploy ./dist
+
+  ${colors.dim}# package.json scripts\uC5D0\uC11C \uC0AC\uC6A9${colors.reset}
+  "scripts": {
+    "deploy": "connectbase-client deploy ./dist"
+  }
+`);
+}
+function parseArgs(args) {
+  const result = {
+    options: {},
+    args: []
+  };
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+    if (arg === "-s" || arg === "--storage") {
+      result.options.storageId = args[++i];
+    } else if (arg === "-k" || arg === "--api-key") {
+      result.options.apiKey = args[++i];
+    } else if (arg === "-u" || arg === "--base-url") {
+      result.options.baseUrl = args[++i];
+    } else if (arg === "-h" || arg === "--help") {
+      result.options.help = "true";
+    } else if (arg === "-v" || arg === "--version") {
+      result.options.version = "true";
+    } else if (!arg.startsWith("-")) {
+      if (!result.command) {
+        result.command = arg;
+      } else {
+        result.args.push(arg);
+      }
+    }
+    i++;
+  }
+  return result;
+}
+async function main() {
+  const parsed = parseArgs(process.argv.slice(2));
+  if (parsed.options.version) {
+    log(`connectbase-client v${VERSION}`);
+    return;
+  }
+  if (parsed.options.help || !parsed.command) {
+    showHelp();
+    return;
+  }
+  const fileConfig = loadConfig();
+  const config = {
+    apiKey: parsed.options.apiKey || fileConfig.apiKey,
+    storageId: parsed.options.storageId || fileConfig.storageId,
+    baseUrl: parsed.options.baseUrl || fileConfig.baseUrl || DEFAULT_BASE_URL
+  };
+  if (parsed.command === "deploy") {
+    const directory = parsed.args[0] || ".";
+    if (!config.apiKey) {
+      error("API Key\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4 (-k \uC635\uC158 \uB610\uB294 CONNECTBASE_API_KEY \uD658\uACBD\uBCC0\uC218)");
+      process.exit(1);
+    }
+    if (!config.storageId) {
+      error("\uC2A4\uD1A0\uB9AC\uC9C0 ID\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4 (-s \uC635\uC158 \uB610\uB294 CONNECTBASE_STORAGE_ID \uD658\uACBD\uBCC0\uC218)");
+      process.exit(1);
+    }
+    await deploy(directory, config);
+  } else {
+    error(`\uC54C \uC218 \uC5C6\uB294 \uBA85\uB839\uC5B4: ${parsed.command}`);
+    showHelp();
+    process.exit(1);
+  }
+}
+main().catch((err) => {
+  error(err.message);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "connectbase-client",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",
@@ -15,6 +15,9 @@
   "types": "dist/index.d.ts",
   "browser": "dist/connect-base.umd.js",
   "unpkg": "dist/connect-base.umd.js",
+  "bin": {
+    "connectbase-client": "./dist/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -36,11 +39,14 @@
     "backend-as-a-service",
     "database",
     "storage",
-    "sdk"
+    "sdk",
+    "cli",
+    "deploy"
   ],
   "author": "",
   "license": "MIT",
   "devDependencies": {
+    "@types/node": "^22.15.18",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },