indxel-cli 0.1.0 → 0.2.0

package/dist/bin.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 
 // src/commands/init.ts
 import { Command } from "commander";
 import chalk from "chalk";
 import ora from "ora";
-import { writeFile } from "fs/promises";
+import { existsSync as existsSync2 } from "fs";
+import { writeFile, mkdir, readFile as readFile2 } from "fs/promises";
 import { join as join2 } from "path";
 
 // src/detect.ts
@@ -175,7 +176,18 @@ export default function robots() {
 }
 
 // src/commands/init.ts
-var initCommand = new Command("init").description("Initialize indxel in your Next.js project").option("--cwd <path>", "Project directory", process.cwd()).option("--force", "Overwrite existing files", false).action(async (opts) => {
+var PRE_PUSH_HOOK = `#!/bin/sh
+# indxel SEO guard \u2014 blocks push if critical SEO errors are found
+echo "\\033[36m[indxel]\\033[0m Running SEO check before push..."
+npx indxel-cli check --ci
+if [ $? -ne 0 ]; then
+  echo ""
+  echo "\\033[31m[indxel] Push blocked \u2014 fix SEO errors first.\\033[0m"
+  echo "\\033[2m  Run 'npx indxel-cli check' for details.\\033[0m"
+  exit 1
+fi
+`;
+var initCommand = new Command("init").description("Initialize indxel in your Next.js project").option("--cwd <path>", "Project directory", process.cwd()).option("--force", "Overwrite existing files", false).option("--hook", "Install git pre-push hook to block pushes on SEO errors", false).action(async (opts) => {
   const cwd = opts.cwd;
   const spinner = ora("Detecting project...").start();
   const project = await detectProject(cwd);
@@ -218,6 +230,31 @@ var initCommand = new Command("init").description("Initialize indxel in your Nex
   } else {
     console.log(chalk.dim(`  - robots already exists (skip)`));
   }
+  const gitDir = join2(cwd, ".git");
+  const hasGit = existsSync2(gitDir);
+  if (opts.hook || opts.force) {
+    if (!hasGit) {
+      console.log(chalk.yellow("  \u26A0") + " No .git directory found \u2014 skip hook install");
+    } else {
+      const hooksDir = join2(gitDir, "hooks");
+      const hookPath = join2(hooksDir, "pre-push");
+      if (existsSync2(hookPath) && !opts.force) {
+        const existing = await readFile2(hookPath, "utf-8");
+        if (existing.includes("indxel")) {
+          console.log(chalk.dim("  - pre-push hook already installed (skip)"));
+        } else {
+          console.log(chalk.yellow("  \u26A0") + " pre-push hook already exists (use --force to overwrite)");
+        }
+      } else {
+        await mkdir(hooksDir, { recursive: true });
+        await writeFile(hookPath, PRE_PUSH_HOOK, { mode: 493 });
+        filesCreated.push(".git/hooks/pre-push");
+        console.log(chalk.green("  \u2713") + " Installed git pre-push hook");
+      }
+    }
+  } else if (hasGit) {
+    console.log(chalk.dim("  - Use --hook to install git pre-push guard"));
+  }
   console.log("");
   if (filesCreated.length > 0) {
     console.log(
@@ -231,6 +268,9 @@ var initCommand = new Command("init").description("Initialize indxel in your Nex
   console.log(chalk.dim("  Next steps:"));
   console.log(chalk.dim(`    1. Edit seo.config.${ext} with your site details`));
   console.log(chalk.dim("    2. Run ") + chalk.bold("npx indxel check") + chalk.dim(" to audit your pages"));
+  if (!opts.hook && hasGit) {
+    console.log(chalk.dim("    3. Run ") + chalk.bold("npx indxel init --hook") + chalk.dim(" to guard git pushes"));
+  }
   console.log("");
 });
 
@@ -241,7 +281,7 @@ import ora2 from "ora";
 import { validateMetadata } from "indxel";
 
 // src/scanner.ts
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 import { join as join3, dirname, sep } from "path";
 import { glob } from "glob";
 async function scanPages(projectRoot, appDir) {
@@ -253,7 +293,7 @@ async function scanPages(projectRoot, appDir) {
   const pages = [];
   for (const file of pageFiles) {
     const fullPath = join3(appDirFull, file);
-    const content = await readFile2(fullPath, "utf-8");
+    const content = await readFile3(fullPath, "utf-8");
     const route = filePathToRoute(file);
     const page = {
       filePath: join3(appDir, file),
@@ -273,7 +313,7 @@ async function scanPages(projectRoot, appDir) {
   });
   for (const file of layoutFiles) {
     const fullPath = join3(appDirFull, file);
-    const content = await readFile2(fullPath, "utf-8");
+    const content = await readFile3(fullPath, "utf-8");
     const route = filePathToRoute(file).replace(/\/layout$/, "") || "/";
     const hasMetadataExport = hasExport(content, "metadata") || hasExport(content, "generateMetadata");
     if (hasMetadataExport) {
@@ -551,15 +591,15 @@ function computeSummary(results) {
 }
 
 // src/store.ts
-import { existsSync as existsSync2 } from "fs";
-import { readFile as readFile3, writeFile as writeFile2, mkdir } from "fs/promises";
+import { existsSync as existsSync3 } from "fs";
+import { readFile as readFile4, writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
 import { join as join4 } from "path";
 var STORE_DIR = ".indxel";
 var LAST_CHECK_FILE = "last-check.json";
 async function saveCheckResult(cwd, summary) {
   const storeDir = join4(cwd, STORE_DIR);
-  if (!existsSync2(storeDir)) {
-    await mkdir(storeDir, { recursive: true });
+  if (!existsSync3(storeDir)) {
+    await mkdir2(storeDir, { recursive: true });
   }
   const stored = {
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -586,11 +626,11 @@ async function saveCheckResult(cwd, summary) {
 }
 async function loadPreviousCheck(cwd) {
   const filePath = join4(cwd, STORE_DIR, LAST_CHECK_FILE);
-  if (!existsSync2(filePath)) {
+  if (!existsSync3(filePath)) {
     return null;
   }
   try {
-    const data = await readFile3(filePath, "utf-8");
+    const data = await readFile4(filePath, "utf-8");
     return JSON.parse(data);
   } catch {
     return null;
@@ -1118,14 +1158,248 @@ var keywordsCommand = new Command4("keywords").description("Research keyword opp
   }
 });
 
+// src/commands/index.ts
+import { Command as Command5 } from "commander";
+import chalk6 from "chalk";
+import ora5 from "ora";
+import { fetchSitemap as fetchSitemap2, fetchRobots as fetchRobots2 } from "indxel";
+async function checkPlan(apiKey) {
+  try {
+    const apiUrl = process.env.INDXEL_API_URL || "https://www.indxel.com";
+    const res = await fetch(`${apiUrl}/api/cli/plan`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.plan ?? null;
+  } catch {
+    return null;
+  }
+}
+var indexCommand = new Command5("index").description("Submit your pages to search engines and check indexation status").argument("<url>", "Site URL (e.g., https://yoursite.com)").option("--check", "Check which pages appear indexed (Pro+)", false).option("--indexnow-key <key>", "IndexNow API key for Bing/Yandex/DuckDuckGo submission (Pro+)").option("--api-key <key>", "Indxel API key (required for --check and --indexnow-key)").option("--json", "Output results as JSON", false).action(async (url, opts) => {
+  const jsonOutput = opts.json;
+  const needsPaid = opts.check || opts.indexnowKey;
+  if (!url.startsWith("http://") && !url.startsWith("https://")) {
+    url = `https://${url}`;
+  }
+  let baseUrl;
+  try {
+    baseUrl = new URL(url);
+  } catch {
+    console.error(chalk6.red("  Invalid URL."));
+    process.exit(1);
+  }
+  const origin = baseUrl.origin;
+  const host = baseUrl.hostname;
+  if (!jsonOutput) {
+    console.log("");
+    console.log(chalk6.bold("  indxel index") + chalk6.dim(` \u2014 ${origin}`));
+    console.log("");
+  }
+  if (needsPaid) {
+    const apiKey = opts.apiKey || process.env.INDXEL_API_KEY;
+    if (!apiKey) {
+      if (!jsonOutput) {
+        console.log(chalk6.red("  \u2717 --check and --indexnow-key require an API key (Pro plan)."));
+        console.log(chalk6.dim("    Use --api-key or set INDXEL_API_KEY."));
+        console.log(chalk6.dim("    Get your key at https://indxel.com/dashboard/settings"));
+        console.log("");
+      }
+      process.exit(1);
+    }
+    const plan = await checkPlan(apiKey);
+    if (!plan) {
+      if (!jsonOutput) {
+        console.log(chalk6.red("  \u2717 Invalid API key."));
+        console.log("");
+      }
+      process.exit(1);
+    }
+    if (plan === "FREE") {
+      if (!jsonOutput) {
+        console.log(chalk6.red("  \u2717 IndexNow submission and indexation check require a Pro plan."));
+        console.log(chalk6.dim("    Upgrade at https://indxel.com/pricing"));
+        console.log("");
+      }
+      process.exit(1);
+    }
+  }
+  const sitemapSpinner = jsonOutput ? null : ora5("Fetching sitemap...").start();
+  const sitemapResult = await fetchSitemap2(origin);
+  const sitemapUrl = `${origin}/sitemap.xml`;
+  if (!sitemapResult.found || sitemapResult.urls.length === 0) {
+    if (sitemapSpinner) sitemapSpinner.fail("No sitemap found");
+    if (!jsonOutput) {
+      console.log(chalk6.dim("  Create a sitemap first: ") + chalk6.bold("npx indxel init"));
+      console.log("");
+    }
+    if (jsonOutput) {
+      console.log(JSON.stringify({ error: "No sitemap found" }, null, 2));
+    }
+    process.exit(1);
+  }
+  if (sitemapSpinner) sitemapSpinner.succeed(`Found sitemap \u2014 ${sitemapResult.urls.length} URLs`);
+  const robotsSpinner = jsonOutput ? null : ora5("Checking robots.txt...").start();
+  const robotsResult = await fetchRobots2(origin);
+  let sitemapInRobots = false;
+  if (robotsResult.found) {
+    sitemapInRobots = robotsResult.sitemapUrls.some(
+      (s) => s.toLowerCase().includes("sitemap")
+    );
+    if (sitemapInRobots) {
+      if (robotsSpinner) robotsSpinner.succeed("robots.txt references sitemap");
+    } else {
+      if (robotsSpinner) robotsSpinner.warn("robots.txt found but doesn't reference sitemap");
+      if (!jsonOutput) {
+        console.log(chalk6.dim(`  Add this to your robots.txt:`));
+        console.log(chalk6.dim(`  Sitemap: ${sitemapUrl}`));
+      }
+    }
+  } else {
+    if (robotsSpinner) robotsSpinner.warn("No robots.txt found");
+    if (!jsonOutput) {
+      console.log(chalk6.dim("  Create one with: ") + chalk6.bold("npx indxel init"));
+    }
+  }
+  if (!jsonOutput) console.log("");
+  const indexNowKey = opts.indexnowKey || process.env.INDEXNOW_KEY;
+  let indexNowResult = [];
+  if (indexNowKey) {
+    const urls = sitemapResult.urls.map((u) => u.loc);
+    const indexNowSpinner = jsonOutput ? null : ora5("Submitting via IndexNow...").start();
+    const indexNowEngines = [
+      { name: "Bing/Yandex", endpoint: "https://api.indexnow.org/indexnow" }
+    ];
+    for (const engine of indexNowEngines) {
+      try {
+        const res = await fetch(engine.endpoint, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            host,
+            key: indexNowKey,
+            keyLocation: `${origin}/${indexNowKey}.txt`,
+            urlList: urls.slice(0, 1e4)
+            // IndexNow limit
+          }),
+          signal: AbortSignal.timeout(15e3)
+        });
+        if (res.ok || res.status === 200 || res.status === 202) {
+          indexNowResult.push({ submitted: true, engine: engine.name, status: res.status });
+          if (indexNowSpinner) indexNowSpinner.succeed(`IndexNow \u2014 ${urls.length} URLs submitted to ${engine.name}`);
+        } else {
+          indexNowResult.push({ submitted: false, engine: engine.name, status: res.status });
+          if (indexNowSpinner) indexNowSpinner.warn(`IndexNow \u2014 ${engine.name} returned HTTP ${res.status}`);
+        }
+      } catch (err) {
+        indexNowResult.push({ submitted: false, engine: engine.name });
+        if (indexNowSpinner) indexNowSpinner.fail(`IndexNow \u2014 ${err instanceof Error ? err.message : "failed"}`);
+      }
+    }
+  } else {
+    if (!jsonOutput) {
+      console.log(chalk6.bold("  IndexNow") + chalk6.dim(" (Bing, Yandex, DuckDuckGo)"));
+      console.log(chalk6.dim("  Get instant indexing by setting up IndexNow:"));
+      console.log(chalk6.dim("    1. Generate a key at ") + chalk6.underline("https://www.bing.com/indexnow"));
+      console.log(chalk6.dim(`    2. Host the key file at ${origin}/{key}.txt`));
+      console.log(chalk6.dim("    3. Run: ") + chalk6.bold(`npx indxel index ${host} --indexnow-key YOUR_KEY`));
+      console.log("");
+    }
+  }
+  if (!jsonOutput) {
+    console.log(chalk6.bold("  Google Search Console"));
+    console.log(chalk6.dim("  Google requires manual setup via Search Console:"));
+    console.log(chalk6.dim("    1. Go to ") + chalk6.underline("https://search.google.com/search-console"));
+    console.log(chalk6.dim(`    2. Add & verify ${host}`));
+    console.log(chalk6.dim("    3. Submit your sitemap: Sitemaps > Add > sitemap.xml"));
+    console.log("");
+  }
+  let indexationResults = null;
+  if (opts.check) {
+    const checkSpinner = jsonOutput ? null : ora5("Checking indexation status...").start();
+    indexationResults = [];
+    const urls = sitemapResult.urls.map((u) => u.loc);
+    let indexedCount = 0;
+    for (let i = 0; i < urls.length; i++) {
+      const pageUrl = urls[i];
+      if (checkSpinner) {
+        checkSpinner.text = `Checking indexation... ${i + 1}/${urls.length}`;
+      }
+      try {
+        const cacheUrl = `https://webcache.googleusercontent.com/search?q=cache:${encodeURIComponent(pageUrl)}`;
+        const res = await fetch(cacheUrl, {
+          method: "HEAD",
+          signal: AbortSignal.timeout(5e3),
+          redirect: "manual",
+          headers: {
+            "User-Agent": "Mozilla/5.0 (compatible; Indxel/0.1; +https://indxel.com)"
+          }
+        });
+        const indexed = res.status === 200 || res.status === 301 || res.status === 302;
+        indexationResults.push({ url: pageUrl, indexed });
+        if (indexed) indexedCount++;
+      } catch {
+        indexationResults.push({ url: pageUrl, indexed: false });
+      }
+      await new Promise((r) => setTimeout(r, 300));
+    }
+    if (checkSpinner) {
+      checkSpinner.succeed(`Indexation: ${indexedCount}/${urls.length} pages found in Google cache`);
+    }
+    if (!jsonOutput) {
+      console.log("");
+      const notIndexed = indexationResults.filter((r) => !r.indexed);
+      if (notIndexed.length > 0) {
+        console.log(chalk6.bold(`  Not indexed (${notIndexed.length})`));
+        for (const r of notIndexed.slice(0, 20)) {
+          console.log(chalk6.red("  \u2717 ") + r.url);
+        }
+        if (notIndexed.length > 20) console.log(chalk6.dim(`  ... and ${notIndexed.length - 20} more`));
+        console.log("");
+      }
+      if (notIndexed.length === 0) {
+        console.log(chalk6.green("  \u2713 All pages appear indexed"));
+        console.log("");
+      }
+    }
+  }
+  if (jsonOutput) {
+    console.log(JSON.stringify({
+      sitemap: { url: sitemapUrl, urls: sitemapResult.urls.length },
+      robotsTxt: { found: robotsResult.found, referencesSitemap: sitemapInRobots },
+      indexNow: indexNowResult.length > 0 ? indexNowResult : null,
+      indexation: indexationResults
+    }, null, 2));
+  } else {
+    console.log(chalk6.bold("  \u2500\u2500\u2500 Summary \u2500\u2500\u2500"));
+    console.log("");
+    console.log(`  Sitemap:        ${sitemapResult.urls.length} URLs`);
+    console.log(`  robots.txt:     ${robotsResult.found ? sitemapInRobots ? chalk6.green("\u2713 references sitemap") : chalk6.yellow("\u26A0 missing sitemap ref") : chalk6.red("\u2717 not found")}`);
+    if (indexNowResult.length > 0) {
+      for (const r of indexNowResult) {
+        console.log(`  IndexNow:       ${r.submitted ? chalk6.green("\u2713 submitted") : chalk6.red("\u2717 failed")} (${r.engine})`);
+      }
+    } else {
+      console.log(`  IndexNow:       ${chalk6.dim("not configured (use --indexnow-key)")}`);
+    }
+    if (indexationResults) {
+      const indexedCount = indexationResults.filter((r) => r.indexed).length;
+      console.log(`  Google cache:   ${indexedCount}/${indexationResults.length} indexed`);
+    }
+    console.log("");
+  }
+});
+
 // src/index.ts
 function createProgram() {
-  const program2 = new Command5();
+  const program2 = new Command6();
   program2.name("indxel").description("Infrastructure SEO developer-first. ESLint pour le SEO.").version("0.1.0");
   program2.addCommand(initCommand);
   program2.addCommand(checkCommand);
   program2.addCommand(crawlCommand);
   program2.addCommand(keywordsCommand);
+  program2.addCommand(indexCommand);
   return program2;
 }