@gscdump/analysis 0.19.2 → 0.19.4

package/dist/analyzer/index.mjs

@@ -2115,6 +2115,142 @@ function buildDataQueryPlan(params, options) {
 		extraQueries
 	};
 }
+function totalsState(state) {
+	return {
+		...state,
+		dimensions: [],
+		orderBy: void 0,
+		rowLimit: 1
+	};
+}
+function readTotals(row) {
+	return {
+		clicks: Number(row?.clicks ?? 0),
+		impressions: Number(row?.impressions ?? 0),
+		ctr: Number(row?.ctr ?? 0),
+		position: Number(row?.position ?? 0)
+	};
+}
+function buildDataQueryRows(params) {
+	const state = requireBuilderState(params.q, "data-query");
+	if (state.dimensions.includes("date")) throw new Error("data-query: date dimension not supported; use data-detail");
+	const queries = {
+		main: state,
+		totals: totalsState(state)
+	};
+	const prev = optionalBuilderState(params.qc, "data-query", "qc");
+	if (prev) {
+		queries.prevMain = prev;
+		queries.prevTotals = totalsState(prev);
+	}
+	return queries;
+}
+function shapeDataQueryRowResults(rowMap, params) {
+	const main = (rowMap.main ?? []).map((r) => coerceNumericCols(r));
+	const totals = readTotals(rowMap.totals?.[0]);
+	if (params.qc == null) return {
+		results: main,
+		meta: {
+			totalCount: main.length,
+			totals
+		}
+	};
+	const state = requireBuilderState(params.q, "data-query");
+	const dims = state.dimensions;
+	const keyOf = (row) => dims.map((d) => String(row[d] ?? "")).join("\0");
+	const prevByKey = /* @__PURE__ */ new Map();
+	for (const r of rowMap.prevMain ?? []) prevByKey.set(keyOf(r), r);
+	const filter = params.comparisonFilter;
+	const merged = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const cur of main) {
+		const key = keyOf(cur);
+		seen.add(key);
+		const prev = prevByKey.get(key);
+		const row = {
+			...cur,
+			prevClicks: Number(prev?.clicks ?? 0),
+			prevImpressions: Number(prev?.impressions ?? 0),
+			prevCtr: Number(prev?.ctr ?? 0),
+			prevPosition: Number(prev?.position ?? 0)
+		};
+		if (passesComparisonFilter(filter, {
+			isNew: !prev,
+			isLost: false,
+			clicksChange: Number(cur.clicks ?? 0) - Number(prev?.clicks ?? 0)
+		})) merged.push(row);
+	}
+	for (const prev of rowMap.prevMain ?? []) {
+		const p = prev;
+		const key = keyOf(p);
+		if (seen.has(key)) continue;
+		const row = {
+			...p,
+			clicks: 0,
+			impressions: 0,
+			ctr: 0,
+			position: 0,
+			prevClicks: Number(p.clicks ?? 0),
+			prevImpressions: Number(p.impressions ?? 0),
+			prevCtr: Number(p.ctr ?? 0),
+			prevPosition: Number(p.position ?? 0)
+		};
+		if (passesComparisonFilter(filter, {
+			isNew: false,
+			isLost: true,
+			clicksChange: -Number(p.clicks ?? 0)
+		})) merged.push(row);
+	}
+	if (state.orderBy) {
+		const { column, dir } = state.orderBy;
+		merged.sort((a, b) => {
+			const av = Number(a[column]) || 0;
+			const bv = Number(b[column]) || 0;
+			return dir === "asc" ? av - bv : bv - av;
+		});
+	}
+	return {
+		results: merged.map((r) => coerceNumericCols(r)),
+		meta: {
+			totalCount: merged.length,
+			totals
+		}
+	};
+}
+function passesComparisonFilter(filter, ctx) {
+	switch (filter) {
+		case "new": return ctx.isNew;
+		case "lost": return ctx.isLost;
+		case "improving": return ctx.clicksChange > 0;
+		case "declining": return ctx.clicksChange < 0;
+		default: return true;
+	}
+}
+function buildDataDetailRows(params) {
+	const state = requireBuilderState(params.q, "data-detail");
+	if (!state.dimensions.includes("date")) throw new Error("data-detail: `date` dimension is required");
+	const queries = {
+		main: state,
+		totals: totalsState(state)
+	};
+	const prev = optionalBuilderState(params.qc, "data-detail", "qc");
+	if (prev) queries.prevTotals = totalsState(prev);
+	return queries;
+}
+function shapeDataDetailRowResults(rowMap, params) {
+	const { startDate, endDate } = extractDateRange(requireBuilderState(params.q, "data-detail").filter);
+	const coerced = (rowMap.main ?? []).map((r) => coerceNumericCols(r));
+	const daily = startDate && endDate ? padTimeseries(coerced, {
+		startDate,
+		endDate
+	}) : coerced;
+	const meta = { totals: readTotals(rowMap.totals?.[0]) };
+	if (rowMap.prevTotals) meta.previousTotals = readTotals(rowMap.prevTotals[0]);
+	return {
+		results: daily,
+		meta
+	};
+}
 function shapeDataQueryRows(rows, params, extras) {
 	return shapeDataQuery(rows, extras, { hasPrev: params.qc != null });
 }
@@ -2200,6 +2336,16 @@ const dataDetailAnalyzer = defineAnalyzer({
 			results,
 			meta
 		};
+	},
+	buildRows(params) {
+		return buildDataDetailRows(params);
+	},
+	reduceRows(rows, params) {
+		const { results, meta } = shapeDataDetailRowResults(Array.isArray(rows) ? {} : rows, params);
+		return {
+			results,
+			meta
+		};
 	}
 });
 const dataQueryAnalyzer = defineAnalyzer({
@@ -2230,6 +2376,16 @@ const dataQueryAnalyzer = defineAnalyzer({
 			results,
 			meta
 		};
+	},
+	buildRows(params) {
+		return buildDataQueryRows(params);
+	},
+	reduceRows(rows, params) {
+		const { results, meta } = shapeDataQueryRowResults(Array.isArray(rows) ? {} : rows, params);
+		return {
+			results,
+			meta
+		};
 	}
 });
 const sortResults$1 = createMetricSorter("lostClicks", {

package/dist/default-registry.mjs

@@ -2115,6 +2115,142 @@ function buildDataQueryPlan(params, options) {
 		extraQueries
 	};
 }
+function totalsState(state) {
+	return {
+		...state,
+		dimensions: [],
+		orderBy: void 0,
+		rowLimit: 1
+	};
+}
+function readTotals(row) {
+	return {
+		clicks: Number(row?.clicks ?? 0),
+		impressions: Number(row?.impressions ?? 0),
+		ctr: Number(row?.ctr ?? 0),
+		position: Number(row?.position ?? 0)
+	};
+}
+function buildDataQueryRows(params) {
+	const state = requireBuilderState(params.q, "data-query");
+	if (state.dimensions.includes("date")) throw new Error("data-query: date dimension not supported; use data-detail");
+	const queries = {
+		main: state,
+		totals: totalsState(state)
+	};
+	const prev = optionalBuilderState(params.qc, "data-query", "qc");
+	if (prev) {
+		queries.prevMain = prev;
+		queries.prevTotals = totalsState(prev);
+	}
+	return queries;
+}
+function shapeDataQueryRowResults(rowMap, params) {
+	const main = (rowMap.main ?? []).map((r) => coerceNumericCols(r));
+	const totals = readTotals(rowMap.totals?.[0]);
+	if (params.qc == null) return {
+		results: main,
+		meta: {
+			totalCount: main.length,
+			totals
+		}
+	};
+	const state = requireBuilderState(params.q, "data-query");
+	const dims = state.dimensions;
+	const keyOf = (row) => dims.map((d) => String(row[d] ?? "")).join("\0");
+	const prevByKey = /* @__PURE__ */ new Map();
+	for (const r of rowMap.prevMain ?? []) prevByKey.set(keyOf(r), r);
+	const filter = params.comparisonFilter;
+	const merged = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const cur of main) {
+		const key = keyOf(cur);
+		seen.add(key);
+		const prev = prevByKey.get(key);
+		const row = {
+			...cur,
+			prevClicks: Number(prev?.clicks ?? 0),
+			prevImpressions: Number(prev?.impressions ?? 0),
+			prevCtr: Number(prev?.ctr ?? 0),
+			prevPosition: Number(prev?.position ?? 0)
+		};
+		if (passesComparisonFilter(filter, {
+			isNew: !prev,
+			isLost: false,
+			clicksChange: Number(cur.clicks ?? 0) - Number(prev?.clicks ?? 0)
+		})) merged.push(row);
+	}
+	for (const prev of rowMap.prevMain ?? []) {
+		const p = prev;
+		const key = keyOf(p);
+		if (seen.has(key)) continue;
+		const row = {
+			...p,
+			clicks: 0,
+			impressions: 0,
+			ctr: 0,
+			position: 0,
+			prevClicks: Number(p.clicks ?? 0),
+			prevImpressions: Number(p.impressions ?? 0),
+			prevCtr: Number(p.ctr ?? 0),
+			prevPosition: Number(p.position ?? 0)
+		};
+		if (passesComparisonFilter(filter, {
+			isNew: false,
+			isLost: true,
+			clicksChange: -Number(p.clicks ?? 0)
+		})) merged.push(row);
+	}
+	if (state.orderBy) {
+		const { column, dir } = state.orderBy;
+		merged.sort((a, b) => {
+			const av = Number(a[column]) || 0;
+			const bv = Number(b[column]) || 0;
+			return dir === "asc" ? av - bv : bv - av;
+		});
+	}
+	return {
+		results: merged.map((r) => coerceNumericCols(r)),
+		meta: {
+			totalCount: merged.length,
+			totals
+		}
+	};
+}
+function passesComparisonFilter(filter, ctx) {
+	switch (filter) {
+		case "new": return ctx.isNew;
+		case "lost": return ctx.isLost;
+		case "improving": return ctx.clicksChange > 0;
+		case "declining": return ctx.clicksChange < 0;
+		default: return true;
+	}
+}
+function buildDataDetailRows(params) {
+	const state = requireBuilderState(params.q, "data-detail");
+	if (!state.dimensions.includes("date")) throw new Error("data-detail: `date` dimension is required");
+	const queries = {
+		main: state,
+		totals: totalsState(state)
+	};
+	const prev = optionalBuilderState(params.qc, "data-detail", "qc");
+	if (prev) queries.prevTotals = totalsState(prev);
+	return queries;
+}
+function shapeDataDetailRowResults(rowMap, params) {
+	const { startDate, endDate } = extractDateRange(requireBuilderState(params.q, "data-detail").filter);
+	const coerced = (rowMap.main ?? []).map((r) => coerceNumericCols(r));
+	const daily = startDate && endDate ? padTimeseries(coerced, {
+		startDate,
+		endDate
+	}) : coerced;
+	const meta = { totals: readTotals(rowMap.totals?.[0]) };
+	if (rowMap.prevTotals) meta.previousTotals = readTotals(rowMap.prevTotals[0]);
+	return {
+		results: daily,
+		meta
+	};
+}
 function shapeDataQueryRows(rows, params, extras) {
 	return shapeDataQuery(rows, extras, { hasPrev: params.qc != null });
 }
@@ -2200,6 +2336,16 @@ const dataDetailAnalyzer = defineAnalyzer({
 			results,
 			meta
 		};
+	},
+	buildRows(params) {
+		return buildDataDetailRows(params);
+	},
+	reduceRows(rows, params) {
+		const { results, meta } = shapeDataDetailRowResults(Array.isArray(rows) ? {} : rows, params);
+		return {
+			results,
+			meta
+		};
 	}
 });
 const dataQueryAnalyzer = defineAnalyzer({
@@ -2230,6 +2376,16 @@ const dataQueryAnalyzer = defineAnalyzer({
 			results,
 			meta
 		};
+	},
+	buildRows(params) {
+		return buildDataQueryRows(params);
+	},
+	reduceRows(rows, params) {
+		const { results, meta } = shapeDataQueryRowResults(Array.isArray(rows) ? {} : rows, params);
+		return {
+			results,
+			meta
+		};
 	}
 });
 const sortResults$1 = createMetricSorter("lostClicks", {

package/dist/index.mjs

@@ -9,6 +9,7 @@ import { buildExtrasQueries, buildTotalsSql, mergeExtras, pgResolverAdapter, res
 import { ENGINE_QUERY_CAPABILITIES, createAttachedTableSource, createEngineQuerySource, queryComparisonRows, queryRows, rewriteForTableSource, runAnalyzerWithEngine, typedQuery } 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";
 function clamp01(value) {
 	if (value < 0) return 0;
 	if (value > 1) return 1;
@@ -2331,6 +2332,142 @@ function buildDataQueryPlan(params, options) {
 		extraQueries
 	};
 }
+function totalsState(state) {
+	return {
+		...state,
+		dimensions: [],
+		orderBy: void 0,
+		rowLimit: 1
+	};
+}
+function readTotals(row) {
+	return {
+		clicks: Number(row?.clicks ?? 0),
+		impressions: Number(row?.impressions ?? 0),
+		ctr: Number(row?.ctr ?? 0),
+		position: Number(row?.position ?? 0)
+	};
+}
+function buildDataQueryRows(params) {
+	const state = requireBuilderState(params.q, "data-query");
+	if (state.dimensions.includes("date")) throw new Error("data-query: date dimension not supported; use data-detail");
+	const queries = {
+		main: state,
+		totals: totalsState(state)
+	};
+	const prev = optionalBuilderState(params.qc, "data-query", "qc");
+	if (prev) {
+		queries.prevMain = prev;
+		queries.prevTotals = totalsState(prev);
+	}
+	return queries;
+}
+function shapeDataQueryRowResults(rowMap, params) {
+	const main = (rowMap.main ?? []).map((r) => coerceNumericCols(r));
+	const totals = readTotals(rowMap.totals?.[0]);
+	if (params.qc == null) return {
+		results: main,
+		meta: {
+			totalCount: main.length,
+			totals
+		}
+	};
+	const state = requireBuilderState(params.q, "data-query");
+	const dims = state.dimensions;
+	const keyOf = (row) => dims.map((d) => String(row[d] ?? "")).join("\0");
+	const prevByKey = /* @__PURE__ */ new Map();
+	for (const r of rowMap.prevMain ?? []) prevByKey.set(keyOf(r), r);
+	const filter = params.comparisonFilter;
+	const merged = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const cur of main) {
+		const key = keyOf(cur);
+		seen.add(key);
+		const prev = prevByKey.get(key);
+		const row = {
+			...cur,
+			prevClicks: Number(prev?.clicks ?? 0),
+			prevImpressions: Number(prev?.impressions ?? 0),
+			prevCtr: Number(prev?.ctr ?? 0),
+			prevPosition: Number(prev?.position ?? 0)
+		};
+		if (passesComparisonFilter(filter, {
+			isNew: !prev,
+			isLost: false,
+			clicksChange: Number(cur.clicks ?? 0) - Number(prev?.clicks ?? 0)
+		})) merged.push(row);
+	}
+	for (const prev of rowMap.prevMain ?? []) {
+		const p = prev;
+		const key = keyOf(p);
+		if (seen.has(key)) continue;
+		const row = {
+			...p,
+			clicks: 0,
+			impressions: 0,
+			ctr: 0,
+			position: 0,
+			prevClicks: Number(p.clicks ?? 0),
+			prevImpressions: Number(p.impressions ?? 0),
+			prevCtr: Number(p.ctr ?? 0),
+			prevPosition: Number(p.position ?? 0)
+		};
+		if (passesComparisonFilter(filter, {
+			isNew: false,
+			isLost: true,
+			clicksChange: -Number(p.clicks ?? 0)
+		})) merged.push(row);
+	}
+	if (state.orderBy) {
+		const { column, dir } = state.orderBy;
+		merged.sort((a, b) => {
+			const av = Number(a[column]) || 0;
+			const bv = Number(b[column]) || 0;
+			return dir === "asc" ? av - bv : bv - av;
+		});
+	}
+	return {
+		results: merged.map((r) => coerceNumericCols(r)),
+		meta: {
+			totalCount: merged.length,
+			totals
+		}
+	};
+}
+function passesComparisonFilter(filter, ctx) {
+	switch (filter) {
+		case "new": return ctx.isNew;
+		case "lost": return ctx.isLost;
+		case "improving": return ctx.clicksChange > 0;
+		case "declining": return ctx.clicksChange < 0;
+		default: return true;
+	}
+}
+function buildDataDetailRows(params) {
+	const state = requireBuilderState(params.q, "data-detail");
+	if (!state.dimensions.includes("date")) throw new Error("data-detail: `date` dimension is required");
+	const queries = {
+		main: state,
+		totals: totalsState(state)
+	};
+	const prev = optionalBuilderState(params.qc, "data-detail", "qc");
+	if (prev) queries.prevTotals = totalsState(prev);
+	return queries;
+}
+function shapeDataDetailRowResults(rowMap, params) {
+	const { startDate, endDate } = extractDateRange(requireBuilderState(params.q, "data-detail").filter);
+	const coerced = (rowMap.main ?? []).map((r) => coerceNumericCols(r));
+	const daily = startDate && endDate ? padTimeseries$1(coerced, {
+		startDate,
+		endDate
+	}) : coerced;
+	const meta = { totals: readTotals(rowMap.totals?.[0]) };
+	if (rowMap.prevTotals) meta.previousTotals = readTotals(rowMap.prevTotals[0]);
+	return {
+		results: daily,
+		meta
+	};
+}
 function shapeDataQueryRows(rows, params, extras) {
 	return shapeDataQuery(rows, extras, { hasPrev: params.qc != null });
 }
@@ -2565,6 +2702,16 @@ const dataDetailAnalyzer = defineAnalyzer$1({
 			results,
 			meta
 		};
+	},
+	buildRows(params) {
+		return buildDataDetailRows(params);
+	},
+	reduceRows(rows, params) {
+		const { results, meta } = shapeDataDetailRowResults(Array.isArray(rows) ? {} : rows, params);
+		return {
+			results,
+			meta
+		};
 	}
 });
 const dataQueryAnalyzer = defineAnalyzer$1({
@@ -2595,6 +2742,16 @@ const dataQueryAnalyzer = defineAnalyzer$1({
 			results,
 			meta
 		};
+	},
+	buildRows(params) {
+		return buildDataQueryRows(params);
+	},
+	reduceRows(rows, params) {
+		const { results, meta } = shapeDataQueryRowResults(Array.isArray(rows) ? {} : rows, params);
+		return {
+			results,
+			meta
+		};
 	}
 });
 const sortResults$1 = createMetricSorter("lostClicks", {
@@ -6767,6 +6924,7 @@ function nextDay(day) {
 }
 function shouldRouteToLive(state, site) {
 	if (!canProxyToGsc(state)) return false;
+	if (!isStateResolvable(state)) return true;
 	const { startDate, endDate } = extractDateRange(state.filter);
 	if (!startDate || !endDate) return false;
 	if (!site.oldestDateSynced || !site.newestDateSynced) return true;

package/dist/query/index.d.mts

@@ -1,4 +1,5 @@
 import { ResolverOptions } from "@gscdump/engine/resolver";
+import { BuilderState } from "gscdump/query";
 import { AnalysisParams } from "@gscdump/engine/analysis-types";
 import { Row } from "@gscdump/engine/contracts";
 interface QueryAnalyzerExtraQuery {
@@ -13,6 +14,20 @@ interface QueryAnalyzerPlan<TK extends string = string> {
   extraQueries?: QueryAnalyzerExtraQuery[];
 }
 declare function buildDataQueryPlan<TK extends string>(params: AnalysisParams, options: ResolverOptions<TK>): QueryAnalyzerPlan<TK>;
+/** Row-query plan for `data-query`. Comparison (`qc`) joins two periods. */
+declare function buildDataQueryRows(params: AnalysisParams): Record<string, BuilderState>;
+/** Post-processing for `data-query` row results. Mirrors `shapeDataQuery`. */
+declare function shapeDataQueryRowResults(rowMap: Record<string, Row[]>, params: AnalysisParams): {
+  results: Row[];
+  meta: Record<string, unknown>;
+};
+/** Row-query plan for `data-detail`. `qc` adds a previous-period totals query. */
+declare function buildDataDetailRows(params: AnalysisParams): Record<string, BuilderState>;
+/** Post-processing for `data-detail` row results. Mirrors `shapeDataDetailRows`. */
+declare function shapeDataDetailRowResults(rowMap: Record<string, Row[]>, params: AnalysisParams): {
+  results: Row[];
+  meta: Record<string, unknown>;
+};
 /**
  * Pure post-processing for `data-query` rows. Adapter-free so reducers can
  * call it without re-running the SQL plan.
@@ -35,4 +50,4 @@ declare function shapeDataDetailRows(rows: Row[], params: AnalysisParams, extras
  * Idempotent: `normalizeQuery(normalizeQuery(q)) === normalizeQuery(q)`.
  */
 declare function normalizeQuery(query: string): string;
-export { type QueryAnalyzerExtraQuery, type QueryAnalyzerPlan, buildDataDetailPlan, buildDataQueryPlan, normalizeQuery, shapeDataDetailRows, shapeDataQueryRows };
+export { type QueryAnalyzerExtraQuery, type QueryAnalyzerPlan, buildDataDetailPlan, buildDataDetailRows, buildDataQueryPlan, buildDataQueryRows, normalizeQuery, shapeDataDetailRowResults, shapeDataDetailRows, shapeDataQueryRowResults, shapeDataQueryRows };

package/dist/query/index.mjs

@@ -99,6 +99,142 @@ function buildDataQueryPlan(params, options) {
 		extraQueries
 	};
 }
+function totalsState(state) {
+	return {
+		...state,
+		dimensions: [],
+		orderBy: void 0,
+		rowLimit: 1
+	};
+}
+function readTotals(row) {
+	return {
+		clicks: Number(row?.clicks ?? 0),
+		impressions: Number(row?.impressions ?? 0),
+		ctr: Number(row?.ctr ?? 0),
+		position: Number(row?.position ?? 0)
+	};
+}
+function buildDataQueryRows(params) {
+	const state = requireBuilderState(params.q, "data-query");
+	if (state.dimensions.includes("date")) throw new Error("data-query: date dimension not supported; use data-detail");
+	const queries = {
+		main: state,
+		totals: totalsState(state)
+	};
+	const prev = optionalBuilderState(params.qc, "data-query", "qc");
+	if (prev) {
+		queries.prevMain = prev;
+		queries.prevTotals = totalsState(prev);
+	}
+	return queries;
+}
+function shapeDataQueryRowResults(rowMap, params) {
+	const main = (rowMap.main ?? []).map((r) => coerceNumericCols(r));
+	const totals = readTotals(rowMap.totals?.[0]);
+	if (params.qc == null) return {
+		results: main,
+		meta: {
+			totalCount: main.length,
+			totals
+		}
+	};
+	const state = requireBuilderState(params.q, "data-query");
+	const dims = state.dimensions;
+	const keyOf = (row) => dims.map((d) => String(row[d] ?? "")).join("\0");
+	const prevByKey = /* @__PURE__ */ new Map();
+	for (const r of rowMap.prevMain ?? []) prevByKey.set(keyOf(r), r);
+	const filter = params.comparisonFilter;
+	const merged = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const cur of main) {
+		const key = keyOf(cur);
+		seen.add(key);
+		const prev = prevByKey.get(key);
+		const row = {
+			...cur,
+			prevClicks: Number(prev?.clicks ?? 0),
+			prevImpressions: Number(prev?.impressions ?? 0),
+			prevCtr: Number(prev?.ctr ?? 0),
+			prevPosition: Number(prev?.position ?? 0)
+		};
+		if (passesComparisonFilter(filter, {
+			isNew: !prev,
+			isLost: false,
+			clicksChange: Number(cur.clicks ?? 0) - Number(prev?.clicks ?? 0)
+		})) merged.push(row);
+	}
+	for (const prev of rowMap.prevMain ?? []) {
+		const p = prev;
+		const key = keyOf(p);
+		if (seen.has(key)) continue;
+		const row = {
+			...p,
+			clicks: 0,
+			impressions: 0,
+			ctr: 0,
+			position: 0,
+			prevClicks: Number(p.clicks ?? 0),
+			prevImpressions: Number(p.impressions ?? 0),
+			prevCtr: Number(p.ctr ?? 0),
+			prevPosition: Number(p.position ?? 0)
+		};
+		if (passesComparisonFilter(filter, {
+			isNew: false,
+			isLost: true,
+			clicksChange: -Number(p.clicks ?? 0)
+		})) merged.push(row);
+	}
+	if (state.orderBy) {
+		const { column, dir } = state.orderBy;
+		merged.sort((a, b) => {
+			const av = Number(a[column]) || 0;
+			const bv = Number(b[column]) || 0;
+			return dir === "asc" ? av - bv : bv - av;
+		});
+	}
+	return {
+		results: merged.map((r) => coerceNumericCols(r)),
+		meta: {
+			totalCount: merged.length,
+			totals
+		}
+	};
+}
+function passesComparisonFilter(filter, ctx) {
+	switch (filter) {
+		case "new": return ctx.isNew;
+		case "lost": return ctx.isLost;
+		case "improving": return ctx.clicksChange > 0;
+		case "declining": return ctx.clicksChange < 0;
+		default: return true;
+	}
+}
+function buildDataDetailRows(params) {
+	const state = requireBuilderState(params.q, "data-detail");
+	if (!state.dimensions.includes("date")) throw new Error("data-detail: `date` dimension is required");
+	const queries = {
+		main: state,
+		totals: totalsState(state)
+	};
+	const prev = optionalBuilderState(params.qc, "data-detail", "qc");
+	if (prev) queries.prevTotals = totalsState(prev);
+	return queries;
+}
+function shapeDataDetailRowResults(rowMap, params) {
+	const { startDate, endDate } = extractDateRange(requireBuilderState(params.q, "data-detail").filter);
+	const coerced = (rowMap.main ?? []).map((r) => coerceNumericCols(r));
+	const daily = startDate && endDate ? padTimeseries(coerced, {
+		startDate,
+		endDate
+	}) : coerced;
+	const meta = { totals: readTotals(rowMap.totals?.[0]) };
+	if (rowMap.prevTotals) meta.previousTotals = readTotals(rowMap.prevTotals[0]);
+	return {
+		results: daily,
+		meta
+	};
+}
 function shapeDataQueryRows(rows, params, extras) {
 	return shapeDataQuery(rows, extras, { hasPrev: params.qc != null });
 }
@@ -305,4 +441,4 @@ const WHITESPACE_RE = /\s+/g;
 function normalizeQuery(query) {
 	return query.toLowerCase().replace(SEPARATOR_RE, " ").replace(WHITESPACE_RE, " ").trim().split(" ").filter(Boolean).map((token) => SYNONYMS[token] ?? token).filter(Boolean).map(depluralize).sort().join(" ");
 }
-export { buildDataDetailPlan, buildDataQueryPlan, normalizeQuery, shapeDataDetailRows, shapeDataQueryRows };
+export { buildDataDetailPlan, buildDataDetailRows, buildDataQueryPlan, buildDataQueryRows, normalizeQuery, shapeDataDetailRowResults, shapeDataDetailRows, shapeDataQueryRowResults, shapeDataQueryRows };

package/dist/source/index.d.mts

@@ -1,6 +1,6 @@
 import { BuilderState } from "gscdump/query";
-import { AnalysisQuerySource, QueryRow } from "@gscdump/engine/source";
 import { PlannerCapabilities } from "gscdump/query/plan";
+import { AnalysisQuerySource, QueryRow } from "@gscdump/engine/source";
 interface SyncedRange {
   oldestDateSynced: string | null;
   newestDateSynced: string | null;

package/dist/source/index.mjs

@@ -1,5 +1,6 @@
 import { canProxyToGsc } from "@gscdump/engine-gsc-api";
 import { extractDateRange } from "gscdump/query";
+import { isStateResolvable } from "gscdump/query/plan";
 function hasGapInCoveredSpans(start, end, coveredSpans) {
 	let cursor = start;
 	for (const span of coveredSpans) {
@@ -17,6 +18,7 @@ function nextDay(day) {
 }
 function shouldRouteToLive(state, site) {
 	if (!canProxyToGsc(state)) return false;
+	if (!isStateResolvable(state)) return true;
 	const { startDate, endDate } = extractDateRange(state.filter);
 	if (!startDate || !endDate) return false;
 	if (!site.oldestDateSynced || !site.newestDateSynced) return true;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/analysis",
   "type": "module",
-  "version": "0.19.2",
+  "version": "0.19.4",
   "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.19.2",
-    "@gscdump/engine-gsc-api": "0.19.2",
-    "gscdump": "0.19.2"
+    "@gscdump/engine": "0.19.4",
+    "@gscdump/engine-gsc-api": "0.19.4",
+    "gscdump": "0.19.4"
   },
   "devDependencies": {
     "vitest": "^4.1.6"