@gscdump/analysis 0.33.0 → 0.33.3

package/dist/analyzer/index.mjs

@@ -7,15 +7,26 @@ import { err, ok, unwrapResult } from "gscdump/result";
 import { between, date, extractDateRange, gsc, page, query } from "gscdump/query";
 import { MS_PER_DAY, daysAgo, toIsoDate } from "gscdump";
 import { buildExtrasQueries, buildTotalsSql, mergeExtras, resolveComparisonSQL, resolveToSQL, resolveToSQLOptimized } from "@gscdump/engine/resolver";
-function num$5(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
+function rowNumber(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? value : 0;
+	if (typeof value === "bigint") return Number(value);
+	if (value == null) return 0;
+	const n = Number(value);
 	return Number.isFinite(n) ? n : 0;
 }
-function str$23(v) {
-	return v == null ? "" : String(v);
+function rowString(value) {
+	return value == null ? "" : String(value);
+}
+function rowBoolean(value) {
+	return value === true || value === 1 || value === "true";
+}
+function parseJsonRows(value) {
+	if (Array.isArray(value)) return value;
+	if (typeof value === "string" && value.length > 0) {
+		const parsed = JSON.parse(value);
+		return Array.isArray(parsed) ? parsed : [];
+	}
+	return [];
 }
 const bayesianCtrAnalyzer = defineAnalyzer({
 	id: "bayesian-ctr",
@@ -155,24 +166,24 @@ const bayesianCtrAnalyzer = defineAnalyzer({
 		const arr = Array.isArray(rows) ? rows : [];
 		const minImpressions = params.minImpressions ?? 50;
 		const results = arr.map((r) => ({
-			keyword: str$23(r.keyword),
-			page: str$23(r.page),
-			clicks: num$5(r.clicks),
-			impressions: num$5(r.impressions),
-			observedCtr: num$5(r.observedCtr),
-			position: num$5(r.position),
-			bucket: num$5(r.bucket),
-			priorAlpha: num$5(r.priorAlpha),
-			priorBeta: num$5(r.priorBeta),
-			bucketPriorMean: num$5(r.bucketPriorMean),
-			posteriorMean: num$5(r.posteriorMean),
-			posteriorSd: num$5(r.posteriorSd),
-			ciLow: num$5(r.ciLow),
-			ciHigh: num$5(r.ciHigh),
-			shrinkageDelta: num$5(r.shrinkageDelta),
-			expectedClicksDelta: num$5(r.expectedClicksDelta),
-			significance: num$5(r.significance),
-			classification: str$23(r.classification)
+			keyword: rowString(r.keyword),
+			page: rowString(r.page),
+			clicks: rowNumber(r.clicks),
+			impressions: rowNumber(r.impressions),
+			observedCtr: rowNumber(r.observedCtr),
+			position: rowNumber(r.position),
+			bucket: rowNumber(r.bucket),
+			priorAlpha: rowNumber(r.priorAlpha),
+			priorBeta: rowNumber(r.priorBeta),
+			bucketPriorMean: rowNumber(r.bucketPriorMean),
+			posteriorMean: rowNumber(r.posteriorMean),
+			posteriorSd: rowNumber(r.posteriorSd),
+			ciLow: rowNumber(r.ciLow),
+			ciHigh: rowNumber(r.ciHigh),
+			shrinkageDelta: rowNumber(r.shrinkageDelta),
+			expectedClicksDelta: rowNumber(r.expectedClicksDelta),
+			significance: rowNumber(r.significance),
+			classification: rowString(r.classification)
 		}));
 		const under = results.filter((r) => r.classification === "underperforming").length;
 		const over = results.filter((r) => r.classification === "overperforming").length;
@@ -190,17 +201,6 @@ const bayesianCtrAnalyzer = defineAnalyzer({
 });
 const BIPARTITE_PAGERANK_ITERATIONS = 25;
 const BIPARTITE_PAGERANK_DAMPING = .85;
-function str$22(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$16(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const bipartitePagerankAnalyzer = defineAnalyzer({
 	id: "bipartite-pagerank",
 	buildSql(params) {
@@ -406,8 +406,8 @@ const bipartitePagerankAnalyzer = defineAnalyzer({
 		const iterations = BIPARTITE_PAGERANK_ITERATIONS;
 		const d = BIPARTITE_PAGERANK_DAMPING;
 		const results = arr.map((r) => ({
-			kind: str$22(r.kind),
-			id: str$22(r.id),
+			kind: rowString(r.kind),
+			id: rowString(r.id),
 			rank: num(r.rank),
 			bridging: num(r.bridging),
 			anchoring: num(r.anchoring),
@@ -417,7 +417,7 @@ const bipartitePagerankAnalyzer = defineAnalyzer({
 		const first = arr[0] ?? {};
 		const queryCount = num(first.queryCount);
 		const urlCount = num(first.urlCount);
-		const deltas = parseJsonList$16(first.deltasJson).map((e) => ({
+		const deltas = parseJsonRows(first.deltasJson).map((e) => ({
 			step: num(e.step),
 			l1: num(e.l1)
 		}));
@@ -503,9 +503,6 @@ function analysisErrorToException(error) {
 function escapeRegexAlt(s) {
 	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function str$21(v) {
-	return v == null ? "" : String(v);
-}
 function requireBrandTermsResult(brandTerms) {
 	return brandTerms?.length ? ok(brandTerms) : err(analysisErrors.missingBrandTerms());
 }
@@ -581,13 +578,13 @@ const brandAnalyzer = defineAnalyzer({
 	},
 	reduceSql(rows) {
 		const normalized = (Array.isArray(rows) ? rows : []).map((r) => ({
-			query: str$21(r.query),
-			page: r.page == null ? void 0 : str$21(r.page),
+			query: rowString(r.query),
+			page: r.page == null ? void 0 : rowString(r.page),
 			clicks: num(r.clicks),
 			impressions: num(r.impressions),
 			ctr: num(r.ctr),
 			position: num(r.position),
-			segment: str$21(r.segment)
+			segment: rowString(r.segment)
 		}));
 		let brandClicks = 0;
 		let nonBrandClicks = 0;
@@ -664,17 +661,6 @@ const sortRowResults$1 = createSorter((item, metric) => {
 		case "pageCount": return item.pages.length;
 	}
 }, "clicks");
-function str$20(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$15(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function analyzeCannibalization(rows, options = {}) {
 	const { minImpressions = 10, maxPositionSpread = 10, minPages = 2, sortBy = "clicks", sortOrder = "desc" } = options;
 	const queryMap = /* @__PURE__ */ new Map();
@@ -827,19 +813,19 @@ const cannibalizationAnalyzer = defineAnalyzer({
 	},
 	reduceSql(rows) {
 		const events = (Array.isArray(rows) ? rows : []).map((r) => ({
-			keyword: str$20(r.keyword),
+			keyword: rowString(r.keyword),
 			totalImpressions: num(r.totalImpressions),
 			totalClicks: num(r.totalClicks),
 			competitorCount: num(r.competitorCount),
-			leaderUrl: str$20(r.leaderUrl),
+			leaderUrl: rowString(r.leaderUrl),
 			leaderCtr: num(r.leaderCtr),
 			leaderPosition: num(r.leaderPosition),
 			hhi: num(r.hhi),
 			fragmentation: num(r.fragmentation),
 			stolenClicks: num(r.stolenClicks),
 			severity: num(r.severity),
-			competitors: parseJsonList$15(r.competitors).map((c) => ({
-				url: str$20(c.url),
+			competitors: parseJsonRows(r.competitors).map((c) => ({
+				url: rowString(c.url),
 				clicks: num(c.clicks),
 				impressions: num(c.impressions),
 				ctr: num(c.ctr),
@@ -916,24 +902,6 @@ const cannibalizationAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function num$4(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
-	return Number.isFinite(n) ? n : 0;
-}
-function str$19(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$14(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const changePointAnalyzer = defineAnalyzer({
 	id: "change-point",
 	buildSql(params) {
@@ -1086,24 +1054,24 @@ const changePointAnalyzer = defineAnalyzer({
 		const metric = params.metric === "clicks" || params.metric === "impressions" ? params.metric : "position";
 		const lowerIsBetter = metric === "position";
 		const results = arr.map((r) => {
-			const delta = num$4(r.delta);
+			const delta = rowNumber(r.delta);
 			const improved = lowerIsBetter ? delta < 0 : delta > 0;
 			return {
-				keyword: str$19(r.keyword),
-				page: str$19(r.page),
-				totalDays: num$4(r.totalDays),
-				totalImpressions: num$4(r.totalImpressions),
-				changeDate: str$19(r.changeDate),
-				llr: num$4(r.llr),
-				leftMean: num$4(r.leftMean),
-				rightMean: num$4(r.rightMean),
+				keyword: rowString(r.keyword),
+				page: rowString(r.page),
+				totalDays: rowNumber(r.totalDays),
+				totalImpressions: rowNumber(r.totalImpressions),
+				changeDate: rowString(r.changeDate),
+				llr: rowNumber(r.llr),
+				leftMean: rowNumber(r.leftMean),
+				rightMean: rowNumber(r.rightMean),
 				delta,
-				leftStddev: num$4(r.leftStddev),
-				rightStddev: num$4(r.rightStddev),
+				leftStddev: rowNumber(r.leftStddev),
+				rightStddev: rowNumber(r.rightStddev),
 				direction: improved ? "improved" : "worsened",
-				series: parseJsonList$14(r.seriesJson).map((s) => ({
-					date: str$19(s.date),
-					value: num$4(s.value)
+				series: parseJsonRows(r.seriesJson).map((s) => ({
+					date: rowString(s.date),
+					value: rowNumber(s.value)
 				}))
 			};
 		});
@@ -1140,17 +1108,6 @@ const INTENT_PREFIXES = [
 	"near me"
 ];
 const WHITESPACE_RE = /\s+/;
-function str$18(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$13(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function extractIntentPrefix(keyword) {
 	const lower = keyword.toLowerCase();
 	for (const prefix of INTENT_PREFIXES) if (lower.startsWith(`${prefix} `) || lower.startsWith(prefix)) return prefix;
@@ -1288,14 +1245,14 @@ const clusteringAnalyzer = defineAnalyzer({
 	},
 	reduceSql(rows) {
 		const clusters = (Array.isArray(rows) ? rows : []).map((r) => ({
-			clusterName: str$18(r.clusterName),
-			clusterType: str$18(r.clusterType),
+			clusterName: rowString(r.clusterName),
+			clusterType: rowString(r.clusterType),
 			keywordCount: num(r.keywordCount),
 			totalClicks: num(r.totalClicks),
 			totalImpressions: num(r.totalImpressions),
 			avgPosition: num(r.avgPosition),
-			keywords: parseJsonList$13(r.keywords).map((k) => ({
-				query: str$18(k.query),
+			keywords: parseJsonRows(r.keywords).map((k) => ({
+				query: rowString(k.query),
 				clicks: num(k.clicks),
 				impressions: num(k.impressions),
 				ctr: num(k.ctr),
@@ -1325,17 +1282,6 @@ const clusteringAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$17(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$12(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function calculateGini(values) {
 	if (values.length === 0) return 0;
 	const sorted = [...values].sort((a, b) => a - b);
@@ -1476,20 +1422,20 @@ const concentrationAnalyzer = defineAnalyzer({
 	},
 	reduceSql(rows, params) {
 		const r = (Array.isArray(rows) ? rows : [])[0] ?? {};
-		const topRaw = parseJsonList$12(r.topNItems);
+		const topRaw = parseJsonRows(r.topNItems);
 		return {
 			results: [{
 				giniCoefficient: num(r.giniCoefficient),
 				hhi: num(r.hhi),
 				topNConcentration: num(r.topNConcentration),
 				topNItems: topRaw.map((t) => ({
-					key: str$17(t.key),
+					key: rowString(t.key),
 					clicks: num(t.clicks),
 					share: num(t.share)
 				})),
 				totalItems: num(r.totalItems),
 				totalClicks: num(r.totalClicks),
-				riskLevel: str$17(r.riskLevel)
+				riskLevel: rowString(r.riskLevel)
 			}],
 			meta: {
 				total: 1,
@@ -1514,16 +1460,6 @@ const concentrationAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function num$3(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
-	return Number.isFinite(n) ? n : 0;
-}
-function str$16(v) {
-	return v == null ? "" : String(v);
-}
 const contentVelocityAnalyzer = defineAnalyzer({
 	id: "content-velocity",
 	buildSql(params) {
@@ -1580,9 +1516,9 @@ const contentVelocityAnalyzer = defineAnalyzer({
 		startDateD.setUTCDate(startDateD.getUTCDate() - days);
 		const startDate = toIsoDate(startDateD);
 		const weekly = arr.map((r) => ({
-			week: str$16(r.week),
-			newKeywords: num$3(r.newKeywords),
-			totalKeywords: num$3(r.totalKeywords)
+			week: rowString(r.week),
+			newKeywords: rowNumber(r.newKeywords),
+			totalKeywords: rowNumber(r.totalKeywords)
 		}));
 		const total = weekly.reduce((s, w) => s + w.newKeywords, 0);
 		const avg = weekly.length > 0 ? total / weekly.length : 0;
@@ -1605,27 +1541,6 @@ const contentVelocityAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function num$2(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
-	return Number.isFinite(n) ? n : 0;
-}
-function str$15(v) {
-	return v == null ? "" : String(v);
-}
-function bool$2(v) {
-	return v === true || v === 1 || v === "true";
-}
-function parseJsonList$11(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const ctrAnomalyAnalyzer = defineAnalyzer({
 	id: "ctr-anomaly",
 	buildSql(params) {
@@ -1767,26 +1682,26 @@ const ctrAnomalyAnalyzer = defineAnalyzer({
 		const minRollingN = 14;
 		const zThreshold = params.threshold ?? 2;
 		const anomalies = arr.map((r) => ({
-			keyword: str$15(r.keyword),
-			page: str$15(r.page),
-			breachDaysDown: num$2(r.breachDaysDown),
-			breachDaysUp: num$2(r.breachDaysUp),
-			clicksLost: num$2(r.clicksLost),
-			severity: num$2(r.severityRaw),
-			maxZ: num$2(r.maxZ),
-			baselineCtr: num$2(r.baselineCtr),
-			baselinePosition: num$2(r.baselinePosition),
-			totalImpressions: num$2(r.totalImpressions),
-			totalClicks: num$2(r.totalClicks),
-			series: parseJsonList$11(r.seriesJson).map((s) => ({
-				date: str$15(s.date),
-				ctr: num$2(s.ctr),
-				position: num$2(s.position),
-				impressions: num$2(s.impressions),
-				rollingCtr: s.rollingCtr == null ? null : num$2(s.rollingCtr),
-				rollingStddev: s.rollingStddev == null ? null : num$2(s.rollingStddev),
-				z: num$2(s.z),
-				breach: bool$2(s.breach)
+			keyword: rowString(r.keyword),
+			page: rowString(r.page),
+			breachDaysDown: rowNumber(r.breachDaysDown),
+			breachDaysUp: rowNumber(r.breachDaysUp),
+			clicksLost: rowNumber(r.clicksLost),
+			severity: rowNumber(r.severityRaw),
+			maxZ: rowNumber(r.maxZ),
+			baselineCtr: rowNumber(r.baselineCtr),
+			baselinePosition: rowNumber(r.baselinePosition),
+			totalImpressions: rowNumber(r.totalImpressions),
+			totalClicks: rowNumber(r.totalClicks),
+			series: parseJsonRows(r.seriesJson).map((s) => ({
+				date: rowString(s.date),
+				ctr: rowNumber(s.ctr),
+				position: rowNumber(s.position),
+				impressions: rowNumber(s.impressions),
+				rollingCtr: s.rollingCtr == null ? null : rowNumber(s.rollingCtr),
+				rollingStddev: s.rollingStddev == null ? null : rowNumber(s.rollingStddev),
+				z: rowNumber(s.z),
+				breach: rowBoolean(s.breach)
 			}))
 		}));
 		const totalClicksLost = anomalies.reduce((s, a) => s + a.clicksLost, 0);
@@ -1803,24 +1718,6 @@ const ctrAnomalyAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function num$1(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
-	return Number.isFinite(n) ? n : 0;
-}
-function str$14(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$10(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const ctrCurveAnalyzer = defineAnalyzer({
 	id: "ctr-curve",
 	buildSql(params) {
@@ -1915,22 +1812,22 @@ const ctrCurveAnalyzer = defineAnalyzer({
 		const arr = Array.isArray(rows) ? rows : [];
 		const { startDate, endDate } = periodOf(params);
 		const row = arr[0] ?? {};
-		const curve = parseJsonList$10(row.curve_json).map((r) => ({
-			bucket: str$14(r.bucket),
-			avgCtr: num$1(r.avgCtr),
-			medianPosition: num$1(r.medianPosition),
-			keywordCount: num$1(r.keywordCount),
-			totalClicks: num$1(r.totalClicks),
-			totalImpressions: num$1(r.totalImpressions)
+		const curve = parseJsonRows(row.curve_json).map((r) => ({
+			bucket: rowString(r.bucket),
+			avgCtr: rowNumber(r.avgCtr),
+			medianPosition: rowNumber(r.medianPosition),
+			keywordCount: rowNumber(r.keywordCount),
+			totalClicks: rowNumber(r.totalClicks),
+			totalImpressions: rowNumber(r.totalImpressions)
 		}));
-		const outliers = parseJsonList$10(row.outliers_json).map((r) => ({
-			query: str$14(r.query),
-			clicks: num$1(r.clicks),
-			impressions: num$1(r.impressions),
-			ctr: num$1(r.ctr),
-			position: num$1(r.position),
-			expectedCtr: num$1(r.expectedCtr),
-			ctrDiff: num$1(r.ctrDiff)
+		const outliers = parseJsonRows(row.outliers_json).map((r) => ({
+			query: rowString(r.query),
+			clicks: rowNumber(r.clicks),
+			impressions: rowNumber(r.impressions),
+			ctr: rowNumber(r.ctr),
+			position: rowNumber(r.position),
+			expectedCtr: rowNumber(r.expectedCtr),
+			ctrDiff: rowNumber(r.ctrDiff)
 		}));
 		return {
 			results: curve,
@@ -1943,17 +1840,6 @@ const ctrCurveAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$13(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$9(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const darkTrafficAnalyzer = defineAnalyzer({
 	id: "dark-traffic",
 	buildSql(params) {
@@ -2055,8 +1941,8 @@ const darkTrafficAnalyzer = defineAnalyzer({
 		const darkClicks = Math.max(0, totalClicks - attributedClicks);
 		const darkPercent = totalClicks > 0 ? darkClicks / totalClicks : 0;
 		return {
-			results: parseJsonList$9(row.pages_json).map((r) => ({
-				url: str$13(r.url),
+			results: parseJsonRows(row.pages_json).map((r) => ({
+				url: rowString(r.url),
 				totalClicks: num(r.totalClicks),
 				attributedClicks: num(r.attributedClicks),
 				darkClicks: num(r.darkClicks),
@@ -2482,17 +2368,6 @@ const sortResults$1 = createMetricSorter("lostClicks", {
 	declinePercent: "desc",
 	currentClicks: "asc"
 });
-function str$12(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$8(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function analyzeDecay(input, options = {}) {
 	const { minPreviousClicks = 50, threshold = .2, sortBy = "lostClicks" } = options;
 	const currentMap = buildPeriodMap(input.current, (r) => r.page, (r) => ({
@@ -2619,7 +2494,7 @@ const decayAnalyzer = defineAnalyzer({
 	},
 	reduceSql(rows, params) {
 		const mapped = (Array.isArray(rows) ? rows : []).map((r) => ({
-			page: str$12(r.page),
+			page: rowString(r.page),
 			currentClicks: num(r.currentClicks),
 			previousClicks: num(r.previousClicks),
 			lostClicks: num(r.lostClicks),
@@ -2627,8 +2502,8 @@ const decayAnalyzer = defineAnalyzer({
 			currentPosition: num(r.currentPosition),
 			previousPosition: num(r.previousPosition),
 			positionDrop: num(r.positionDrop),
-			series: parseJsonList$8(r.seriesJson).map((s) => ({
-				week: str$12(s.week),
+			series: parseJsonRows(r.seriesJson).map((s) => ({
+				week: rowString(s.week),
 				clicks: num(s.clicks),
 				impressions: num(s.impressions)
 			}))
@@ -2666,9 +2541,6 @@ const decayAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$11(v) {
-	return v == null ? "" : String(v);
-}
 const deviceGapAnalyzer = defineAnalyzer({
 	id: "device-gap",
 	buildSql(params) {
@@ -2719,8 +2591,8 @@ const deviceGapAnalyzer = defineAnalyzer({
 		const arr = Array.isArray(rows) ? rows : [];
 		const { startDate, endDate } = periodOf(params);
 		const typed = arr.map((r) => ({
-			date: str$11(r.date),
-			device: str$11(r.device).toUpperCase(),
+			date: rowString(r.date),
+			device: rowString(r.device).toUpperCase(),
 			clicks: num(r.clicks),
 			impressions: num(r.impressions),
 			ctr: num(r.ctr),
@@ -2798,17 +2670,6 @@ const deviceGapAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$10(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$7(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const INTENT_ATLAS_STOP_WORDS = [
 	"the",
 	"a",
@@ -2951,14 +2812,14 @@ const intentAtlasAnalyzer = defineAnalyzer({
 	},
 	reduceSql(rows) {
 		const clusters = (Array.isArray(rows) ? rows : []).map((r) => ({
-			clusterKey: str$10(r.clusterKey),
+			clusterKey: rowString(r.clusterKey),
 			keywordCount: num(r.keywordCount),
 			totalImpressions: num(r.totalImpressions),
 			totalClicks: num(r.totalClicks),
 			ctr: num(r.ctr),
 			avgPosition: num(r.avgPosition),
-			keywords: parseJsonList$7(r.keywords).slice(0, 25).map((k) => ({
-				query: str$10(k.query),
+			keywords: parseJsonRows(r.keywords).slice(0, 25).map((k) => ({
+				query: rowString(k.query),
 				impressions: num(k.impressions),
 				clicks: num(k.clicks),
 				position: num(k.position)
@@ -2976,17 +2837,6 @@ const intentAtlasAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$9(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$6(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const keywordBreadthAnalyzer = defineAnalyzer({
 	id: "keyword-breadth",
 	buildSql(params) {
@@ -3061,18 +2911,18 @@ const keywordBreadthAnalyzer = defineAnalyzer({
 		const arr = Array.isArray(rows) ? rows : [];
 		const { startDate, endDate } = periodOf(params);
 		const row = arr[0] ?? {};
-		const distribution = parseJsonList$6(row.distribution_json).sort((a, b) => num(a.sortKey) - num(b.sortKey)).map((r) => ({
-			bucket: str$9(r.bucket),
+		const distribution = parseJsonRows(row.distribution_json).sort((a, b) => num(a.sortKey) - num(b.sortKey)).map((r) => ({
+			bucket: rowString(r.bucket),
 			pageCount: num(r.pageCount)
 		}));
-		const fragile = parseJsonList$6(row.fragile_json).map((r) => ({
-			url: str$9(r.url),
+		const fragile = parseJsonRows(row.fragile_json).map((r) => ({
+			url: rowString(r.url),
 			keywordCount: num(r.keywordCount),
 			clicks: num(r.clicks),
 			impressions: num(r.impressions)
 		}));
-		const authority = parseJsonList$6(row.authority_json).map((r) => ({
-			url: str$9(r.url),
+		const authority = parseJsonRows(row.authority_json).map((r) => ({
+			url: rowString(r.url),
 			keywordCount: num(r.keywordCount),
 			clicks: num(r.clicks),
 			impressions: num(r.impressions)
@@ -3095,23 +2945,12 @@ const keywordBreadthAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$8(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$5(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function downsampleLogRank(points) {
 	const all = points.map((p) => ({
 		rank: num(p.rank),
 		impressions: num(p.impressions),
 		clicks: num(p.clicks),
-		query: str$8(p.query)
+		query: rowString(p.query)
 	}));
 	if (all.length <= 80) return all;
 	const top = all.slice(0, 10);
@@ -3220,7 +3059,7 @@ const longTailAnalyzer = defineAnalyzer({
 	},
 	reduceSql(rows) {
 		const results = (Array.isArray(rows) ? rows : []).map((r) => ({
-			page: str$8(r.page),
+			page: rowString(r.page),
 			queryCount: num(r.queryCount),
 			totalImpressions: num(r.totalImpressions),
 			totalClicks: num(r.totalClicks),
@@ -3229,8 +3068,8 @@ const longTailAnalyzer = defineAnalyzer({
 			r2: num(r.r2),
 			headImpressions: num(r.headImpressions),
 			headShare: num(r.headShare),
-			fingerprint: str$8(r.fingerprint),
-			points: downsampleLogRank(parseJsonList$5(r.pointsJson))
+			fingerprint: rowString(r.fingerprint),
+			points: downsampleLogRank(parseJsonRows(r.pointsJson))
 		}));
 		const counts = {
 			"flat-tail": 0,
@@ -3252,17 +3091,6 @@ function percentDifference(current, previous) {
 	if (previous === 0) return current > 0 ? 100 : 0;
 	return (current - previous) / previous * 100;
 }
-function str$7(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$4(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function withCanonicalFields(r) {
 	return {
 		...r,
@@ -3488,8 +3316,8 @@ const moversAnalyzer = defineAnalyzer({
 			const baselineImpressions = Math.round(num(r.baselineImpressions));
 			const baselinePosition = num(r.baselinePosition);
 			return {
-				keyword: str$7(r.keyword),
-				page: r.page == null ? null : str$7(r.page),
+				keyword: rowString(r.keyword),
+				page: r.page == null ? null : rowString(r.page),
 				recentClicks,
 				recentImpressions,
 				recentPosition,
@@ -3500,9 +3328,9 @@ const moversAnalyzer = defineAnalyzer({
 				clicksChangePercent: num(r.clicksChangePercent),
 				impressionsChangePercent: num(r.impressionsChangePercent),
 				positionChange: num(r.positionChange),
-				direction: str$7(r.direction),
-				series: parseJsonList$4(r.seriesJson).map((s) => ({
-					week: str$7(s.week),
+				direction: rowString(r.direction),
+				series: parseJsonRows(r.seriesJson).map((s) => ({
+					week: rowString(s.week),
 					clicks: num(s.clicks),
 					impressions: num(s.impressions)
 				}))
@@ -3738,9 +3566,6 @@ const opportunityAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$6(v) {
-	return v == null ? "" : String(v);
-}
 const positionDistributionAnalyzer = defineAnalyzer({
 	id: "position-distribution",
 	buildSql(params) {
@@ -3777,7 +3602,7 @@ const positionDistributionAnalyzer = defineAnalyzer({
 		const { startDate, endDate } = periodOf(params);
 		return {
 			results: arr.map((r) => ({
-				date: str$6(r.date),
+				date: rowString(r.date),
 				pos_1_3: num(r.pos_1_3),
 				pos_4_10: num(r.pos_4_10),
 				pos_11_20: num(r.pos_11_20),
@@ -3792,9 +3617,6 @@ const positionDistributionAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$5(v) {
-	return v == null ? "" : String(v);
-}
 const positionVolatilityAnalyzer = defineAnalyzer({
 	id: "position-volatility",
 	buildSql(params) {
@@ -3895,8 +3717,8 @@ const positionVolatilityAnalyzer = defineAnalyzer({
 		const byPage = /* @__PURE__ */ new Map();
 		const allDates = /* @__PURE__ */ new Set();
 		for (const r of arr) {
-			const page = str$5(r.page);
-			const date = str$5(r.date);
+			const page = rowString(r.page);
+			const date = rowString(r.date);
 			allDates.add(date);
 			const entry = byPage.get(page) ?? {
 				page,
@@ -3931,17 +3753,6 @@ const positionVolatilityAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$4(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$3(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const queryMigrationAnalyzer = defineAnalyzer({
 	id: "query-migration",
 	buildSql(params) {
@@ -4063,17 +3874,17 @@ const queryMigrationAnalyzer = defineAnalyzer({
 			prevStart = toIsoDate(new Date(curStartMs - MS_PER_DAY - span));
 		}
 		const edges = arr.map((r) => ({
-			sourcePage: str$4(r.source_page),
-			targetPage: str$4(r.target_page),
+			sourcePage: rowString(r.source_page),
+			targetPage: rowString(r.target_page),
 			weight: num(r.weight),
 			queryCount: num(r.query_count),
 			exactCount: num(r.exact_count),
 			fuzzyCount: num(r.query_count) - num(r.exact_count),
-			examples: parseJsonList$3(r.examplesJson).slice(0, 8).map((e) => ({
-				sourceQuery: str$4(e.sourceQuery),
-				targetQuery: str$4(e.targetQuery),
+			examples: parseJsonRows(r.examplesJson).slice(0, 8).map((e) => ({
+				sourceQuery: rowString(e.sourceQuery),
+				targetQuery: rowString(e.targetQuery),
 				absorbed: num(e.absorbed),
-				matchType: str$4(e.matchType)
+				matchType: rowString(e.matchType)
 			}))
 		}));
 		const nodeAgg = /* @__PURE__ */ new Map();
@@ -4112,12 +3923,6 @@ const queryMigrationAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$3(v) {
-	return v == null ? "" : String(v);
-}
-function bool$1(v) {
-	return v === true || v === 1 || v === "true";
-}
 function calculateCV(values) {
 	if (values.length === 0) return 0;
 	const mean = values.reduce((a, b) => a + b, 0) / values.length;
@@ -4211,11 +4016,11 @@ const seasonalityAnalyzer = defineAnalyzer({
 	reduceSql(rows) {
 		const arr = Array.isArray(rows) ? rows : [];
 		const breakdown = arr.map((r) => ({
-			month: str$3(r.month),
+			month: rowString(r.month),
 			value: num(r.value),
 			vsAverage: num(r.vsAverage),
-			isPeak: bool$1(r.isPeak),
-			isTrough: bool$1(r.isTrough)
+			isPeak: rowBoolean(r.isPeak),
+			isTrough: rowBoolean(r.isTrough)
 		}));
 		const first = arr[0];
 		const strength = first ? num(first.strength) : 0;
@@ -4247,20 +4052,6 @@ const seasonalityAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str$2(v) {
-	return v == null ? "" : String(v);
-}
-function bool(v) {
-	return v === true || v === 1 || v === "true";
-}
-function parseJsonList$2(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const stlDecomposeAnalyzer = defineAnalyzer({
 	id: "stl-decompose",
 	buildSql(params) {
@@ -4413,21 +4204,21 @@ const stlDecomposeAnalyzer = defineAnalyzer({
 		const arr = Array.isArray(rows) ? rows : [];
 		const metric = params.metric === "clicks" ? "clicks" : "impressions";
 		const results = arr.map((r) => ({
-			keyword: str$2(r.keyword),
-			page: str$2(r.page),
+			keyword: rowString(r.keyword),
+			page: rowString(r.page),
 			totalImpressions: num(r.totalImpressions),
 			days: num(r.days),
 			seasonalStrength: num(r.seasonalStrength),
 			trendStrength: num(r.trendStrength),
 			residualAnomalies: num(r.residualAnomalies),
 			trendSlope: num(r.trendSlope),
-			series: parseJsonList$2(r.seriesJson).map((s) => ({
-				date: str$2(s.date),
+			series: parseJsonRows(r.seriesJson).map((s) => ({
+				date: rowString(s.date),
 				observed: num(s.observed),
 				trend: s.trend == null ? null : num(s.trend),
 				seasonal: s.seasonal == null ? null : num(s.seasonal),
 				residual: s.residual == null ? null : num(s.residual),
-				anomaly: bool(s.anomaly)
+				anomaly: rowBoolean(s.anomaly)
 			}))
 		}));
 		return {
@@ -4510,17 +4301,6 @@ const strikingDistanceAnalyzer = defineAnalyzer({
 		return { queries: queriesQueryState(periodOf(params), params.limit ?? DEFAULT_ROW_LIMIT$1) };
 	}
 });
-function str$1(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$1(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const survivalAnalyzer = defineAnalyzer({
 	id: "survival",
 	buildSql(params) {
@@ -4673,7 +4453,7 @@ const survivalAnalyzer = defineAnalyzer({
 		const startDate = params.startDate ?? daysAgo(183);
 		const windowDays = Math.round((new Date(endDate).getTime() - new Date(startDate).getTime()) / MS_PER_DAY) + 1;
 		const results = arr.map((r) => {
-			const curve = parseJsonList$1(r.curveJson).map((p) => ({
+			const curve = parseJsonRows(r.curveJson).map((p) => ({
 				tenure: num(p.tenure),
 				survival: num(p.survival),
 				atRisk: num(p.atRisk),
@@ -4696,7 +4476,7 @@ const survivalAnalyzer = defineAnalyzer({
 			const last = curve[curve.length - 1];
 			if (medianTenure === 0 && last && last.survival > .5) medianTenure = last.tenure;
 			return {
-				cohort: str$1(r.cohort),
+				cohort: rowString(r.cohort),
 				episodeCount: num(r.episodeCount),
 				censoringRate: num(r.censoringRate),
 				medianTenure,
@@ -4713,17 +4493,6 @@ const survivalAnalyzer = defineAnalyzer({
 		};
 	}
 });
-function str(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const trendsAnalyzer = defineAnalyzer({
 	id: "trends",
 	buildSql(params) {
@@ -4834,20 +4603,20 @@ const trendsAnalyzer = defineAnalyzer({
 		const startDate = params.startDate || toIsoDate(/* @__PURE__ */ new Date(Date.parse(endDate) - (weeks * 7 - 1) * MS_PER_DAY));
 		const dim = params.dimension === "keywords" ? "keywords" : "pages";
 		const results = arr.map((r) => {
-			const series = parseJsonList(r.seriesJson).map((s) => ({
-				week: str(s.week),
+			const series = parseJsonRows(r.seriesJson).map((s) => ({
+				week: rowString(s.week),
 				clicks: num(s.clicks),
 				impressions: num(s.impressions)
 			}));
 			return {
-				[dim === "keywords" ? "query" : "page"]: str(r.entity),
+				[dim === "keywords" ? "query" : "page"]: rowString(r.entity),
 				totalClicks: num(r.totalClicks),
 				totalImpressions: num(r.totalImpressions),
 				weeksWithData: num(r.weeksWithData),
 				slope: num(r.slope),
 				growthRatio: num(r.growthRatio),
 				avgPosition: num(r.avgPosition),
-				trend: str(r.trend),
+				trend: rowString(r.trend),
 				series
 			};
 		});