@gscdump/sdk 0.27.1 → 0.27.2

package/dist/index.d.mts

@@ -403,6 +403,18 @@ interface PartnerWebSocketLike {
 interface PartnerWebSocketConstructor {
   new (url: string, protocols?: string | string[]): PartnerWebSocketLike;
 }
+interface PartnerRealtimeReconnectOptions {
+  /** Default `true`. Set `false` to disable automatic reconnection entirely. */
+  enabled?: boolean;
+  /** First-retry delay in ms; doubles each attempt. Default `1000`. */
+  baseDelayMs?: number;
+  /** Upper bound on the backoff delay in ms. Default `30000`. */
+  maxDelayMs?: number;
+  /** Stop after this many consecutive failed attempts. Default `Infinity`. */
+  maxRetries?: number;
+  /** Apply equal-jitter to each delay so many clients don't reconnect in lockstep. Default `true`. */
+  jitter?: boolean;
+}
 interface PartnerRealtimeOptions {
   /**
    * HTTP API base used only to derive a same-origin websocket base when `wsBase`
@@ -421,6 +433,17 @@ interface PartnerRealtimeOptions {
   siteIds?: string[];
   protocols?: string | string[];
   WebSocket?: PartnerWebSocketConstructor;
+  /**
+   * Automatic reconnection on unexpected close (network drop, server restart).
+   * A raw WebSocket `error` Event carries no actionable detail, so rather than
+   * surfacing it the client transparently reconnects with exponential backoff.
+   * `true` (default) uses defaults; pass an object to tune; `false` disables.
+   * The backoff counter resets once a reconnection reaches `authenticated`.
+   */
+  reconnect?: boolean | PartnerRealtimeReconnectOptions;
+  /** Injected timer hooks (for tests). Defaults to global `setTimeout`/`clearTimeout`. */
+  setTimeout?: (handler: () => void, ms: number) => unknown;
+  clearTimeout?: (handle: unknown) => void;
 }
 interface PartnerRealtimeClient {
   readonly status: PartnerRealtimeStatus;

package/dist/index.mjs

@@ -1379,6 +1379,16 @@ function getGscUnstableCutoffDate() {
 	const cutoff = new Date(y, m - 1, d - 3);
 	return `${cutoff.getFullYear()}-${String(cutoff.getMonth() + 1).padStart(2, "0")}-${String(cutoff.getDate()).padStart(2, "0")}`;
 }
+function resolveReconnect(reconnect) {
+	const opts = reconnect === false ? { enabled: false } : reconnect === true || reconnect == null ? {} : reconnect;
+	return {
+		enabled: opts.enabled ?? true,
+		baseDelayMs: opts.baseDelayMs ?? 1e3,
+		maxDelayMs: opts.maxDelayMs ?? 3e4,
+		maxRetries: opts.maxRetries ?? Number.POSITIVE_INFINITY,
+		jitter: opts.jitter ?? true
+	};
+}
 const HTTP_PROTOCOL_RE = /^http/i;
 const API_SUFFIX_RE = /\/api\/?$/;
 const TRAILING_SLASH_RE = /\/+$/;
@@ -1415,6 +1425,12 @@ function getWebSocketCtor(options) {
 function createPartnerRealtimeClient(options) {
 	let socket = null;
 	let status = "idle";
+	const reconnect = resolveReconnect(options.reconnect);
+	const setTimer = options.setTimeout ?? ((handler, ms) => setTimeout(handler, ms));
+	const clearTimer = options.clearTimeout ?? ((handle) => clearTimeout(handle));
+	let manualClose = false;
+	let reconnectAttempts = 0;
+	let reconnectTimer = null;
 	const statusHandlers = /* @__PURE__ */ new Set();
 	const messageHandlers = /* @__PURE__ */ new Set();
 	const eventHandlers = /* @__PURE__ */ new Set();
@@ -1441,6 +1457,68 @@ function createPartnerRealtimeClient(options) {
 			siteIds
 		});
 	}
+	function clearReconnectTimer() {
+		if (reconnectTimer != null) {
+			clearTimer(reconnectTimer);
+			reconnectTimer = null;
+		}
+	}
+	function backoffDelay(attempt) {
+		const exp = Math.min(reconnect.maxDelayMs, reconnect.baseDelayMs * 2 ** attempt);
+		if (!reconnect.jitter) return exp;
+		return Math.round(exp / 2 + Math.random() * (exp / 2));
+	}
+	function openSocket() {
+		if (socket) return socket;
+		clearReconnectTimer();
+		manualClose = false;
+		socket = new (getWebSocketCtor(options))(buildWsUrl(options), options.protocols);
+		setStatus("connecting");
+		socket.onopen = () => {
+			setStatus("open");
+			sendJson(authPayload());
+		};
+		socket.onmessage = (event) => {
+			const message = parseMessage(event.data);
+			if (!message) return;
+			if ("event" in message && message.event === "connected") {
+				reconnectAttempts = 0;
+				setStatus("authenticated");
+				if (options.siteIds?.length) subscribe(options.siteIds);
+			}
+			for (const handler of messageHandlers) handler(message);
+			if (isRealtimeEvent(message)) for (const handler of eventHandlers) handler(message);
+		};
+		socket.onerror = (event) => {
+			setStatus("error");
+			for (const handler of errorHandlers) handler(event);
+		};
+		socket.onclose = (event) => {
+			socket = null;
+			setStatus("closed");
+			for (const handler of messageHandlers) handler({
+				type: "error",
+				message: `WebSocket closed: ${JSON.stringify(event)}`
+			});
+			scheduleReconnect();
+		};
+		return socket;
+	}
+	function scheduleReconnect() {
+		if (!reconnect.enabled || manualClose || reconnectTimer != null) return;
+		if (reconnectAttempts >= reconnect.maxRetries) {
+			const err = /* @__PURE__ */ new Error(`Partner realtime reconnect exhausted after ${reconnectAttempts} attempts`);
+			for (const handler of errorHandlers) handler(err);
+			return;
+		}
+		const delay = backoffDelay(reconnectAttempts);
+		reconnectAttempts += 1;
+		setStatus("connecting");
+		reconnectTimer = setTimer(() => {
+			reconnectTimer = null;
+			openSocket();
+		}, delay);
+	}
 	return {
 		get status() {
 			return status;
@@ -1449,38 +1527,11 @@ function createPartnerRealtimeClient(options) {
 			return socket;
 		},
 		connect() {
-			if (socket) return socket;
-			socket = new (getWebSocketCtor(options))(buildWsUrl(options), options.protocols);
-			setStatus("connecting");
-			socket.onopen = () => {
-				setStatus("open");
-				sendJson(authPayload());
-			};
-			socket.onmessage = (event) => {
-				const message = parseMessage(event.data);
-				if (!message) return;
-				if ("event" in message && message.event === "connected") {
-					setStatus("authenticated");
-					if (options.siteIds?.length) subscribe(options.siteIds);
-				}
-				for (const handler of messageHandlers) handler(message);
-				if (isRealtimeEvent(message)) for (const handler of eventHandlers) handler(message);
-			};
-			socket.onerror = (event) => {
-				setStatus("error");
-				for (const handler of errorHandlers) handler(event);
-			};
-			socket.onclose = (event) => {
-				socket = null;
-				setStatus("closed");
-				for (const handler of messageHandlers) handler({
-					type: "error",
-					message: `WebSocket closed: ${JSON.stringify(event)}`
-				});
-			};
-			return socket;
+			return openSocket();
 		},
 		close(code, reason) {
+			manualClose = true;
+			clearReconnectTimer();
 			socket?.close(code, reason);
 			socket = null;
 			setStatus("closed");
@@ -1777,7 +1828,7 @@ function classifySearchConsoleStage(input) {
 	const discovered = issueCount$1(issues, "discovered_not_indexed");
 	const crawled = issueCount$1(issues, "crawled_not_indexed");
 	const hardBlocks = issueCount$1(issues, "blocked_robots", "server_error", "access_denied", "forbidden") + (input.crawlAuditBlockerCount ?? 0);
-	const canonicalMismatches = input.canonicalMismatchCount ?? issueCount$1(issues, "canonical_mismatch");
+	const canonicalMismatches = Math.min(notIndexed, input.canonicalMismatchCount ?? issueCount$1(issues, "canonical_mismatch"));
 	const visibleNoClickPages = (input.pageInventory ?? []).filter((page) => page.impressions >= 50 && page.clicks === 0).length;
 	const poorPositionPages = (input.pageInventory ?? []).filter((page) => page.impressions >= 50 && (page.position ?? 0) > 20).length;
 	const ctrOutlierCount = input.ctrOutlierCount ?? 0;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/sdk",
   "type": "module",
-  "version": "0.27.1",
+  "version": "0.27.2",
   "description": "Consumer SDK for hosted gscdump.com integrations.",
   "author": {
     "name": "Harlan Wilton",
@@ -44,10 +44,10 @@
     "date-fns": "^4.4.0",
     "ofetch": "^1.5.1",
     "zod": "^4.4.3",
-    "@gscdump/analysis": "0.27.1",
-    "@gscdump/contracts": "0.27.1",
-    "@gscdump/engine": "0.27.1",
-    "gscdump": "0.27.1"
+    "@gscdump/analysis": "0.27.2",
+    "@gscdump/engine": "0.27.2",
+    "gscdump": "0.27.2",
+    "@gscdump/contracts": "0.27.2"
   },
   "devDependencies": {
     "typescript": "^6.0.3",