seo 0.2.5 → 0.2.7

package/dist/index.js

@@ -1,15 +1,15 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { n as load, t as version } from "./package-BF_XgK7-.js";
+import { n as load, t as version } from "./package-BI-bLeV4.js";
 import { Headers, fetch as fetch$1 } from "undici";
 import { chmodSync, createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
+import { arch, homedir, platform } from "node:os";
 import { dirname, join } from "node:path";
 import { z } from "zod";
 import lockfile from "proper-lockfile";
 import crypto, { createHash, randomUUID, sign } from "node:crypto";
 import http from "node:http";
 import open from "open";
-import Database from "better-sqlite3";
+import Libsql from "libsql";
 import { Readability } from "@mozilla/readability";
 import Defuddle from "defuddle";
 import { parseHTML } from "linkedom";
@@ -146,6 +146,7 @@ function resolveSeoCliPaths(input = {}) {
 		configFile: join(configDir, "config.json"),
 		tokensFile: join(configDir, "tokens.json"),
 		oauthClientFile: join(configDir, "oauth-client.json"),
+		telemetryStateFile: join(configDir, "telemetry.json"),
 		cacheDbFile: join(cacheDir, "cache.db")
 	};
 }
@@ -493,6 +494,12 @@ function getPrivacySnapshot() {
 			mode: fileMode(paths.oauthClientFile),
 			sizeBytes: sizeOf(paths.oauthClientFile)
 		},
+		{
+			label: "Telemetry state",
+			path: paths.telemetryStateFile,
+			mode: fileMode(paths.telemetryStateFile),
+			sizeBytes: sizeOf(paths.telemetryStateFile)
+		},
 		{
 			label: "Cache DB",
 			path: paths.cacheDbFile,
@@ -1069,6 +1076,52 @@ async function exchangeCode(input) {
 	return tokenResponse.json();
 }
 //#endregion
+//#region packages/core/src/storage/sqlite.ts
+function withoutDriverMetadata(row) {
+	if (!row || typeof row !== "object" || Array.isArray(row)) return row;
+	const { _metadata: _driverMetadata, ...data } = row;
+	return data;
+}
+var Statement = class {
+	statement;
+	constructor(statement) {
+		this.statement = statement;
+	}
+	run(...params) {
+		return this.statement.run(...params);
+	}
+	get(...params) {
+		return withoutDriverMetadata(this.statement.get(...params));
+	}
+	all(...params) {
+		return this.statement.all(...params).map(withoutDriverMetadata);
+	}
+};
+var SqliteDatabase = class {
+	database;
+	constructor(filename) {
+		this.database = new Libsql(filename);
+	}
+	prepare(source) {
+		return new Statement(this.database.prepare(source));
+	}
+	transaction(fn) {
+		return this.database.transaction(fn);
+	}
+	exec(source) {
+		this.database.exec(source);
+		return this;
+	}
+	pragma(source) {
+		const result = this.database.pragma(source);
+		return Array.isArray(result) ? result.map(withoutDriverMetadata) : withoutDriverMetadata(result);
+	}
+	close() {
+		this.database.close();
+		return this;
+	}
+};
+//#endregion
 //#region packages/core/src/storage/database.ts
 const CREATE_SQL = `
 CREATE TABLE IF NOT EXISTS sites (
@@ -1352,10 +1405,14 @@ function getDb() {
 		recursive: true,
 		mode: 448
 	});
-	db = new Database(path);
+	db = new SqliteDatabase(path);
 	initDb(db);
 	return db;
 }
+function checkDatabaseReadiness() {
+	if (getDb().prepare("SELECT 1 AS ready").get()?.ready !== 1) throw new Error("The local SQLite database did not return a readiness row.");
+	return { dbPath: getSeoCliPaths().cacheDbFile };
+}
 function hashKey(parts) {
 	const json = JSON.stringify(parts);
 	return Buffer.from(json).toString("base64url");
@@ -27746,7 +27803,7 @@ function setDefaultClient(idOrName) {
 //#endregion
 //#region packages/core/src/doctor.ts
 const REQUIRED_SCOPES = ["https://www.googleapis.com/auth/webmasters.readonly", "https://www.googleapis.com/auth/analytics.readonly"];
-async function runDoctor() {
+async function runDoctor(dependencies = {}) {
 	const paths = getSeoCliPaths();
 	const config = readConfig();
 	const authMode = getAuthModeStatus();
@@ -27755,6 +27812,23 @@ async function runDoctor() {
 	const oauthClient = readOauthClient();
 	const tokenClientConfigured = tokens ? Boolean(getClientConfig(tokens.client_source)) : void 0;
 	const checks = [];
+	try {
+		const database = (dependencies.checkDatabase ?? checkDatabaseReadiness)();
+		checks.push({
+			id: "local-database",
+			label: "Local database",
+			status: "pass",
+			detail: database.dbPath
+		});
+	} catch (error) {
+		checks.push({
+			id: "local-database",
+			label: "Local database",
+			status: "fail",
+			detail: error instanceof Error ? error.message : "The local database could not be opened.",
+			fix: "Upgrade or reinstall `seo`. If this still fails, report it at https://github.com/iannuttall/seo/issues."
+		});
+	}
 	checks.push({
 		id: "config-dir",
 		label: "Config directory",
@@ -28480,6 +28554,371 @@ var JsonFileStorageAdapter = class {
 };
 const localCredentialsProvider = new LocalCredentialsProvider();
 //#endregion
+//#region packages/core/src/version.ts
+const SEO_VERSION = version;
+//#endregion
+//#region packages/core/src/telemetry.ts
+const TELEMETRY_ENDPOINT = "https://seoskill.dev/api/t";
+const TELEMETRY_SCHEMA_VERSION = 1;
+const TELEMETRY_TIMEOUT_MS = 2e3;
+const TELEMETRY_EVENTS = [
+	"first_run",
+	"setup_complete",
+	"audit_start",
+	"audit_complete",
+	"audit_failed",
+	"first_audit_complete",
+	"active_d1",
+	"active_d7",
+	"active_d30"
+];
+const TELEMETRY_AGENTS = [
+	"claude-code",
+	"cursor",
+	"codex",
+	"cli",
+	"unknown"
+];
+const TELEMETRY_ERROR_CATEGORIES = [
+	"auth",
+	"crawl_timeout",
+	"network",
+	"config",
+	"unknown"
+];
+const TELEMETRY_REPORTS = [
+	"affected-urls",
+	"agent-readiness",
+	"ai-readiness",
+	"ai-referrals",
+	"ai-search-scorecard",
+	"audit-page",
+	"audit-urls",
+	"cannibalisation",
+	"community-intent",
+	"compare-crawls",
+	"content-optimization",
+	"crawl-diff",
+	"site-crawl",
+	"ctr-underperformers",
+	"decaying-pages",
+	"setup-check",
+	"entity-readiness",
+	"explain-crawl-issue",
+	"geo-gaps",
+	"crawl-report",
+	"index-coverage",
+	"index-coverage-plan",
+	"index-monitor",
+	"index-watch",
+	"internal-links",
+	"link-recovery",
+	"crawl-history",
+	"crawler-rules",
+	"llms-txt-audit",
+	"generate-llms-txt",
+	"measure-change",
+	"monthly-report",
+	"okf-build",
+	"okf-validate",
+	"page-opportunities",
+	"performance-audit",
+	"pseo-audit",
+	"query-clusters",
+	"quick-wins",
+	"redirect-trace",
+	"narrative-report",
+	"second-page",
+	"segment-impact",
+	"striking-distance",
+	"seo-to-ai-query",
+	"top-fixes",
+	"traffic-anomaly",
+	"update-correlation",
+	"search-performance-overview",
+	"monthly-action-plan",
+	"refresh-priorities",
+	"technical-watch",
+	"update-postmortem"
+];
+const RETENTION_MILESTONES = [
+	{
+		days: 1,
+		event: "active_d1"
+	},
+	{
+		days: 7,
+		event: "active_d7"
+	},
+	{
+		days: 30,
+		event: "active_d30"
+	}
+];
+const CI_ENVIRONMENT_KEYS = [
+	"GITHUB_ACTIONS",
+	"GITLAB_CI",
+	"CIRCLECI",
+	"TRAVIS",
+	"BUILDKITE",
+	"JENKINS_URL",
+	"TEAMCITY_VERSION",
+	"TF_BUILD",
+	"BITBUCKET_BUILD_NUMBER",
+	"CODEBUILD_BUILD_ID"
+];
+const TELEMETRY_NOTICE = `SEO Skill collects anonymous usage data to improve the tool (event name,
+report id, version, agent, OS, architecture, Node major, and install week;
+never URLs, report data, or identifiers of any kind).
+Docs: https://seoskill.dev/telemetry
+Disable: seo telemetry disable (or set DO_NOT_TRACK=1)\n`;
+function optionEnv(options) {
+	return options.env ?? process.env;
+}
+function optionNow(options) {
+	return options.now ?? /* @__PURE__ */ new Date();
+}
+function optionStateFile(options) {
+	return options.stateFile ?? getSeoCliPaths().telemetryStateFile;
+}
+function isEnvEnabled(value) {
+	return value === "1" || value?.toLowerCase() === "true";
+}
+function isTelemetryCi(env = process.env) {
+	return env.NODE_ENV === "test" || Boolean(env.NODE_TEST_CONTEXT) || isEnvEnabled(env.CI) || CI_ENVIRONMENT_KEYS.some((key) => Boolean(env[key]));
+}
+function environmentDisableReason(env) {
+	if (isTelemetryCi(env)) return "ci";
+	if (isEnvEnabled(env.DO_NOT_TRACK)) return "do_not_track";
+	if (isEnvEnabled(env.SEOSKILL_TELEMETRY_DISABLED) || isEnvEnabled(env.SEO_TELEMETRY_DISABLED)) return "environment";
+}
+function isTelemetryMilestone(value) {
+	return typeof value === "string" && [
+		"first_run",
+		"setup_complete",
+		"first_audit_complete",
+		"active_d1",
+		"active_d7",
+		"active_d30"
+	].includes(value);
+}
+function isTelemetryReport(value) {
+	return typeof value === "string" && TELEMETRY_REPORTS.includes(value);
+}
+function isValidCohort(value) {
+	return typeof value === "string" && /^\d{4}-W(?:0[1-9]|[1-4]\d|5[0-3])$/.test(value);
+}
+function isTelemetryState(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const state = value;
+	return typeof state.telemetryEnabled === "boolean" && typeof state.firstRunAt === "string" && Number.isFinite(Date.parse(state.firstRunAt)) && isValidCohort(state.cohort) && Array.isArray(state.sentMilestones) && state.sentMilestones.every(isTelemetryMilestone);
+}
+function readState(path) {
+	if (!existsSync(path)) return { kind: "missing" };
+	const value = readJsonFile(path);
+	return isTelemetryState(value) ? {
+		kind: "valid",
+		state: value
+	} : { kind: "invalid" };
+}
+function writeState(path, state) {
+	writeJsonAtomic(path, state, 384);
+}
+function isoWeek(date) {
+	const utc = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+	const day = utc.getUTCDay() || 7;
+	utc.setUTCDate(utc.getUTCDate() + 4 - day);
+	const yearStart = new Date(Date.UTC(utc.getUTCFullYear(), 0, 1));
+	const week = Math.ceil(((utc.getTime() - yearStart.getTime()) / 864e5 + 1) / 7);
+	return `${utc.getUTCFullYear()}-W${String(week).padStart(2, "0")}`;
+}
+function newState(options, enabled = true) {
+	const now = optionNow(options);
+	return {
+		telemetryEnabled: enabled,
+		firstRunAt: now.toISOString(),
+		cohort: isoWeek(now),
+		sentMilestones: []
+	};
+}
+function detectTelemetryAgent(input = {}) {
+	const env = input.env ?? process.env;
+	const clientName = input.clientName?.toLowerCase() ?? "";
+	if (clientName.includes("claude")) return "claude-code";
+	if (clientName.includes("cursor")) return "cursor";
+	if (clientName.includes("codex")) return "codex";
+	if (input.clientName) return "unknown";
+	if (env.CLAUDECODE || env.CLAUDE_CODE) return "claude-code";
+	if (env.CURSOR_AGENT || env.CURSOR_TRACE_ID || env.CURSOR_SESSION_ID) return "cursor";
+	if (env.CODEX_HOME || env.CODEX_THREAD_ID || env.CODEX_SANDBOX) return "codex";
+	return "cli";
+}
+function telemetryAgent(options) {
+	return options.agent ?? detectTelemetryAgent({
+		clientName: options.clientName,
+		env: optionEnv(options)
+	});
+}
+function nodeMajor(version) {
+	return version.replace(/^v/, "").split(".")[0] || "unknown";
+}
+function buildTelemetryPayload(event, state, fields = {}, options = {}) {
+	return {
+		event,
+		version: options.version ?? SEO_VERSION,
+		agent: telemetryAgent(options),
+		os: options.processPlatform ?? platform(),
+		arch: options.processArch ?? arch(),
+		node: nodeMajor(options.nodeVersion ?? process.version),
+		cohort: state.cohort,
+		schema: 1,
+		...fields.errorCategory ? { errorCategory: fields.errorCategory } : {},
+		...fields.report ? { report: fields.report } : {}
+	};
+}
+function dispatchTelemetry(payload, options) {
+	const fetchTelemetry = options.fetch ?? globalThis.fetch;
+	try {
+		fetchTelemetry(options.endpoint ?? "https://seoskill.dev/api/t", {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify(payload),
+			signal: AbortSignal.timeout(TELEMETRY_TIMEOUT_MS)
+		}).catch(() => void 0);
+	} catch {}
+}
+function statusFromState(options) {
+	const stateFile = optionStateFile(options);
+	const envReason = environmentDisableReason(optionEnv(options));
+	const stored = readState(stateFile);
+	if (envReason) return {
+		enabled: false,
+		reason: envReason,
+		stateFile,
+		...stored.kind === "valid" ? { state: stored.state } : {}
+	};
+	if (stored.kind === "invalid") return {
+		enabled: false,
+		reason: "invalid_state",
+		stateFile
+	};
+	if (stored.kind === "valid" && !stored.state.telemetryEnabled) return {
+		enabled: false,
+		reason: "local_setting",
+		stateFile,
+		state: stored.state
+	};
+	return {
+		enabled: true,
+		stateFile,
+		...stored.kind === "valid" ? { state: stored.state } : {}
+	};
+}
+function getTelemetryStatus(options = {}) {
+	return statusFromState(options);
+}
+function setTelemetryEnabled(enabled, options = {}) {
+	const stateFile = optionStateFile(options);
+	const stored = readState(stateFile);
+	const state = stored.kind === "valid" ? stored.state : newState(options, enabled);
+	state.telemetryEnabled = enabled;
+	writeState(stateFile, state);
+	return statusFromState(options);
+}
+function enabledState(options) {
+	const status = statusFromState(options);
+	return status.enabled ? status.state : void 0;
+}
+function initializeTelemetry(options = {}) {
+	const initialStatus = statusFromState(options);
+	if (!initialStatus.enabled) return initialStatus;
+	const stateFile = initialStatus.stateFile;
+	const state = initialStatus.state ?? newState(options);
+	const events = [];
+	if (!state.sentMilestones.includes("first_run")) {
+		try {
+			(options.notice ?? ((message) => process.stderr.write(message)))(TELEMETRY_NOTICE);
+		} catch {
+			return {
+				enabled: false,
+				reason: "invalid_state",
+				stateFile
+			};
+		}
+		state.sentMilestones.push("first_run");
+		events.push("first_run");
+	}
+	const daysSinceFirstRun = (optionNow(options).getTime() - Date.parse(state.firstRunAt)) / 864e5;
+	for (const milestone of RETENTION_MILESTONES) if (daysSinceFirstRun >= milestone.days && !state.sentMilestones.includes(milestone.event)) {
+		state.sentMilestones.push(milestone.event);
+		events.push(milestone.event);
+	}
+	try {
+		writeState(stateFile, state);
+	} catch {
+		return {
+			enabled: false,
+			reason: "invalid_state",
+			stateFile
+		};
+	}
+	for (const event of events) dispatchTelemetry(buildTelemetryPayload(event, state, {}, options), options);
+	return {
+		enabled: true,
+		stateFile,
+		state
+	};
+}
+function sendEvent(event, fields, options) {
+	const state = enabledState(options);
+	if (!state) return;
+	dispatchTelemetry(buildTelemetryPayload(event, state, fields, options), options);
+}
+function trackTelemetryReportStart(report, options = {}) {
+	if (!isTelemetryReport(report)) return;
+	sendEvent("audit_start", { report }, options);
+}
+function trackTelemetryReportComplete(report, options = {}) {
+	if (!isTelemetryReport(report)) return;
+	const state = enabledState(options);
+	if (!state) return;
+	dispatchTelemetry(buildTelemetryPayload("audit_complete", state, { report }, options), options);
+	if (state.sentMilestones.includes("first_audit_complete")) return;
+	state.sentMilestones.push("first_audit_complete");
+	try {
+		writeState(optionStateFile(options), state);
+	} catch {
+		return;
+	}
+	dispatchTelemetry(buildTelemetryPayload("first_audit_complete", state, { report }, options), options);
+}
+function trackTelemetryReportFailed(report, errorCategory, options = {}) {
+	if (!isTelemetryReport(report)) return;
+	sendEvent("audit_failed", {
+		errorCategory,
+		report
+	}, options);
+}
+function trackTelemetrySetupComplete(options = {}) {
+	const state = enabledState(options);
+	if (!state || state.sentMilestones.includes("setup_complete")) return;
+	state.sentMilestones.push("setup_complete");
+	try {
+		writeState(optionStateFile(options), state);
+	} catch {
+		return;
+	}
+	dispatchTelemetry(buildTelemetryPayload("setup_complete", state, {}, options), options);
+}
+function telemetryErrorCategory(error) {
+	if (error instanceof Error && error.name === "AbortError") return "crawl_timeout";
+	const code = error && typeof error === "object" && "code" in error ? String(error.code) : void 0;
+	if (code === "ACCESS_DENIED" || code === "AUTH_CONFIG_REQUIRED" || code === "AUTH_EXPIRED" || code === "AUTH_REQUIRED") return "auth";
+	if (code === "INVALID_INPUT" || code === "PROPERTY_NOT_FOUND") return "config";
+	if (code === "OPTIONAL_PROVIDER_UNAVAILABLE" || code === "PROVIDER_UNAVAILABLE" || code === "RATE_LIMITED") return "network";
+	return "unknown";
+}
+//#endregion
 //#region packages/core/src/utils/time.ts
 function parseOlderThan(input) {
 	if (!input) return;
@@ -28514,9 +28953,6 @@ function isoDate(daysAgo = 0) {
 	return date.toISOString().slice(0, 10);
 }
 //#endregion
-//#region packages/core/src/version.ts
-const SEO_VERSION = version;
-//#endregion
-export { AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, AI_SEARCH_SCORECARD_METHODOLOGY_ID, AI_SEARCH_SCORECARD_METHODOLOGY_VERSION, AUDIT_PAGE_RULE_IDS, BROWSER_USER_AGENT, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CRAWL_REPORT_STORAGE_VERSION, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_DEFAULT_MIN_IMPRESSIONS, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DataForSeoProvider, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, JsonFileStorageAdapter, LocalCredentialsProvider, OKF_DEFAULT_CONCEPTS, OKF_MAX_CONCEPTS, REPORT_BASELINE_MAX_AGE_MS, REPORT_BASELINE_MAX_DEPTH, REPORT_BASELINE_MAX_PAGES, SCORECARD_CHECK_WEIGHTS, SCORECARD_STATUS_CREDIT, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, SemrushProvider, SeoError, ServiceAccountAccessTokenClient, SessionLedger, affectedUrls, agentReadiness, aiPromptsForQuery, aiReadiness, aiReferralSourceForValue, aiReferralsReport, aiSearchScorecard, allocateIndexUrlsToProperties, analyticsConnectionsSchema, analyzeAiReferralRows, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertUrlMatchesGscProperty, attachCrawlRecommendations, auditCrawlPages, auditCrawlRequests, auditLlmsTxt, auditPage, authStatus, boundedSitemapInventory, buildOkfBundle, buildPseoAuditReportFromRows, cannibalReport, changeMeasurementCsvRows, classifyCommunityIntent, clearCache, clientProfileSchema, clusterPseoTemplates, clusterQueryRows, collectAgentDiscovery, combineRobotsValues, communityIntentReport, compareCrawlPages, compareCrawlReports, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlDiff, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportStore, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createContentGroup, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createLogger, createPageRenderer, ctrUnderperformersReport, decayClusterDrafts, decayComparisonRange, decayingReport, deleteChange, deleteClient, deleteContentGroup, deleteCrawlReport, deleteTokens, deriveBrandTerms, detectBrandTerms, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, ensureSeoCliDirs, entityReadiness, estimateSerpTitleWidth, expectedCtrForPosition, explainOkfValidation, explainRule, fetchCruxFieldData, fetchPage, fetchSearchStatusIncidents, fetchSitemapUrls, fileSize, finalGscDateRange, findOverlappingSearchUpdates, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, generateLlmsTxt, geoGaps, geoGapsReport, getAuthModeStatus, getCacheStats, getChange, getClient, getClientConfig, getContentGroup, getDb, getKeywordProvider, getPreviousRun, getPrivacySnapshot, getRepeatedLinkRecoverUrls, getRunPages, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTokenStorageStatus, googleAnalyticsPropertyId, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, indexCoveragePlan, indexCoverageSignals, indexMonitor, indexWatch, inferPseoTemplate, inferTemplateMovement, insertCrawlRun, insertLinkRecoverRun, inspectUrl, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isCompatibleTechnicalBaseline, isCurrentTechnicalBaseline, isEntityEvidenceSchemaType, isSiteIdentitySchemaType, isSkippableReportError, isoDate, latestCrawlReport, latestCrawlSummaries, latestFinalGscDate, latestIndexWatchSummary, latestLinkRecoverSummary, linkRecover, linkRecoverRecommendation, listChanges, listClients, listContentGroups, listCrawlReports, listGa4AccountSummaries, listGa4DataStreams, listRules, listSearchUpdates, listSites, loadCrawlReport, localCredentialsProvider, loginWithLoopback, makeRunId, matchGa4WebStreams, measureChange, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, monitoringStatus, monthlyReport, monthlyReportWorkflow, narrativeCsvFiles, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLoadedCrawlReport, okfConceptLimit, pageEvidenceRecommendation, pageOpportunitiesReport, parseOlderThan, parsePseoPath, performanceAudit, performanceReportIsCacheable, planDueIndexUrls, planIndexCoverageFromUrls, plural, propertyMatchesUrl, providerPreferenceSchema, pseoAuditOptions, pseoAuditReport, pseoCsvFiles, pseoIndexStatus, pseoPresentation, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, readConfig, readOauthClient, readTokens, recommendCrawlDiffItem, recommendationForRule, recordChange, redirectTrace, refreshAuthToken, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, renderCrawlCsv, renderCrawlHtml, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderPseoMarkdown, renderWorkflowMarkdown, reportNarrative, reportPresentation, requestHeaders, resolveSegmentRanges, resolveSeoCliPaths, resolveTechnicalBaseline, reviewObservations, roundedPosition, runDoctor, runGa4Report, saveClient, saveCrawlReport, secondPage, segmentComparisonRange, segmentImpact, segmentRangeDays, selectAffectedUrls, selectDueIndexUrls, seoErrorEnvelope, seoToAiQueryReport, sessionSourceInListFilter, setDefaultClient, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteSchema, sqliteCrawlReportStore, strikingDistance, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, technicalWatchWorkflow, templateForUrl, toSeoError, tokenSchema, topCrawlRecommendations, topFixes, trafficAnomaly, unavailableSegmentImpactReport, unicodeTokens, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateOkfFiles, verifyQueryContent, workflowPresentation, writeConfig, writeOauthClient, writeTokens, xRobotsDirectives };
+export { AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, AI_SEARCH_SCORECARD_METHODOLOGY_ID, AI_SEARCH_SCORECARD_METHODOLOGY_VERSION, AUDIT_PAGE_RULE_IDS, BROWSER_USER_AGENT, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CRAWL_REPORT_STORAGE_VERSION, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_DEFAULT_MIN_IMPRESSIONS, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DataForSeoProvider, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, JsonFileStorageAdapter, LocalCredentialsProvider, OKF_DEFAULT_CONCEPTS, OKF_MAX_CONCEPTS, REPORT_BASELINE_MAX_AGE_MS, REPORT_BASELINE_MAX_DEPTH, REPORT_BASELINE_MAX_PAGES, SCORECARD_CHECK_WEIGHTS, SCORECARD_STATUS_CREDIT, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, SemrushProvider, SeoError, ServiceAccountAccessTokenClient, SessionLedger, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_NOTICE, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, affectedUrls, agentReadiness, aiPromptsForQuery, aiReadiness, aiReferralSourceForValue, aiReferralsReport, aiSearchScorecard, allocateIndexUrlsToProperties, analyticsConnectionsSchema, analyzeAiReferralRows, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertUrlMatchesGscProperty, attachCrawlRecommendations, auditCrawlPages, auditCrawlRequests, auditLlmsTxt, auditPage, authStatus, boundedSitemapInventory, buildOkfBundle, buildPseoAuditReportFromRows, buildTelemetryPayload, cannibalReport, changeMeasurementCsvRows, checkDatabaseReadiness, classifyCommunityIntent, clearCache, clientProfileSchema, clusterPseoTemplates, clusterQueryRows, collectAgentDiscovery, combineRobotsValues, communityIntentReport, compareCrawlPages, compareCrawlReports, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlDiff, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportStore, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createContentGroup, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createLogger, createPageRenderer, ctrUnderperformersReport, decayClusterDrafts, decayComparisonRange, decayingReport, deleteChange, deleteClient, deleteContentGroup, deleteCrawlReport, deleteTokens, deriveBrandTerms, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, ensureSeoCliDirs, entityReadiness, estimateSerpTitleWidth, expectedCtrForPosition, explainOkfValidation, explainRule, fetchCruxFieldData, fetchPage, fetchSearchStatusIncidents, fetchSitemapUrls, fileSize, finalGscDateRange, findOverlappingSearchUpdates, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, generateLlmsTxt, geoGaps, geoGapsReport, getAuthModeStatus, getCacheStats, getChange, getClient, getClientConfig, getContentGroup, getDb, getKeywordProvider, getPreviousRun, getPrivacySnapshot, getRepeatedLinkRecoverUrls, getRunPages, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleAnalyticsPropertyId, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, indexCoveragePlan, indexCoverageSignals, indexMonitor, indexWatch, inferPseoTemplate, inferTemplateMovement, initializeTelemetry, insertCrawlRun, insertLinkRecoverRun, inspectUrl, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isCompatibleTechnicalBaseline, isCurrentTechnicalBaseline, isEntityEvidenceSchemaType, isSiteIdentitySchemaType, isSkippableReportError, isTelemetryCi, isTelemetryReport, isoDate, isoWeek, latestCrawlReport, latestCrawlSummaries, latestFinalGscDate, latestIndexWatchSummary, latestLinkRecoverSummary, linkRecover, linkRecoverRecommendation, listChanges, listClients, listContentGroups, listCrawlReports, listGa4AccountSummaries, listGa4DataStreams, listRules, listSearchUpdates, listSites, loadCrawlReport, localCredentialsProvider, loginWithLoopback, makeRunId, matchGa4WebStreams, measureChange, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, monitoringStatus, monthlyReport, monthlyReportWorkflow, narrativeCsvFiles, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLoadedCrawlReport, okfConceptLimit, pageEvidenceRecommendation, pageOpportunitiesReport, parseOlderThan, parsePseoPath, performanceAudit, performanceReportIsCacheable, planDueIndexUrls, planIndexCoverageFromUrls, plural, propertyMatchesUrl, providerPreferenceSchema, pseoAuditOptions, pseoAuditReport, pseoCsvFiles, pseoIndexStatus, pseoPresentation, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, readConfig, readOauthClient, readTokens, recommendCrawlDiffItem, recommendationForRule, recordChange, redirectTrace, refreshAuthToken, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, renderCrawlCsv, renderCrawlHtml, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderPseoMarkdown, renderWorkflowMarkdown, reportNarrative, reportPresentation, requestHeaders, resolveSegmentRanges, resolveSeoCliPaths, resolveTechnicalBaseline, reviewObservations, roundedPosition, runDoctor, runGa4Report, saveClient, saveCrawlReport, secondPage, segmentComparisonRange, segmentImpact, segmentRangeDays, selectAffectedUrls, selectDueIndexUrls, seoErrorEnvelope, seoToAiQueryReport, sessionSourceInListFilter, setDefaultClient, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteSchema, sqliteCrawlReportStore, strikingDistance, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, technicalWatchWorkflow, telemetryErrorCategory, templateForUrl, toSeoError, tokenSchema, topCrawlRecommendations, topFixes, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, unavailableSegmentImpactReport, unicodeTokens, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateOkfFiles, verifyQueryContent, workflowPresentation, writeConfig, writeOauthClient, writeTokens, xRobotsDirectives };
 
 //# sourceMappingURL=index.js.map