@gscdump/analysis 0.39.0 → 0.40.1

package/README.md

@@ -89,7 +89,9 @@ const registry = createAnalyzerRegistry({ rows: ROW_ANALYZERS, sql: SQL_ANALYZER
 const result = await runAnalyzerFromSource(source, { type: 'striking-distance', minImpressions: 100 }, registry)
 ```
 
-`attachParquetIndex` and `attachSnapshotIndex` from `@gscdump/engine-duckdb-node` wire parquet files (per-day, per-month, or pre-baked `.duckdb` snapshots) into a DuckDB session. Pair with `analyzeInBrowser` from `@gscdump/analysis` for the attached-table dispatch path.
+`attachParquetIndex` and `attachSnapshotIndex` from `@gscdump/engine/node`
+wire parquet files (per-day, per-month, or pre-baked `.duckdb` snapshots) into
+a Node DuckDB session.
 
 ## Browser (DuckDB-WASM)
 
@@ -98,7 +100,6 @@ import { analyzeInBrowser } from '@gscdump/analysis'
 // Compose your own narrow registry instead of pulling the kitchen-sink default
 // (which statically imports every SQL analyzer). For demo only:
 import { defaultAnalyzerRegistry } from '@gscdump/analysis/registry'
-import { createEngine } from '@gscdump/engine-duckdb-wasm'
 
 const result = await analyzeInBrowser(
   runner,
@@ -110,7 +111,10 @@ const result = await analyzeInBrowser(
 
 `analyzeInBrowser` wraps any runner with `query(sql, params, signal?)` in an `AnalysisQuerySource` with the `attachedTables` capability and dispatches via `runAnalyzerFromSource`.
 
-For typed drizzle-style access, `@gscdump/engine-duckdb-wasm` exports `createEngine` (a `SqlQuerySource`) plus `bootDuckDBWasm`, `attachParquetUrlTables`, `createBrowserAnalysisRuntime`, and `resolveWindow` (re-export from `@gscdump/engine/period`).
+`@gscdump/engine-duckdb-wasm` exports `bootDuckDBWasm`,
+`attachParquetUrlTables`, `createBrowserAnalysisRuntime`, and `resolveWindow`
+(re-exported from `@gscdump/engine/period`). Browser analysis uses attached
+tables rather than a canonical-schema `createEngine`; see ADR-0001.
 
 ## SQLite (D1 / Cloudflare Workers)
 
@@ -148,7 +152,7 @@ Available source factories:
 - `createCompositeSource({ engine, gsc })` — `@gscdump/analysis/source`; engine first, GSC fallback
 - `createInMemoryQuerySource({ queryRows })` — `@gscdump/analysis/source`
 - `createEngineQuerySource({ engine, ctx })` — `@gscdump/engine/source`
-- `createEngine({ ... })` — `@gscdump/engine-duckdb-wasm`, `@gscdump/engine-sqlite`, `@gscdump/engine-duckdb-node`
+- `createEngine({ ... })` — `@gscdump/engine-sqlite`
 
 Portable analyzers currently cover the row-based tools:
 `striking-distance`, `opportunity`, `brand`, `clustering`, `concentration`,
@@ -192,7 +196,7 @@ Presets: `last-7d`, `last-28d`, `last-30d`, `last-90d`, `last-180d`, `last-365d`
 
 - [`gscdump`](../gscdump) — REST client + query builder (edge-safe).
 - [`@gscdump/engine`](../engine) — Parquet/DuckDB storage engine + analyzer/source/period contracts.
-- [`@gscdump/engine-duckdb-node`](../engine-duckdb-node) — Node DuckDB engine factory + parquet/snapshot attach helpers.
+- [`@gscdump/engine/node`](../engine) — Node DuckDB handle + parquet/snapshot attach helpers.
 - [`@gscdump/engine-duckdb-wasm`](../engine-duckdb-wasm) — DuckDB-WASM browser runtime + drizzle adapter.
 - [`@gscdump/engine-sqlite`](../engine-sqlite) — SQLite / D1 dialect adapter.
 - [`@gscdump/engine-gsc-api`](../engine-gsc-api) — GSC live-API engine adapter.

package/dist/analyzer/index.d.mts

@@ -81,6 +81,13 @@ interface BrandSegmentationOptions {
   /** Minimum impressions for a keyword to be included. Default: 10 */
   minImpressions?: number;
 }
+interface BrandSegmentationRow {
+  query?: string;
+  keyword?: string;
+  variants?: readonly string[];
+  clicks?: number | null;
+  impressions?: number | null;
+}
 interface BrandSummary {
   brandClicks: number;
   nonBrandClicks: number;
@@ -88,9 +95,9 @@ interface BrandSummary {
   brandImpressions: number;
   nonBrandImpressions: number;
 }
-interface BrandSegmentationResult {
-  brand: QueriesRow[];
-  nonBrand: QueriesRow[];
+interface BrandSegmentationResult<T extends BrandSegmentationRow = QueriesRow> {
+  brand: T[];
+  nonBrand: T[];
   summary: BrandSummary;
 }
 interface BrandResultRow {
@@ -698,12 +705,6 @@ interface TrendsResult {
   series: TrendSeriesPoint[];
 }
 declare const trendsAnalyzer: import("@gscdump/engine/analyzer").DefinedAnalyzer;
-/**
- * `zero-click` — high impressions, low CTR, good ranking. SQL groups by
- * (query, url) and applies HAVING/WHERE pushdown; row reducer dedupes to the
- * best-positioned page per query (different semantics, kept for parity with
- * the existing live-GSC behavior).
- */
 interface ZeroClickResult {
   query: string;
   page: string;

package/dist/analyzer/index.mjs

@@ -522,8 +522,7 @@ function analyzeBrandSegmentation(keywords, options) {
 		const impressions = num(row.impressions);
 		if (impressions < minImpressions) continue;
 		const clicks = num(row.clicks);
-		const query = row.query.toLowerCase();
-		if (lowerBrandTerms.some((term) => query.includes(term))) {
+		if ((row.variants?.length ? row.variants : [row.query ?? row.keyword ?? ""]).some((query) => lowerBrandTerms.some((term) => query.toLowerCase().includes(term)))) {
 			brand.push(row);
 			brandClicks += clicks;
 			brandImpressions += impressions;
@@ -3502,6 +3501,52 @@ function calculateCtrGapScore(actualCtr, position) {
 	const gap = expectedCtr - actualCtr;
 	return Math.min(gap / expectedCtr, 1);
 }
+const SORT_DIR = {
+	opportunityScore: "desc",
+	potentialClicks: "desc",
+	impressions: "desc",
+	position: "asc"
+};
+function analyzeOpportunity(keywords, options = {}) {
+	const minImpressions = options.minImpressions ?? 100;
+	const positionWeight = options.weights?.position ?? 1;
+	const impressionsWeight = options.weights?.impressions ?? 1;
+	const ctrGapWeight = options.weights?.ctrGap ?? 1;
+	const totalWeight = positionWeight + impressionsWeight + ctrGapWeight;
+	const sortBy = options.sortBy ?? "opportunityScore";
+	const results = [];
+	for (const row of keywords) {
+		const impressions = num(row.impressions);
+		if (impressions < minImpressions) continue;
+		const position = num(row.position);
+		const ctr = num(row.ctr);
+		const clicks = num(row.clicks);
+		const positionScore = calculatePositionScore(position);
+		const impressionScore = calculateImpressionScore(impressions);
+		const ctrGapScore = calculateCtrGapScore(ctr, position);
+		const weightedProduct = positionScore ** positionWeight * impressionScore ** impressionsWeight * ctrGapScore ** ctrGapWeight;
+		const opportunityScore = Math.round(weightedProduct ** (1 / totalWeight) * 100);
+		const potentialClicks = Math.round(impressions * getExpectedCtr(Math.min(3, position)));
+		results.push({
+			keyword: row.query,
+			page: row.page ?? null,
+			clicks,
+			impressions,
+			ctr,
+			position,
+			opportunityScore,
+			potentialClicks,
+			factors: {
+				positionScore,
+				impressionScore,
+				ctrGapScore
+			}
+		});
+	}
+	const direction = SORT_DIR[sortBy];
+	results.sort((left, right) => direction === "asc" ? left[sortBy] - right[sortBy] : right[sortBy] - left[sortBy]);
+	return options.limit ? results.slice(0, options.limit) : results;
+}
 const opportunityAnalyzer = defineAnalyzer({
 	id: "opportunity",
 	buildSql(params) {
@@ -3615,46 +3660,11 @@ const opportunityAnalyzer = defineAnalyzer({
 		return { queries: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
-		const keywords = (Array.isArray(rows) ? rows : []) ?? [];
-		const minImpressions = params.minImpressions ?? 100;
-		const positionWeight = 1;
-		const impressionsWeight = 1;
-		const ctrGapWeight = 1;
-		const sortBy = "opportunityScore";
-		const results = [];
-		for (const row of keywords) {
-			const impressions = num(row.impressions);
-			const position = num(row.position);
-			const ctr = num(row.ctr);
-			const clicks = num(row.clicks);
-			if (impressions < minImpressions) continue;
-			const positionScore = calculatePositionScore(position);
-			const impressionScore = calculateImpressionScore(impressions);
-			const ctrGapScore = calculateCtrGapScore(ctr, position);
-			const geometricMean = (positionScore ** positionWeight * impressionScore ** impressionsWeight * ctrGapScore ** ctrGapWeight) ** (1 / 3);
-			const opportunityScore = Math.round(geometricMean * 100);
-			const targetCtr = getExpectedCtr(Math.min(3, position));
-			const potentialClicks = Math.round(impressions * targetCtr);
-			results.push({
-				keyword: row.query,
-				page: row.page ?? null,
-				clicks,
-				impressions,
-				ctr,
-				position,
-				opportunityScore,
-				potentialClicks,
-				factors: {
-					positionScore,
-					impressionScore,
-					ctrGapScore
-				}
-			});
-		}
+		const results = analyzeOpportunity((Array.isArray(rows) ? rows : []) ?? [], { minImpressions: params.minImpressions });
 		const paged = paginateSortedInMemory(results, {
 			limit: params.limit,
 			offset: params.offset
-		}, (left, right) => right[sortBy] - left[sortBy]);
+		}, (left, right) => right.opportunityScore - left.opportunityScore);
 		return {
 			results: paged,
 			meta: {
@@ -4330,6 +4340,12 @@ const stlDecomposeAnalyzer = defineAnalyzer({
 	}
 });
 const DEFAULT_ROW_LIMIT$1 = 25e3;
+function paginateStrikingDistance(results, options) {
+	return paginateSortedInMemory(results, {
+		limit: options.limit ?? 1e3,
+		offset: options.offset
+	}, (left, right) => right.potentialClicks - left.potentialClicks);
+}
 function filterStrikingDistance(rows, options = {}) {
 	const minPosition = options.minPosition ?? 4;
 	const maxPosition = options.maxPosition ?? 20;
@@ -4360,10 +4376,7 @@ const strikingDistanceAnalyzer = defineAnalyzer({
 	id: "striking-distance",
 	reduce(rows, params) {
 		const results = filterStrikingDistance(Array.isArray(rows) ? rows : [], params);
-		const paged = paginateSortedInMemory(results, {
-			limit: params.limit ?? 1e3,
-			offset: params.offset
-		}, (left, right) => right.potentialClicks - left.potentialClicks);
+		const paged = paginateStrikingDistance(results, params);
 		return {
 			results: paged,
 			meta: {
@@ -4739,6 +4752,18 @@ const trendsAnalyzer = defineAnalyzer({
 	}
 });
 const DEFAULT_ROW_LIMIT = 25e3;
+function analyzeZeroClick(rows, options = {}) {
+	const minImpressions = options.minImpressions ?? 1e3;
+	const maxCtr = options.maxCtr ?? .03;
+	const maxPosition = options.maxPosition ?? 10;
+	const queryMap = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		if (row.impressions < minImpressions || row.position > maxPosition || row.ctr > maxCtr) continue;
+		const existing = queryMap.get(row.query);
+		if (!existing || row.position < existing.position) queryMap.set(row.query, { ...row });
+	}
+	return [...queryMap.values()].sort((left, right) => right.impressions - left.impressions);
+}
 const zeroClickAnalyzer = defineAnalyzer({
 	id: "zero-click",
 	buildSql(params) {
@@ -4822,26 +4847,11 @@ const zeroClickAnalyzer = defineAnalyzer({
 		return { rows: gsc.select(query, page).where(between(date, period.startDate, period.endDate)).limit(limit).getState() };
 	},
 	reduceRows(rows, params) {
-		const arr = Array.isArray(rows) ? rows : [];
-		const minImpressions = params.minImpressions ?? 1e3;
-		const maxCtr = params.maxCtr ?? .03;
-		const maxPosition = params.maxPosition ?? 10;
-		const queryMap = /* @__PURE__ */ new Map();
-		for (const row of arr) {
-			if (row.impressions < minImpressions) continue;
-			if (row.position > maxPosition) continue;
-			if (row.ctr > maxCtr) continue;
-			const existing = queryMap.get(row.query);
-			if (!existing || row.position < existing.position) queryMap.set(row.query, {
-				query: row.query,
-				page: row.page,
-				clicks: row.clicks,
-				impressions: row.impressions,
-				ctr: row.ctr,
-				position: row.position
-			});
-		}
-		const results = Array.from(queryMap.values());
+		const results = analyzeZeroClick(Array.isArray(rows) ? rows : [], {
+			minImpressions: params.minImpressions ?? 1e3,
+			maxCtr: params.maxCtr ?? .03,
+			maxPosition: params.maxPosition ?? 10
+		});
 		const paged = paginateSortedInMemory(results, {
 			limit: params.limit,
 			offset: params.offset

package/dist/default-registry.mjs

@@ -522,8 +522,7 @@ function analyzeBrandSegmentation(keywords, options) {
 		const impressions = num(row.impressions);
 		if (impressions < minImpressions) continue;
 		const clicks = num(row.clicks);
-		const query = row.query.toLowerCase();
-		if (lowerBrandTerms.some((term) => query.includes(term))) {
+		if ((row.variants?.length ? row.variants : [row.query ?? row.keyword ?? ""]).some((query) => lowerBrandTerms.some((term) => query.toLowerCase().includes(term)))) {
 			brand.push(row);
 			brandClicks += clicks;
 			brandImpressions += impressions;
@@ -3496,6 +3495,52 @@ function calculateCtrGapScore(actualCtr, position) {
 	const gap = expectedCtr - actualCtr;
 	return Math.min(gap / expectedCtr, 1);
 }
+const SORT_DIR = {
+	opportunityScore: "desc",
+	potentialClicks: "desc",
+	impressions: "desc",
+	position: "asc"
+};
+function analyzeOpportunity(keywords, options = {}) {
+	const minImpressions = options.minImpressions ?? 100;
+	const positionWeight = options.weights?.position ?? 1;
+	const impressionsWeight = options.weights?.impressions ?? 1;
+	const ctrGapWeight = options.weights?.ctrGap ?? 1;
+	const totalWeight = positionWeight + impressionsWeight + ctrGapWeight;
+	const sortBy = options.sortBy ?? "opportunityScore";
+	const results = [];
+	for (const row of keywords) {
+		const impressions = num(row.impressions);
+		if (impressions < minImpressions) continue;
+		const position = num(row.position);
+		const ctr = num(row.ctr);
+		const clicks = num(row.clicks);
+		const positionScore = calculatePositionScore(position);
+		const impressionScore = calculateImpressionScore(impressions);
+		const ctrGapScore = calculateCtrGapScore(ctr, position);
+		const weightedProduct = positionScore ** positionWeight * impressionScore ** impressionsWeight * ctrGapScore ** ctrGapWeight;
+		const opportunityScore = Math.round(weightedProduct ** (1 / totalWeight) * 100);
+		const potentialClicks = Math.round(impressions * getExpectedCtr(Math.min(3, position)));
+		results.push({
+			keyword: row.query,
+			page: row.page ?? null,
+			clicks,
+			impressions,
+			ctr,
+			position,
+			opportunityScore,
+			potentialClicks,
+			factors: {
+				positionScore,
+				impressionScore,
+				ctrGapScore
+			}
+		});
+	}
+	const direction = SORT_DIR[sortBy];
+	results.sort((left, right) => direction === "asc" ? left[sortBy] - right[sortBy] : right[sortBy] - left[sortBy]);
+	return options.limit ? results.slice(0, options.limit) : results;
+}
 const opportunityAnalyzer = defineAnalyzer({
 	id: "opportunity",
 	buildSql(params) {
@@ -3609,46 +3654,11 @@ const opportunityAnalyzer = defineAnalyzer({
 		return { queries: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
-		const keywords = (Array.isArray(rows) ? rows : []) ?? [];
-		const minImpressions = params.minImpressions ?? 100;
-		const positionWeight = 1;
-		const impressionsWeight = 1;
-		const ctrGapWeight = 1;
-		const sortBy = "opportunityScore";
-		const results = [];
-		for (const row of keywords) {
-			const impressions = num(row.impressions);
-			const position = num(row.position);
-			const ctr = num(row.ctr);
-			const clicks = num(row.clicks);
-			if (impressions < minImpressions) continue;
-			const positionScore = calculatePositionScore(position);
-			const impressionScore = calculateImpressionScore(impressions);
-			const ctrGapScore = calculateCtrGapScore(ctr, position);
-			const geometricMean = (positionScore ** positionWeight * impressionScore ** impressionsWeight * ctrGapScore ** ctrGapWeight) ** (1 / 3);
-			const opportunityScore = Math.round(geometricMean * 100);
-			const targetCtr = getExpectedCtr(Math.min(3, position));
-			const potentialClicks = Math.round(impressions * targetCtr);
-			results.push({
-				keyword: row.query,
-				page: row.page ?? null,
-				clicks,
-				impressions,
-				ctr,
-				position,
-				opportunityScore,
-				potentialClicks,
-				factors: {
-					positionScore,
-					impressionScore,
-					ctrGapScore
-				}
-			});
-		}
+		const results = analyzeOpportunity((Array.isArray(rows) ? rows : []) ?? [], { minImpressions: params.minImpressions });
 		const paged = paginateSortedInMemory(results, {
 			limit: params.limit,
 			offset: params.offset
-		}, (left, right) => right[sortBy] - left[sortBy]);
+		}, (left, right) => right.opportunityScore - left.opportunityScore);
 		return {
 			results: paged,
 			meta: {
@@ -4324,6 +4334,12 @@ const stlDecomposeAnalyzer = defineAnalyzer({
 	}
 });
 const DEFAULT_ROW_LIMIT$1 = 25e3;
+function paginateStrikingDistance(results, options) {
+	return paginateSortedInMemory(results, {
+		limit: options.limit ?? 1e3,
+		offset: options.offset
+	}, (left, right) => right.potentialClicks - left.potentialClicks);
+}
 function filterStrikingDistance(rows, options = {}) {
 	const minPosition = options.minPosition ?? 4;
 	const maxPosition = options.maxPosition ?? 20;
@@ -4354,10 +4370,7 @@ const strikingDistanceAnalyzer = defineAnalyzer({
 	id: "striking-distance",
 	reduce(rows, params) {
 		const results = filterStrikingDistance(Array.isArray(rows) ? rows : [], params);
-		const paged = paginateSortedInMemory(results, {
-			limit: params.limit ?? 1e3,
-			offset: params.offset
-		}, (left, right) => right.potentialClicks - left.potentialClicks);
+		const paged = paginateStrikingDistance(results, params);
 		return {
 			results: paged,
 			meta: {
@@ -4733,6 +4746,18 @@ const trendsAnalyzer = defineAnalyzer({
 	}
 });
 const DEFAULT_ROW_LIMIT = 25e3;
+function analyzeZeroClick(rows, options = {}) {
+	const minImpressions = options.minImpressions ?? 1e3;
+	const maxCtr = options.maxCtr ?? .03;
+	const maxPosition = options.maxPosition ?? 10;
+	const queryMap = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		if (row.impressions < minImpressions || row.position > maxPosition || row.ctr > maxCtr) continue;
+		const existing = queryMap.get(row.query);
+		if (!existing || row.position < existing.position) queryMap.set(row.query, { ...row });
+	}
+	return [...queryMap.values()].sort((left, right) => right.impressions - left.impressions);
+}
 const defaultAnalyzerRegistry = createAnalyzerRegistry({ defined: [
 	bayesianCtrAnalyzer,
 	bipartitePagerankAnalyzer,
@@ -4845,26 +4870,11 @@ const defaultAnalyzerRegistry = createAnalyzerRegistry({ defined: [
 			return { rows: gsc.select(query, page).where(between(date, period.startDate, period.endDate)).limit(limit).getState() };
 		},
 		reduceRows(rows, params) {
-			const arr = Array.isArray(rows) ? rows : [];
-			const minImpressions = params.minImpressions ?? 1e3;
-			const maxCtr = params.maxCtr ?? .03;
-			const maxPosition = params.maxPosition ?? 10;
-			const queryMap = /* @__PURE__ */ new Map();
-			for (const row of arr) {
-				if (row.impressions < minImpressions) continue;
-				if (row.position > maxPosition) continue;
-				if (row.ctr > maxCtr) continue;
-				const existing = queryMap.get(row.query);
-				if (!existing || row.position < existing.position) queryMap.set(row.query, {
-					query: row.query,
-					page: row.page,
-					clicks: row.clicks,
-					impressions: row.impressions,
-					ctr: row.ctr,
-					position: row.position
-				});
-			}
-			const results = Array.from(queryMap.values());
+			const results = analyzeZeroClick(Array.isArray(rows) ? rows : [], {
+				minImpressions: params.minImpressions ?? 1e3,
+				maxCtr: params.maxCtr ?? .03,
+				maxPosition: params.maxPosition ?? 10
+			});
 			const paged = paginateSortedInMemory(results, {
 				limit: params.limit,
 				offset: params.offset

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 import { Analyzer, Analyzer as Analyzer$1, AnalyzerCapabilityError, AnalyzerRegistry, AnalyzerRegistry as AnalyzerRegistry$1, AnalyzerRegistryInit, AnalyzerVariants, DefineAnalyzerOptions, DefinedAnalyzer, Plan, ReduceContext, ReduceCtx, Reducer, RequiredCapability, RowQueriesPlan, SqlExtraQuery, SqlPlan, SqlPlanSpec, TypedRowQuery, createAnalyzerRegistry, defineAnalyzer, runAnalyzerFromSource } from "@gscdump/engine/analyzer";
-import { AnalysisPeriod, ComparisonMode, ComparisonPeriod, PadTimeseriesOptions, ResolveWindowOptions, ResolvedWindow, WindowPreset, comparisonOf, padTimeseries, periodOf, resolveWindow, windowToComparisonPeriod, windowToPeriod } from "@gscdump/engine/period";
+import { AnalysisPeriod, ComparisonMode, ComparisonPeriod, PadTimeseriesOptions, ResolveWindowOptions, ResolvedWindow, WindowPreset, comparisonOf, padTimeseries, periodOf, resolveWindow } from "@gscdump/engine/period";
 import { AnalysisParams, AnalysisParams as AnalysisParams$1, AnalysisResult, AnalysisResult as AnalysisResult$1, AnalysisTool, num } from "@gscdump/engine/analysis-types";
 import { Result } from "gscdump/result";
 import { BuilderState } from "gscdump/query";
-import { AnalysisQuerySource, AnalysisQuerySource as AnalysisQuerySource$1, AnalysisSourceKind, AttachedTableRunner, AttachedTableRunner as AnalyzerRunner, AttachedTableSourceOptions, AttachedTableSourceOptions as BrowserAnalyzeOptions, ENGINE_QUERY_CAPABILITIES, EngineQuerySourceOptions, ExecuteSqlOptions, FileSet, QueryRow, QueryRow as QueryRow$1, SourceCapabilities, TypedQuery, createEngineQuerySource, queryComparisonRows, queryRows, rewriteForTableSource, runAnalyzerWithEngine, typedQuery } from "@gscdump/engine/source";
+import { AnalysisQuerySource, AnalysisQuerySource as AnalysisQuerySource$1, AnalysisSourceKind, AttachedTableRunner, AttachedTableRunner as AnalyzerRunner, AttachedTableSourceOptions, AttachedTableSourceOptions as BrowserAnalyzeOptions, ENGINE_QUERY_CAPABILITIES, EngineQuerySourceOptions, ExecuteSqlOptions, FileSet, QueryRow, QueryRow as QueryRow$1, SourceCapabilities, createEngineQuerySource, queryRows, rewriteForTableSource, runAnalyzerWithEngine } from "@gscdump/engine/source";
 import { DefineReportOptions, DefinedReport, DefinedReport as DefinedReport$1, ReportAction, ReportContext, ReportContext as ReportContext$1, ReportFinding, ReportParams, ReportPlanStep, ReportResult, ReportResult as ReportResult$1, ReportSection } from "@gscdump/engine/report";
 import { PlannerCapabilities } from "gscdump/query/plan";
 type ActionSource = 'cannibalization' | 'striking-distance' | 'ctr-anomaly' | 'change-point' | 'opportunity';
@@ -78,6 +78,13 @@ interface BrandSegmentationOptions {
   /** Minimum impressions for a keyword to be included. Default: 10 */
   minImpressions?: number;
 }
+interface BrandSegmentationRow {
+  query?: string;
+  keyword?: string;
+  variants?: readonly string[];
+  clicks?: number | null;
+  impressions?: number | null;
+}
 interface BrandSummary {
   brandClicks: number;
   nonBrandClicks: number;
@@ -85,16 +92,17 @@ interface BrandSummary {
   brandImpressions: number;
   nonBrandImpressions: number;
 }
-interface BrandSegmentationResult {
-  brand: QueriesRow[];
-  nonBrand: QueriesRow[];
+interface BrandSegmentationResult<T extends BrandSegmentationRow = QueriesRow> {
+  brand: T[];
+  nonBrand: T[];
   summary: BrandSummary;
 }
 /**
  * Pure helper: segment keywords into brand and non-brand based on provided
  * brand terms. Re-exported from `@gscdump/analysis` for portable callers.
  */
-declare function analyzeBrandSegmentation(keywords: QueriesRow[], options: BrandSegmentationOptions): BrandSegmentationResult;
+declare function analyzeBrandSegmentation(keywords: QueriesRow[], options: BrandSegmentationOptions): BrandSegmentationResult<QueriesRow>;
+declare function analyzeBrandSegmentation<T extends BrandSegmentationRow>(keywords: T[], options: BrandSegmentationOptions): BrandSegmentationResult<T>;
 type CannibalizationSortMetric = 'clicks' | 'impressions' | 'positionSpread' | 'pageCount';
 interface CannibalizationOptions {
   /** Minimum impressions for a query to be considered. Default: 10 */
@@ -295,6 +303,7 @@ interface MoversResult {
  * recent changes between two periods.
  */
 declare function analyzeMovers(input: MoversInput, options?: MoversOptions): MoversResult;
+type OpportunitySortMetric = 'opportunityScore' | 'potentialClicks' | 'impressions' | 'position';
 interface OpportunityFactors {
   positionScore: number;
   impressionScore: number;
@@ -311,6 +320,19 @@ interface OpportunityResult {
   potentialClicks: number;
   factors: OpportunityFactors;
 }
+interface OpportunityWeights {
+  position?: number;
+  impressions?: number;
+  ctrGap?: number;
+}
+interface OpportunityOptions {
+  minImpressions?: number;
+  weights?: OpportunityWeights;
+  sortBy?: OpportunitySortMetric;
+  limit?: number;
+}
+/** Pure opportunity scorer shared by hosted and package analyzer callers. */
+declare function analyzeOpportunity(keywords: QueriesRow[], options?: OpportunityOptions): OpportunityResult[];
 type SeasonalityMetric = 'clicks' | 'impressions';
 interface SeasonalityOptions {
   /** Metric to analyze for seasonality. Default: clicks */
@@ -371,12 +393,25 @@ interface StrikingDistanceResult {
   /** Estimated clicks at ~15% CTR (the average for positions 1–3). */
   potentialClicks: number;
 }
-/**
- * `zero-click` — high impressions, low CTR, good ranking. SQL groups by
- * (query, url) and applies HAVING/WHERE pushdown; row reducer dedupes to the
- * best-positioned page per query (different semantics, kept for parity with
- * the existing live-GSC behavior).
- */
+interface StrikingDistanceFilterOptions {
+  minPosition?: number;
+  maxPosition?: number;
+  minImpressions?: number;
+  maxCtr?: number;
+}
+interface StrikingDistanceOptions extends StrikingDistanceFilterOptions {
+  limit?: number;
+  offset?: number;
+}
+/** Pure striking-distance analysis for consumers that already own the rows. */
+declare function analyzeStrikingDistance(rows: readonly {
+  query: unknown;
+  page?: unknown;
+  clicks: unknown;
+  impressions: unknown;
+  ctr: unknown;
+  position: unknown;
+}[], options?: StrikingDistanceOptions): StrikingDistanceResult[];
 interface ZeroClickResult {
   query: string;
   page: string;
@@ -385,6 +420,13 @@ interface ZeroClickResult {
   ctr: number;
   position: number;
 }
+interface ZeroClickOptions {
+  minImpressions?: number;
+  maxCtr?: number;
+  maxPosition?: number;
+}
+/** Pure zero-click detector shared by hosted and package analyzer callers. */
+declare function analyzeZeroClick(rows: QueryPageRow[], options?: ZeroClickOptions): ZeroClickResult[];
 declare function analyzeInBrowser(runner: AttachedTableRunner, opts: AttachedTableSourceOptions, params: AnalysisParams$1, registry: AnalyzerRegistry$1): Promise<AnalysisResult$1>;
 /**
  * Default analyzer registry built from every in-tree analyzer. Convenience
@@ -604,4 +646,4 @@ interface InMemoryQuerySourceOptions {
 }
 declare function createInMemoryQuerySource(options: InMemoryQuerySourceOptions): AnalysisQuerySource$1;
 declare const SQL_ANALYZERS: readonly Analyzer$1[];
-export { type ActionPriorityResult, type ActionPrioritySourceState, type ActionPrioritySourceStatus, type ActionSource, type AnalysisError, type AnalysisErrorKind, type AnalysisParams, type AnalysisPeriod, type AnalysisQuerySource, type AnalysisResult, type AnalysisSourceKind, type AnalysisTool, type Analyzer, AnalyzerCapabilityError, type AnalyzerRegistry, type AnalyzerRegistryInit, type AnalyzerRunner, type AnalyzerVariants, type BaseMetrics, type BrandSegmentationOptions, type BrandSegmentationResult, type BrandSummary, type BrowserAnalyzeOptions, type CannibalizationCompetitor, type CannibalizationEvent, type CannibalizationOptions, type CannibalizationPage, type CannibalizationResult, type CannibalizationSortMetric, type ClusterType, type ClusteringOptions, type ClusteringResult, type ComparisonMode, type ComparisonPeriod, type CompositeSourceOptions, type ConcentrationInput, type ConcentrationItem, type ConcentrationOptions, type ConcentrationResult, type ConcentrationRiskLevel, DEFAULT_PRIORITY_SOURCES, type DateRow, type DecayInput, type DecayOptions, type DecayResult, type DecaySeriesPoint, type DecaySortMetric, type DefineAnalyzerOptions, type DefineReportOptions, type DefinedAnalyzer, type DefinedReport, type DryRunReportResult, ENGINE_QUERY_CAPABILITIES, type Effort, type EngineQuerySourceOptions, type ExecuteSqlOptions, type FileSet, type FormatReportOptions, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, type InMemoryQuerySourceOptions, type IntentClassification, type KeywordCluster, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversSortMetric, NORMALIZER_VERSION, type OpportunityResult, type PadTimeseriesOptions, type PageRow, type Plan, type PriorityAction, type QueriesRow, type QueryPageRow, type QueryRow, REPORTS, ROW_ANALYZERS, type ReduceContext, type ReduceCtx, type Reducer, type ReportAction, type ReportContext, type ReportFinding, type ReportPlanStep, type ReportResult, type ReportSection, type RequiredCapability, type ResolveWindowOptions, type ResolvedWindow, type RowQueriesPlan, type RunReportOptions, SEARCH_INTENT_CODE, SQL_ANALYZERS, type SearchIntent, type SeasonalityMetric, type SeasonalityOptions, type SeasonalityResult, type SitemapDelta, type SitemapHealthDiff, type SitemapHealthInput, type SitemapHealthRow, type SitemapHealthTotals, type SortOrder, type SourceCapabilities, type SqlExtraQuery, type SqlPlan, type SqlPlanSpec, type StrikingDistanceInputRow, type StrikingDistanceResult, type TypedQuery, type TypedRowQuery, type WindowPreset, type ZeroClickResult, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzePageConcentration, analyzeSeasonality, classifyQueryIntent, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, decodeIntent, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryComparisonRows, queryRows, resolveWindow, rewriteForTableSource, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, scorePriorityActions, typedQuery, windowToComparisonPeriod, windowToPeriod };
+export { type ActionPriorityResult, type ActionPrioritySourceState, type ActionPrioritySourceStatus, type ActionSource, type AnalysisError, type AnalysisErrorKind, type AnalysisParams, type AnalysisPeriod, type AnalysisQuerySource, type AnalysisResult, type AnalysisSourceKind, type AnalysisTool, type Analyzer, AnalyzerCapabilityError, type AnalyzerRegistry, type AnalyzerRegistryInit, type AnalyzerRunner, type AnalyzerVariants, type BaseMetrics, type BrandSegmentationOptions, type BrandSegmentationResult, type BrandSegmentationRow, type BrandSummary, type BrowserAnalyzeOptions, type CannibalizationCompetitor, type CannibalizationEvent, type CannibalizationOptions, type CannibalizationPage, type CannibalizationResult, type CannibalizationSortMetric, type ClusterType, type ClusteringOptions, type ClusteringResult, type ComparisonMode, type ComparisonPeriod, type CompositeSourceOptions, type ConcentrationInput, type ConcentrationItem, type ConcentrationOptions, type ConcentrationResult, type ConcentrationRiskLevel, DEFAULT_PRIORITY_SOURCES, type DateRow, type DecayInput, type DecayOptions, type DecayResult, type DecaySeriesPoint, type DecaySortMetric, type DefineAnalyzerOptions, type DefineReportOptions, type DefinedAnalyzer, type DefinedReport, type DryRunReportResult, ENGINE_QUERY_CAPABILITIES, type Effort, type EngineQuerySourceOptions, type ExecuteSqlOptions, type FileSet, type FormatReportOptions, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, type InMemoryQuerySourceOptions, type IntentClassification, type KeywordCluster, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversSortMetric, NORMALIZER_VERSION, type OpportunityFactors, type OpportunityOptions, type OpportunityResult, type OpportunitySortMetric, type OpportunityWeights, type PadTimeseriesOptions, type PageRow, type Plan, type PriorityAction, type QueriesRow, type QueryPageRow, type QueryRow, REPORTS, ROW_ANALYZERS, type ReduceContext, type ReduceCtx, type Reducer, type ReportAction, type ReportContext, type ReportFinding, type ReportPlanStep, type ReportResult, type ReportSection, type RequiredCapability, type ResolveWindowOptions, type ResolvedWindow, type RowQueriesPlan, type RunReportOptions, SEARCH_INTENT_CODE, SQL_ANALYZERS, type SearchIntent, type SeasonalityMetric, type SeasonalityOptions, type SeasonalityResult, type SitemapDelta, type SitemapHealthDiff, type SitemapHealthInput, type SitemapHealthRow, type SitemapHealthTotals, type SortOrder, type SourceCapabilities, type SqlExtraQuery, type SqlPlan, type SqlPlanSpec, type StrikingDistanceInputRow, type StrikingDistanceOptions, type StrikingDistanceResult, type TypedRowQuery, type WindowPreset, type ZeroClickOptions, type ZeroClickResult, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, decodeIntent, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, rewriteForTableSource, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, scorePriorityActions };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { AnalyzerCapabilityError, createAnalyzerRegistry, createAnalyzerRegistry as createAnalyzerRegistry$1, defineAnalyzer, defineAnalyzer as defineAnalyzer$1, requireAdapter, runAnalyzerFromSource, runAnalyzerFromSource as runAnalyzerFromSource$1 } from "@gscdump/engine/analyzer";
-import { comparisonOf, comparisonOf as comparisonOf$1, defaultEndDate, padTimeseries, padTimeseries as padTimeseries$1, periodOf, periodOf as periodOf$1, resolveWindow, windowToComparisonPeriod, windowToPeriod } from "@gscdump/engine/period";
+import { comparisonOf, comparisonOf as comparisonOf$1, defaultEndDate, padTimeseries, padTimeseries as padTimeseries$1, periodOf, periodOf as periodOf$1, resolveWindow } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
 import { num, num as num$1 } from "@gscdump/engine/analysis-types";
@@ -8,7 +8,7 @@ import { between, date, extractDateRange, gsc, page, query } from "gscdump/query
 import { MS_PER_DAY, daysAgoUtc, toIsoDate } from "gscdump/dates";
 import { buildExtrasQueries, buildTotalsSql, mergeExtras, pgResolverAdapter, resolveComparisonSQL, resolveToSQLOptimized } from "@gscdump/engine/resolver";
 import pluralize from "pluralize";
-import { ENGINE_QUERY_CAPABILITIES, createAttachedTableSource, createEngineQuerySource, queryComparisonRows, queryRows, rewriteForTableSource, runAnalyzerWithEngine, typedQuery } from "@gscdump/engine/source";
+import { ENGINE_QUERY_CAPABILITIES, createAttachedTableSource, createEngineQuerySource, queryRows, rewriteForTableSource, runAnalyzerWithEngine } from "@gscdump/engine/source";
 import { computeInputHash, createReportRegistry, defineReport } from "@gscdump/engine/report";
 import { canProxyToGsc } from "@gscdump/engine-gsc-api";
 import { isStateResolvable } from "gscdump/query/plan";
@@ -754,8 +754,7 @@ function analyzeBrandSegmentation(keywords, options) {
 		const impressions = num$1(row.impressions);
 		if (impressions < minImpressions) continue;
 		const clicks = num$1(row.clicks);
-		const query = row.query.toLowerCase();
-		if (lowerBrandTerms.some((term) => query.includes(term))) {
+		if ((row.variants?.length ? row.variants : [row.query ?? row.keyword ?? ""]).some((query) => lowerBrandTerms.some((term) => query.toLowerCase().includes(term)))) {
 			brand.push(row);
 			brandClicks += clicks;
 			brandImpressions += impressions;
@@ -4076,6 +4075,52 @@ function calculateCtrGapScore(actualCtr, position) {
 	const gap = expectedCtr - actualCtr;
 	return Math.min(gap / expectedCtr, 1);
 }
+const SORT_DIR = {
+	opportunityScore: "desc",
+	potentialClicks: "desc",
+	impressions: "desc",
+	position: "asc"
+};
+function analyzeOpportunity(keywords, options = {}) {
+	const minImpressions = options.minImpressions ?? 100;
+	const positionWeight = options.weights?.position ?? 1;
+	const impressionsWeight = options.weights?.impressions ?? 1;
+	const ctrGapWeight = options.weights?.ctrGap ?? 1;
+	const totalWeight = positionWeight + impressionsWeight + ctrGapWeight;
+	const sortBy = options.sortBy ?? "opportunityScore";
+	const results = [];
+	for (const row of keywords) {
+		const impressions = num$1(row.impressions);
+		if (impressions < minImpressions) continue;
+		const position = num$1(row.position);
+		const ctr = num$1(row.ctr);
+		const clicks = num$1(row.clicks);
+		const positionScore = calculatePositionScore(position);
+		const impressionScore = calculateImpressionScore(impressions);
+		const ctrGapScore = calculateCtrGapScore(ctr, position);
+		const weightedProduct = positionScore ** positionWeight * impressionScore ** impressionsWeight * ctrGapScore ** ctrGapWeight;
+		const opportunityScore = Math.round(weightedProduct ** (1 / totalWeight) * 100);
+		const potentialClicks = Math.round(impressions * getExpectedCtr(Math.min(3, position)));
+		results.push({
+			keyword: row.query,
+			page: row.page ?? null,
+			clicks,
+			impressions,
+			ctr,
+			position,
+			opportunityScore,
+			potentialClicks,
+			factors: {
+				positionScore,
+				impressionScore,
+				ctrGapScore
+			}
+		});
+	}
+	const direction = SORT_DIR[sortBy];
+	results.sort((left, right) => direction === "asc" ? left[sortBy] - right[sortBy] : right[sortBy] - left[sortBy]);
+	return options.limit ? results.slice(0, options.limit) : results;
+}
 const opportunityAnalyzer = defineAnalyzer$1({
 	id: "opportunity",
 	buildSql(params) {
@@ -4189,46 +4234,11 @@ const opportunityAnalyzer = defineAnalyzer$1({
 		return { queries: queriesQueryState(periodOf$1(params), params.limit) };
 	},
 	reduceRows(rows, params) {
-		const keywords = (Array.isArray(rows) ? rows : []) ?? [];
-		const minImpressions = params.minImpressions ?? 100;
-		const positionWeight = 1;
-		const impressionsWeight = 1;
-		const ctrGapWeight = 1;
-		const sortBy = "opportunityScore";
-		const results = [];
-		for (const row of keywords) {
-			const impressions = num$1(row.impressions);
-			const position = num$1(row.position);
-			const ctr = num$1(row.ctr);
-			const clicks = num$1(row.clicks);
-			if (impressions < minImpressions) continue;
-			const positionScore = calculatePositionScore(position);
-			const impressionScore = calculateImpressionScore(impressions);
-			const ctrGapScore = calculateCtrGapScore(ctr, position);
-			const geometricMean = (positionScore ** positionWeight * impressionScore ** impressionsWeight * ctrGapScore ** ctrGapWeight) ** (1 / 3);
-			const opportunityScore = Math.round(geometricMean * 100);
-			const targetCtr = getExpectedCtr(Math.min(3, position));
-			const potentialClicks = Math.round(impressions * targetCtr);
-			results.push({
-				keyword: row.query,
-				page: row.page ?? null,
-				clicks,
-				impressions,
-				ctr,
-				position,
-				opportunityScore,
-				potentialClicks,
-				factors: {
-					positionScore,
-					impressionScore,
-					ctrGapScore
-				}
-			});
-		}
+		const results = analyzeOpportunity((Array.isArray(rows) ? rows : []) ?? [], { minImpressions: params.minImpressions });
 		const paged = paginateSortedInMemory(results, {
 			limit: params.limit,
 			offset: params.offset
-		}, (left, right) => right[sortBy] - left[sortBy]);
+		}, (left, right) => right.opportunityScore - left.opportunityScore);
 		return {
 			results: paged,
 			meta: {
@@ -4904,6 +4914,12 @@ const stlDecomposeAnalyzer = defineAnalyzer$1({
 	}
 });
 const DEFAULT_ROW_LIMIT$1 = 25e3;
+function paginateStrikingDistance(results, options) {
+	return paginateSortedInMemory(results, {
+		limit: options.limit ?? 1e3,
+		offset: options.offset
+	}, (left, right) => right.potentialClicks - left.potentialClicks);
+}
 function filterStrikingDistance(rows, options = {}) {
 	const minPosition = options.minPosition ?? 4;
 	const maxPosition = options.maxPosition ?? 20;
@@ -4930,14 +4946,14 @@ function filterStrikingDistance(rows, options = {}) {
 	}
 	return results;
 }
+function analyzeStrikingDistance(rows, options = {}) {
+	return paginateStrikingDistance(filterStrikingDistance(rows, options), options);
+}
 const strikingDistanceAnalyzer = defineAnalyzer$1({
 	id: "striking-distance",
 	reduce(rows, params) {
 		const results = filterStrikingDistance(Array.isArray(rows) ? rows : [], params);
-		const paged = paginateSortedInMemory(results, {
-			limit: params.limit ?? 1e3,
-			offset: params.offset
-		}, (left, right) => right.potentialClicks - left.potentialClicks);
+		const paged = paginateStrikingDistance(results, params);
 		return {
 			results: paged,
 			meta: {
@@ -5313,6 +5329,18 @@ const trendsAnalyzer = defineAnalyzer$1({
 	}
 });
 const DEFAULT_ROW_LIMIT = 25e3;
+function analyzeZeroClick(rows, options = {}) {
+	const minImpressions = options.minImpressions ?? 1e3;
+	const maxCtr = options.maxCtr ?? .03;
+	const maxPosition = options.maxPosition ?? 10;
+	const queryMap = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		if (row.impressions < minImpressions || row.position > maxPosition || row.ctr > maxCtr) continue;
+		const existing = queryMap.get(row.query);
+		if (!existing || row.position < existing.position) queryMap.set(row.query, { ...row });
+	}
+	return [...queryMap.values()].sort((left, right) => right.impressions - left.impressions);
+}
 const ALL_ANALYZERS = [
 	bayesianCtrAnalyzer,
 	bipartitePagerankAnalyzer,
@@ -5425,26 +5453,11 @@ const ALL_ANALYZERS = [
 			return { rows: gsc.select(query, page).where(between(date, period.startDate, period.endDate)).limit(limit).getState() };
 		},
 		reduceRows(rows, params) {
-			const arr = Array.isArray(rows) ? rows : [];
-			const minImpressions = params.minImpressions ?? 1e3;
-			const maxCtr = params.maxCtr ?? .03;
-			const maxPosition = params.maxPosition ?? 10;
-			const queryMap = /* @__PURE__ */ new Map();
-			for (const row of arr) {
-				if (row.impressions < minImpressions) continue;
-				if (row.position > maxPosition) continue;
-				if (row.ctr > maxCtr) continue;
-				const existing = queryMap.get(row.query);
-				if (!existing || row.position < existing.position) queryMap.set(row.query, {
-					query: row.query,
-					page: row.page,
-					clicks: row.clicks,
-					impressions: row.impressions,
-					ctr: row.ctr,
-					position: row.position
-				});
-			}
-			const results = Array.from(queryMap.values());
+			const results = analyzeZeroClick(Array.isArray(rows) ? rows : [], {
+				minImpressions: params.minImpressions ?? 1e3,
+				maxCtr: params.maxCtr ?? .03,
+				maxPosition: params.maxPosition ?? 10
+			});
 			const paged = paginateSortedInMemory(results, {
 				limit: params.limit,
 				offset: params.offset
@@ -7066,4 +7079,4 @@ function createInMemoryQuerySource(options) {
 	};
 }
 const SQL_ANALYZERS = ALL_ANALYZERS.flatMap((d) => d.sql ? [d.sql] : []);
-export { AnalyzerCapabilityError, DEFAULT_PRIORITY_SOURCES, ENGINE_QUERY_CAPABILITIES, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, NORMALIZER_VERSION, REPORTS, ROW_ANALYZERS, SEARCH_INTENT_CODE, SQL_ANALYZERS, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzePageConcentration, analyzeSeasonality, classifyQueryIntent, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, decodeIntent, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryComparisonRows, queryRows, resolveWindow, rewriteForTableSource, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, scorePriorityActions, typedQuery, windowToComparisonPeriod, windowToPeriod };
+export { AnalyzerCapabilityError, DEFAULT_PRIORITY_SOURCES, ENGINE_QUERY_CAPABILITIES, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, NORMALIZER_VERSION, REPORTS, ROW_ANALYZERS, SEARCH_INTENT_CODE, SQL_ANALYZERS, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, decodeIntent, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, rewriteForTableSource, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, scorePriorityActions };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/analysis",
   "type": "module",
-  "version": "0.39.0",
+  "version": "0.40.1",
   "description": "GSC analyzers — striking-distance, opportunity, movers, decay, brand, clustering, concentration, seasonality. Pure row-based + DuckDB-native.",
   "author": {
     "name": "Harlan Wilton",
@@ -74,11 +74,10 @@
     }
   },
   "dependencies": {
-    "drizzle-orm": "1.0.0-rc.3",
     "pluralize": "^8.0.0",
-    "@gscdump/engine": "0.39.0",
-    "@gscdump/engine-gsc-api": "0.39.0",
-    "gscdump": "0.39.0"
+    "@gscdump/engine": "0.40.1",
+    "@gscdump/engine-gsc-api": "0.40.1",
+    "gscdump": "0.40.1"
   },
   "devDependencies": {
     "vitest": "^4.1.10"