@gscdump/sdk 1.5.0 → 1.5.1

package/dist/search-console-stage.mjs

@@ -133,6 +133,106 @@ const GROWTH_CLICKS_PCT_90D = 10;
 const GROWTH_IMPRESSIONS_PCT_90D = 20;
 const DECLINE_CLICKS_PCT = -10;
 const MIN_DECLINE_PRIOR_CLICKS = 50;
+const SEVERE_COVERAGE_PERCENT = 20;
+const SEVERE_COVERAGE_MIN_URLS = 20;
+const SEVERE_NOT_INDEXED_MIN_URLS = 10;
+function severeCoverageReason(counts, totalUrls) {
+	if (counts.hardBlocks > Math.max(5, totalUrls * .05) && counts.hardBlocks >= counts.unknown && counts.hardBlocks >= counts.crawled) return "crawl";
+	const indexability = Math.max(counts.canonical, counts.noindex);
+	if (indexability > Math.max(5, totalUrls * .05) && indexability >= counts.unknown && indexability >= counts.crawled) return "indexability";
+	if (counts.generic > 0 && counts.unknown + counts.discovered + counts.crawled + counts.hardBlocks + counts.canonical + counts.noindex === 0) return "unspecified";
+	const candidates = [
+		{
+			reason: "unknown",
+			count: counts.unknown,
+			severe: counts.unknown >= Math.max(10, totalUrls * .4)
+		},
+		{
+			reason: "discovered",
+			count: counts.discovered,
+			severe: counts.discovered >= Math.max(10, totalUrls * .15)
+		},
+		{
+			reason: "crawled",
+			count: counts.crawled,
+			severe: counts.crawled >= Math.max(10, totalUrls * .15)
+		}
+	];
+	const severe = candidates.filter((candidate) => candidate.severe);
+	const winner = (severe.length > 0 ? severe : candidates).sort((left, right) => right.count - left.count)[0];
+	return winner && winner.count > 0 ? winner.reason : "mixed";
+}
+function severeCoverageStage(input, totalUrls, indexed) {
+	const notIndexed = Math.max(0, totalUrls - indexed);
+	const indexedPercent = totalUrls > 0 ? indexed / totalUrls * 100 : 0;
+	if (totalUrls < SEVERE_COVERAGE_MIN_URLS || notIndexed < SEVERE_NOT_INDEXED_MIN_URLS || indexedPercent >= SEVERE_COVERAGE_PERCENT) return null;
+	const issues = input.issues ?? [];
+	const counts = {
+		unknown: countSearchConsoleIssues(issues, "unknown_to_google"),
+		discovered: countSearchConsoleIssues(issues, "discovered_not_indexed"),
+		crawled: countSearchConsoleIssues(issues, "crawled_not_indexed"),
+		hardBlocks: countSearchConsoleIssues(issues, "blocked_robots", "server_error", "access_denied", "access_forbidden", "forbidden", "blocked_4xx", "redirect_error", "crawl_error", "not_found", "soft_404"),
+		canonical: countSearchConsoleIssues(issues, "canonical_mismatch", "canonical_cross_domain"),
+		noindex: countSearchConsoleIssues(issues, "noindex"),
+		generic: countSearchConsoleIssues(issues, "not_indexed")
+	};
+	if (Object.values(counts).every((count) => count === 0)) return null;
+	const reason = severeCoverageReason(counts, totalUrls);
+	const key = reason === "crawl" ? "crawl_blocked" : reason === "indexability" ? "indexability_blocked" : reason === "unknown" ? "weak_discovery" : reason === "discovered" ? "discovery_backlog" : "index_rejection";
+	const copy = {
+		crawl: {
+			summary: `Google is reporting hard access or fetch faults on ${formatSearchConsoleCount(counts.hardBlocks)} URLs.`,
+			primaryAction: "Fix fetch, server, robots, and broken-response faults before content work."
+		},
+		indexability: {
+			summary: "Google can reach pages, but canonical or indexability signals are preventing clean inclusion.",
+			primaryAction: "Make canonical and index directives agree on the URLs that should rank."
+		},
+		unknown: {
+			summary: `Google still does not know about ${formatSearchConsoleCount(counts.unknown)} of the inspected URLs.`,
+			primaryAction: "Audit sitemap freshness, sitemap membership, and internal links from already-indexed pages."
+		},
+		discovered: {
+			summary: `Google has discovered ${formatSearchConsoleCount(counts.discovered)} URLs but has not crawled them yet.`,
+			primaryAction: "Reduce low-value inventory and strengthen internal links to the pages that should be crawled."
+		},
+		crawled: {
+			summary: `Google crawled ${formatSearchConsoleCount(counts.crawled)} URLs but chose not to keep them in the index.`,
+			primaryAction: "Rule out blockers, then improve, consolidate, or noindex thin and duplicate page sets."
+		},
+		unspecified: {
+			summary: `Google reports ${formatSearchConsoleCount(counts.generic || notIndexed)} URLs as not indexed, but the current diagnostic snapshot does not expose a narrower reason bucket.`,
+			primaryAction: "Refresh URL Inspection diagnostics and join affected URLs to sitemap, internal-link, canonical, fetch, and rendered-content evidence."
+		},
+		mixed: {
+			summary: `${formatSearchConsoleCount(notIndexed)} URLs are not indexed, with multiple Google coverage reasons present.`,
+			primaryAction: "Split the affected URLs by Google coverage reason before changing the site."
+		}
+	}[reason];
+	return {
+		...stage(key, [
+			{
+				label: "Indexed pages",
+				value: `${formatSearchConsoleCount(indexed)} of ${formatSearchConsoleCount(totalUrls)}`,
+				source: "indexing"
+			},
+			...counts.unknown > 0 ? [{
+				label: "Unknown URLs",
+				value: formatSearchConsoleCount(counts.unknown),
+				source: "indexing"
+			}] : [],
+			...counts.crawled > 0 ? [{
+				label: "Crawled, not indexed",
+				value: formatSearchConsoleCount(counts.crawled),
+				source: "indexing"
+			}] : []
+		]),
+		severity: reason === "crawl" || reason === "indexability" ? "error" : "warning",
+		summary: copy.summary,
+		primaryAction: copy.primaryAction,
+		sprintFindingTypes: ["search-console-stage", "pages-not-indexed"]
+	};
+}
 function classifySearchConsoleStage(input) {
 	const issues = input.issues ?? [];
 	const summary = input.summary ?? null;
@@ -185,6 +285,8 @@ function classifySearchConsoleStage(input) {
 		value: `${formatSearchConsoleCount(indexed)} of ${formatSearchConsoleCount(totalUrls)}`,
 		source: "indexing"
 	}]);
+	const severeCoverage = isNascent ? null : severeCoverageStage(input, totalUrls, indexed);
+	if (severeCoverage) return severeCoverage;
 	if (isDeclining) return stage("declining_visibility", [{
 		label: "Clicks 90d",
 		value: `${clicks90d.toFixed(1)}%`,

package/dist/v1/realtime.d.mts

@@ -1,6 +1,6 @@
 import { RealtimeV1Cursor, RealtimeV1Event, RealtimeV1StreamHead, RealtimeV1StreamId } from "@gscdump/contracts/v1/realtime";
 type MaybePromise<T> = T | Promise<T>;
-declare const GSCDUMP_REALTIME_V1_SDK_VERSION: "1.5.0";
+declare const GSCDUMP_REALTIME_V1_SDK_VERSION: "1.5.1";
 type GscdumpRealtimeV1TransportState = 'idle' | 'ticketing' | 'connecting' | 'handshaking' | 'replaying' | 'live' | 'waiting' | 'stopped' | 'terminal';
 type GscdumpRealtimeV1Freshness = 'unknown' | 'stale' | 'applying' | 'fresh' | 'resyncing' | 'degraded';
 type GscdumpRealtimeV1ErrorCode = 'cursor_store_failed' | 'effect_failed' | 'heartbeat_stale' | 'integration_failed' | 'protocol_error' | 'resync_failed' | 'runtime_unavailable' | 'socket_error' | 'ticket_invalid' | 'ticket_provider_failed' | 'upgrade_rejected';

package/dist/v1/realtime.mjs

@@ -1,6 +1,6 @@
 import { utf8Size } from "../utf8.mjs";
 import { GSCDUMP_REALTIME_ACK_POLICY, GSCDUMP_REALTIME_CLOSE_CODES, GSCDUMP_REALTIME_CONNECTION_POLICY, GSCDUMP_REALTIME_LIMITS, GSCDUMP_REALTIME_PING, GSCDUMP_REALTIME_PONG, GSCDUMP_REALTIME_PROTOCOL_VERSION, GSCDUMP_REALTIME_SUBPROTOCOL, REALTIME_V1_EVENT_NAMES, REALTIME_V1_RESOURCE_TYPES, createRealtimeV1Schemas } from "@gscdump/contracts/v1/realtime";
-const GSCDUMP_REALTIME_V1_SDK_VERSION = "1.5.0";
+const GSCDUMP_REALTIME_V1_SDK_VERSION = "1.5.1";
 var GscdumpRealtimeV1Error = class extends Error {
 	tag = "GscdumpRealtimeV1Error";
 	code;
@@ -87,7 +87,7 @@ function createGscdumpRealtimeV1Client(options) {
 	const schemas = createRealtimeV1Schemas();
 	const runtime = options.runtime ?? defaultRuntime();
 	const cursorStore = options.cursorStore ?? createMemoryCursorStore();
-	const sdkVersion = options.sdkVersion ?? "1.5.0";
+	const sdkVersion = options.sdkVersion ?? "1.5.1";
 	if (!sdkVersion) throw new TypeError("sdkVersion cannot be empty.");
 	let running = false;
 	let epoch = 0;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/sdk",
   "type": "module",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "Consumer SDK for hosted gscdump.com integrations.",
   "author": {
     "name": "Harlan Wilton",
@@ -146,9 +146,9 @@
   "dependencies": {
     "ofetch": "^1.5.1",
     "zod": "^4.4.3",
-    "@gscdump/contracts": "^1.5.0",
-    "@gscdump/engine": "^1.5.0",
-    "gscdump": "^1.5.0"
+    "@gscdump/contracts": "^1.5.1",
+    "@gscdump/engine": "^1.5.1",
+    "gscdump": "^1.5.1"
   },
   "devDependencies": {
     "typescript": "^7.0.2",