landingboost 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# LandingBoost CLI
+
+Run LandingBoost scans from any terminal.
+
+```bash
+landingboost login --api-key lpapi_...
+landingboost scan https://example.com
+```
+
+The API key is saved locally at `~/.landingboost/config.json` with file mode `0600`.
+
+## Commands
+
+```bash
+landingboost login --api-key lpapi_...
+landingboost scan https://example.com
+landingboost scan https://example.com --json
+landingboost status
+landingboost logout
+```
+

package/bin/landingboost.mjs

@@ -0,0 +1,301 @@
+#!/usr/bin/env node
+
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+const DEFAULT_ENDPOINT = "https://skzaijeszkmghxaoizls.supabase.co/functions/v1/lp-score";
+const CONFIG_DIR = path.join(os.homedir(), ".landingboost");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+
+function printHelp() {
+  console.log(`LandingBoost CLI
+
+Usage:
+  landingboost login --api-key lpapi_...
+  landingboost scan https://example.com
+
+Commands:
+  login       Save your API key locally.
+  scan        Run a landing page scan.
+  status      Show saved CLI configuration.
+  logout      Remove the saved API key.
+
+Options:
+  --api-key <key>      API key. Overrides saved key and LANDINGBOOST_API_KEY.
+  --endpoint <url>     Override the lp-score endpoint.
+  --json               Print the compact API response as JSON.
+  --help               Show this help.
+`);
+}
+
+function parseArgs(argv) {
+  const args = {
+    command: "",
+    url: "",
+    apiKey: "",
+    endpoint: "",
+    json: false,
+    help: false,
+  };
+
+  const first = argv[0] || "";
+  if (["login", "scan", "status", "logout", "help"].includes(first)) {
+    args.command = first;
+    argv = argv.slice(1);
+  } else {
+    args.command = first === "--help" || first === "-h" ? "help" : "scan";
+  }
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === "--help" || arg === "-h") {
+      args.help = true;
+    } else if (arg === "--json") {
+      args.json = true;
+    } else if (arg === "--api-key") {
+      args.apiKey = argv[i + 1] || "";
+      i += 1;
+    } else if (arg === "--endpoint") {
+      args.endpoint = argv[i + 1] || "";
+      i += 1;
+    } else if (!arg.startsWith("-") && !args.url) {
+      args.url = arg;
+    }
+  }
+
+  return args;
+}
+
+function normalizeUrl(input) {
+  const trimmed = String(input || "").trim();
+  if (!trimmed) return "";
+  if (/^https?:\/\//i.test(trimmed)) return trimmed;
+  return `https://${trimmed}`;
+}
+
+function assertValidUrl(url, label = "URL") {
+  try {
+    const parsed = new URL(url);
+    if (!["http:", "https:"].includes(parsed.protocol)) throw new Error("unsupported protocol");
+    return parsed.toString();
+  } catch {
+    throw new Error(`Invalid ${label}: ${url}`);
+  }
+}
+
+function resolveEndpoint(value) {
+  return (
+    value ||
+    process.env.LANDINGBOOST_API_ENDPOINT ||
+    (process.env.LANDINGBOOST_SUPABASE_URL
+      ? `${process.env.LANDINGBOOST_SUPABASE_URL.replace(/\/$/, "")}/functions/v1/lp-score`
+      : DEFAULT_ENDPOINT)
+  );
+}
+
+function maskKey(key) {
+  if (!key) return "";
+  return `${key.slice(0, 12)}...${key.slice(-4)}`;
+}
+
+function validateApiKeyShape(apiKey) {
+  if (!apiKey || !apiKey.startsWith("lpapi_")) {
+    throw new Error("API key must start with lpapi_.");
+  }
+}
+
+async function readConfig() {
+  try {
+    const raw = await readFile(CONFIG_FILE, "utf8");
+    const parsed = JSON.parse(raw);
+    return typeof parsed === "object" && parsed ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+
+async function writeConfig(config) {
+  await mkdir(CONFIG_DIR, { recursive: true, mode: 0o700 });
+  await writeFile(CONFIG_FILE, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
+}
+
+async function removeConfig() {
+  await rm(CONFIG_FILE, { force: true });
+}
+
+function firstText(...values) {
+  for (const value of values) {
+    if (typeof value === "string" && value.trim()) return value.trim();
+  }
+  return "";
+}
+
+function scoreLine(label, value) {
+  return `${label.padEnd(9)} ${String(value ?? "n/a").padStart(3)}`;
+}
+
+function formatText(result) {
+  const scores = result.scores || {};
+  const edit = result.one_edit || {};
+  const usage = result.usage || {};
+  const refs = result.benchmark_summary?.references || [];
+  const scanUrl = result.scanId ? `https://landingboost.app/?scanId=${result.scanId}` : "";
+  const title = firstText(edit.title, edit.headline, "Next edit");
+  const instruction = firstText(edit.instruction, edit.change_this, edit.summary);
+  const where = firstText(edit.where, edit.location);
+
+  const lines = [];
+  lines.push("LandingBoost scan");
+  lines.push(`${result.final_url || result.url || ""}`);
+  lines.push("");
+  lines.push(`Score: ${scores.overall_100 ?? "n/a"}/100`);
+  if (result.weakest_axis) lines.push(`Bottleneck: ${result.weakest_axis}`);
+  lines.push("");
+  lines.push("One Edit");
+  lines.push(`  ${title}`);
+  if (instruction) lines.push(`  ${instruction}`);
+  if (where) lines.push(`  Where: ${where}`);
+  lines.push("");
+  lines.push("Scores");
+  lines.push(`  ${scoreLine("Clarity", scores.clarity_100)}`);
+  lines.push(`  ${scoreLine("Relevance", scores.relevance_100)}`);
+  lines.push(`  ${scoreLine("Trust", scores.trust_100)}`);
+  lines.push(`  ${scoreLine("Action", scores.action_100)}`);
+
+  const referenceNames = refs.map((ref) => ref.name).filter(Boolean).slice(0, 3);
+  if (referenceNames.length) {
+    lines.push("");
+    lines.push(`Matched: ${referenceNames.join(", ")}`);
+  }
+
+  if (typeof usage.api_calls_used === "number" || typeof usage.api_calls_remaining === "number") {
+    lines.push("");
+    lines.push(
+      `Usage: ${usage.api_calls_used ?? "?"}/${usage.api_calls_limit ?? "?"} API/CLI runs used, ${usage.api_calls_remaining ?? "?"} left this month`,
+    );
+  }
+
+  if (scanUrl) {
+    lines.push("");
+    lines.push(`Open: ${scanUrl}`);
+  }
+
+  return lines.join("\n");
+}
+
+async function commandLogin(args) {
+  const apiKey = args.apiKey || process.env.LANDINGBOOST_API_KEY || "";
+  validateApiKeyShape(apiKey);
+  const endpoint = assertValidUrl(resolveEndpoint(args.endpoint), "endpoint");
+
+  await writeConfig({
+    apiKey,
+    endpoint,
+    savedAt: new Date().toISOString(),
+  });
+
+  console.log(`Saved LandingBoost API key: ${maskKey(apiKey)}`);
+  console.log(`Config: ${CONFIG_FILE}`);
+  console.log("Run: landingboost scan https://example.com");
+}
+
+async function commandStatus() {
+  const config = await readConfig();
+  if (!config.apiKey) {
+    console.log("No saved LandingBoost API key.");
+    console.log("Run: landingboost login --api-key lpapi_...");
+    return;
+  }
+
+  console.log("LandingBoost CLI is configured.");
+  console.log(`Key: ${maskKey(config.apiKey)}`);
+  console.log(`Endpoint: ${config.endpoint || DEFAULT_ENDPOINT}`);
+}
+
+async function commandLogout() {
+  await removeConfig();
+  console.log("Removed saved LandingBoost API key.");
+}
+
+async function commandScan(args) {
+  if (!args.url) {
+    console.error("Missing URL.");
+    console.error("Run: landingboost scan https://example.com");
+    process.exitCode = 1;
+    return;
+  }
+
+  const config = await readConfig();
+  const apiKey = args.apiKey || process.env.LANDINGBOOST_API_KEY || config.apiKey || "";
+  if (!apiKey) {
+    console.error("Missing API key.");
+    console.error("Run once: landingboost login --api-key lpapi_...");
+    process.exitCode = 1;
+    return;
+  }
+  validateApiKeyShape(apiKey);
+
+  const lpUrl = assertValidUrl(normalizeUrl(args.url));
+  const endpoint = assertValidUrl(resolveEndpoint(args.endpoint || config.endpoint), "endpoint");
+
+  const response = await fetch(endpoint, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`,
+    },
+    body: JSON.stringify({
+      lpUrl,
+      responseMode: "compact",
+    }),
+  });
+
+  const rawText = await response.text();
+  let result;
+  try {
+    result = JSON.parse(rawText);
+  } catch {
+    throw new Error(`Non-JSON response from LandingBoost (${response.status}): ${rawText.slice(0, 500)}`);
+  }
+
+  if (!response.ok || result?.ok === false) {
+    const message = result?.error || result?.message || `LandingBoost API failed with ${response.status}`;
+    if (args.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.error(message);
+      if (result?.code) console.error(`Code: ${result.code}`);
+    }
+    process.exitCode = 1;
+    return;
+  }
+
+  if (args.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatText(result));
+  }
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.help || args.command === "help") {
+    printHelp();
+    return;
+  }
+
+  if (args.command === "login") return commandLogin(args);
+  if (args.command === "status") return commandStatus(args);
+  if (args.command === "logout") return commandLogout(args);
+  if (args.command === "scan") return commandScan(args);
+
+  printHelp();
+  process.exitCode = 1;
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "landingboost",
+  "version": "0.1.0",
+  "description": "LandingBoost command line scanner.",
+  "type": "module",
+  "bin": {
+    "landingboost": "bin/landingboost.mjs"
+  },
+  "files": [
+    "bin/landingboost.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED"
+}