pool-anything 0.1.0 → 0.1.1

package/dist/admin/seo.js

@@ -0,0 +1,58 @@
+/** Shared SEO constants for the public landing (tools-site) + local app.
+ *  Canonical host is the hosted tools UI; local / just reuses the same tags
+ *  so exported static HTML is already optimized with no per-env branching. */
+export const SITE_URL = "https://pool-anything-tools.pages.dev";
+export const SITE_NAME = "pool-anything";
+export const SEO_TITLE = "pool-anything — Pool Free-Tier API Keys, Rotate & Track Usage";
+export const SEO_DESCRIPTION = "Gather free-tier API keys into one pool and rotate them. Round-robin proxy, per-key usage & quota tracking, 36 providers, self-hosted TypeScript + SQLite.";
+export const SEO_OG_IMAGE = `${SITE_URL}/logo.png`;
+export const HOME_HEAD_EXTRA = `<meta name="description" content="${SEO_DESCRIPTION}" />
+<link rel="canonical" href="${SITE_URL}/" />
+<meta name="robots" content="index, follow, max-image-preview:large" />
+<meta name="author" content="Parithosh Varma" />
+<meta name="theme-color" content="#ffffff" />
+<meta property="og:type" content="website" />
+<meta property="og:site_name" content="${SITE_NAME}" />
+<meta property="og:title" content="${SEO_TITLE}" />
+<meta property="og:description" content="${SEO_DESCRIPTION}" />
+<meta property="og:url" content="${SITE_URL}/" />
+<meta property="og:image" content="${SEO_OG_IMAGE}" />
+<meta name="twitter:card" content="summary" />
+<meta name="twitter:title" content="${SEO_TITLE}" />
+<meta name="twitter:description" content="${SEO_DESCRIPTION}" />
+<meta name="twitter:image" content="${SEO_OG_IMAGE}" />
+<script type="application/ld+json">{"@context":"https://schema.org","@type":"SoftwareApplication","name":"pool-anything","applicationCategory":"DeveloperApplication","operatingSystem":"Any","url":"${SITE_URL}/","description":"${SEO_DESCRIPTION}","license":"https://www.apache.org/licenses/LICENSE-2.0","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"author":{"@type":"Person","name":"Parithosh Varma"}}</script>`;
+/** Minimal per-page head (description + canonical) for app sub-pages. */
+export function subPageHead(path, description) {
+    const url = `${SITE_URL}${path}`;
+    return `<meta name="description" content="${description}" />
+<link rel="canonical" href="${url}" />
+<meta name="robots" content="index, follow" />
+<meta property="og:type" content="website" />
+<meta property="og:site_name" content="${SITE_NAME}" />
+<meta property="og:url" content="${url}" />
+<meta property="og:image" content="${SEO_OG_IMAGE}" />
+<meta name="twitter:card" content="summary" />`;
+}
+export function robotsTxt() {
+    return `User-agent: *
+Allow: /
+Sitemap: ${SITE_URL}/sitemap.xml
+`;
+}
+const STATIC_ROUTES = ["/", "/pools", "/keys", "/playground", "/analytics", "/history"];
+export function sitemapXml(providerIds) {
+    const urls = new Set(STATIC_ROUTES);
+    for (const id of providerIds) {
+        if (/^[a-z0-9-]+$/.test(id))
+            urls.add(`/provider/${id}/`);
+    }
+    const withSlash = [...urls].map((p) => (p === "/" ? "/" : p.endsWith("/") ? p : `${p}/`));
+    const today = new Date().toISOString().slice(0, 10);
+    const entries = withSlash
+        .map((p) => `  <url><loc>${SITE_URL}${p}</loc><lastmod>${today}</lastmod><changefreq>${p === "/" ? "weekly" : "monthly"}</changefreq><priority>${p === "/" ? "1.0" : p.startsWith("/provider/") ? "0.6" : "0.8"}</priority></url>`)
+        .join("\n");
+    // Note: provider routes are exported as /provider/:id/index.html so the
+    // trailing-slash form is canonical on Pages.
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${entries}\n</urlset>\n`;
+}

package/dist/admin/shell.js

@@ -39,7 +39,7 @@ export function shellNav(active) {
     };
     return `<aside class="sidebar">
   <div class="sb-header"><a class="sb-logo" aria-label="pool-anything home" href="/"><img src="/logo.png" alt="pool-anything" width="36" height="36" /></a><div class="sb-acct" title="Local account"><span>Local account</span></div></div>
-  <nav class="sb-nav">${item("/", ICONS.home, "Home")}${item("/pools", ICONS.pools, "Pools")}${item("/keys", ICONS.keys, "API key manager")}${item("/playground", ICONS.playground, "Playground")}${item("/analytics", ICONS.analytics, "Analytics")}${item(DOCS_URL, ICONS.docs, "Docs")}</nav>
+  <nav class="sb-nav">${item("/", ICONS.home, "Home")}${item("/pools", ICONS.pools, "Pools")}${item("/keys", ICONS.keys, "API key manager")}${item("/playground", ICONS.playground, "Playground")}${item("/analytics", ICONS.analytics, "Analytics")}${item("/history", ICONS.history, "History")}${item(DOCS_URL, ICONS.docs, "Docs")}</nav>
   <div class="sb-footer"><button class="collapse-btn" id="collapseBtn" type="button" data-sidebar="trigger" aria-expanded="true" aria-label="Collapse sidebar"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" aria-hidden="true" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"><path d="M21.25 6.72v10.56a2.97 2.97 0 0 1-2.97 2.97H5.72a2.97 2.97 0 0 1-2.97-2.97V6.72a2.97 2.97 0 0 1 2.97-2.97h12.56a2.97 2.97 0 0 1 2.97 2.97"></path><path d="M6.25 7.25v9.5"></path></svg></button></div>
 </aside><script>
   (function () {
@@ -59,6 +59,8 @@ export function shellNav(active) {
 export const sharedHeader = `<header>
   <div></div>
   <div class="spacer">
+    <span class="ver-pill" id="verPill" title="pool-anything version">v…</span>
+    <button class="ver-update" id="verUpdate" type="button" hidden>Update</button>
     <a href="${DOCS_URL}" target="_blank" rel="noopener">Docs</a>
   </div>
 </header>`;
@@ -70,9 +72,13 @@ export const sharedLayoutCss = `
   ${tokensCss}
   .content { flex:1; min-width:0; display:flex; flex-direction:column; }
   header { height:56px; background:var(--card); border-bottom:1px solid var(--line); display:flex; align-items:center; padding:0 16px; gap:8px; position:sticky; top:0; z-index:5; }
-  header .spacer { margin-left:auto; display:flex; gap:4px; }
+  header .spacer { margin-left:auto; display:flex; gap:4px; align-items:center; }
   header a { font-size:14px; padding:6px 12px; border-radius:8px; border:0; background:inherit; color:var(--ink); text-decoration:none; cursor:pointer; }
   header a:hover { background:var(--paper-2); }
+  .ver-pill { font-size:12px; font-weight:600; color:var(--ink-soft); background:var(--paper-2); border:1px solid var(--line); border-radius:999px; padding:4px 10px; white-space:nowrap; }
+  .ver-update { font-size:12px; font-weight:600; border:1px solid var(--ink); background:var(--ink); color:var(--card); border-radius:999px; padding:4px 12px; cursor:pointer; white-space:nowrap; }
+  .ver-update[hidden] { display:none; }
+  .ver-update:disabled { opacity:.6; cursor:default; }
   main { display:flex; flex-direction:column; align-items:center; justify-content:flex-start; padding:32px 16px 24px; }
   .wrap { width:100%; max-width:1400px; margin:0 auto; display:flex; flex-direction:column; align-items:stretch; gap:16px; padding:0 8px; }
   .page-head { display:flex; align-items:center; gap:10px; }
@@ -126,4 +132,41 @@ export const shellJs = `<script>
     if (!shell.classList.contains('peeking')) return;
     finishCollapse(() => shell.classList.remove('peeking'));
   });
+  // Version pill + self-update. GET /api/version stays public so the pill
+  // renders without a token; POST /api/update is a write and needs the
+  // bearer when POOL_API_TOKEN is set (see middleware/auth.ts).
+  (function () {
+    var pill = document.getElementById('verPill');
+    var btn = document.getElementById('verUpdate');
+    if (!pill || !btn) return;
+    function txt(el, s) { if (el) el.textContent = s; }
+    fetch('/api/version').then(function (r) { return r.json(); }).then(function (v) {
+      if (!v || !v.current) return;
+      txt(pill, 'v' + v.current);
+      pill.title = v.latest ? ('current v' + v.current + ', latest v' + v.latest) : ('pool-anything v' + v.current);
+      if (v.updateAvailable) {
+        btn.hidden = false;
+        txt(btn, 'Update to v' + v.latest);
+      }
+    }).catch(function () {});
+    btn.addEventListener('click', function () {
+      if (btn.disabled) return;
+      btn.disabled = true;
+      txt(btn, 'Updating…');
+      fetch('/api/update', { method: 'POST' }).then(function (r) { return r.json(); }).then(function (j) {
+        if (j && j.ok) {
+          txt(pill, 'v' + (j.current || j.latest || ''));
+          txt(btn, 'Updated — restart server');
+          pill.title = (j.text || 'updated');
+        } else {
+          txt(btn, 'Update failed — retry');
+          btn.disabled = false;
+          pill.title = ((j && (j.text || j.error)) || 'update failed');
+        }
+      }).catch(function () {
+        txt(btn, 'Update failed — retry');
+        btn.disabled = false;
+      });
+    });
+  })();
 </script>`;

package/dist/cli/commands.js

@@ -0,0 +1,276 @@
+/**
+ * Presentation-free command core for the assistant CLI.
+ * No console/readline/Ink here — dispatch() returns view-models and each
+ * frontend (plain-text one-shot, Ink shell) renders them its own way.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { sdb, PROVIDERS, mask, poolSummary, isMultiFieldProvider, normalizeCredentials } from "../pool/index.js";
+import { nextKey, recordUsage } from "../pool/rotation.js";
+import { MAX_KEYS_PER_POOL, MAX_API_KEY_CHARS } from "../router/api.js";
+import { PACKAGE_ROOT } from "../config/paths.js";
+import { parse, suggest } from "./nl.js";
+import { fmtFull, helpBox } from "./ui.js";
+export function readVersion() {
+    try {
+        const raw = fs.readFileSync(path.join(PACKAGE_ROOT, "package.json"), "utf8");
+        const pkg = JSON.parse(raw);
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function allPools() {
+    return sdb.prepare("SELECT id, provider, name FROM pools ORDER BY id").all();
+}
+/** Resolve free-text ref: numeric id, provider id, or name substring. */
+export function resolvePool(ref) {
+    const pools = allPools();
+    if (pools.length === 0)
+        return null;
+    const t = ref.trim().toLowerCase();
+    if (!t)
+        return pools[0];
+    if (/^\d+$/.test(t)) {
+        const hit = pools.find((p) => p.id === Number(t));
+        if (hit)
+            return hit;
+    }
+    const byProvider = pools.filter((p) => p.provider.toLowerCase() === t);
+    if (byProvider.length > 0)
+        return byProvider[0];
+    const byName = pools.filter((p) => p.name.toLowerCase().includes(t));
+    if (byName.length > 0)
+        return byName[0];
+    const byProviderSub = pools.filter((p) => p.provider.toLowerCase().includes(t));
+    if (byProviderSub.length > 0)
+        return byProviderSub[0];
+    return null;
+}
+function needPool(ref) {
+    const p = resolvePool(ref);
+    if (!p) {
+        return { error: ref.trim() ? `No pool matches "${ref.trim()}". Try 'list pools'.` : "No pools yet — try: create pool <name> for <provider>." };
+    }
+    return { pool: p };
+}
+function poolsResult() {
+    const pools = sdb.prepare("SELECT id, provider, name FROM pools ORDER BY id").all().map((p) => {
+        const s = poolSummary(p.id);
+        const keyCount = sdb.prepare("SELECT COUNT(*) AS n FROM pool_keys WHERE pool_id = ?").get(p.id).n;
+        return {
+            id: p.id, name: p.name, provider: p.provider, keys: keyCount,
+            used: s?.usedInWindow ?? 0, quota: s?.quota ?? null, active: keyCount > 0,
+        };
+    });
+    return { kind: "pools", pools };
+}
+function keysResult(ref) {
+    const r = needPool(ref);
+    if ("error" in r)
+        return { kind: "message", tone: "err", text: r.error };
+    const rows = sdb
+        .prepare("SELECT id, label, api_key FROM pool_keys WHERE pool_id = ? ORDER BY id")
+        .all(r.pool.id);
+    return {
+        kind: "keys", pool: r.pool,
+        keys: rows.map((k) => ({ id: k.id, label: k.label, masked: mask(k.api_key) })),
+    };
+}
+function usageResult(ref) {
+    const r = needPool(ref);
+    if ("error" in r)
+        return { kind: "message", tone: "err", text: r.error };
+    const s = poolSummary(r.pool.id);
+    if (!s)
+        return { kind: "message", tone: "err", text: "Pool not found." };
+    const cooling = sdb.prepare("SELECT COUNT(*) AS n FROM pool_keys WHERE pool_id = ? AND cooldown_until > ?").get(r.pool.id, Date.now()).n;
+    const perKey = s.perKey.map((k) => {
+        const row = sdb.prepare("SELECT api_key FROM pool_keys WHERE id = ?").get(k.id);
+        return { label: k.label, masked: mask(row?.api_key ?? ""), used: k.used };
+    });
+    return {
+        kind: "usage",
+        view: { id: s.id, name: s.name, provider: s.provider, used: s.usedInWindow, quota: s.quota, remaining: s.remaining, keys: s.keys, cooling },
+        perKey,
+    };
+}
+function nextResult(ref) {
+    const r = needPool(ref);
+    if ("error" in r)
+        return { kind: "message", tone: "err", text: r.error };
+    const sel = nextKey(r.pool.id);
+    if ("error" in sel)
+        return { kind: "message", tone: "err", text: `Error: ${sel.error}` };
+    return { kind: "message", tone: "ok", text: `Next key in pool #${r.pool.id}: #${sel.key_id} ${sel.label} (${sel.masked})` };
+}
+function consumeResult(tokens, ref) {
+    const r = needPool(ref);
+    if ("error" in r)
+        return { kind: "message", tone: "err", text: r.error };
+    const res = recordUsage(r.pool.id, tokens);
+    if ("error" in res)
+        return { kind: "message", tone: "err", text: `Error: ${res.error}` };
+    return { kind: "message", tone: "ok", text: `Recorded ${fmtFull(tokens)} tokens on #${res.key_id} ${res.label} (${res.masked}).` };
+}
+async function createResult(name, provider, ask) {
+    const msg = (tone, text) => ({ kind: "message", tone, text });
+    let n = name.trim();
+    let pv = provider.trim().toLowerCase();
+    if (!pv)
+        pv = (await ask("Provider id (e.g. groq)? ")).trim().toLowerCase();
+    const known = PROVIDERS.find((p) => p.id === pv);
+    if (!known)
+        return msg("err", `Unknown provider "${pv}". Try 'list providers'.`);
+    if (!n)
+        n = (await ask(`Name for the new ${known.name} pool? `)).trim();
+    if (!n)
+        return msg("info", "Cancelled (empty name).");
+    if (n.length > 80)
+        return msg("err", "Name must be <= 80 characters.");
+    const r = sdb.prepare("INSERT INTO pools (provider, name) VALUES (?, ?)").run(known.id, n);
+    return msg("ok", `Created pool #${r.lastInsertRowid} "${n}" (${known.id}). Add keys with: add keys to ${known.id}`);
+}
+async function deleteResult(ref, ask) {
+    const msg = (tone, text) => ({ kind: "message", tone, text });
+    const r = needPool(ref);
+    if ("error" in r)
+        return msg("err", r.error);
+    const ans = (await ask(`Delete pool #${r.pool.id} "${r.pool.name}" and its keys? [y/N] `)).trim().toLowerCase();
+    if (ans !== "y" && ans !== "yes")
+        return msg("info", "Cancelled.");
+    sdb.exec("BEGIN IMMEDIATE");
+    try {
+        sdb.prepare("DELETE FROM usage WHERE pool_id = ?").run(r.pool.id);
+        sdb.prepare("DELETE FROM pool_keys WHERE pool_id = ?").run(r.pool.id);
+        sdb.prepare("DELETE FROM pools WHERE id = ?").run(r.pool.id);
+        sdb.exec("COMMIT");
+    }
+    catch (e) {
+        try {
+            sdb.exec("ROLLBACK");
+        }
+        catch { /* already rolled back */ }
+        throw e;
+    }
+    return msg("ok", `Deleted pool #${r.pool.id} "${r.pool.name}".`);
+}
+/** Insert pasted lines as keys. Returns counts. Shared by interactive + piped import. */
+export function insertKeys(pool, rawLines) {
+    const existing = sdb.prepare("SELECT COUNT(*) AS n FROM pool_keys WHERE pool_id = ?").get(pool.id).n;
+    const multi = isMultiFieldProvider(pool.provider);
+    let added = 0;
+    let skipped = 0;
+    for (const raw of rawLines) {
+        if (existing + added >= MAX_KEYS_PER_POOL)
+            break;
+        if (multi) {
+            let obj;
+            try {
+                obj = JSON.parse(raw);
+            }
+            catch {
+                skipped++;
+                continue;
+            }
+            const norm = normalizeCredentials(pool.provider, obj);
+            if (!norm.ok) {
+                skipped++;
+                continue;
+            }
+            const single = norm.value["apiKey"] ?? norm.value["api_key"] ?? norm.value["apiToken"] ?? Object.values(norm.value)[0] ?? "";
+            sdb.prepare("INSERT INTO pool_keys (pool_id, label, api_key, credentials) VALUES (?, ?, ?, ?)").run(pool.id, `key ${existing + added + 1}`, single, JSON.stringify(norm.value));
+            added++;
+        }
+        else {
+            const key = raw.trim();
+            if (!key || /[\r\n\0]/.test(key)) {
+                skipped++;
+                continue;
+            }
+            if (key.length > MAX_API_KEY_CHARS) {
+                skipped++;
+                continue;
+            }
+            const dup = sdb.prepare("SELECT id FROM pool_keys WHERE pool_id = ? AND api_key = ?").get(pool.id, key);
+            if (dup) {
+                skipped++;
+                continue;
+            }
+            sdb.prepare("INSERT INTO pool_keys (pool_id, label, api_key) VALUES (?, ?, ?)").run(pool.id, `key ${existing + added + 1}`, key);
+            added++;
+        }
+    }
+    return { added, skipped };
+}
+export function importHint(pool, expected) {
+    const base = isMultiFieldProvider(pool.provider)
+        ? "This provider needs multi-field credentials: paste one JSON object per line."
+        : "Paste API keys (one per line, empty line to finish):";
+    return expected !== null ? `${base} (expecting ~${expected})` : base;
+}
+export function liveStats(poolId) {
+    const reqMin = sdb.prepare("SELECT COUNT(*) AS n FROM usage WHERE pool_id = ? AND created_at >= datetime('now','-1 minute')").get(poolId).n;
+    const tokMin = sdb.prepare("SELECT COALESCE(SUM(tokens),0) AS t FROM usage WHERE pool_id = ? AND created_at >= datetime('now','-1 minute')").get(poolId).t;
+    const lat = sdb.prepare("SELECT AVG(latency_ms) AS a FROM pool_keys WHERE pool_id = ? AND latency_ms IS NOT NULL").get(poolId);
+    const perKey = sdb
+        .prepare("SELECT k.id, k.label, k.api_key AS apiKey, COALESCE(SUM(u.tokens),0) AS used FROM pool_keys k LEFT JOIN usage u ON u.key_id = k.id WHERE k.pool_id = ? GROUP BY k.id ORDER BY k.id")
+        .all(poolId);
+    return { reqMin, tokMin, avgLatency: lat.a, perKey };
+}
+let serverStarted = false;
+/** Execute one input line. No I/O except via ask(); returns a view-model. */
+export async function dispatch(input, ask) {
+    const intent = parse(input);
+    switch (intent.kind) {
+        case "exit": return { kind: "exit" };
+        case "help": return { kind: "message", tone: "info", text: helpBox() };
+        case "clear": return { kind: "clear" };
+        case "version": return { kind: "message", tone: "info", text: readVersion() };
+        case "list-pools": return poolsResult();
+        case "list-providers": return { kind: "providers" };
+        case "list-keys": return keysResult(intent.ref);
+        case "usage": return usageResult(intent.ref);
+        case "next": return nextResult(intent.ref);
+        case "consume": return consumeResult(intent.tokens, intent.ref);
+        case "create-pool": return createResult(intent.name, intent.provider, ask);
+        case "delete-pool": return deleteResult(intent.ref, ask);
+        case "add-keys": {
+            const r = needPool(intent.ref);
+            if ("error" in r)
+                return { kind: "message", tone: "err", text: r.error };
+            return { kind: "import", pool: r.pool, expected: intent.count, hint: importHint(r.pool, intent.count) };
+        }
+        case "watch": {
+            const r = needPool(intent.ref);
+            if ("error" in r)
+                return { kind: "message", tone: "err", text: r.error };
+            return { kind: "watch", pool: r.pool };
+        }
+        case "serve": {
+            if (serverStarted)
+                return { kind: "serve", already: true };
+            serverStarted = true;
+            await import("../server.js");
+            return { kind: "serve", already: false };
+        }
+        case "update": {
+            const { performUpdate } = await import("../version.js");
+            const r = await performUpdate();
+            return { kind: "message", tone: r.ok ? (r.updated ? "ok" : "info") : "err", text: r.text };
+        }
+        case "uninstall": {
+            const ans = (await ask("Remove the pool-anything CLI (npm uninstall -g)? Your pools/keys in SQLite stay. [y/N] ")).trim().toLowerCase();
+            if (ans !== "y" && ans !== "yes")
+                return { kind: "message", tone: "info", text: "Cancelled." };
+            const { performUninstall } = await import("../version.js");
+            const r = performUninstall();
+            return { kind: "message", tone: r.ok ? "ok" : "err", text: r.text };
+        }
+        case "unknown": {
+            const s = suggest(input, PROVIDERS.map((p) => p.id));
+            return { kind: "message", tone: "err", text: `I didn't understand that.${s ? ` Did you mean '${s}'?` : ""} Type '.help' for commands.` };
+        }
+    }
+}

package/dist/cli/nl.js

@@ -45,6 +45,14 @@ export function parse(input) {
         return { kind: "serve" };
     if (/^(server|web ui|dashboard)$/.test(s))
         return { kind: "serve" };
+    // Self-maintenance: `update`/`/update` upgrades via npm; `uninstall` removes
+    // the global install (CLI only — no UI affordance by design).
+    if (/^[/.]?(update|upgrade)\b/.test(s) || /^(check for updates?|check updates?)$/.test(s))
+        return { kind: "update" };
+    if (/^[/.]?uninstall\b/.test(s) ||
+        /\buninstall\b/.test(s) ||
+        /^(remove|delete) (self|pool-anything|the app)\b/.test(s))
+        return { kind: "uninstall" };
     // Keys before pools: "list keys ..." contains neither "pool" word necessarily.
     if (/\bkeys?\b/.test(s) && /\b(list|ls|show|display|get)\b/.test(s)) {
         return { kind: "list-keys", ref: refOf(s, KEY_LIST_WORDS) };
@@ -107,6 +115,8 @@ const CANONICAL = [
     "delete pool",
     "watch",
     "serve",
+    "update",
+    "uninstall",
     "help",
     "exit",
 ];