@gscdump/sdk 3.2.0 → 3.3.0

package/dist/search-console-stage.d.mts

@@ -72,7 +72,7 @@ interface ClassifySearchConsoleStageInput {
   pageMoverDropCount?: number | null;
   /** v2 trajectory axis — when present, drives the growth override + decline detection. */
   trajectory?: SearchConsoleStageTrajectory | null;
-  /** v2 maturity axis — impressions over the trailing 28 days. Gates whether coverage% is even meaningful. */
+  /** v2 reach axis — impressions over the trailing 28 days. Gates comparative growth claims. */
   impressions28d?: number | null;
   /**
    * v2 on-page technical faults from the crawl audit (broken links/images,
@@ -92,11 +92,8 @@ interface ClassifySearchConsoleStageInput {
   siteType?: string | null;
 }
 /**
- * v2 classifier. Trajectory and maturity are first-class axes that run BEFORE
- * the coverage/discovery rungs, so a growing site is told to keep expanding —
- * never to "fix indexing". Reuses the existing stage-key enum (growth →
- * `healthy_growth_ready`, nascent → `waiting_for_data`, mass crawled-not-indexed
- * → `index_rejection`, on-page/crawl faults → `crawl_blocked`).
+ * v2 classifier. Direct indexing evidence remains actionable at any traffic
+ * volume. Comparative reach claims require enough current observations.
  */
 declare function classifySearchConsoleStage(input: ClassifySearchConsoleStageInput): SearchConsoleStage;
 export { ClassifySearchConsoleStageInput, SearchConsoleStage, SearchConsoleStageEvidence, SearchConsoleStageIssue, SearchConsoleStageKey, SearchConsoleStagePage, SearchConsoleStageSeverity, SearchConsoleStageSitemap, SearchConsoleStageSummary, SearchConsoleStageTrajectory, classifySearchConsoleStage };

package/dist/search-console-stage.mjs

@@ -128,7 +128,7 @@ function stage(key, evidence) {
 	};
 }
 const ESTABLISHED_IMPRESSIONS_28D = 2e4;
-const NASCENT_IMPRESSIONS_28D = 1e3;
+const MIN_GROWTH_IMPRESSIONS_28D = 1e3;
 const GROWTH_CLICKS_PCT_90D = 10;
 const GROWTH_IMPRESSIONS_PCT_90D = 20;
 const DECLINE_CLICKS_PCT = -10;
@@ -272,9 +272,8 @@ function classifySearchConsoleStage(input) {
 	const posDelta90d = traj?.positionDelta90d ?? null;
 	const clicks28d = traj?.clicksPct28d ?? null;
 	const clicksPrior28d = traj?.clicksPrior28d ?? null;
-	const isGrowing = clicks90d != null && clicks90d > GROWTH_CLICKS_PCT_90D || imp90d != null && imp90d > GROWTH_IMPRESSIONS_PCT_90D && posDelta90d != null && posDelta90d < 0;
+	const isGrowing = impressions28d != null && impressions28d >= MIN_GROWTH_IMPRESSIONS_28D && (clicks90d != null && clicks90d > GROWTH_CLICKS_PCT_90D || imp90d != null && imp90d > GROWTH_IMPRESSIONS_PCT_90D && posDelta90d != null && posDelta90d < 0);
 	const isDeclining = clicks90d != null && clicks90d < DECLINE_CLICKS_PCT && clicks28d != null && clicks28d < DECLINE_CLICKS_PCT && clicksPrior28d != null && clicksPrior28d >= MIN_DECLINE_PRIOR_CLICKS;
-	const isNascent = impressions28d != null && impressions28d < NASCENT_IMPRESSIONS_28D;
 	const isEstablished = impressions28d != null && impressions28d >= ESTABLISHED_IMPRESSIONS_28D;
 	if (hardBlocks > Math.max(10, totalUrls * .05)) return stage("crawl_blocked", [{
 		label: "Crawl / on-page faults",
@@ -285,7 +284,7 @@ function classifySearchConsoleStage(input) {
 		value: `${formatSearchConsoleCount(indexed)} of ${formatSearchConsoleCount(totalUrls)}`,
 		source: "indexing"
 	}]);
-	const severeCoverage = isNascent ? null : severeCoverageStage(input, totalUrls, indexed);
+	const severeCoverage = severeCoverageStage(input, totalUrls, indexed);
 	if (severeCoverage) return severeCoverage;
 	if (isDeclining) return stage("declining_visibility", [{
 		label: "Clicks 90d",
@@ -332,15 +331,6 @@ function classifySearchConsoleStage(input) {
 		value: formatSearchConsoleCount(notIndexed),
 		source: "indexing"
 	}]);
-	if (isNascent) return stage("waiting_for_data", [{
-		label: "Impressions (28d)",
-		value: formatSearchConsoleCount(impressions28d ?? 0),
-		source: "performance"
-	}, {
-		label: "Indexed pages",
-		value: `${formatSearchConsoleCount(indexed)} of ${formatSearchConsoleCount(totalUrls)}`,
-		source: "indexing"
-	}]);
 	if (!isEstablished && (sitemaps.length === 0 || sitemapErrors > 0 || unknown > Math.max(5, totalUrls * .1))) return stage("weak_discovery", [{
 		label: "Sitemaps",
 		value: sitemaps.length === 0 ? "None registered" : `${formatSearchConsoleCount(sitemapErrors)} errors`,

package/dist/site-triage.d.mts

@@ -1,5 +1,5 @@
 import { SearchConsoleStageIssue } from "./search-console-stage.mjs";
-type ReachStage = 'waiting_for_data' | 'emerging' | 'growing' | 'plateaued' | 'declining' | 'faded' | 'decayed';
+type ReachStage = 'emerging' | 'growing' | 'plateaued' | 'declining' | 'faded' | 'decayed';
 type HealthStage = 'healthy' | 'crawl_faults' | 'quality_rejection';
 interface TriageEvidence {
   label: string;
@@ -9,7 +9,7 @@ interface TriageEvidence {
  * Distance-to-next-stage for one axis, so the UI never re-derives thresholds.
  *
  * `direction`:
- *  - `advance` — up-path rung (waiting → emerging → growing). `pct` = value/target.
+ *  - `advance` — up-path rung (emerging → growing). `pct` = value/target.
  *  - `escape`  — off-ramp recovery (declining/faded/decayed) or a held health gate
  *    (crawl_faults/quality_rejection). `pct` = inverse distance: closer to passing ⇒ higher.
  *  - `sustain` — already good (growing/healthy). `nextStage` null, `pct` 1, framed as momentum.
@@ -46,7 +46,6 @@ interface SiteTriage {
   headline: 'reach' | 'health';
 }
 interface SiteTriageInput {
-  connected: boolean;
   /** Impressions over the trailing 28 days — the maturity tier. */
   impressions28d?: number | null;
   /** Lifetime-ish impressions (trailing 12 months) — separates new from decayed/faded. */

package/dist/site-triage.mjs

@@ -1,8 +1,8 @@
 import { countSearchConsoleIssues, formatSearchConsoleCount } from "./search-console-signals.mjs";
 import { normalizeSiteType } from "./site-baseline.mjs";
-const NASCENT_IMPRESSIONS_28D = 1e3;
+const MIN_GROWTH_IMPRESSIONS_28D = 1e3;
 const ESTABLISHED_IMPRESSIONS_28D = 2e4;
-const LIFETIME_FLOOR = 500;
+const MIN_HISTORY_IMPRESSIONS = 500;
 const GROWTH_CLICKS_PCT = 10;
 const GROWTH_IMPRESSIONS_PCT = 20;
 const DECLINE_CLICKS_PCT = -10;
@@ -148,13 +148,9 @@ function classifyHealthStage(input) {
 	};
 }
 const REACH_COPY = {
-	waiting_for_data: {
-		summary: "Too new to diagnose — not enough search history yet.",
-		primaryAction: "Submit a clean sitemap, add internal links, and give it time."
-	},
 	emerging: {
-		summary: "Early but climbing — real impressions are starting to land.",
-		primaryAction: "Keep publishing on the themes already gaining impressions."
+		summary: "Search Console is ready. Search visibility is still limited.",
+		primaryAction: "Improve discovery and indexing, then build on pages that earn impressions."
 	},
 	growing: {
 		summary: "Discoverable, indexed-enough, and trending up. The next work is expansion, not cleanup.",
@@ -195,12 +191,8 @@ function classifyReachStage(input) {
 	const imp90dPct = input.impressionsPct90d ?? null;
 	const posDelta = input.positionDelta90d ?? null;
 	const liveness = input.livenessRatio ?? null;
-	if (imp12m != null && imp12m < LIFETIME_FLOOR) return reach("waiting_for_data", [{
-		label: "Impressions (12m)",
-		value: formatSearchConsoleCount(imp12m)
-	}], advance("emerging", "lifetime impressions", imp12m, LIFETIME_FLOOR, `${formatSearchConsoleCount(imp12m)} of ${formatSearchConsoleCount(LIFETIME_FLOOR)} lifetime impressions — collecting data, keep indexing`));
-	const hadRealReach = (imp12m ?? imp28d) > LIFETIME_FLOOR;
-	const isGrowing = clicks90dPct != null && clicks90dPct > GROWTH_CLICKS_PCT || imp90dPct != null && imp90dPct > GROWTH_IMPRESSIONS_PCT && posDelta != null && posDelta < 0;
+	const hadRealReach = (imp12m ?? imp28d) > MIN_HISTORY_IMPRESSIONS;
+	const isGrowing = imp28d >= MIN_GROWTH_IMPRESSIONS_28D && (clicks90dPct != null && clicks90dPct > GROWTH_CLICKS_PCT || imp90dPct != null && imp90dPct > GROWTH_IMPRESSIONS_PCT && posDelta != null && posDelta < 0);
 	if (hadRealReach && liveness != null && liveness < FADED_LIVENESS && !isGrowing) return reach("faded", [{
 		label: "Recent week vs peak",
 		value: `${(liveness * 100).toFixed(0)}%`
@@ -234,7 +226,7 @@ function classifyReachStage(input) {
 		}] : []], sustain(growthMetric, growthPct, growthLabel));
 	}
 	const ctr = clicks28d != null && imp28d > 0 ? clicks28d / imp28d : null;
-	if (hadRealReach && imp28d >= NASCENT_IMPRESSIONS_28D && ctr != null && ctr < DECAY_CTR) return reach("decayed", [{
+	if (hadRealReach && imp28d >= MIN_GROWTH_IMPRESSIONS_28D && ctr != null && ctr < DECAY_CTR) return reach("decayed", [{
 		label: "Impressions (28d)",
 		value: formatSearchConsoleCount(imp28d)
 	}, {
@@ -248,10 +240,10 @@ function classifyReachStage(input) {
 		label: "Impressions (28d)",
 		value: formatSearchConsoleCount(imp28d)
 	}], growthProgression("plateaued"));
-	if (imp28d < NASCENT_IMPRESSIONS_28D) return reach("emerging", [{
+	if (imp28d < MIN_GROWTH_IMPRESSIONS_28D) return reach("emerging", [{
 		label: "Impressions (28d)",
 		value: formatSearchConsoleCount(imp28d)
-	}], growthProgression("emerging"));
+	}], advance("growing", "28d impressions", imp28d, MIN_GROWTH_IMPRESSIONS_28D, `${formatSearchConsoleCount(imp28d)} impressions in 28 days. Build enough visibility to measure growth reliably.`));
 	return reach("plateaued", [{
 		label: "Impressions (28d)",
 		value: formatSearchConsoleCount(imp28d)

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: "3.2.0";
+declare const GSCDUMP_REALTIME_V1_SDK_VERSION: "3.3.0";
 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 = "3.2.0";
+const GSCDUMP_REALTIME_V1_SDK_VERSION = "3.3.0";
 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 ?? "3.2.0";
+	const sdkVersion = options.sdkVersion ?? "3.3.0";
 	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": "3.2.0",
+  "version": "3.3.0",
   "description": "Consumer SDK for hosted gscdump.com integrations.",
   "author": {
     "name": "Harlan Wilton",
@@ -144,14 +144,14 @@
     "node": ">=22"
   },
   "dependencies": {
+    "@gscdump/contracts": "^3.3.0",
+    "gscdump": "^3.3.0",
     "ofetch": "^1.5.1",
-    "zod": "^4.4.3",
-    "@gscdump/contracts": "^3.2.0",
-    "gscdump": "^3.2.0"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "build": "obuild",