@gscdump/analysis 0.20.3 → 0.21.1

package/dist/analyzer/index.d.mts

@@ -67,7 +67,7 @@ interface BaseMetrics {
   position: number;
 }
 /** Keyword row from query */
-interface KeywordRow extends BaseMetrics {
+interface QueriesRow extends BaseMetrics {
   query: string;
   page?: string;
 }
@@ -89,8 +89,8 @@ interface BrandSummary {
   nonBrandImpressions: number;
 }
 interface BrandSegmentationResult {
-  brand: KeywordRow[];
-  nonBrand: KeywordRow[];
+  brand: QueriesRow[];
+  nonBrand: QueriesRow[];
   summary: BrandSummary;
 }
 interface BrandResultRow {
@@ -191,7 +191,7 @@ interface ClusteringOptions {
 interface KeywordCluster {
   clusterName: string;
   clusterType: 'prefix' | 'intent';
-  keywords: KeywordRow[];
+  keywords: QueriesRow[];
   totalClicks: number;
   totalImpressions: number;
   avgPosition: number;
@@ -199,7 +199,7 @@ interface KeywordCluster {
 }
 interface ClusteringResult {
   clusters: KeywordCluster[];
-  unclustered: KeywordRow[];
+  unclustered: QueriesRow[];
 }
 declare const clusteringAnalyzer: import("@gscdump/engine/analyzer").DefinedAnalyzer;
 type ConcentrationRiskLevel = 'low' | 'medium' | 'high';
@@ -430,8 +430,8 @@ interface MoversOptions {
   sortBy?: MoversSortMetric;
 }
 interface MoversInput {
-  current: KeywordRow[];
-  previous: KeywordRow[];
+  current: QueriesRow[];
+  previous: QueriesRow[];
   /** If periods have different lengths, provide normalization factor (previous/current) */
   normalizationFactor?: number;
 }
@@ -702,7 +702,7 @@ interface ZeroClickResult {
   position: number;
 }
 declare const zeroClickAnalyzer: import("@gscdump/engine/analyzer").DefinedAnalyzer;
-declare function keywordsQueryState(period: AnalysisPeriod, limit?: number): BuilderState;
+declare function queriesQueryState(period: AnalysisPeriod, limit?: number): BuilderState;
 declare function pagesQueryState(period: AnalysisPeriod, limit?: number): BuilderState;
 declare function datesQueryState(period: AnalysisPeriod, limit?: number): BuilderState;
 /**
@@ -746,4 +746,4 @@ declare function resolveSort<K extends string>(input: {
   sortBy: K;
   sortDir: 'asc' | 'desc';
 };
-export { type BayesianCtrResult, type BipartitePagerankNode, type BipartitePagerankResult, type BrandResultRow, type BrandSegmentationOptions, type BrandSegmentationResult, type BrandSummary, type CannibalizationCompetitor, type CannibalizationEvent, type CannibalizationOptions, type CannibalizationPage, type CannibalizationResult, type CannibalizationSortMetric, type ChangePointResult, type ChangePointSeriesPoint, type ClusterType, type ClusteringOptions, type ClusteringResult, type ConcentrationInput, type ConcentrationItem, type ConcentrationOptions, type ConcentrationResult, type ConcentrationRiskLevel, type ContentVelocityWeek, type CtrAnomalyResult, type CtrAnomalySeriesPoint, type CtrCurveBucket, type CtrCurveOutlier, type DarkTrafficResult, type DataDetailResult, type DataQueryResult, type DecayInput, type DecayOptions, type DecayResult, type DecaySeriesPoint, type DecaySortMetric, type DeviceGapResult, type IntentAtlasResult, type KeywordBreadthResult, type KeywordCluster, type LongTailResult, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversResultRow, type MoversSeriesPoint, type MoversSortMetric, type OpportunityResult, type PaginateInput, type PositionDistributionResult, type PositionVolatilityDay, type PositionVolatilityResult, type QueryMigrationExample, type QueryMigrationResult, type SeasonalityMetric, type SeasonalityOptions, type SeasonalityResult, type StlDecomposeResult, type StlDecomposeSeriesPoint, type StrikingDistanceInputRow, type StrikingDistanceResult, type SurvivalCurvePoint, type SurvivalResult, type TrendCategory, type TrendSeriesPoint, type TrendsResult, type ZeroClickResult, bayesianCtrAnalyzer, bipartitePagerankAnalyzer, brandAnalyzer, cannibalizationAnalyzer, changePointAnalyzer, clampLimit, clampOffset, clusteringAnalyzer, concentrationAnalyzer, contentVelocityAnalyzer, ctrAnomalyAnalyzer, ctrCurveAnalyzer, darkTrafficAnalyzer, dataDetailAnalyzer, dataQueryAnalyzer, datesQueryState, decayAnalyzer, deviceGapAnalyzer, intentAtlasAnalyzer, keywordBreadthAnalyzer, keywordsQueryState, longTailAnalyzer, moversAnalyzer, opportunityAnalyzer, pagesQueryState, paginateClause, paginateInMemory, positionDistributionAnalyzer, positionVolatilityAnalyzer, queryMigrationAnalyzer, resolveSort, seasonalityAnalyzer, stlDecomposeAnalyzer, strikingDistanceAnalyzer, survivalAnalyzer, trendsAnalyzer, zeroClickAnalyzer };
+export { type BayesianCtrResult, type BipartitePagerankNode, type BipartitePagerankResult, type BrandResultRow, type BrandSegmentationOptions, type BrandSegmentationResult, type BrandSummary, type CannibalizationCompetitor, type CannibalizationEvent, type CannibalizationOptions, type CannibalizationPage, type CannibalizationResult, type CannibalizationSortMetric, type ChangePointResult, type ChangePointSeriesPoint, type ClusterType, type ClusteringOptions, type ClusteringResult, type ConcentrationInput, type ConcentrationItem, type ConcentrationOptions, type ConcentrationResult, type ConcentrationRiskLevel, type ContentVelocityWeek, type CtrAnomalyResult, type CtrAnomalySeriesPoint, type CtrCurveBucket, type CtrCurveOutlier, type DarkTrafficResult, type DataDetailResult, type DataQueryResult, type DecayInput, type DecayOptions, type DecayResult, type DecaySeriesPoint, type DecaySortMetric, type DeviceGapResult, type IntentAtlasResult, type KeywordBreadthResult, type KeywordCluster, type LongTailResult, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversResultRow, type MoversSeriesPoint, type MoversSortMetric, type OpportunityResult, type PaginateInput, type PositionDistributionResult, type PositionVolatilityDay, type PositionVolatilityResult, type QueryMigrationExample, type QueryMigrationResult, type SeasonalityMetric, type SeasonalityOptions, type SeasonalityResult, type StlDecomposeResult, type StlDecomposeSeriesPoint, type StrikingDistanceInputRow, type StrikingDistanceResult, type SurvivalCurvePoint, type SurvivalResult, type TrendCategory, type TrendSeriesPoint, type TrendsResult, type ZeroClickResult, bayesianCtrAnalyzer, bipartitePagerankAnalyzer, brandAnalyzer, cannibalizationAnalyzer, changePointAnalyzer, clampLimit, clampOffset, clusteringAnalyzer, concentrationAnalyzer, contentVelocityAnalyzer, ctrAnomalyAnalyzer, ctrCurveAnalyzer, darkTrafficAnalyzer, dataDetailAnalyzer, dataQueryAnalyzer, datesQueryState, decayAnalyzer, deviceGapAnalyzer, intentAtlasAnalyzer, keywordBreadthAnalyzer, longTailAnalyzer, moversAnalyzer, opportunityAnalyzer, pagesQueryState, paginateClause, paginateInMemory, positionDistributionAnalyzer, positionVolatilityAnalyzer, queriesQueryState, queryMigrationAnalyzer, resolveSort, seasonalityAnalyzer, stlDecomposeAnalyzer, strikingDistanceAnalyzer, survivalAnalyzer, trendsAnalyzer, zeroClickAnalyzer };

package/dist/analyzer/index.mjs

@@ -145,7 +145,7 @@ const bayesianCtrAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -395,7 +395,7 @@ const bipartitePagerankAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -436,7 +436,7 @@ const bipartitePagerankAnalyzer = defineAnalyzer({
 	}
 });
 const DEFAULT_LIMIT$1 = 25e3;
-function keywordsQueryState(period, limit = DEFAULT_LIMIT$1) {
+function queriesQueryState(period, limit = DEFAULT_LIMIT$1) {
 	return gsc.select(query, page).where(between(date, period.startDate, period.endDate)).limit(limit).getState();
 }
 function pagesQueryState(period, limit = DEFAULT_LIMIT$1) {
@@ -513,7 +513,7 @@ const brandAnalyzer = defineAnalyzer({
 				regex
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -555,7 +555,7 @@ const brandAnalyzer = defineAnalyzer({
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf(params), params.limit) };
+		return { queries: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		if (!params.brandTerms?.length) throw new Error("Brand analysis requires brandTerms");
@@ -759,7 +759,7 @@ const cannibalizationAnalyzer = defineAnalyzer({
 				minQueryImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -841,7 +841,7 @@ const cannibalizationAnalyzer = defineAnalyzer({
 		};
 	},
 	buildRows(params) {
-		return { rows: keywordsQueryState(periodOf(params), params.limit) };
+		return { rows: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		const results = analyzeCannibalization(Array.isArray(rows) ? rows : [], {
@@ -1014,7 +1014,7 @@ const changePointAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1220,7 +1220,7 @@ const clusteringAnalyzer = defineAnalyzer({
 				minClusterSize
 			],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1250,7 +1250,7 @@ const clusteringAnalyzer = defineAnalyzer({
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf(params), params.limit) };
+		return { queries: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		const result = analyzeClustering(Array.isArray(rows) ? rows : [], {
@@ -1343,7 +1343,7 @@ const concentrationAnalyzer = defineAnalyzer({
 		const { startDate, endDate } = periodOf(params);
 		const dim = params.dimension || "pages";
 		const topN = params.topN ?? 10;
-		const table = dim === "keywords" ? "keywords" : "pages";
+		const table = dim === "keywords" ? "queries" : "pages";
 		const keyCol = dim === "keywords" ? "query" : "url";
 		return {
 			sql: `
@@ -1441,12 +1441,12 @@ const concentrationAnalyzer = defineAnalyzer({
 		const period = periodOf(params);
 		const out = {};
 		if (dim === "pages") out.pages = pagesQueryState(period, params.limit);
-		else out.keywords = keywordsQueryState(period, params.limit);
+		else out.queries = queriesQueryState(period, params.limit);
 		return out;
 	},
 	reduceRows(rows, params) {
 		const dim = params.dimension || "pages";
-		const arr = Array.isArray(rows) ? rows : rows[dim] ?? [];
+		const arr = Array.isArray(rows) ? rows : rows[dim === "pages" ? "pages" : "queries"] ?? [];
 		return {
 			results: [dim === "pages" ? analyzePageConcentration(arr, { topN: params.topN }) : analyzeKeywordConcentration(arr, { topN: params.topN })],
 			meta: { dimension: dim }
@@ -1506,7 +1506,7 @@ const contentVelocityAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1696,7 +1696,7 @@ const ctrAnomalyAnalyzer = defineAnalyzer({
 				minDailyImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1845,7 +1845,7 @@ const ctrCurveAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1971,11 +1971,11 @@ const darkTrafficAnalyzer = defineAnalyzer({
 			},
 			extraFiles: {
 				KEYWORDS: {
-					table: "keywords",
+					table: "queries",
 					partitions: enumeratePartitions(startDate, endDate)
 				},
 				PAGE_KEYWORDS: {
-					table: "page_keywords",
+					table: "page_queries",
 					partitions: enumeratePartitions(startDate, endDate)
 				}
 			}
@@ -2598,7 +2598,7 @@ const deviceGapAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "devices",
+				table: "dates",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -2832,7 +2832,7 @@ const intentAtlasAnalyzer = defineAnalyzer({
 				minQueryImpressions
 			],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -2940,7 +2940,7 @@ const keywordBreadthAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3101,7 +3101,7 @@ const longTailAnalyzer = defineAnalyzer({
 				minQueryImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3319,11 +3319,11 @@ const moversAnalyzer = defineAnalyzer({
 				changeThreshold
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(cur.startDate, cur.endDate)
 			},
 			previous: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(prev.startDate, prev.endDate)
 			}
 		};
@@ -3366,8 +3366,8 @@ const moversAnalyzer = defineAnalyzer({
 	buildRows(params) {
 		const { current, previous } = comparisonOf(params);
 		return {
-			current: keywordsQueryState(current, params.limit),
-			previous: keywordsQueryState(previous, params.limit)
+			current: queriesQueryState(current, params.limit),
+			previous: queriesQueryState(previous, params.limit)
 		};
 	},
 	reduceRows(rows, params) {
@@ -3545,7 +3545,7 @@ const opportunityAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3572,7 +3572,7 @@ const opportunityAnalyzer = defineAnalyzer({
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf(params), params.limit) };
+		return { queries: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		const keywords = (Array.isArray(rows) ? rows : []) ?? [];
@@ -3654,7 +3654,7 @@ const positionDistributionAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3772,7 +3772,7 @@ const positionVolatilityAnalyzer = defineAnalyzer({
 				minDays
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3929,11 +3929,11 @@ const queryMigrationAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(cur.startDate, cur.endDate)
 			},
 			previous: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(prevStart, prevEnd)
 			}
 		};
@@ -4291,7 +4291,7 @@ const stlDecomposeAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -4388,13 +4388,13 @@ const strikingDistanceAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf(params), params.limit ?? DEFAULT_ROW_LIMIT$1) };
+		return { queries: queriesQueryState(periodOf(params), params.limit ?? DEFAULT_ROW_LIMIT$1) };
 	}
 });
 function str$1(v) {
@@ -4549,7 +4549,7 @@ const survivalAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -4621,7 +4621,7 @@ const trendsAnalyzer = defineAnalyzer({
 		const minWeeksWithData = params.minWeeksWithData ?? Math.max(2, Math.floor(weeks / 4));
 		const limit = params.limit ?? 500;
 		const dim = params.dimension === "keywords" ? "keywords" : "pages";
-		const table = dim === "keywords" ? "keywords" : "pages";
+		const table = dim === "keywords" ? "queries" : "pages";
 		return {
 			sql: `
     WITH bucketed AS (
@@ -4810,7 +4810,7 @@ const zeroClickAnalyzer = defineAnalyzer({
 				maxCtr
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -4877,4 +4877,4 @@ const zeroClickAnalyzer = defineAnalyzer({
 		};
 	}
 });
-export { bayesianCtrAnalyzer, bipartitePagerankAnalyzer, brandAnalyzer, cannibalizationAnalyzer, changePointAnalyzer, clampLimit, clampOffset, clusteringAnalyzer, concentrationAnalyzer, contentVelocityAnalyzer, ctrAnomalyAnalyzer, ctrCurveAnalyzer, darkTrafficAnalyzer, dataDetailAnalyzer, dataQueryAnalyzer, datesQueryState, decayAnalyzer, deviceGapAnalyzer, intentAtlasAnalyzer, keywordBreadthAnalyzer, keywordsQueryState, longTailAnalyzer, moversAnalyzer, opportunityAnalyzer, pagesQueryState, paginateClause, paginateInMemory, positionDistributionAnalyzer, positionVolatilityAnalyzer, queryMigrationAnalyzer, resolveSort, seasonalityAnalyzer, stlDecomposeAnalyzer, strikingDistanceAnalyzer, survivalAnalyzer, trendsAnalyzer, zeroClickAnalyzer };
+export { bayesianCtrAnalyzer, bipartitePagerankAnalyzer, brandAnalyzer, cannibalizationAnalyzer, changePointAnalyzer, clampLimit, clampOffset, clusteringAnalyzer, concentrationAnalyzer, contentVelocityAnalyzer, ctrAnomalyAnalyzer, ctrCurveAnalyzer, darkTrafficAnalyzer, dataDetailAnalyzer, dataQueryAnalyzer, datesQueryState, decayAnalyzer, deviceGapAnalyzer, intentAtlasAnalyzer, keywordBreadthAnalyzer, longTailAnalyzer, moversAnalyzer, opportunityAnalyzer, pagesQueryState, paginateClause, paginateInMemory, positionDistributionAnalyzer, positionVolatilityAnalyzer, queriesQueryState, queryMigrationAnalyzer, resolveSort, seasonalityAnalyzer, stlDecomposeAnalyzer, strikingDistanceAnalyzer, survivalAnalyzer, trendsAnalyzer, zeroClickAnalyzer };

package/dist/default-registry.mjs

@@ -145,7 +145,7 @@ const bayesianCtrAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -395,7 +395,7 @@ const bipartitePagerankAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -436,7 +436,7 @@ const bipartitePagerankAnalyzer = defineAnalyzer({
 	}
 });
 const DEFAULT_LIMIT$1 = 25e3;
-function keywordsQueryState(period, limit = DEFAULT_LIMIT$1) {
+function queriesQueryState(period, limit = DEFAULT_LIMIT$1) {
 	return gsc.select(query, page).where(between(date, period.startDate, period.endDate)).limit(limit).getState();
 }
 function pagesQueryState(period, limit = DEFAULT_LIMIT$1) {
@@ -513,7 +513,7 @@ const brandAnalyzer = defineAnalyzer({
 				regex
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -555,7 +555,7 @@ const brandAnalyzer = defineAnalyzer({
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf(params), params.limit) };
+		return { queries: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		if (!params.brandTerms?.length) throw new Error("Brand analysis requires brandTerms");
@@ -759,7 +759,7 @@ const cannibalizationAnalyzer = defineAnalyzer({
 				minQueryImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -841,7 +841,7 @@ const cannibalizationAnalyzer = defineAnalyzer({
 		};
 	},
 	buildRows(params) {
-		return { rows: keywordsQueryState(periodOf(params), params.limit) };
+		return { rows: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		const results = analyzeCannibalization(Array.isArray(rows) ? rows : [], {
@@ -1014,7 +1014,7 @@ const changePointAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1220,7 +1220,7 @@ const clusteringAnalyzer = defineAnalyzer({
 				minClusterSize
 			],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1250,7 +1250,7 @@ const clusteringAnalyzer = defineAnalyzer({
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf(params), params.limit) };
+		return { queries: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		const result = analyzeClustering(Array.isArray(rows) ? rows : [], {
@@ -1343,7 +1343,7 @@ const concentrationAnalyzer = defineAnalyzer({
 		const { startDate, endDate } = periodOf(params);
 		const dim = params.dimension || "pages";
 		const topN = params.topN ?? 10;
-		const table = dim === "keywords" ? "keywords" : "pages";
+		const table = dim === "keywords" ? "queries" : "pages";
 		const keyCol = dim === "keywords" ? "query" : "url";
 		return {
 			sql: `
@@ -1441,12 +1441,12 @@ const concentrationAnalyzer = defineAnalyzer({
 		const period = periodOf(params);
 		const out = {};
 		if (dim === "pages") out.pages = pagesQueryState(period, params.limit);
-		else out.keywords = keywordsQueryState(period, params.limit);
+		else out.queries = queriesQueryState(period, params.limit);
 		return out;
 	},
 	reduceRows(rows, params) {
 		const dim = params.dimension || "pages";
-		const arr = Array.isArray(rows) ? rows : rows[dim] ?? [];
+		const arr = Array.isArray(rows) ? rows : rows[dim === "pages" ? "pages" : "queries"] ?? [];
 		return {
 			results: [dim === "pages" ? analyzePageConcentration(arr, { topN: params.topN }) : analyzeKeywordConcentration(arr, { topN: params.topN })],
 			meta: { dimension: dim }
@@ -1506,7 +1506,7 @@ const contentVelocityAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1696,7 +1696,7 @@ const ctrAnomalyAnalyzer = defineAnalyzer({
 				minDailyImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1845,7 +1845,7 @@ const ctrCurveAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1971,11 +1971,11 @@ const darkTrafficAnalyzer = defineAnalyzer({
 			},
 			extraFiles: {
 				KEYWORDS: {
-					table: "keywords",
+					table: "queries",
 					partitions: enumeratePartitions(startDate, endDate)
 				},
 				PAGE_KEYWORDS: {
-					table: "page_keywords",
+					table: "page_queries",
 					partitions: enumeratePartitions(startDate, endDate)
 				}
 			}
@@ -2598,7 +2598,7 @@ const deviceGapAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "devices",
+				table: "dates",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -2832,7 +2832,7 @@ const intentAtlasAnalyzer = defineAnalyzer({
 				minQueryImpressions
 			],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -2940,7 +2940,7 @@ const keywordBreadthAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3101,7 +3101,7 @@ const longTailAnalyzer = defineAnalyzer({
 				minQueryImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3319,11 +3319,11 @@ const moversAnalyzer = defineAnalyzer({
 				changeThreshold
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(cur.startDate, cur.endDate)
 			},
 			previous: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(prev.startDate, prev.endDate)
 			}
 		};
@@ -3366,8 +3366,8 @@ const moversAnalyzer = defineAnalyzer({
 	buildRows(params) {
 		const { current, previous } = comparisonOf(params);
 		return {
-			current: keywordsQueryState(current, params.limit),
-			previous: keywordsQueryState(previous, params.limit)
+			current: queriesQueryState(current, params.limit),
+			previous: queriesQueryState(previous, params.limit)
 		};
 	},
 	reduceRows(rows, params) {
@@ -3539,7 +3539,7 @@ const opportunityAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3566,7 +3566,7 @@ const opportunityAnalyzer = defineAnalyzer({
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf(params), params.limit) };
+		return { queries: queriesQueryState(periodOf(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		const keywords = (Array.isArray(rows) ? rows : []) ?? [];
@@ -3648,7 +3648,7 @@ const positionDistributionAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3766,7 +3766,7 @@ const positionVolatilityAnalyzer = defineAnalyzer({
 				minDays
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3923,11 +3923,11 @@ const queryMigrationAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(cur.startDate, cur.endDate)
 			},
 			previous: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(prevStart, prevEnd)
 			}
 		};
@@ -4285,7 +4285,7 @@ const stlDecomposeAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -4382,13 +4382,13 @@ const strikingDistanceAnalyzer = defineAnalyzer({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf(params), params.limit ?? DEFAULT_ROW_LIMIT$1) };
+		return { queries: queriesQueryState(periodOf(params), params.limit ?? DEFAULT_ROW_LIMIT$1) };
 	}
 });
 function str$1(v) {
@@ -4543,7 +4543,7 @@ const survivalAnalyzer = defineAnalyzer({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -4615,7 +4615,7 @@ const trendsAnalyzer = defineAnalyzer({
 		const minWeeksWithData = params.minWeeksWithData ?? Math.max(2, Math.floor(weeks / 4));
 		const limit = params.limit ?? 500;
 		const dim = params.dimension === "keywords" ? "keywords" : "pages";
-		const table = dim === "keywords" ? "keywords" : "pages";
+		const table = dim === "keywords" ? "queries" : "pages";
 		return {
 			sql: `
     WITH bucketed AS (
@@ -4833,7 +4833,7 @@ const defaultAnalyzerRegistry = createAnalyzerRegistry({ defined: [
 					maxCtr
 				],
 				current: {
-					table: "page_keywords",
+					table: "page_queries",
 					partitions: enumeratePartitions(startDate, endDate)
 				}
 			};

package/dist/index.d.mts

@@ -52,7 +52,7 @@ interface BaseMetrics {
   position: number;
 }
 /** Keyword row from query */
-interface KeywordRow extends BaseMetrics {
+interface QueriesRow extends BaseMetrics {
   query: string;
   page?: string;
 }
@@ -85,15 +85,15 @@ interface BrandSummary {
   nonBrandImpressions: number;
 }
 interface BrandSegmentationResult {
-  brand: KeywordRow[];
-  nonBrand: KeywordRow[];
+  brand: QueriesRow[];
+  nonBrand: QueriesRow[];
   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: KeywordRow[], options: BrandSegmentationOptions): BrandSegmentationResult;
+declare function analyzeBrandSegmentation(keywords: QueriesRow[], options: BrandSegmentationOptions): BrandSegmentationResult;
 type CannibalizationSortMetric = 'clicks' | 'impressions' | 'positionSpread' | 'pageCount';
 interface CannibalizationOptions {
   /** Minimum impressions for a query to be considered. Default: 10 */
@@ -162,7 +162,7 @@ interface ClusteringOptions {
 interface KeywordCluster {
   clusterName: string;
   clusterType: 'prefix' | 'intent';
-  keywords: KeywordRow[];
+  keywords: QueriesRow[];
   totalClicks: number;
   totalImpressions: number;
   avgPosition: number;
@@ -170,13 +170,13 @@ interface KeywordCluster {
 }
 interface ClusteringResult {
   clusters: KeywordCluster[];
-  unclustered: KeywordRow[];
+  unclustered: QueriesRow[];
 }
 /**
  * Pure helper: clusters keywords by intent prefix or common word prefix.
  * Re-exported from `@gscdump/analysis` for portable callers.
  */
-declare function analyzeClustering(keywords: KeywordRow[], options?: ClusteringOptions): ClusteringResult;
+declare function analyzeClustering(keywords: QueriesRow[], options?: ClusteringOptions): ClusteringResult;
 type ConcentrationRiskLevel = 'low' | 'medium' | 'high';
 interface ConcentrationOptions {
   /** Number of top items to report. Default: 10 */
@@ -216,7 +216,7 @@ declare function analyzePageConcentration(pages: PageRow[], options?: Concentrat
 /**
  * Keyword concentration analysis.
  */
-declare function analyzeKeywordConcentration(keywords: KeywordRow[], options?: ConcentrationOptions): ConcentrationResult;
+declare function analyzeKeywordConcentration(keywords: QueriesRow[], options?: ConcentrationOptions): ConcentrationResult;
 type DecaySortMetric = 'lostClicks' | 'declinePercent' | 'currentClicks';
 interface DecayOptions {
   /** Minimum clicks in previous period to consider. Default: 50 */
@@ -261,8 +261,8 @@ interface MoversOptions {
   sortBy?: MoversSortMetric;
 }
 interface MoversInput {
-  current: KeywordRow[];
-  previous: KeywordRow[];
+  current: QueriesRow[];
+  previous: QueriesRow[];
   /** If periods have different lengths, provide normalization factor (previous/current) */
   normalizationFactor?: number;
 }
@@ -498,4 +498,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 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, IN_MEMORY_DEFAULT_CAPABILITIES, type InMemoryQuerySourceOptions, type KeywordCluster, type KeywordRow, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversSortMetric, type OpportunityResult, type PadTimeseriesOptions, type PageRow, type Plan, type PriorityAction, 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, SQL_ANALYZERS, 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, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzePageConcentration, analyzeSeasonality, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, formatReport, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryComparisonRows, queryRows, resolveWindow, rewriteForTableSource, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, scorePriorityActions, typedQuery, windowToComparisonPeriod, windowToPeriod };
+export { type ActionPriorityResult, type ActionPrioritySourceState, type ActionPrioritySourceStatus, type ActionSource, 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, IN_MEMORY_DEFAULT_CAPABILITIES, type InMemoryQuerySourceOptions, type KeywordCluster, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversSortMetric, 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, SQL_ANALYZERS, 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, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzePageConcentration, analyzeSeasonality, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, formatReport, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryComparisonRows, queryRows, resolveWindow, rewriteForTableSource, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, scorePriorityActions, typedQuery, windowToComparisonPeriod, windowToPeriod };

package/dist/index.mjs

@@ -362,7 +362,7 @@ const bayesianCtrAnalyzer = defineAnalyzer$1({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -612,7 +612,7 @@ const bipartitePagerankAnalyzer = defineAnalyzer$1({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -653,7 +653,7 @@ const bipartitePagerankAnalyzer = defineAnalyzer$1({
 	}
 });
 const DEFAULT_LIMIT$2 = 25e3;
-function keywordsQueryState(period, limit = DEFAULT_LIMIT$2) {
+function queriesQueryState(period, limit = DEFAULT_LIMIT$2) {
 	return gsc.select(query, page).where(between(date, period.startDate, period.endDate)).limit(limit).getState();
 }
 function pagesQueryState(period, limit = DEFAULT_LIMIT$2) {
@@ -730,7 +730,7 @@ const brandAnalyzer = defineAnalyzer$1({
 				regex
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -772,7 +772,7 @@ const brandAnalyzer = defineAnalyzer$1({
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf$1(params), params.limit) };
+		return { queries: queriesQueryState(periodOf$1(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		if (!params.brandTerms?.length) throw new Error("Brand analysis requires brandTerms");
@@ -976,7 +976,7 @@ const cannibalizationAnalyzer = defineAnalyzer$1({
 				minQueryImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1058,7 +1058,7 @@ const cannibalizationAnalyzer = defineAnalyzer$1({
 		};
 	},
 	buildRows(params) {
-		return { rows: keywordsQueryState(periodOf$1(params), params.limit) };
+		return { rows: queriesQueryState(periodOf$1(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		const results = analyzeCannibalization(Array.isArray(rows) ? rows : [], {
@@ -1231,7 +1231,7 @@ const changePointAnalyzer = defineAnalyzer$1({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1437,7 +1437,7 @@ const clusteringAnalyzer = defineAnalyzer$1({
 				minClusterSize
 			],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1467,7 +1467,7 @@ const clusteringAnalyzer = defineAnalyzer$1({
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf$1(params), params.limit) };
+		return { queries: queriesQueryState(periodOf$1(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		const result = analyzeClustering(Array.isArray(rows) ? rows : [], {
@@ -1560,7 +1560,7 @@ const concentrationAnalyzer = defineAnalyzer$1({
 		const { startDate, endDate } = periodOf$1(params);
 		const dim = params.dimension || "pages";
 		const topN = params.topN ?? 10;
-		const table = dim === "keywords" ? "keywords" : "pages";
+		const table = dim === "keywords" ? "queries" : "pages";
 		const keyCol = dim === "keywords" ? "query" : "url";
 		return {
 			sql: `
@@ -1658,12 +1658,12 @@ const concentrationAnalyzer = defineAnalyzer$1({
 		const period = periodOf$1(params);
 		const out = {};
 		if (dim === "pages") out.pages = pagesQueryState(period, params.limit);
-		else out.keywords = keywordsQueryState(period, params.limit);
+		else out.queries = queriesQueryState(period, params.limit);
 		return out;
 	},
 	reduceRows(rows, params) {
 		const dim = params.dimension || "pages";
-		const arr = Array.isArray(rows) ? rows : rows[dim] ?? [];
+		const arr = Array.isArray(rows) ? rows : rows[dim === "pages" ? "pages" : "queries"] ?? [];
 		return {
 			results: [dim === "pages" ? analyzePageConcentration(arr, { topN: params.topN }) : analyzeKeywordConcentration(arr, { topN: params.topN })],
 			meta: { dimension: dim }
@@ -1723,7 +1723,7 @@ const contentVelocityAnalyzer = defineAnalyzer$1({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -1913,7 +1913,7 @@ const ctrAnomalyAnalyzer = defineAnalyzer$1({
 				minDailyImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -2062,7 +2062,7 @@ const ctrCurveAnalyzer = defineAnalyzer$1({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -2188,11 +2188,11 @@ const darkTrafficAnalyzer = defineAnalyzer$1({
 			},
 			extraFiles: {
 				KEYWORDS: {
-					table: "keywords",
+					table: "queries",
 					partitions: enumeratePartitions(startDate, endDate)
 				},
 				PAGE_KEYWORDS: {
-					table: "page_keywords",
+					table: "page_queries",
 					partitions: enumeratePartitions(startDate, endDate)
 				}
 			}
@@ -2964,7 +2964,7 @@ const deviceGapAnalyzer = defineAnalyzer$1({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "devices",
+				table: "dates",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3198,7 +3198,7 @@ const intentAtlasAnalyzer = defineAnalyzer$1({
 				minQueryImpressions
 			],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3306,7 +3306,7 @@ const keywordBreadthAnalyzer = defineAnalyzer$1({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3467,7 +3467,7 @@ const longTailAnalyzer = defineAnalyzer$1({
 				minQueryImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3681,11 +3681,11 @@ const moversAnalyzer = defineAnalyzer$1({
 				changeThreshold
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(cur.startDate, cur.endDate)
 			},
 			previous: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(prev.startDate, prev.endDate)
 			}
 		};
@@ -3728,8 +3728,8 @@ const moversAnalyzer = defineAnalyzer$1({
 	buildRows(params) {
 		const { current, previous } = comparisonOf$1(params);
 		return {
-			current: keywordsQueryState(current, params.limit),
-			previous: keywordsQueryState(previous, params.limit)
+			current: queriesQueryState(current, params.limit),
+			previous: queriesQueryState(previous, params.limit)
 		};
 	},
 	reduceRows(rows, params) {
@@ -3901,7 +3901,7 @@ const opportunityAnalyzer = defineAnalyzer$1({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -3928,7 +3928,7 @@ const opportunityAnalyzer = defineAnalyzer$1({
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf$1(params), params.limit) };
+		return { queries: queriesQueryState(periodOf$1(params), params.limit) };
 	},
 	reduceRows(rows, params) {
 		const keywords = (Array.isArray(rows) ? rows : []) ?? [];
@@ -4010,7 +4010,7 @@ const positionDistributionAnalyzer = defineAnalyzer$1({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "keywords",
+				table: "queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -4128,7 +4128,7 @@ const positionVolatilityAnalyzer = defineAnalyzer$1({
 				minDays
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -4285,11 +4285,11 @@ const queryMigrationAnalyzer = defineAnalyzer$1({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(cur.startDate, cur.endDate)
 			},
 			previous: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(prevStart, prevEnd)
 			}
 		};
@@ -4647,7 +4647,7 @@ const stlDecomposeAnalyzer = defineAnalyzer$1({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -4744,13 +4744,13 @@ const strikingDistanceAnalyzer = defineAnalyzer$1({
   `,
 			params: [startDate, endDate],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
 	},
 	buildRows(params) {
-		return { keywords: keywordsQueryState(periodOf$1(params), params.limit ?? DEFAULT_ROW_LIMIT$1) };
+		return { queries: queriesQueryState(periodOf$1(params), params.limit ?? DEFAULT_ROW_LIMIT$1) };
 	}
 });
 function str$1(v) {
@@ -4905,7 +4905,7 @@ const survivalAnalyzer = defineAnalyzer$1({
 				minImpressions
 			],
 			current: {
-				table: "page_keywords",
+				table: "page_queries",
 				partitions: enumeratePartitions(startDate, endDate)
 			}
 		};
@@ -4977,7 +4977,7 @@ const trendsAnalyzer = defineAnalyzer$1({
 		const minWeeksWithData = params.minWeeksWithData ?? Math.max(2, Math.floor(weeks / 4));
 		const limit = params.limit ?? 500;
 		const dim = params.dimension === "keywords" ? "keywords" : "pages";
-		const table = dim === "keywords" ? "keywords" : "pages";
+		const table = dim === "keywords" ? "queries" : "pages";
 		return {
 			sql: `
     WITH bucketed AS (
@@ -5195,7 +5195,7 @@ const ALL_ANALYZERS = [
 					maxCtr
 				],
 				current: {
-					table: "page_keywords",
+					table: "page_queries",
 					partitions: enumeratePartitions(startDate, endDate)
 				}
 			};

package/dist/semantic/index.d.mts

@@ -35,7 +35,7 @@ interface ContentGapOptions {
 }
 /**
  * Content-gap requires a source with a raw-SQL escape hatch. The analyzer's
- * query shape (CTEs + window functions against `main.page_keywords`) isn't
+ * query shape (CTEs + window functions against `main.page_queries`) isn't
  * expressible as a {@link BuilderState}, so it bypasses `queryRows` and
  * goes directly through `source.executeSql`.
  */

package/dist/semantic/index.mjs

@@ -179,7 +179,7 @@ async function fetchContentGapInputs(executeSql, options) {
         SUM(impressions)::BIGINT AS total_impressions,
         SUM(clicks)::BIGINT AS total_clicks,
         SUM(sum_position) / NULLIF(SUM(impressions), 0) + 1 AS avg_position
-      FROM main.page_keywords
+      FROM main.page_queries
       WHERE query IS NOT NULL AND query <> ''
       GROUP BY query
       HAVING SUM(impressions) >= ?
@@ -191,7 +191,7 @@ async function fetchContentGapInputs(executeSql, options) {
         SUM(pk.impressions)::BIGINT AS url_impressions,
         SUM(pk.sum_position) / NULLIF(SUM(pk.impressions), 0) + 1 AS url_position,
         ROW_NUMBER() OVER (PARTITION BY pk.query ORDER BY SUM(pk.impressions) DESC) AS rnk
-      FROM main.page_keywords pk
+      FROM main.page_queries pk
       JOIN query_totals qt USING (query)
       WHERE pk.url IS NOT NULL AND pk.url <> ''
       GROUP BY pk.query, pk.url
@@ -204,7 +204,7 @@ async function fetchContentGapInputs(executeSql, options) {
   `, [Number(options.minImpressions), Number(options.maxQueries)]);
 	const urlRows = await executeSql(`
     SELECT url, SUM(impressions)::BIGINT AS impressions
-    FROM main.page_keywords
+    FROM main.page_queries
     WHERE url IS NOT NULL AND url <> ''
     GROUP BY url
     ORDER BY impressions DESC

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/analysis",
   "type": "module",
-  "version": "0.20.3",
+  "version": "0.21.1",
   "description": "GSC analyzers — striking-distance, opportunity, movers, decay, brand, clustering, concentration, seasonality. Pure row-based + DuckDB-native.",
   "author": {
     "name": "Harlan Wilton",
@@ -75,9 +75,9 @@
   },
   "dependencies": {
     "drizzle-orm": "^0.45.2",
-    "@gscdump/engine": "0.20.3",
-    "@gscdump/engine-gsc-api": "0.20.3",
-    "gscdump": "0.20.3"
+    "@gscdump/engine": "0.21.1",
+    "@gscdump/engine-gsc-api": "0.21.1",
+    "gscdump": "0.21.1"
   },
   "devDependencies": {
     "vitest": "^4.1.6"