@pagebridge/cli 0.0.2 → 0.1.1

package/dist/commands/init.js

@@ -0,0 +1,182 @@
+import { Command } from "commander";
+import { createClient as createSanityClient } from "@sanity/client";
+import { GSCClient } from "@pagebridge/core";
+import { createDb, sql } from "@pagebridge/db";
+import { log } from "../logger.js";
+import { existsSync, writeFileSync } from "fs";
+import { resolve as resolvePath } from "path";
+import * as readline from "readline/promises";
+import { stdin as input, stdout as output } from "process";
+const rl = readline.createInterface({ input, output });
+async function prompt(question, defaultValue) {
+    const displayQuestion = defaultValue
+        ? `${question} (${defaultValue}): `
+        : `${question}: `;
+    const answer = await rl.question(displayQuestion);
+    return answer.trim() || defaultValue || "";
+}
+async function confirmPrompt(question, defaultYes = true) {
+    const suffix = defaultYes ? " (Y/n): " : " (y/N): ";
+    const answer = await rl.question(question + suffix);
+    const normalized = answer.trim().toLowerCase();
+    if (!normalized)
+        return defaultYes;
+    return normalized === "y" || normalized === "yes";
+}
+export const initCommand = new Command("init")
+    .description("Interactive setup wizard for PageBridge")
+    .option("--skip-db-check", "Skip database connection test")
+    .option("--skip-sanity-check", "Skip Sanity API test")
+    .option("--skip-gsc-check", "Skip Google Search Console API test")
+    .action(async (options) => {
+    log.info("🚀 PageBridge Interactive Setup\n");
+    const envPath = resolvePath(process.cwd(), ".env");
+    // Check if .env already exists
+    if (existsSync(envPath)) {
+        const overwrite = await confirmPrompt(".env file already exists. Do you want to overwrite it?", false);
+        if (!overwrite) {
+            log.info("Skipping .env creation. Exiting...");
+            rl.close();
+            return;
+        }
+    }
+    log.info("Let's configure your environment variables.\n");
+    // Database URL
+    log.info("📦 Database Configuration");
+    const dbUrl = await prompt("PostgreSQL connection string", "postgresql://postgres:postgres@localhost:5432/gsc_sanity");
+    if (!options.skipDbCheck && dbUrl) {
+        try {
+            log.info("Testing database connection...");
+            const { db, close } = createDb(dbUrl);
+            await db.execute(sql `SELECT 1`);
+            await close();
+            log.info("✅ Database connection successful\n");
+        }
+        catch (error) {
+            log.error(`❌ Database connection failed: ${error instanceof Error ? error.message : String(error)}`);
+            log.warn("You can continue anyway, but you'll need to fix this before syncing.\n");
+        }
+    }
+    // Sanity Configuration
+    log.info("🎨 Sanity Configuration");
+    const sanityProjectId = await prompt("Sanity Project ID");
+    const sanityDataset = await prompt("Sanity Dataset", "production");
+    const sanityToken = await prompt("Sanity API Token (with Editor permissions)");
+    if (!options.skipSanityCheck && sanityProjectId && sanityToken) {
+        try {
+            log.info("Testing Sanity API connection...");
+            const sanity = createSanityClient({
+                projectId: sanityProjectId,
+                dataset: sanityDataset,
+                token: sanityToken,
+                apiVersion: "2024-01-01",
+                useCdn: false,
+            });
+            await sanity.fetch('*[_type == "gscSite"][0]{ _id }');
+            log.info("✅ Sanity connection successful\n");
+        }
+        catch (error) {
+            log.error(`❌ Sanity connection failed: ${error instanceof Error ? error.message : String(error)}`);
+            log.warn("Check your project ID, dataset, and token permissions.\n");
+        }
+    }
+    // Google Service Account
+    log.info("🔐 Google Search Console Configuration");
+    log.info("You need a Google Cloud service account with Search Console API access.");
+    log.info('Paste the entire service account JSON (it should start with {"type":"service_account"...):\n');
+    const googleServiceAccount = await prompt("Google Service Account JSON");
+    // Validate JSON
+    let credentials = null;
+    try {
+        credentials = JSON.parse(googleServiceAccount);
+        if (!credentials) {
+            throw new Error("Parsed credentials is null");
+        }
+        log.info(`✅ Valid JSON for service account: ${credentials.client_email}\n`);
+    }
+    catch {
+        log.error("❌ Invalid JSON format for service account");
+        log.warn("You'll need to fix this in .env before syncing.\n");
+    }
+    // Test GSC API
+    if (!options.skipGscCheck && credentials) {
+        try {
+            log.info("Testing Google Search Console API access...");
+            const gsc = new GSCClient({ credentials });
+            const sites = await gsc.listSites();
+            log.info(`✅ GSC API access successful. Found ${sites.length} sites:`);
+            sites.forEach((site) => log.info(`   - ${site}`));
+            log.info("");
+        }
+        catch (error) {
+            log.error(`❌ GSC API access failed: ${error instanceof Error ? error.message : String(error)}`);
+            log.warn("Make sure the service account has access to your Search Console properties.\n");
+        }
+    }
+    // Site URL
+    log.info("🌐 Site Configuration");
+    const siteUrl = await prompt("Your website base URL (e.g., https://example.com)");
+    // Write .env file
+    const envContent = `# PageBridge Environment Variables
+# Generated by 'pagebridge init' on ${new Date().toISOString()}
+# Uses PAGEBRIDGE_ prefix to avoid conflicts with your project's env vars.
+
+# Google Service Account JSON (stringified)
+PAGEBRIDGE_GOOGLE_SERVICE_ACCOUNT='${googleServiceAccount}'
+
+# PostgreSQL connection string
+PAGEBRIDGE_DATABASE_URL='${dbUrl}'
+
+# Sanity Studio configuration
+PAGEBRIDGE_SANITY_PROJECT_ID='${sanityProjectId}'
+PAGEBRIDGE_SANITY_DATASET='${sanityDataset}'
+PAGEBRIDGE_SANITY_TOKEN='${sanityToken}'
+
+# Your site URL
+PAGEBRIDGE_SITE_URL='${siteUrl}'
+`;
+    writeFileSync(envPath, envContent, "utf-8");
+    log.info("✅ .env file created successfully!\n");
+    // Offer to run migrations
+    const runMigrations = await confirmPrompt("Would you like to run database migrations now?", true);
+    if (runMigrations && dbUrl) {
+        log.info("Running database migrations...");
+        try {
+            // Import migrate function
+            const { migrateIfRequested } = await import("../migrate.js");
+            await migrateIfRequested(true, dbUrl);
+            log.info("✅ Migrations completed\n");
+        }
+        catch (error) {
+            log.error(`❌ Migration failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+    // Offer to run first sync
+    if (credentials) {
+        const runSync = await confirmPrompt("Would you like to run your first sync now?", false);
+        if (runSync) {
+            const sites = await new GSCClient({ credentials }).listSites();
+            if (sites.length === 0) {
+                log.warn("No sites found in your Search Console account.");
+            }
+            else if (sites.length === 1) {
+                log.info(`\nUsing site: ${sites[0]}`);
+                // Note: You'd import and call the sync command here
+                log.info(`Run: pagebridge sync --site "${sites[0]}" --migrate`);
+            }
+            else {
+                log.info("\nAvailable sites:");
+                sites.forEach((site, i) => log.info(`  ${i + 1}. ${site}`));
+                const siteChoice = await prompt("\nEnter site number or full URL");
+                const selectedSite = sites[parseInt(siteChoice) - 1] || siteChoice;
+                log.info(`\nRun: pagebridge sync --site "${selectedSite}" --migrate`);
+            }
+        }
+    }
+    log.info("\n🎉 Setup complete!");
+    log.info("\nNext steps:");
+    log.info("  1. Review your .env file");
+    log.info("  2. Run: pagebridge sync --site <your-site-url> --migrate");
+    log.info("  3. Open Sanity Studio to see your performance data\n");
+    rl.close();
+});

package/dist/index.js

@@ -1,12 +1,16 @@
 #!/usr/bin/env node
 import { program } from "commander";
+import { initCommand } from "./commands/init.js";
+import { doctorCommand } from "./commands/doctor.js";
 import { syncCommand } from "./commands/sync.js";
 import { listSitesCommand } from "./commands/list-sites.js";
 import { diagnoseCommand } from "./commands/diagnose.js";
 program
     .name("pagebridge")
     .description("PageBridge - Connect Google Search Console to Sanity CMS")
-    .version("0.0.1");
+    .version("0.0.2");
+program.addCommand(initCommand);
+program.addCommand(doctorCommand);
 program.addCommand(syncCommand);
 program.addCommand(listSitesCommand);
 program.addCommand(diagnoseCommand);

package/dist/resolve-config.d.ts

@@ -1,5 +1,8 @@
 /**
- * Resolves a config value from a CLI option first, then env var fallback.
+ * Resolves a config value from:
+ *  1. CLI option (highest priority)
+ *  2. PAGEBRIDGE_ prefixed env var (e.g. PAGEBRIDGE_DATABASE_URL)
+ *  3. Unprefixed env var fallback (e.g. DATABASE_URL)
  */
 export declare function resolve(optionValue: string | undefined, envVarName: string): string | undefined;
 interface ConfigEntry {

package/dist/resolve-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../src/resolve-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,OAAO,CACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAEpB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAU1D"}
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../src/resolve-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAMpB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAY1D"}

package/dist/resolve-config.js

@@ -1,8 +1,13 @@
 /**
- * Resolves a config value from a CLI option first, then env var fallback.
+ * Resolves a config value from:
+ *  1. CLI option (highest priority)
+ *  2. PAGEBRIDGE_ prefixed env var (e.g. PAGEBRIDGE_DATABASE_URL)
+ *  3. Unprefixed env var fallback (e.g. DATABASE_URL)
  */
 export function resolve(optionValue, envVarName) {
-    return optionValue ?? process.env[envVarName];
+    return (optionValue ??
+        process.env[`PAGEBRIDGE_${envVarName}`] ??
+        process.env[envVarName]);
 }
 /**
  * Validates that all required config entries have values.
@@ -15,7 +20,7 @@ export function requireConfig(entries) {
     console.error("Error: Missing required configuration.\n");
     for (const entry of missing) {
         console.error(`  ${entry.name}`);
-        console.error(`    ${entry.flag}  or  ${entry.envVar} env var\n`);
+        console.error(`    ${entry.flag}  or  PAGEBRIDGE_${entry.envVar} / ${entry.envVar} env var\n`);
     }
     process.exit(1);
 }

package/package.json

@@ -1,24 +1,42 @@
 {
   "name": "@pagebridge/cli",
-  "version": "0.0.2",
+  "version": "0.1.1",
+  "description": "CLI for PageBridge — sync Google Search Console data, detect content decay, and generate refresh tasks",
   "private": false,
   "license": "MIT",
   "type": "module",
+  "keywords": [
+    "pagebridge",
+    "cli",
+    "google-search-console",
+    "gsc",
+    "seo",
+    "content-decay",
+    "sanity",
+    "search-analytics",
+    "content-refresh",
+    "decay-detection"
+  ],
   "bin": {
     "pagebridge": "./dist/index.js"
   },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
   "dependencies": {
     "@sanity/client": "^7.14.1",
     "commander": "^14.0.3",
-    "@pagebridge/db": "^0.0.2",
-    "@pagebridge/core": "^0.0.1"
+    "@pagebridge/core": "^0.0.3",
+    "@pagebridge/db": "^0.0.3"
   },
   "devDependencies": {
     "@types/node": "^22.15.3",
     "eslint": "^9.39.1",
     "typescript": "^5.9.3",
-    "@pagebridge/typescript-config": "^0.0.0",
-    "@pagebridge/eslint-config": "^0.0.0"
+    "@pagebridge/eslint-config": "^0.0.0",
+    "@pagebridge/typescript-config": "^0.0.0"
   },
   "scripts": {
     "build": "tsc",

package/.turbo/turbo-build.log

@@ -1,2 +0,0 @@
-[?9001h[?1004h[?25l> @pagebridge/cli@0.0.1 build F:\Code\pagebridge\oss\apps\cli
-> tsc]0;C:\WINDOWS\system32\cmd.exe[?25h[?9001l[?1004l

package/.turbo/turbo-check-types.log

@@ -1,4 +0,0 @@
-
-> @pagebridge/cli@0.0.1 check-types F:\Code\pagebridge\oss\apps\cli
-> tsc --noEmit
-

package/eslint.config.js

@@ -1,3 +0,0 @@
-import { config } from "@pagebridge/eslint-config/base";
-
-export default [...config];

package/src/commands/diagnose.ts

@@ -1,149 +0,0 @@
-import { Command } from "commander";
-import {
-  createDb,
-  unmatchDiagnostics,
-  eq,
-  desc,
-} from "@pagebridge/db";
-import { resolve, requireConfig } from "../resolve-config.js";
-import { log } from "../logger.js";
-import { migrateIfRequested } from "../migrate.js";
-
-export const diagnoseCommand = new Command("diagnose")
-  .description("View diagnostics for unmatched URLs")
-  .requiredOption("--site <url>", "GSC site URL (e.g., sc-domain:example.com)")
-  .option("--reason <reason>", "Filter by unmatch reason")
-  .option("--limit <n>", "Limit number of results", "20")
-  .option("--json", "Output as JSON")
-  .option("--migrate", "Run database migrations before querying")
-  .option("--db-url <url>", "PostgreSQL connection string")
-  .action(async (options) => {
-    const dbUrl = resolve(options.dbUrl, "DATABASE_URL");
-
-    requireConfig([
-      { name: "DATABASE_URL", flag: "--db-url <url>", envVar: "DATABASE_URL", value: dbUrl },
-    ]);
-
-    // Run migrations if requested
-    await migrateIfRequested(!!options.migrate, dbUrl!);
-
-    const { db, close } = createDb(dbUrl!);
-
-    // Register shutdown handlers
-    const shutdown = async () => {
-      log.warn("Received shutdown signal, closing connections...");
-      await close();
-      process.exit(130);
-    };
-    process.on("SIGTERM", shutdown);
-    process.on("SIGINT", shutdown);
-
-    try {
-      const query = db
-        .select()
-        .from(unmatchDiagnostics)
-        .where(eq(unmatchDiagnostics.siteId, options.site))
-        .orderBy(desc(unmatchDiagnostics.lastSeenAt))
-        .limit(parseInt(options.limit));
-
-      const results = await query;
-
-      if (options.json) {
-        console.log(JSON.stringify(results, null, 2));
-        return;
-      }
-
-      if (results.length === 0) {
-        log.info(`No unmatched URLs found for ${options.site}`);
-        log.info(
-          `Run 'sync --site ${options.site}' first to generate diagnostics.`,
-        );
-        return;
-      }
-
-      // Group by reason
-      const byReason = new Map<string, typeof results>();
-      for (const r of results) {
-        const existing = byReason.get(r.unmatchReason) ?? [];
-        existing.push(r);
-        byReason.set(r.unmatchReason, existing);
-      }
-
-      log.info(`\nUnmatched URL Diagnostics for ${options.site}\n`);
-      log.info(`Total: ${results.length} unmatched URLs\n`);
-
-      for (const [reason, items] of byReason) {
-        log.info(
-          `${getReasonEmoji(reason)} ${getReasonDescription(reason)} (${items.length}):`,
-        );
-
-        for (const item of items) {
-          log.info(`  ${item.gscUrl}`);
-          if (item.extractedSlug) {
-            log.info(`    Extracted slug: "${item.extractedSlug}"`);
-          }
-          if (item.similarSlugs) {
-            try {
-              const similar = JSON.parse(item.similarSlugs) as string[];
-              if (similar.length > 0) {
-                log.info(`    Similar slugs in Sanity:`);
-                for (const s of similar) {
-                  log.info(`      - ${s}`);
-                }
-              }
-            } catch {
-              // Ignore parse errors
-            }
-          }
-        }
-      }
-
-      log.info(`\nTo fix unmatched URLs:`);
-      log.info(
-        `  1. Check if the Sanity document exists with the correct slug`,
-      );
-      log.info(`  2. Verify the document type is in the contentTypes list`);
-      log.info(`  3. Ensure the slug field name matches your configuration`);
-      log.info(
-        `  4. If using a path prefix, verify it matches your URL structure`,
-      );
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      log.error(`Diagnose failed: ${message}`);
-      process.exitCode = 1;
-    } finally {
-      await close();
-      process.removeListener("SIGTERM", shutdown);
-      process.removeListener("SIGINT", shutdown);
-    }
-  });
-
-function getReasonEmoji(reason: string): string {
-  switch (reason) {
-    case "matched":
-      return "[OK]";
-    case "no_slug_extracted":
-      return "[SLUG]";
-    case "no_matching_document":
-      return "[DOC]";
-    case "outside_path_prefix":
-      return "[PREFIX]";
-    default:
-      return "[?]";
-  }
-}
-
-function getReasonDescription(reason: string): string {
-  switch (reason) {
-    case "matched":
-      return "Successfully matched";
-    case "no_slug_extracted":
-      return "Could not extract slug from URL";
-    case "no_matching_document":
-      return "No Sanity document with matching slug";
-    case "outside_path_prefix":
-      return "URL outside configured path prefix";
-    default:
-      return `Unknown reason: ${reason}`;
-  }
-}

package/src/commands/list-sites.ts

@@ -1,51 +0,0 @@
-import { Command } from "commander";
-import { GSCClient } from "@pagebridge/core";
-import { resolve, requireConfig } from "../resolve-config.js";
-import { log } from "../logger.js";
-
-export const listSitesCommand = new Command("list-sites")
-  .description("List all sites the service account has access to")
-  .option("--google-service-account <json>", "Google service account JSON")
-  .action(async (options) => {
-    const googleServiceAccount = resolve(options.googleServiceAccount, "GOOGLE_SERVICE_ACCOUNT");
-
-    requireConfig([
-      { name: "GOOGLE_SERVICE_ACCOUNT", flag: "--google-service-account <json>", envVar: "GOOGLE_SERVICE_ACCOUNT", value: googleServiceAccount },
-    ]);
-
-    let credentials;
-    try {
-      credentials = JSON.parse(googleServiceAccount!);
-    } catch {
-      log.error("Failed to parse GOOGLE_SERVICE_ACCOUNT as JSON");
-      process.exit(1);
-    }
-
-    log.info(`Using service account: ${credentials.client_email}`);
-
-    const gsc = new GSCClient({ credentials });
-
-    try {
-      const sites = await gsc.listSites();
-
-      if (sites.length === 0) {
-        log.warn("No sites found. The service account has no access to any GSC properties.");
-        log.info("\nTo fix this:");
-        log.info(
-          "1. Go to Google Search Console > Settings > Users and permissions",
-        );
-        log.info(`2. Add user: ${credentials.client_email}`);
-        log.info("3. Set permission level to 'Full'");
-      } else {
-        log.info(`Found ${sites.length} site(s):\n`);
-        sites.forEach((site) => log.info(`   ${site}`));
-        log.info(
-          '\nUse one of these exact values with: pnpm sync --site "<value>"',
-        );
-      }
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      log.error(`Failed to list sites: ${message}`);
-      process.exit(1);
-    }
-  });