@gscdump/cli 0.40.2 → 1.0.0

package/README.md

@@ -4,7 +4,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/@gscdump/cli?color=yellow)](https://npm.chart.dev/@gscdump/cli)
 [![license](https://img.shields.io/github/license/harlan-zw/gscdump?color=yellow)](https://github.com/harlan-zw/gscdump/blob/main/LICENSE)
 
-> CLI for Google Search Console — sync to a local DuckDB/Parquet store, run typed queries, execute 21 SEO analyzers, and serve an MCP endpoint for AI assistants.
+> CLI for Google Search Console — sync to a local DuckDB/Parquet store, run typed queries, execute 29 SEO analyzers, and serve an MCP endpoint for AI assistants.
 
 ## Install
 

package/dist/_chunks/auth.mjs

@@ -7,7 +7,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { isCancel, text } from "@clack/prompts";
 import { err, ok, unwrapResult } from "gscdump/result";
-import { createAuth } from "gscdump/api";
+import { createAuth } from "gscdump";
 import { createServer } from "node:http";
 import { JWT, OAuth2Client } from "google-auth-library";
 import { ofetch } from "ofetch";

package/dist/_chunks/auth2.mjs

@@ -6,7 +6,7 @@ import { runSmokeTest } from "./init.mjs";
 import process from "node:process";
 import { defineCommand } from "citty";
 import path from "node:path";
-import { hasGscWriteScope, hasIndexingScope } from "gscdump/api";
+import { hasGscWriteScope, hasIndexingScope } from "gscdump";
 import { ofetch } from "ofetch";
 const AUTH_SUBCOMMANDS = [
 	"status",

package/dist/_chunks/context.mjs

@@ -3,7 +3,7 @@ import { logger } from "./utils.mjs";
 import { resolveAuth } from "./auth.mjs";
 import process from "node:process";
 import { cancel, isCancel, select } from "@clack/prompts";
-import { googleSearchConsole } from "gscdump/api";
+import { googleSearchConsole } from "gscdump";
 import { createNodeHarness } from "@gscdump/engine/node";
 import { TABLE_DIMS, transformGscRow } from "@gscdump/engine/ingest";
 import { allTables, inferTable } from "@gscdump/engine/schema";

package/dist/_chunks/doctor.mjs

@@ -8,7 +8,7 @@ import process from "node:process";
 import { defineCommand } from "citty";
 import fs from "node:fs/promises";
 import path from "node:path";
-import { googleSearchConsole, hasGscWriteScope, hasIndexingScope } from "gscdump/api";
+import { googleSearchConsole, hasGscWriteScope, hasIndexingScope } from "gscdump";
 import { ofetch } from "ofetch";
 const REQUIRED_SCOPES = [
 	"https://www.googleapis.com/auth/webmasters",

package/dist/_chunks/entities.mjs

@@ -1,11 +1,10 @@
-import { OUTPUT_ARGS, applyOutputMode, logger, runWithConcurrency } from "./utils.mjs";
+import { OUTPUT_ARGS, applyOutputMode, logger, progressBar, runWithConcurrency } from "./utils.mjs";
 import { createCommandContext } from "./context.mjs";
 import process from "node:process";
 import { defineCommand } from "citty";
 import { readFile } from "node:fs/promises";
 import { Buffer } from "node:buffer";
 import { createIndexingMetadataStore, createInspectionStore, createSitemapStore } from "@gscdump/engine/entities";
-import { progressBar } from "gscdump";
 const INSPECTION_QPD_PER_PROPERTY = 2e3;
 const INDEXING_NOT_FOUND_RE = /\b404\b|NOT_FOUND/i;
 const INSPECTION_HISTORY_LOOKBACK_MONTHS = 24;

package/dist/_chunks/error-handler.mjs

@@ -1,9 +1,28 @@
 import { formatAuthProvenance, isAuthError } from "./auth.mjs";
 import process from "node:process";
 import { isQueryError } from "gscdump/query";
-import { formatErrorForCli } from "gscdump/api";
+import { classifyError } from "gscdump";
 import { isAnalysisError } from "@gscdump/analysis/errors";
 import { isEngineError } from "@gscdump/engine/errors";
+const QUOTA_MESSAGE_RE = /quota|rate\s*limit/i;
+function formatErrorForCli(cause) {
+	const error = classifyError(cause);
+	const lines = [`\x1B[31m${error.message}\x1B[0m`];
+	let suggestion = "";
+	switch (error.kind) {
+		case "auth-expired":
+			suggestion = "Run `gscdump auth` to re-authenticate.";
+			break;
+		case "rate-limited": {
+			const retryIn = error.retryAfter ? `${error.retryAfter}s` : "a few minutes";
+			if (QUOTA_MESSAGE_RE.test(error.message)) suggestion = error.message.includes("Indexing API") ? "Indexing API quota exhausted (~200/day). Try again tomorrow." : `Quota or rate limit hit (Search Analytics ~25000/day). Try again in ${retryIn}.`;
+			else suggestion = `Rate limited. Slow down requests. Try again in ${retryIn}.`;
+			break;
+		}
+	}
+	if (suggestion) lines.push("", suggestion);
+	return lines.join("\n");
+}
 function extractQueryError(error) {
 	if (isQueryError(error)) return error;
 	const tagged = error.queryError;

package/dist/_chunks/indexing.mjs

@@ -3,7 +3,7 @@ import { createCommandContext } from "./context.mjs";
 import { gscErrorHandler } from "./error-handler.mjs";
 import process from "node:process";
 import { defineCommand } from "citty";
-import { batchRequestIndexing, fetchSitemapUrls, getIndexingMetadata, requestIndexing, runSequentialBatch } from "gscdump/api";
+import { batchRequestIndexing, fetchSitemapUrls, getIndexingMetadata, requestIndexing, runSequentialBatch } from "gscdump";
 const RETRIES_ARG = { retries: {
 	type: "string",
 	description: "Override per-call retry count (default: 3)"

package/dist/_chunks/init.mjs

@@ -7,7 +7,7 @@ import { defineCommand } from "citty";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { confirm, isCancel, text } from "@clack/prompts";
-import { googleSearchConsole } from "gscdump/api";
+import { googleSearchConsole } from "gscdump";
 const ENV_LINE_RE = /^([^=]+)=(.*)$/;
 async function promptDataDir(existing) {
 	const fallback = existing ?? defaultDataDir();

package/dist/_chunks/inspect.mjs

@@ -3,7 +3,7 @@ import { createCommandContext } from "./context.mjs";
 import { gscErrorHandler } from "./error-handler.mjs";
 import process from "node:process";
 import { defineCommand } from "citty";
-import { batchInspectUrls, fetchSitemapUrls } from "gscdump/api";
+import { batchInspectUrls, fetchSitemapUrls } from "gscdump";
 function verdictTone(verdict) {
 	if (verdict === "PASS") return "\x1B[32m";
 	if (verdict === "NEUTRAL" || verdict === "PARTIAL") return "\x1B[33m";

package/dist/_chunks/mcp.mjs

@@ -7,7 +7,7 @@ import { isQueryError } from "gscdump/query";
 import { defaultAnalyzerRegistry } from "@gscdump/analysis/registry";
 import { createGscApiQuerySource } from "@gscdump/engine-gsc-api";
 import { err, ok, unwrapResult } from "gscdump/result";
-import { addSite, batchInspectUrls, batchRequestIndexing, deleteSite, discoverSitemap, fetchSitemap, fetchSitesWithSitemaps, getIndexingMetadata, getVerificationToken, getVerifiedSite, googleSearchConsole, hasGscWriteScope, hasIndexingScope, listVerifiedSites, requestIndexing, runSequentialBatch, unverifySite, verifySite } from "gscdump/api";
+import { addSite, batchInspectUrls, batchRequestIndexing, deleteSite, discoverSitemap, fetchSitemap, fetchSitesWithSitemaps, getIndexingMetadata, getVerificationToken, getVerifiedSite, googleSearchConsole, hasGscWriteScope, hasIndexingScope, listVerifiedSites, requestIndexing, runSequentialBatch, unverifySite, verifySite } from "gscdump";
 import { ofetch } from "ofetch";
 import { isAnalysisError } from "@gscdump/analysis/errors";
 import { isEngineError } from "@gscdump/engine/errors";
@@ -417,7 +417,7 @@ async function runMcpSearchAnalyticsQuery(client, args) {
 		const remaining = totalLimit - allRows.length;
 		const currentLimit = Math.min(pageSize, remaining);
 		if (currentLimit <= 0) break;
-		const rows = ((await client._rawQuery(args.siteUrl, {
+		const rows = ((await client.searchAnalytics.query(args.siteUrl, {
 			startDate: args.startDate,
 			endDate: args.endDate,
 			dimensions: args.dimensions,

package/dist/_chunks/query.mjs

@@ -92,7 +92,7 @@ async function runLiveQuery(client, siteUrl, opts) {
 		const remaining = totalLimit - allRows.length;
 		const rowLimit = Math.min(pageSize, remaining);
 		if (rowLimit <= 0) break;
-		const rows = ((await client._rawQuery(siteUrl, {
+		const rows = ((await client.searchAnalytics.query(siteUrl, {
 			...baseBody,
 			rowLimit,
 			startRow

package/dist/_chunks/sitemaps.mjs

@@ -3,7 +3,7 @@ import { createCommandContext } from "./context.mjs";
 import { gscErrorHandler } from "./error-handler.mjs";
 import process from "node:process";
 import { defineCommand } from "citty";
-import { discoverSitemap, fetchSitemap, fetchSitemapUrls } from "gscdump/api";
+import { discoverSitemap, fetchSitemap, fetchSitemapUrls } from "gscdump";
 const listCommand = defineCommand({
 	meta: {
 		name: "list",

package/dist/_chunks/sites.mjs

@@ -4,7 +4,7 @@ import { gscErrorHandler } from "./error-handler.mjs";
 import process from "node:process";
 import { defineCommand } from "citty";
 import { confirm, isCancel } from "@clack/prompts";
-import { addSite, deleteSite, fetchSitesWithSitemaps, getVerificationToken, getVerifiedSite, listVerifiedSites, siteUrlToVerificationSite, unverifySite, verificationMethodsFor, verifySite } from "gscdump/api";
+import { addSite, deleteSite, fetchSitesWithSitemaps, getVerificationToken, getVerifiedSite, listVerifiedSites, siteUrlToVerificationSite, unverifySite, verificationMethodsFor, verifySite } from "gscdump";
 const ALL_METHODS = [
 	"META",
 	"FILE",

package/dist/_chunks/sync.mjs

@@ -1,10 +1,9 @@
-import { OUTPUT_ARGS, applyOutputMode, clearLine, displayPath, formatAge, logger, runWithConcurrency } from "./utils.mjs";
+import { OUTPUT_ARGS, applyOutputMode, clearLine, displayPath, formatAge, logger, progressBar, runWithConcurrency } from "./utils.mjs";
 import { TABLE_DIMS, allTables, createCommandContext, createLocalStore, transformGscRow } from "./context.mjs";
 import process from "node:process";
 import { defineCommand } from "citty";
 import { SearchTypes } from "gscdump/query";
 import { createEmptyTypesStore } from "@gscdump/engine/entities";
-import { progressBar } from "gscdump";
 import { daysAgoUtc, getDateRange } from "gscdump/dates";
 import { DEFAULT_ROLLUPS, rebuildRollups } from "@gscdump/engine/rollups";
 const DEFAULT_TABLES = [
@@ -100,7 +99,7 @@ async function runOneDate(store, client, siteUrl, table, searchType, dims, date)
 	const rows = [];
 	let startRow = 0;
 	while (true) {
-		const batch = (await client._rawQuery(siteUrl, {
+		const batch = (await client.searchAnalytics.query(siteUrl, {
 			startDate: date,
 			endDate: date,
 			dimensions: dims,

package/dist/_chunks/utils.mjs

@@ -4,7 +4,7 @@ import fs from "node:fs/promises";
 import os from "node:os";
 import { Buffer } from "node:buffer";
 import { SearchTypes } from "gscdump/query";
-var version = "0.40.2";
+var version = "1.0.0";
 const ALL_SEARCH_TYPES = Object.values(SearchTypes);
 const VERSION = version;
 function noSubcommandSelected(parent, subNames) {
@@ -90,6 +90,30 @@ async function withConfiguredOutput(run) {
 		process.stdout.write = original;
 	}
 }
+const ANSI = {
+	reset: "\x1B[0m",
+	bold: "\x1B[1m",
+	dim: "\x1B[90m",
+	red: "\x1B[31m",
+	green: "\x1B[32m",
+	yellow: "\x1B[33m",
+	cyan: "\x1B[36m"
+};
+function color(c, s) {
+	if (!isColorEnabled()) return String(s);
+	return `${ANSI[c]}${s}${ANSI.reset}`;
+}
+function dim(s) {
+	return color("dim", s);
+}
+function cyan(s) {
+	return color("cyan", s);
+}
+function progressBar(current, total, label, width = 30) {
+	const percent = total > 0 ? Math.min(current / total, 1) : 0;
+	const filled = Math.round(width * percent);
+	return `  ${`${cyan("█".repeat(filled))}${dim("░".repeat(width - filled))}`} ${dim(`${current}/${total}`)} ${label}`;
+}
 const gradientColors = [
 	(s) => `\x1B[38;2;52;211;153m${s}\x1B[0m`,
 	(s) => `\x1B[38;2;45;212;191m${s}\x1B[0m`,
@@ -188,4 +212,4 @@ function exportToCSV(output) {
 	])}`);
 	return sections.join("\n\n");
 }
-export { ALL_SEARCH_TYPES, OUTPUT_ARGS, VERSION, applyOutputMode, clearLine, configureColor, displayPath, exportToCSV, formatAge, logger, noSubcommandSelected, parseSearchType, readUrlList, runWithConcurrency, showSplash, toCSV, withConfiguredOutput };
+export { ALL_SEARCH_TYPES, OUTPUT_ARGS, VERSION, applyOutputMode, clearLine, configureColor, displayPath, exportToCSV, formatAge, logger, noSubcommandSelected, parseSearchType, progressBar, readUrlList, runWithConcurrency, showSplash, toCSV, withConfiguredOutput };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/cli",
   "type": "module",
-  "version": "0.40.2",
+  "version": "1.0.0",
   "description": "CLI for Google Search Console - dump, query, and run MCP server",
   "author": {
     "name": "Harlan Wilton",
@@ -44,7 +44,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "dependencies": {
     "@clack/prompts": "^1.7.0",
@@ -56,10 +56,10 @@
     "ofetch": "^1.5.1",
     "open": "^11.0.0",
     "zod": "^4.4.3",
-    "@gscdump/analysis": "0.40.2",
-    "@gscdump/engine": "0.40.2",
-    "gscdump": "0.40.2",
-    "@gscdump/engine-gsc-api": "0.40.2"
+    "@gscdump/analysis": "^1.0.0",
+    "@gscdump/engine": "^1.0.0",
+    "@gscdump/engine-gsc-api": "^1.0.0",
+    "gscdump": "^1.0.0"
   },
   "devDependencies": {
     "vitest": "^4.1.10"