@kaooffline/quickhost 0.1.0

package/README.md

@@ -0,0 +1,40 @@
+# quickhost CLI
+
+One-command static hosting on [kaooffline.top](https://kaooffline.top). Vite / Astro / plain HTML → `https://you.kaooffline.top/app`. Free, no server. Apps expire 30 days after last deploy (redeploy renews).
+
+Works with `npx`, `bunx`, `pnpm dlx`.
+
+## Install / use
+
+```bash
+npx @kaooffline/quickhost register -u alice
+cd my-vite-app
+npx @kaooffline/quickhost deploy --app demo
+# -> https://alice.kaooffline.top/demo/
+```
+
+With bun:
+
+```bash
+bunx @kaooffline/quickhost register -u alice
+bunx @kaooffline/quickhost deploy --app demo
+```
+
+## Commands
+
+```
+quickhost register -u <name>   claim username (asks password)
+quickhost login -u <name>      login on this machine
+quickhost deploy [--app x] [--dir ./dist] [--api URL]
+quickhost list                 live apps + expiry dates
+quickhost delete --app x       remove an app now
+quickhost whoami               current login
+```
+
+Deploy auto-detects `dist/`, `build/`, `out/`, `public/` (Vite/Astro first) and runs `npm run build` if nothing is built yet. Needs `index.html` at the publish dir root. SPA fallback included.
+
+## Limits
+
+50MB/app, 500 files/app, 25MB/file, 20 apps/user, 9GB platform-wide (free-tier hard lock). Static only, no databases. 10 deploys/day/IP.
+
+Docs: https://kaooffline.top/docs

package/bin/quickhost.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+// quickhost CLI - zero dependencies, Node 18+.
+// Usage:
+//   npx @kaooffline/quickhost register -u alice
+//   npx @kaooffline/quickhost login -u alice
+//   npx @kaooffline/quickhost deploy [--app my-app] [--dir ./dist] [--api https://api.kaooffline.top]
+//   npx @kaooffline/quickhost list | npx @kaooffline/quickhost delete --app my-app | npx @kaooffline/quickhost whoami
+import { readFileSync, writeFileSync, existsSync, statSync, readdirSync } from "node:fs";
+import { join, relative, resolve, basename } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+
+const CFG = join(homedir(), ".quickhost.json");
+const load = () => { try { return JSON.parse(readFileSync(CFG, "utf8")); } catch { return {}; } };
+const save = (c) => writeFileSync(CFG, JSON.stringify(c, null, 2));
+const arg = (k, d = null) => {
+  const i = process.argv.indexOf(k);
+  return i >= 0 && process.argv[i + 1] ? process.argv[i + 1] : d;
+};
+const apiBase = () => (arg("--api") || process.env.QUICKHOST_API || load().api || "https://api.kaooffline.top").replace(/\/$/, "");
+const authH = () => { const t = load().token; return t ? { authorization: "Bearer " + t } : {}; };
+
+const MIME = { html: "text/html", js: "text/javascript", mjs: "text/javascript", css: "text/css", json: "application/json", png: "image/png", jpg: "image/jpeg", jpeg: "image/jpeg", webp: "image/webp", gif: "image/gif", svg: "image/svg+xml", ico: "image/x-icon", woff: "font/woff", woff2: "font/woff2", ttf: "font/ttf", txt: "text/plain", xml: "application/xml", webmanifest: "application/manifest+json", map: "application/json" };
+const mime = (p) => MIME[(p.split(".").pop() || "").toLowerCase()] || "application/octet-stream";
+
+async function promptSecret(q) {
+  process.stdout.write(q);
+  return await new Promise((res) => {
+    let s = "";
+    process.stdin.setRawMode?.(true); process.stdin.resume(); process.stdin.setEncoding("utf8");
+    const on = (c) => {
+      if (c === "\r" || c === "\n" || c === "\u0004") { process.stdin.setRawMode?.(false); process.stdin.pause(); process.stdin.removeListener("data", on); process.stdout.write("\n"); res(s); }
+      else if (c === "\u0003") process.exit(1);
+      else if (c === "\b" || c === "\x7f") { s = s.slice(0, -1); }
+      else s += c;
+    };
+    process.stdin.on("data", on);
+  });
+}
+
+async function registerOrLogin(mode) {
+  const u = (arg("-u") || arg("--username") || "").toLowerCase().trim();
+  if (!u) { console.error(`Usage: quickhost ${mode} -u <username>`); process.exit(1); }
+  const p = arg("-p") || arg("--password") || await promptSecret("password: ");
+  const r = await fetch(`${apiBase()}/api/${mode}`, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ username: u, password: p }) });
+  const j = await r.json().catch(() => ({}));
+  if (!r.ok) { console.error("ERR:", j.error || r.status); process.exit(1); }
+  save({ ...load(), api: apiBase(), username: j.username, token: j.token });
+  console.log(`ok: logged in as ${j.username}`);
+}
+
+function walk(dir, out = [], root = dir) {
+  for (const e of readdirSync(dir, { withFileTypes: true })) {
+    const p = join(dir, e.name);
+    if (e.isDirectory()) { if (e.name === "node_modules" || e.name === ".git") continue; walk(p, out, root); }
+    else out.push({ abs: p, rel: relative(root, p).replace(/\\/g, "/") });
+  }
+  return out;
+}
+function detectDir() {
+  const manual = arg("--dir") || arg("-d");
+  if (manual) return resolve(manual);
+  for (const c of ["dist", "build", "out", "public", "."]) {
+    if (existsSync(join(process.cwd(), c, "index.html"))) return resolve(join(process.cwd(), c));
+  }
+  // try build once
+  try {
+    const pkg = JSON.parse(readFileSync(join(process.cwd(), "package.json"), "utf8"));
+    if (pkg.scripts?.build) {
+      console.log("no dist/ found, running build:", pkg.scripts.build);
+      execSync("npm run build", { stdio: "inherit" });
+      for (const c of ["dist", "build", "out"]) {
+        if (existsSync(join(process.cwd(), c, "index.html"))) return resolve(join(process.cwd(), c));
+      }
+    }
+  } catch {}
+  console.error("ERR: no index.html found. Build your app (npm run build) or pass --dir ./dist");
+  process.exit(1);
+}
+
+async function deploy() {
+  const cfg = load();
+  if (!cfg.token) { console.error("ERR: not logged in. Run: quickhost login -u <name>"); process.exit(1); }
+  let app = (arg("--app") || arg("-a") || "").toLowerCase().trim();
+  if (!app) {
+    try { app = basename(resolve(process.cwd())).toLowerCase().replace(/[^a-z0-9-]/g, "").slice(0, 40); }
+    catch {}
+  }
+  if (!/^[a-z0-9-]{1,40}$/.test(app)) { console.error("ERR: bad app name, use --app my-app"); process.exit(1); }
+  const dir = detectDir();
+  const files = walk(dir).filter((f) => !f.rel.startsWith("."));
+  if (!files.length) { console.error("ERR: empty dir", dir); process.exit(1); }
+  if (files.length > 500) { console.error("ERR: >500 files (limit)"); process.exit(1); }
+  console.log(`deploying ${files.length} files from ${dir} as ${cfg.username}/${app} ...`);
+  const t0 = Date.now();
+  let i = 0;
+  for (const f of files) {
+    const buf = readFileSync(f.abs);
+    if (buf.length > 25 * 1024 * 1024) { console.error("ERR: file >25MB:", f.rel); process.exit(1); }
+    const r = await fetch(`${apiBase()}/api/apps/${app}/${encodeURIComponent(f.rel).replace(/%2F/g, "/")}`, {
+      method: "PUT", headers: { ...authH(), "content-type": mime(f.rel) }, body: buf,
+    });
+    if (!r.ok) { console.error("ERR upload", f.rel, await r.text()); process.exit(1); }
+    if (++i % 20 === 0) process.stdout.write(`  ${i}/${files.length}\r`);
+  }
+  const r = await fetch(`${apiBase()}/api/apps/${app}/finalize`, { method: "POST", headers: { ...authH(), "content-type": "application/json" }, body: "{}" });
+  const j = await r.json().catch(() => ({}));
+  if (!r.ok) { console.error("ERR finalize:", j.error || r.status); process.exit(1); }
+  console.log(`\nDone in ${((Date.now() - t0) / 1000).toFixed(1)}s: ${j.url}`);
+  console.log(`Expires: ${new Date(j.expires_at * 1000).toLocaleDateString()} (redeploy renews 30d)`);
+}
+
+const cmd = process.argv[2];
+if (cmd === "register" || cmd === "login") await registerOrLogin(cmd);
+else if (cmd === "deploy" || !cmd) await deploy();
+else if (cmd === "list") {
+  const r = await fetch(`${apiBase()}/api/apps`, { headers: authH() });
+  const j = await r.json();
+  if (!r.ok) { console.error("ERR:", j.error); process.exit(1); }
+  for (const a of j.apps || []) console.log(`${a.username}.kaooffline.top/${a.appname}  expires=${new Date(a.expires_at * 1000).toLocaleDateString()} files=${a.file_count}`);
+  if (!(j.apps || []).length) console.log("(no live apps)");
+} else if (cmd === "delete") {
+  const app = arg("--app") || arg("-a");
+  if (!app) { console.error("Usage: quickhost delete --app <name>"); process.exit(1); }
+  const r = await fetch(`${apiBase()}/api/apps/${app}`, { method: "DELETE", headers: authH() });
+  console.log(r.ok ? "deleted" : "ERR " + (await r.text()));
+} else if (cmd === "whoami") {
+  const r = await fetch(`${apiBase()}/api/me`, { headers: authH() });
+  console.log(await r.text());
+} else { console.log("Usage: quickhost [register -u x|login -u x|deploy --app x --dir ./dist|list|delete --app x|whoami]"); }

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@kaooffline/quickhost",
+  "version": "0.1.0",
+  "description": "quickHOST CLI - one-command static hosting (Vite/Astro/HTML) to username.kaooffline.top/app. Free, 30-day rolling expiry.",
+  "type": "module",
+  "bin": { "quickhost": "bin/quickhost.js" },
+  "files": ["bin"],
+  "keywords": ["hosting", "vite", "astro", "static", "deploy", "kaooffline", "quickhost"],
+  "homepage": "https://kaooffline.top/docs",
+  "repository": { "type": "git", "url": "https://kaooffline.top" },
+  "engines": { "node": ">=18" },
+  "license": "MIT"
+}