@gscdump/analysis 0.38.2 → 0.40.1

package/dist/index.mjs

@@ -1,14 +1,14 @@
 import { AnalyzerCapabilityError, createAnalyzerRegistry, createAnalyzerRegistry as createAnalyzerRegistry$1, defineAnalyzer, defineAnalyzer as defineAnalyzer$1, requireAdapter, runAnalyzerFromSource, runAnalyzerFromSource as runAnalyzerFromSource$1 } from "@gscdump/engine/analyzer";
-import { comparisonOf, comparisonOf as comparisonOf$1, defaultEndDate, padTimeseries, padTimeseries as padTimeseries$1, periodOf, periodOf as periodOf$1, resolveWindow, windowToComparisonPeriod, windowToPeriod } from "@gscdump/engine/period";
+import { comparisonOf, comparisonOf as comparisonOf$1, defaultEndDate, padTimeseries, padTimeseries as padTimeseries$1, periodOf, periodOf as periodOf$1, resolveWindow } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
 import { num, num as num$1 } from "@gscdump/engine/analysis-types";
 import { err, ok, unwrapResult } from "gscdump/result";
 import { between, date, extractDateRange, gsc, page, query } from "gscdump/query";
 import { MS_PER_DAY, daysAgoUtc, toIsoDate } from "gscdump/dates";
-import { buildExtrasQueries, buildTotalsSql, mergeExtras, pgResolverAdapter, resolveComparisonSQL, resolveToSQL, resolveToSQLOptimized } from "@gscdump/engine/resolver";
+import { buildExtrasQueries, buildTotalsSql, mergeExtras, pgResolverAdapter, resolveComparisonSQL, resolveToSQLOptimized } from "@gscdump/engine/resolver";
 import pluralize from "pluralize";
-import { ENGINE_QUERY_CAPABILITIES, createAttachedTableSource, createEngineQuerySource, queryComparisonRows, queryRows, rewriteForTableSource, runAnalyzerWithEngine, typedQuery } from "@gscdump/engine/source";
+import { ENGINE_QUERY_CAPABILITIES, createAttachedTableSource, createEngineQuerySource, queryRows, rewriteForTableSource, runAnalyzerWithEngine } from "@gscdump/engine/source";
 import { computeInputHash, createReportRegistry, defineReport } from "@gscdump/engine/report";
 import { canProxyToGsc } from "@gscdump/engine-gsc-api";
 import { isStateResolvable } from "gscdump/query/plan";
@@ -754,8 +754,7 @@ function analyzeBrandSegmentation(keywords, options) {
 		const impressions = num$1(row.impressions);
 		if (impressions < minImpressions) continue;
 		const clicks = num$1(row.clicks);
-		const query = row.query.toLowerCase();
-		if (lowerBrandTerms.some((term) => query.includes(term))) {
+		if ((row.variants?.length ? row.variants : [row.query ?? row.keyword ?? ""]).some((query) => lowerBrandTerms.some((term) => query.toLowerCase().includes(term)))) {
 			brand.push(row);
 			brandClicks += clicks;
 			brandImpressions += impressions;
@@ -897,7 +896,7 @@ function createMetricSorter(defaultMetric, orderByMetric) {
 		return [...items].sort((a, b) => (a[sortBy] - b[sortBy]) * mult);
 	};
 }
-const sortRowResults$1 = createSorter((item, metric) => {
+const sortRowResults = createSorter((item, metric) => {
 	switch (metric) {
 		case "clicks": return item.totalClicks;
 		case "impressions": return item.totalImpressions;
@@ -944,7 +943,7 @@ function analyzeCannibalization(rows, options = {}) {
 			positionSpread
 		});
 	}
-	return sortRowResults$1(results, sortBy, sortOrder);
+	return sortRowResults(results, sortBy, sortOrder);
 }
 const cannibalizationAnalyzer = defineAnalyzer$1({
 	id: "cannibalization",
@@ -2482,14 +2481,9 @@ function shapeDataQueryRows(rows, params, extras) {
 function buildDataDetailPlan(params, options) {
 	const state = requireBuilderState(params.q, "data-detail");
 	if (!state.dimensions.includes("date")) throw new Error("data-detail: `date` dimension is required");
-	const main = resolveToSQL(state, options);
-	const totals = buildTotalsSql(state, options);
+	const main = resolveToSQLOptimized(state, options);
 	const prev = optionalBuilderState(params.qc, "data-detail", "qc");
-	const extraQueries = [{
-		name: "totals",
-		sql: totals.sql,
-		params: totals.params
-	}];
+	const extraQueries = [];
 	if (prev) {
 		const previousTotals = buildTotalsSql(prev, options);
 		extraQueries.push({
@@ -2507,18 +2501,22 @@ function buildDataDetailPlan(params, options) {
 }
 function shapeDataDetailRows(rows, params, extras) {
 	const { startDate: rangeStart, endDate: rangeEnd } = extractDateRange(requireBuilderState(params.q, "data-detail").filter);
-	const coerced = rows.map(coerceNumericCols);
+	const first = rows[0];
+	const totals = {
+		clicks: Number(first?.totalClicks ?? 0),
+		impressions: Number(first?.totalImpressions ?? 0),
+		ctr: Number(first?.totalCtr ?? 0),
+		position: Number(first?.totalPosition ?? 0)
+	};
+	const coerced = rows.map((raw) => {
+		const { totalCount: _tc, totalClicks: _tclk, totalImpressions: _timp, totalCtr: _tctr, totalPosition: _tpos, sum_position: _sp, ...rest } = raw;
+		return coerceNumericCols(rest);
+	});
 	const daily = rangeStart && rangeEnd ? padTimeseries$1(coerced, {
 		startDate: rangeStart,
 		endDate: rangeEnd
 	}) : coerced;
-	const totalsRow = extras?.totals?.[0] ?? {};
-	const meta = { totals: {
-		clicks: Number(totalsRow.clicks ?? 0),
-		impressions: Number(totalsRow.impressions ?? 0),
-		ctr: Number(totalsRow.ctr ?? 0),
-		position: Number(totalsRow.position ?? 0)
-	} };
+	const meta = { totals };
 	if (extras?.prevTotals) {
 		const previousTotalsRow = extras.prevTotals[0] ?? {};
 		meta.previousTotals = {
@@ -2647,10 +2645,12 @@ const SEPARATOR_RE$1 = /[-_/.@#:+]+/g;
 const WHITESPACE_RE$1 = /\s+/g;
 const DIACRITICS_RE$1 = /\p{Diacritic}/gu;
 function tokenize(query) {
-	const text = query.normalize("NFKD").replace(DIACRITICS_RE$1, "").toLowerCase().replace(SEPARATOR_RE$1, " ").replace(WHITESPACE_RE$1, " ").trim();
+	let index = 0;
+	while (index < query.length && query.charCodeAt(index) <= 127) index++;
+	const text = (index === query.length ? query : query.normalize("NFKD").replace(DIACRITICS_RE$1, "")).toLowerCase().replace(SEPARATOR_RE$1, " ").replace(WHITESPACE_RE$1, " ").trim();
 	return {
 		text,
-		tokens: text.split(" ").filter(Boolean)
+		tokens: text.length === 0 ? [] : text.split(" ")
 	};
 }
 function classifyQueryIntent(query) {
@@ -2816,15 +2816,27 @@ const NO_STRIP_S = /* @__PURE__ */ new Set([
 	"nervous",
 	"conscious"
 ]);
+const DEPLURALIZED_CACHE_MAX = 4096;
+const depluralizedCache = /* @__PURE__ */ new Map();
 function depluralize(token) {
 	if (token.length <= 3 || NO_STRIP_S.has(token) || token.endsWith("sis")) return token;
-	return pluralize.singular(token);
+	const last = token.charCodeAt(token.length - 1);
+	if (last < 97 || last > 122) return token;
+	const cached = depluralizedCache.get(token);
+	if (cached !== void 0) return cached;
+	const singular = pluralize.singular(token);
+	if (depluralizedCache.size >= DEPLURALIZED_CACHE_MAX) depluralizedCache.clear();
+	depluralizedCache.set(token, singular);
+	return singular;
 }
 const SEPARATOR_RE = /[-_/.@#:+]+/g;
 const WHITESPACE_RE = /\s+/g;
 const DIACRITICS_RE = /\p{Diacritic}/gu;
 const NORMALIZER_VERSION = 2;
 function foldUnicode(s) {
+	let index = 0;
+	while (index < s.length && s.charCodeAt(index) <= 127) index++;
+	if (index === s.length) return s;
 	return s.normalize("NFKD").replace(DIACRITICS_RE, "");
 }
 const DIRECTIONAL_CONNECTORS = /* @__PURE__ */ new Set([
@@ -2860,9 +2872,15 @@ function isOrderSensitive(tokens) {
 	return false;
 }
 function normalizeQuery(query) {
-	const cleaned = foldUnicode(query).toLowerCase().replace(SEPARATOR_RE, " ").replace(WHITESPACE_RE, " ").trim().split(" ").filter(Boolean);
-	const mapped = cleaned.map((token) => SYNONYMS[token] ?? token).filter(Boolean);
-	const tokens = (mapped.length > 0 ? mapped : cleaned).map(depluralize);
+	const normalized = foldUnicode(query).toLowerCase().replace(SEPARATOR_RE, " ").replace(WHITESPACE_RE, " ").trim();
+	if (normalized.length === 0) return "";
+	const cleaned = normalized.split(" ");
+	const mapped = [];
+	for (const token of cleaned) {
+		const synonym = SYNONYMS[token] ?? token;
+		if (synonym) mapped.push(depluralize(synonym));
+	}
+	const tokens = mapped.length > 0 ? mapped : cleaned.map(depluralize);
 	return (isOrderSensitive(tokens) ? tokens : tokens.sort()).join(" ");
 }
 const dataDetailAnalyzer = defineAnalyzer$1({
@@ -2967,7 +2985,69 @@ function paginateInMemory(rows, input) {
 	const o = clampOffset(input.offset);
 	return rows.slice(o, o + l);
 }
-const sortResults$1 = createMetricSorter("lostClicks", {
+function paginateSortedInMemory(rows, input, compare) {
+	const limit = clampLimit(input.limit, rows.length);
+	const offset = clampOffset(input.offset);
+	const selectedCount = Math.min(rows.length, offset + limit);
+	if (limit === 0 || offset >= rows.length || selectedCount === 0) return [];
+	const fullSort = () => [...rows].sort(compare).slice(offset, offset + limit);
+	if (selectedCount >= rows.length / 2) return fullSort();
+	let invalidComparison = false;
+	const compareStable = (left, right) => {
+		const order = compare(left.value, right.value);
+		if (Number.isNaN(order)) {
+			invalidComparison = true;
+			return left.index - right.index;
+		}
+		return order || left.index - right.index;
+	};
+	const isWorse = (left, right) => compareStable(left, right) > 0;
+	const heap = [];
+	const siftUp = (start) => {
+		let index = start;
+		while (index > 0) {
+			const parent = index - 1 >>> 1;
+			if (!isWorse(heap[index], heap[parent])) break;
+			const swap = heap[parent];
+			heap[parent] = heap[index];
+			heap[index] = swap;
+			index = parent;
+		}
+	};
+	const siftDown = () => {
+		let index = 0;
+		for (;;) {
+			const left = index * 2 + 1;
+			if (left >= heap.length) return;
+			const right = left + 1;
+			let worse = left;
+			if (right < heap.length && isWorse(heap[right], heap[left])) worse = right;
+			if (!isWorse(heap[worse], heap[index])) return;
+			const swap = heap[index];
+			heap[index] = heap[worse];
+			heap[worse] = swap;
+			index = worse;
+		}
+	};
+	for (let index = 0; index < rows.length; index++) {
+		const candidate = {
+			value: rows[index],
+			index
+		};
+		if (heap.length < selectedCount) {
+			heap.push(candidate);
+			siftUp(heap.length - 1);
+		} else if (compareStable(candidate, heap[0]) < 0) {
+			heap[0] = candidate;
+			siftDown();
+		}
+	}
+	if (invalidComparison) return fullSort();
+	heap.sort(compareStable);
+	if (invalidComparison) return fullSort();
+	return heap.slice(offset, offset + limit).map((entry) => entry.value);
+}
+const sortResults = createMetricSorter("lostClicks", {
 	lostClicks: "desc",
 	declinePercent: "desc",
 	currentClicks: "asc"
@@ -3000,7 +3080,7 @@ function analyzeDecay(input, options = {}) {
 			positionDrop: currentPosition != null ? currentPosition - prev.position : null
 		});
 	}
-	return sortResults$1(results, sortBy);
+	return sortResults(results, sortBy);
 }
 const decayAnalyzer = defineAnalyzer$1({
 	id: "decay",
@@ -3995,12 +4075,52 @@ function calculateCtrGapScore(actualCtr, position) {
 	const gap = expectedCtr - actualCtr;
 	return Math.min(gap / expectedCtr, 1);
 }
-const sortResults = createMetricSorter("opportunityScore", {
+const SORT_DIR = {
 	opportunityScore: "desc",
 	potentialClicks: "desc",
 	impressions: "desc",
 	position: "asc"
-});
+};
+function analyzeOpportunity(keywords, options = {}) {
+	const minImpressions = options.minImpressions ?? 100;
+	const positionWeight = options.weights?.position ?? 1;
+	const impressionsWeight = options.weights?.impressions ?? 1;
+	const ctrGapWeight = options.weights?.ctrGap ?? 1;
+	const totalWeight = positionWeight + impressionsWeight + ctrGapWeight;
+	const sortBy = options.sortBy ?? "opportunityScore";
+	const results = [];
+	for (const row of keywords) {
+		const impressions = num$1(row.impressions);
+		if (impressions < minImpressions) continue;
+		const position = num$1(row.position);
+		const ctr = num$1(row.ctr);
+		const clicks = num$1(row.clicks);
+		const positionScore = calculatePositionScore(position);
+		const impressionScore = calculateImpressionScore(impressions);
+		const ctrGapScore = calculateCtrGapScore(ctr, position);
+		const weightedProduct = positionScore ** positionWeight * impressionScore ** impressionsWeight * ctrGapScore ** ctrGapWeight;
+		const opportunityScore = Math.round(weightedProduct ** (1 / totalWeight) * 100);
+		const potentialClicks = Math.round(impressions * getExpectedCtr(Math.min(3, position)));
+		results.push({
+			keyword: row.query,
+			page: row.page ?? null,
+			clicks,
+			impressions,
+			ctr,
+			position,
+			opportunityScore,
+			potentialClicks,
+			factors: {
+				positionScore,
+				impressionScore,
+				ctrGapScore
+			}
+		});
+	}
+	const direction = SORT_DIR[sortBy];
+	results.sort((left, right) => direction === "asc" ? left[sortBy] - right[sortBy] : right[sortBy] - left[sortBy]);
+	return options.limit ? results.slice(0, options.limit) : results;
+}
 const opportunityAnalyzer = defineAnalyzer$1({
 	id: "opportunity",
 	buildSql(params) {
@@ -4114,51 +4234,15 @@ const opportunityAnalyzer = defineAnalyzer$1({
 		return { queries: queriesQueryState(periodOf$1(params), params.limit) };
 	},
 	reduceRows(rows, params) {
-		const keywords = (Array.isArray(rows) ? rows : []) ?? [];
-		const minImpressions = params.minImpressions ?? 100;
-		const positionWeight = 1;
-		const impressionsWeight = 1;
-		const ctrGapWeight = 1;
-		const sortBy = "opportunityScore";
-		const results = [];
-		for (const row of keywords) {
-			const impressions = num$1(row.impressions);
-			const position = num$1(row.position);
-			const ctr = num$1(row.ctr);
-			const clicks = num$1(row.clicks);
-			if (impressions < minImpressions) continue;
-			const positionScore = calculatePositionScore(position);
-			const impressionScore = calculateImpressionScore(impressions);
-			const ctrGapScore = calculateCtrGapScore(ctr, position);
-			const geometricMean = (positionScore ** positionWeight * impressionScore ** impressionsWeight * ctrGapScore ** ctrGapWeight) ** (1 / 3);
-			const opportunityScore = Math.round(geometricMean * 100);
-			const targetCtr = getExpectedCtr(Math.min(3, position));
-			const potentialClicks = Math.round(impressions * targetCtr);
-			results.push({
-				keyword: row.query,
-				page: row.page ?? null,
-				clicks,
-				impressions,
-				ctr,
-				position,
-				opportunityScore,
-				potentialClicks,
-				factors: {
-					positionScore,
-					impressionScore,
-					ctrGapScore
-				}
-			});
-		}
-		const sorted = sortResults(results, sortBy);
-		const paged = paginateInMemory(sorted, {
+		const results = analyzeOpportunity((Array.isArray(rows) ? rows : []) ?? [], { minImpressions: params.minImpressions });
+		const paged = paginateSortedInMemory(results, {
 			limit: params.limit,
 			offset: params.offset
-		});
+		}, (left, right) => right.opportunityScore - left.opportunityScore);
 		return {
 			results: paged,
 			meta: {
-				total: sorted.length,
+				total: results.length,
 				returned: paged.length
 			}
 		};
@@ -4830,6 +4914,12 @@ const stlDecomposeAnalyzer = defineAnalyzer$1({
 	}
 });
 const DEFAULT_ROW_LIMIT$1 = 25e3;
+function paginateStrikingDistance(results, options) {
+	return paginateSortedInMemory(results, {
+		limit: options.limit ?? 1e3,
+		offset: options.offset
+	}, (left, right) => right.potentialClicks - left.potentialClicks);
+}
 function filterStrikingDistance(rows, options = {}) {
 	const minPosition = options.minPosition ?? 4;
 	const maxPosition = options.maxPosition ?? 20;
@@ -4856,15 +4946,14 @@ function filterStrikingDistance(rows, options = {}) {
 	}
 	return results;
 }
+function analyzeStrikingDistance(rows, options = {}) {
+	return paginateStrikingDistance(filterStrikingDistance(rows, options), options);
+}
 const strikingDistanceAnalyzer = defineAnalyzer$1({
 	id: "striking-distance",
 	reduce(rows, params) {
 		const results = filterStrikingDistance(Array.isArray(rows) ? rows : [], params);
-		results.sort((a, b) => b.potentialClicks - a.potentialClicks);
-		const paged = paginateInMemory(results, {
-			limit: params.limit ?? 1e3,
-			offset: params.offset
-		});
+		const paged = paginateStrikingDistance(results, params);
 		return {
 			results: paged,
 			meta: {
@@ -5240,7 +5329,18 @@ const trendsAnalyzer = defineAnalyzer$1({
 	}
 });
 const DEFAULT_ROW_LIMIT = 25e3;
-const sortRowResults = createSorter((item) => item.impressions, "impressions");
+function analyzeZeroClick(rows, options = {}) {
+	const minImpressions = options.minImpressions ?? 1e3;
+	const maxCtr = options.maxCtr ?? .03;
+	const maxPosition = options.maxPosition ?? 10;
+	const queryMap = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		if (row.impressions < minImpressions || row.position > maxPosition || row.ctr > maxCtr) continue;
+		const existing = queryMap.get(row.query);
+		if (!existing || row.position < existing.position) queryMap.set(row.query, { ...row });
+	}
+	return [...queryMap.values()].sort((left, right) => right.impressions - left.impressions);
+}
 const ALL_ANALYZERS = [
 	bayesianCtrAnalyzer,
 	bipartitePagerankAnalyzer,
@@ -5353,30 +5453,15 @@ const ALL_ANALYZERS = [
 			return { rows: gsc.select(query, page).where(between(date, period.startDate, period.endDate)).limit(limit).getState() };
 		},
 		reduceRows(rows, params) {
-			const arr = Array.isArray(rows) ? rows : [];
-			const minImpressions = params.minImpressions ?? 1e3;
-			const maxCtr = params.maxCtr ?? .03;
-			const maxPosition = params.maxPosition ?? 10;
-			const queryMap = /* @__PURE__ */ new Map();
-			for (const row of arr) {
-				if (row.impressions < minImpressions) continue;
-				if (row.position > maxPosition) continue;
-				if (row.ctr > maxCtr) continue;
-				const existing = queryMap.get(row.query);
-				if (!existing || row.position < existing.position) queryMap.set(row.query, {
-					query: row.query,
-					page: row.page,
-					clicks: row.clicks,
-					impressions: row.impressions,
-					ctr: row.ctr,
-					position: row.position
-				});
-			}
-			const results = sortRowResults(Array.from(queryMap.values()), "impressions", "desc");
-			const paged = paginateInMemory(results, {
+			const results = analyzeZeroClick(Array.isArray(rows) ? rows : [], {
+				minImpressions: params.minImpressions ?? 1e3,
+				maxCtr: params.maxCtr ?? .03,
+				maxPosition: params.maxPosition ?? 10
+			});
+			const paged = paginateSortedInMemory(results, {
 				limit: params.limit,
 				offset: params.offset
-			});
+			}, (left, right) => right.impressions - left.impressions);
 			return {
 				results: paged,
 				meta: {
@@ -6994,4 +7079,4 @@ function createInMemoryQuerySource(options) {
 	};
 }
 const SQL_ANALYZERS = ALL_ANALYZERS.flatMap((d) => d.sql ? [d.sql] : []);
-export { AnalyzerCapabilityError, DEFAULT_PRIORITY_SOURCES, ENGINE_QUERY_CAPABILITIES, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, NORMALIZER_VERSION, REPORTS, ROW_ANALYZERS, SEARCH_INTENT_CODE, SQL_ANALYZERS, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzePageConcentration, analyzeSeasonality, classifyQueryIntent, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, decodeIntent, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryComparisonRows, queryRows, resolveWindow, rewriteForTableSource, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, scorePriorityActions, typedQuery, windowToComparisonPeriod, windowToPeriod };
+export { AnalyzerCapabilityError, DEFAULT_PRIORITY_SOURCES, ENGINE_QUERY_CAPABILITIES, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, NORMALIZER_VERSION, REPORTS, ROW_ANALYZERS, SEARCH_INTENT_CODE, SQL_ANALYZERS, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, decodeIntent, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, rewriteForTableSource, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, scorePriorityActions };

package/package.json

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