@yoryoboy/bi-mcp 1.5.0 → 1.5.2

package/dist/src/services/search-console/search-console-utils.js

@@ -1,32 +1,13 @@
 import { z } from "zod";
+import { getProfileGoogleServiceMapping } from "../../config/google-store.js";
 const searchConsoleDateRegex = /^\d{4}-\d{2}-\d{2}$/;
 const searchConsoleSearchTypes = ["web", "image", "video", "news", "discover"];
-const searchConsoleDimensions = [
-  "query",
-  "page",
-  "country",
-  "device",
-  "date",
-  "searchAppearance"
-];
-const searchConsoleFilterOperators = [
-  "contains",
-  "equals",
-  "notContains",
-  "notEquals",
-  "includingRegex",
-  "excludingRegex"
-];
+const searchConsoleDimensions = ["query", "page", "country", "device", "date", "searchAppearance"];
+const searchConsoleFilterOperators = ["contains", "equals", "notContains", "notEquals", "includingRegex", "excludingRegex"];
 const searchConsoleAggregationTypes = ["auto", "byPage", "byProperty"];
-const searchConsoleDimensionFilterSchema = z.object({
-  dimension: z.enum(searchConsoleDimensions).describe("Dimension to filter on in Search Console (query, page, country, device, date, or searchAppearance)"),
-  operator: z.enum(searchConsoleFilterOperators).describe("Filter operator supported by Search Console."),
-  expression: z.string().min(1).describe("Filter value or regex expression.")
-});
-const siteUrlSchemaField = z.string().optional().describe(
-  "Search Console site URL or domain property identifier (for example https://www.example.com/ or sc-domain:example.com). If omitted, the tool expects the site to be configured elsewhere."
-);
-const profileIdSchemaField = z.string().optional().describe("Optional business profile identifier for future multi-profile resolution. Defaults to the active profile when supported.");
+const searchConsoleDimensionFilterSchema = z.object({ dimension: z.enum(searchConsoleDimensions).describe("Dimension to filter on in Search Console (query, page, country, device, date, or searchAppearance)"), operator: z.enum(searchConsoleFilterOperators).describe("Filter operator supported by Search Console."), expression: z.string().min(1).describe("Filter value or regex expression.") });
+const siteUrlSchemaField = z.string().optional().describe("Search Console site URL or domain property identifier (for example https://www.example.com/ or sc-domain:example.com). If omitted, the tool tries profileId mapping first.");
+const profileIdSchemaField = z.string().optional().describe("Optional business profile identifier used to resolve Google service mappings.");
 const startDateSchemaField = z.string().regex(searchConsoleDateRegex).describe("Start date in YYYY-MM-DD format.");
 const endDateSchemaField = z.string().regex(searchConsoleDateRegex).describe("End date in YYYY-MM-DD format.");
 const currentStartDateSchemaField = z.string().regex(searchConsoleDateRegex).describe("Current comparison period start date in YYYY-MM-DD format.");
@@ -37,49 +18,34 @@ const rowLimitSchemaField = z.number().int().min(1).max(25e3).optional().describ
 const startRowSchemaField = z.number().int().min(0).optional().describe("Zero-based row offset for paginated Search Console requests.");
 const searchTypeSchemaField = z.enum(searchConsoleSearchTypes).optional().describe("Search type to query. Defaults to web.");
 const brandTermsSchemaField = z.array(z.string().min(1)).max(50).optional().describe("Brand tokens used to separate branded from non-branded queries.");
-function resolveSearchConsoleSiteUrl(siteUrl, profileId) {
+async function resolveSearchConsoleSiteUrl(siteUrl, profileId) {
   const explicitSiteUrl = siteUrl?.trim();
-  if (explicitSiteUrl) {
-    return explicitSiteUrl;
+  if (explicitSiteUrl) return explicitSiteUrl;
+  const explicitProfileId = profileId?.trim();
+  if (explicitProfileId) {
+    const mapping = await getProfileGoogleServiceMapping(explicitProfileId);
+    if (mapping?.searchConsoleSiteUrl) return mapping.searchConsoleSiteUrl;
+    throw new Error(`Missing Search Console site URL. profileId "${explicitProfileId}" has no Search Console mapping configured.`);
   }
-  if (profileId?.trim()) {
-    throw new Error(
-      `Missing Search Console site URL. profileId "${profileId}" was provided, but business-data based site resolution is not implemented yet. Pass siteUrl explicitly or configure Search Console site resolution first.`
-    );
-  }
-  throw new Error(
-    "Missing Search Console site URL. Pass siteUrl explicitly or first call gsc_list_accessible_sites to discover available properties."
-  );
+  throw new Error("Missing Search Console site URL. Pass siteUrl explicitly, provide profileId with a configured mapping, or call gsc_list_accessible_sites first.");
 }
 function inferSearchConsolePropertyType(siteUrl) {
-  if (siteUrl.startsWith("sc-domain:")) {
-    return "domain";
-  }
-  if (/^https?:\/\//.test(siteUrl)) {
-    return "url_prefix";
-  }
+  if (siteUrl.startsWith("sc-domain:")) return "domain";
+  if (/^https?:\/\//.test(siteUrl)) return "url_prefix";
   return "unknown";
 }
 function normalizePermissionLevel(permissionLevel) {
   return permissionLevel?.trim().toLowerCase() || void 0;
 }
 function normalizeSearchConsoleSiteEntry(siteEntry) {
-  return {
-    site_url: siteEntry.siteUrl,
-    property_type: inferSearchConsolePropertyType(siteEntry.siteUrl),
-    permission_level: normalizePermissionLevel(siteEntry.permissionLevel)
-  };
+  return { site_url: siteEntry.siteUrl, property_type: inferSearchConsolePropertyType(siteEntry.siteUrl), permission_level: normalizePermissionLevel(siteEntry.permissionLevel) };
 }
 function toPercent(numerator, denominator) {
-  if (!Number.isFinite(numerator) || !Number.isFinite(denominator) || denominator <= 0) {
-    return 0;
-  }
+  if (!Number.isFinite(numerator) || !Number.isFinite(denominator) || denominator <= 0) return 0;
   return numerator / denominator * 100;
 }
 function round(value, decimals = 2) {
-  if (!Number.isFinite(value)) {
-    return 0;
-  }
+  if (!Number.isFinite(value)) return 0;
   const factor = 10 ** decimals;
   return Math.round(value * factor) / factor;
 }
@@ -88,49 +54,21 @@ function normalizeSearchConsoleRow(row, dimensions = []) {
   const impressions = row.impressions ?? 0;
   const ctr = typeof row.ctr === "number" ? row.ctr * 100 : toPercent(clicks, impressions);
   const keys = row.keys ?? [];
-  return {
-    keys,
-    dimensions: dimensions.reduce((accumulator, dimension, index) => {
-      accumulator[dimension] = keys[index] ?? "";
-      return accumulator;
-    }, {}),
-    clicks: round(clicks, 2),
-    impressions: round(impressions, 2),
-    ctr_percent: round(ctr, 2),
-    position: round(row.position ?? 0, 2)
-  };
+  return { keys, dimensions: dimensions.reduce((accumulator, dimension, index) => {
+    accumulator[dimension] = keys[index] ?? "";
+    return accumulator;
+  }, {}), clicks: round(clicks, 2), impressions: round(impressions, 2), ctr_percent: round(ctr, 2), position: round(row.position ?? 0, 2) };
 }
 function buildSearchConsoleQueryBody(input) {
-  const dimensionFilterGroups = input.dimensionFilters && input.dimensionFilters.length > 0 ? [
-    {
-      groupType: "and",
-      filters: input.dimensionFilters
-    }
-  ] : void 0;
-  return {
-    startDate: input.startDate,
-    endDate: input.endDate,
-    dimensions: input.dimensions,
-    type: input.searchType ?? "web",
-    dimensionFilterGroups,
-    aggregationType: input.aggregationType,
-    rowLimit: input.rowLimit,
-    startRow: input.startRow
-  };
+  const dimensionFilterGroups = input.dimensionFilters && input.dimensionFilters.length > 0 ? [{ groupType: "and", filters: input.dimensionFilters }] : void 0;
+  return { startDate: input.startDate, endDate: input.endDate, dimensions: input.dimensions, type: input.searchType ?? "web", dimensionFilterGroups, aggregationType: input.aggregationType, rowLimit: input.rowLimit, startRow: input.startRow };
 }
 function buildPaginationMetadata(input) {
   const startRow = input.startRow ?? 0;
   const rowLimit = input.rowLimit;
   const isPartial = Boolean(rowLimit) && input.returnedRows === rowLimit;
   const nextStartRow = isPartial ? startRow + input.returnedRows : void 0;
-  return {
-    is_partial: isPartial,
-    start_row: startRow,
-    row_limit: rowLimit,
-    returned_rows: input.returnedRows,
-    next_start_row: nextStartRow,
-    continuation_instructions: nextStartRow ? "This Search Console response may be truncated at row_limit. If you need additional rows, call the same tool again with startRow set to next_start_row." : void 0
-  };
+  return { is_partial: isPartial, start_row: startRow, row_limit: rowLimit, returned_rows: input.returnedRows, next_start_row: nextStartRow, continuation_instructions: nextStartRow ? "This Search Console response may be truncated at row_limit. If you need additional rows, call the same tool again with startRow set to next_start_row." : void 0 };
 }
 function parseBrandTerms(brandTerms) {
   return (brandTerms ?? []).map((term) => term.trim().toLowerCase()).filter(Boolean);
@@ -138,98 +76,41 @@ function parseBrandTerms(brandTerms) {
 function isBrandedQuery(query, brandTerms) {
   const normalizedQuery = query.trim().toLowerCase();
   const normalizedBrandTerms = parseBrandTerms(brandTerms);
-  if (!normalizedQuery || normalizedBrandTerms.length === 0) {
-    return false;
-  }
+  if (!normalizedQuery || normalizedBrandTerms.length === 0) return false;
   return normalizedBrandTerms.some((brandTerm) => normalizedQuery.includes(brandTerm));
 }
 function classifyBrandLabel(query, brandTerms) {
+  if ((brandTerms ?? []).length === 0) return "unknown";
   return isBrandedQuery(query, brandTerms) ? "brand" : "non_brand";
 }
-function computeChangePercent(currentValue, previousValue) {
-  if (!Number.isFinite(currentValue) || !Number.isFinite(previousValue)) {
-    return null;
-  }
-  if (previousValue === 0) {
-    if (currentValue === 0) {
-      return 0;
-    }
-    return null;
-  }
-  return round((currentValue - previousValue) / previousValue * 100, 2);
-}
 function sumSearchConsoleRows(rows) {
-  const totals = rows.reduce(
-    (accumulator, row) => {
-      accumulator.clicks += row.clicks;
-      accumulator.impressions += row.impressions;
-      accumulator.weightedPosition += row.position * row.impressions;
-      return accumulator;
-    },
-    {
-      clicks: 0,
-      impressions: 0,
-      weightedPosition: 0
-    }
-  );
-  return {
-    clicks: round(totals.clicks, 2),
-    impressions: round(totals.impressions, 2),
-    ctrPercent: round(toPercent(totals.clicks, totals.impressions), 2),
-    averagePosition: totals.impressions > 0 ? round(totals.weightedPosition / totals.impressions, 2) : 0
-  };
+  const clicks = rows.reduce((total, row) => total + row.clicks, 0);
+  const impressions = rows.reduce((total, row) => total + row.impressions, 0);
+  const weightedCtr = impressions > 0 ? rows.reduce((total, row) => total + row.impressions * row.ctr_percent, 0) / impressions : 0;
+  const weightedPosition = impressions > 0 ? rows.reduce((total, row) => total + row.impressions * row.position, 0) / impressions : 0;
+  return { clicks: round(clicks), impressions: round(impressions), ctrPercent: round(weightedCtr), averagePosition: round(weightedPosition) };
 }
-function buildComparisonMap(rows, keyBuilder) {
-  return new Map(rows.map((row) => [keyBuilder(row), row]));
+function scoreQuickWinOpportunity(input) {
+  return round(input.impressions * Math.max(0, 8 - input.ctrPercent) * Math.max(0.5, 20 - input.position) / 100);
 }
-function tokenizeQuery(query) {
-  return query.toLowerCase().split(/[^a-z0-9áéíóúüñ]+/i).map((token) => token.trim()).filter(Boolean);
+function scoreHighImpressionLowClickOpportunity(input) {
+  return round(input.impressions * Math.max(0, 5 - input.ctrPercent) * Math.max(0.5, 15 - input.position) / 100);
 }
-function looksLikeCommercialQuery(query) {
-  const tokens = tokenizeQuery(query);
-  const commercialTerms = /* @__PURE__ */ new Set([
-    "comprar",
-    "precio",
-    "precios",
-    "cuanto",
-    "oferta",
-    "ofertas",
-    "envio",
-    "shop",
-    "tienda",
-    "modelo",
-    "medida",
-    "ml",
-    "cm",
-    "kg"
-  ]);
-  return tokens.some((token) => commercialTerms.has(token));
+function classifyQuickWinType(position, ctrPercent) {
+  if (position > 0 && position <= 10 && ctrPercent < 4) return "ctr";
+  if (position > 10 && position <= 20) return "position";
+  return "mixed";
 }
 function looksLikeProductQuery(query, productTerms) {
-  const normalizedProductTerms = parseBrandTerms(productTerms);
-  const normalizedQuery = query.toLowerCase();
-  if (normalizedProductTerms.some((term) => normalizedQuery.includes(term))) {
-    return true;
-  }
-  return looksLikeCommercialQuery(query) || tokenizeQuery(query).length >= 3;
+  if ((productTerms ?? []).some((term) => query.toLowerCase().includes(term.trim().toLowerCase()))) return true;
+  return /\b(comprar|precio|modelo|sku|talle|color|review|opiniones)\b/i.test(query);
 }
-function classifyQuickWinType(position, ctrPercent) {
-  if (position <= 8 && ctrPercent <= 3) {
-    return "ctr";
-  }
-  return "position";
-}
-function scoreHighImpressionLowClickOpportunity(input) {
-  const impressionScore = Math.min(input.impressions / 100, 60);
-  const ctrPenalty = Math.max(0, 15 - input.ctrPercent) * 2;
-  const positionBonus = input.position > 0 && input.position <= 20 ? Math.max(0, 20 - input.position) : 0;
-  return round(impressionScore + ctrPenalty + positionBonus, 2);
+function buildComparisonMap(rows, getKey) {
+  return new Map(rows.map((row) => [getKey(row), row]));
 }
-function scoreQuickWinOpportunity(input) {
-  const impressionWeight = Math.min(input.impressions / 150, 50);
-  const ctrWeight = Math.max(0, 10 - input.ctrPercent) * 3;
-  const positionWeight = input.position > 0 && input.position <= 20 ? Math.max(0, 18 - input.position) * 1.8 : 0;
-  return round(impressionWeight + ctrWeight + positionWeight, 2);
+function computeChangePercent(current, previous) {
+  if (previous === 0) return current > 0 ? 100 : 0;
+  return round((current - previous) / previous * 100);
 }
 export {
   brandTermsSchemaField,
@@ -244,7 +125,6 @@ export {
   endDateSchemaField,
   inferSearchConsolePropertyType,
   isBrandedQuery,
-  looksLikeCommercialQuery,
   looksLikeProductQuery,
   normalizePermissionLevel,
   normalizeSearchConsoleRow,
@@ -269,7 +149,6 @@ export {
   startDateSchemaField,
   startRowSchemaField,
   sumSearchConsoleRows,
-  toPercent,
-  tokenizeQuery
+  toPercent
 };
 //# sourceMappingURL=search-console-utils.js.map

package/dist/src/services/search-console/search-console-utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/services/search-console/search-console-utils.ts"],
-  "sourcesContent": ["import { z } from \"zod\";\n\nimport type {\n  SearchConsoleDimensionFilter,\n  SearchConsoleDimensionFilterGroup,\n  SearchConsoleSearchAnalyticsRequest,\n  SearchConsoleSearchAnalyticsRow,\n  SearchConsoleSiteEntry,\n} from \"./search-console-client.js\";\n\nexport const searchConsoleDateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nexport const searchConsoleSearchTypes = [\"web\", \"image\", \"video\", \"news\", \"discover\"] as const;\nexport const searchConsoleDimensions = [\n  \"query\",\n  \"page\",\n  \"country\",\n  \"device\",\n  \"date\",\n  \"searchAppearance\",\n] as const;\nexport const searchConsoleFilterOperators = [\n  \"contains\",\n  \"equals\",\n  \"notContains\",\n  \"notEquals\",\n  \"includingRegex\",\n  \"excludingRegex\",\n] as const;\nexport const searchConsoleAggregationTypes = [\"auto\", \"byPage\", \"byProperty\"] as const;\n\nexport const searchConsoleDimensionFilterSchema = z.object({\n  dimension: z\n    .enum(searchConsoleDimensions)\n    .describe(\"Dimension to filter on in Search Console (query, page, country, device, date, or searchAppearance)\"),\n  operator: z\n    .enum(searchConsoleFilterOperators)\n    .describe(\"Filter operator supported by Search Console.\"),\n  expression: z.string().min(1).describe(\"Filter value or regex expression.\"),\n});\n\nexport const siteUrlSchemaField = z\n  .string()\n  .optional()\n  .describe(\n    \"Search Console site URL or domain property identifier (for example https://www.example.com/ or sc-domain:example.com). If omitted, the tool expects the site to be configured elsewhere.\"\n  );\n\nexport const profileIdSchemaField = z\n  .string()\n  .optional()\n  .describe(\"Optional business profile identifier for future multi-profile resolution. Defaults to the active profile when supported.\");\n\nexport const startDateSchemaField = z\n  .string()\n  .regex(searchConsoleDateRegex)\n  .describe(\"Start date in YYYY-MM-DD format.\");\n\nexport const endDateSchemaField = z\n  .string()\n  .regex(searchConsoleDateRegex)\n  .describe(\"End date in YYYY-MM-DD format.\");\n\nexport const currentStartDateSchemaField = z\n  .string()\n  .regex(searchConsoleDateRegex)\n  .describe(\"Current comparison period start date in YYYY-MM-DD format.\");\n\nexport const currentEndDateSchemaField = z\n  .string()\n  .regex(searchConsoleDateRegex)\n  .describe(\"Current comparison period end date in YYYY-MM-DD format.\");\n\nexport const previousStartDateSchemaField = z\n  .string()\n  .regex(searchConsoleDateRegex)\n  .describe(\"Previous comparison period start date in YYYY-MM-DD format.\");\n\nexport const previousEndDateSchemaField = z\n  .string()\n  .regex(searchConsoleDateRegex)\n  .describe(\"Previous comparison period end date in YYYY-MM-DD format.\");\n\nexport const rowLimitSchemaField = z\n  .number()\n  .int()\n  .min(1)\n  .max(25000)\n  .optional()\n  .describe(\"Maximum number of rows to return. Search Console supports up to 25,000 rows per request.\");\n\nexport const startRowSchemaField = z\n  .number()\n  .int()\n  .min(0)\n  .optional()\n  .describe(\"Zero-based row offset for paginated Search Console requests.\");\n\nexport const searchTypeSchemaField = z\n  .enum(searchConsoleSearchTypes)\n  .optional()\n  .describe(\"Search type to query. Defaults to web.\");\n\nexport const brandTermsSchemaField = z\n  .array(z.string().min(1))\n  .max(50)\n  .optional()\n  .describe(\"Brand tokens used to separate branded from non-branded queries.\");\n\nexport function resolveSearchConsoleSiteUrl(siteUrl?: string, profileId?: string): string {\n  const explicitSiteUrl = siteUrl?.trim();\n  if (explicitSiteUrl) {\n    return explicitSiteUrl;\n  }\n\n  if (profileId?.trim()) {\n    throw new Error(\n      `Missing Search Console site URL. profileId \"${profileId}\" was provided, but business-data based site resolution is not implemented yet. Pass siteUrl explicitly or configure Search Console site resolution first.`\n    );\n  }\n\n  throw new Error(\n    \"Missing Search Console site URL. Pass siteUrl explicitly or first call gsc_list_accessible_sites to discover available properties.\"\n  );\n}\n\nexport function inferSearchConsolePropertyType(\n  siteUrl: string\n): \"domain\" | \"url_prefix\" | \"unknown\" {\n  if (siteUrl.startsWith(\"sc-domain:\")) {\n    return \"domain\";\n  }\n\n  if (/^https?:\\/\\//.test(siteUrl)) {\n    return \"url_prefix\";\n  }\n\n  return \"unknown\";\n}\n\nexport function normalizePermissionLevel(permissionLevel?: string): string | undefined {\n  return permissionLevel?.trim().toLowerCase() || undefined;\n}\n\nexport function normalizeSearchConsoleSiteEntry(siteEntry: SearchConsoleSiteEntry) {\n  return {\n    site_url: siteEntry.siteUrl,\n    property_type: inferSearchConsolePropertyType(siteEntry.siteUrl),\n    permission_level: normalizePermissionLevel(siteEntry.permissionLevel),\n  };\n}\n\nexport function toPercent(numerator: number, denominator: number): number {\n  if (!Number.isFinite(numerator) || !Number.isFinite(denominator) || denominator <= 0) {\n    return 0;\n  }\n\n  return (numerator / denominator) * 100;\n}\n\nexport function round(value: number, decimals = 2): number {\n  if (!Number.isFinite(value)) {\n    return 0;\n  }\n\n  const factor = 10 ** decimals;\n  return Math.round(value * factor) / factor;\n}\n\nexport function normalizeSearchConsoleRow(\n  row: SearchConsoleSearchAnalyticsRow,\n  dimensions: readonly string[] = []\n) {\n  const clicks = row.clicks ?? 0;\n  const impressions = row.impressions ?? 0;\n  const ctr = typeof row.ctr === \"number\" ? row.ctr * 100 : toPercent(clicks, impressions);\n  const keys = row.keys ?? [];\n\n  return {\n    keys,\n    dimensions: dimensions.reduce<Record<string, string>>((accumulator, dimension, index) => {\n      accumulator[dimension] = keys[index] ?? \"\";\n      return accumulator;\n    }, {}),\n    clicks: round(clicks, 2),\n    impressions: round(impressions, 2),\n    ctr_percent: round(ctr, 2),\n    position: round(row.position ?? 0, 2),\n  };\n}\n\nexport function buildSearchConsoleQueryBody(input: {\n  startDate: string;\n  endDate: string;\n  dimensions?: string[];\n  searchType?: string;\n  dimensionFilters?: SearchConsoleDimensionFilter[];\n  aggregationType?: string;\n  rowLimit?: number;\n  startRow?: number;\n}): SearchConsoleSearchAnalyticsRequest {\n  const dimensionFilterGroups: SearchConsoleDimensionFilterGroup[] | undefined =\n    input.dimensionFilters && input.dimensionFilters.length > 0\n      ? [\n          {\n            groupType: \"and\",\n            filters: input.dimensionFilters,\n          },\n        ]\n      : undefined;\n\n  return {\n    startDate: input.startDate,\n    endDate: input.endDate,\n    dimensions: input.dimensions,\n    type: input.searchType ?? \"web\",\n    dimensionFilterGroups,\n    aggregationType: input.aggregationType,\n    rowLimit: input.rowLimit,\n    startRow: input.startRow,\n  };\n}\n\nexport function buildPaginationMetadata(input: {\n  startRow?: number;\n  rowLimit?: number;\n  returnedRows: number;\n}) {\n  const startRow = input.startRow ?? 0;\n  const rowLimit = input.rowLimit;\n  const isPartial = Boolean(rowLimit) && input.returnedRows === rowLimit;\n  const nextStartRow = isPartial ? startRow + input.returnedRows : undefined;\n\n  return {\n    is_partial: isPartial,\n    start_row: startRow,\n    row_limit: rowLimit,\n    returned_rows: input.returnedRows,\n    next_start_row: nextStartRow,\n    continuation_instructions: nextStartRow\n      ? \"This Search Console response may be truncated at row_limit. If you need additional rows, call the same tool again with startRow set to next_start_row.\"\n      : undefined,\n  };\n}\n\nexport function parseBrandTerms(brandTerms?: string[]): string[] {\n  return (brandTerms ?? []).map((term) => term.trim().toLowerCase()).filter(Boolean);\n}\n\nexport function isBrandedQuery(query: string, brandTerms?: string[]): boolean {\n  const normalizedQuery = query.trim().toLowerCase();\n  const normalizedBrandTerms = parseBrandTerms(brandTerms);\n\n  if (!normalizedQuery || normalizedBrandTerms.length === 0) {\n    return false;\n  }\n\n  return normalizedBrandTerms.some((brandTerm) => normalizedQuery.includes(brandTerm));\n}\n\nexport function classifyBrandLabel(query: string, brandTerms?: string[]): \"brand\" | \"non_brand\" {\n  return isBrandedQuery(query, brandTerms) ? \"brand\" : \"non_brand\";\n}\n\nexport function computeChangePercent(currentValue: number, previousValue: number): number | null {\n  if (!Number.isFinite(currentValue) || !Number.isFinite(previousValue)) {\n    return null;\n  }\n\n  if (previousValue === 0) {\n    if (currentValue === 0) {\n      return 0;\n    }\n\n    return null;\n  }\n\n  return round(((currentValue - previousValue) / previousValue) * 100, 2);\n}\n\nexport function sumSearchConsoleRows(\n  rows: Array<ReturnType<typeof normalizeSearchConsoleRow>>\n): {\n  clicks: number;\n  impressions: number;\n  ctrPercent: number;\n  averagePosition: number;\n} {\n  const totals = rows.reduce(\n    (accumulator, row) => {\n      accumulator.clicks += row.clicks;\n      accumulator.impressions += row.impressions;\n      accumulator.weightedPosition += row.position * row.impressions;\n      return accumulator;\n    },\n    {\n      clicks: 0,\n      impressions: 0,\n      weightedPosition: 0,\n    }\n  );\n\n  return {\n    clicks: round(totals.clicks, 2),\n    impressions: round(totals.impressions, 2),\n    ctrPercent: round(toPercent(totals.clicks, totals.impressions), 2),\n    averagePosition: totals.impressions > 0 ? round(totals.weightedPosition / totals.impressions, 2) : 0,\n  };\n}\n\nexport function buildComparisonMap(\n  rows: Array<ReturnType<typeof normalizeSearchConsoleRow>>,\n  keyBuilder: (row: ReturnType<typeof normalizeSearchConsoleRow>) => string\n) {\n  return new Map(rows.map((row) => [keyBuilder(row), row]));\n}\n\nexport function tokenizeQuery(query: string): string[] {\n  return query\n    .toLowerCase()\n    .split(/[^a-z0-9\u00E1\u00E9\u00ED\u00F3\u00FA\u00FC\u00F1]+/i)\n    .map((token) => token.trim())\n    .filter(Boolean);\n}\n\nexport function looksLikeCommercialQuery(query: string): boolean {\n  const tokens = tokenizeQuery(query);\n  const commercialTerms = new Set([\n    \"comprar\",\n    \"precio\",\n    \"precios\",\n    \"cuanto\",\n    \"oferta\",\n    \"ofertas\",\n    \"envio\",\n    \"shop\",\n    \"tienda\",\n    \"modelo\",\n    \"medida\",\n    \"ml\",\n    \"cm\",\n    \"kg\",\n  ]);\n\n  return tokens.some((token) => commercialTerms.has(token));\n}\n\nexport function looksLikeProductQuery(query: string, productTerms?: string[]): boolean {\n  const normalizedProductTerms = parseBrandTerms(productTerms);\n  const normalizedQuery = query.toLowerCase();\n\n  if (normalizedProductTerms.some((term) => normalizedQuery.includes(term))) {\n    return true;\n  }\n\n  return looksLikeCommercialQuery(query) || tokenizeQuery(query).length >= 3;\n}\n\nexport function classifyQuickWinType(position: number, ctrPercent: number): \"ctr\" | \"position\" {\n  if (position <= 8 && ctrPercent <= 3) {\n    return \"ctr\";\n  }\n\n  return \"position\";\n}\n\nexport function scoreHighImpressionLowClickOpportunity(input: {\n  impressions: number;\n  ctrPercent: number;\n  position: number;\n}): number {\n  const impressionScore = Math.min(input.impressions / 100, 60);\n  const ctrPenalty = Math.max(0, 15 - input.ctrPercent) * 2;\n  const positionBonus = input.position > 0 && input.position <= 20 ? Math.max(0, 20 - input.position) : 0;\n\n  return round(impressionScore + ctrPenalty + positionBonus, 2);\n}\n\nexport function scoreQuickWinOpportunity(input: {\n  impressions: number;\n  ctrPercent: number;\n  position: number;\n}): number {\n  const impressionWeight = Math.min(input.impressions / 150, 50);\n  const ctrWeight = Math.max(0, 10 - input.ctrPercent) * 3;\n  const positionWeight = input.position > 0 && input.position <= 20 ? Math.max(0, 18 - input.position) * 1.8 : 0;\n\n  return round(impressionWeight + ctrWeight + positionWeight, 2);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { z } from 'zod';\nimport { getProfileGoogleServiceMapping } from '../../config/google-store.js';\nimport type { SearchConsoleDimensionFilter, SearchConsoleDimensionFilterGroup, SearchConsoleSearchAnalyticsRequest, SearchConsoleSearchAnalyticsRow, SearchConsoleSiteEntry } from './search-console-client.js';\n\nexport const searchConsoleDateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\nexport const searchConsoleSearchTypes = ['web', 'image', 'video', 'news', 'discover'] as const;\nexport const searchConsoleDimensions = ['query', 'page', 'country', 'device', 'date', 'searchAppearance'] as const;\nexport const searchConsoleFilterOperators = ['contains', 'equals', 'notContains', 'notEquals', 'includingRegex', 'excludingRegex'] as const;\nexport const searchConsoleAggregationTypes = ['auto', 'byPage', 'byProperty'] as const;\nexport const searchConsoleDimensionFilterSchema = z.object({ dimension: z.enum(searchConsoleDimensions).describe('Dimension to filter on in Search Console (query, page, country, device, date, or searchAppearance)'), operator: z.enum(searchConsoleFilterOperators).describe('Filter operator supported by Search Console.'), expression: z.string().min(1).describe('Filter value or regex expression.') });\nexport const siteUrlSchemaField = z.string().optional().describe('Search Console site URL or domain property identifier (for example https://www.example.com/ or sc-domain:example.com). If omitted, the tool tries profileId mapping first.');\nexport const profileIdSchemaField = z.string().optional().describe('Optional business profile identifier used to resolve Google service mappings.');\nexport const startDateSchemaField = z.string().regex(searchConsoleDateRegex).describe('Start date in YYYY-MM-DD format.');\nexport const endDateSchemaField = z.string().regex(searchConsoleDateRegex).describe('End date in YYYY-MM-DD format.');\nexport const currentStartDateSchemaField = z.string().regex(searchConsoleDateRegex).describe('Current comparison period start date in YYYY-MM-DD format.');\nexport const currentEndDateSchemaField = z.string().regex(searchConsoleDateRegex).describe('Current comparison period end date in YYYY-MM-DD format.');\nexport const previousStartDateSchemaField = z.string().regex(searchConsoleDateRegex).describe('Previous comparison period start date in YYYY-MM-DD format.');\nexport const previousEndDateSchemaField = z.string().regex(searchConsoleDateRegex).describe('Previous comparison period end date in YYYY-MM-DD format.');\nexport const rowLimitSchemaField = z.number().int().min(1).max(25000).optional().describe('Maximum number of rows to return. Search Console supports up to 25,000 rows per request.');\nexport const startRowSchemaField = z.number().int().min(0).optional().describe('Zero-based row offset for paginated Search Console requests.');\nexport const searchTypeSchemaField = z.enum(searchConsoleSearchTypes).optional().describe('Search type to query. Defaults to web.');\nexport const brandTermsSchemaField = z.array(z.string().min(1)).max(50).optional().describe('Brand tokens used to separate branded from non-branded queries.');\n\nexport async function resolveSearchConsoleSiteUrl(siteUrl?: string, profileId?: string): Promise<string> {\n  const explicitSiteUrl = siteUrl?.trim();\n  if (explicitSiteUrl) return explicitSiteUrl;\n  const explicitProfileId = profileId?.trim();\n  if (explicitProfileId) {\n    const mapping = await getProfileGoogleServiceMapping(explicitProfileId);\n    if (mapping?.searchConsoleSiteUrl) return mapping.searchConsoleSiteUrl;\n    throw new Error(`Missing Search Console site URL. profileId \"${explicitProfileId}\" has no Search Console mapping configured.`);\n  }\n  throw new Error('Missing Search Console site URL. Pass siteUrl explicitly, provide profileId with a configured mapping, or call gsc_list_accessible_sites first.');\n}\n\nexport function inferSearchConsolePropertyType(siteUrl: string): 'domain' | 'url_prefix' | 'unknown' { if (siteUrl.startsWith('sc-domain:')) return 'domain'; if (/^https?:\\/\\//.test(siteUrl)) return 'url_prefix'; return 'unknown'; }\nexport function normalizePermissionLevel(permissionLevel?: string): string | undefined { return permissionLevel?.trim().toLowerCase() || undefined; }\nexport function normalizeSearchConsoleSiteEntry(siteEntry: SearchConsoleSiteEntry) { return { site_url: siteEntry.siteUrl, property_type: inferSearchConsolePropertyType(siteEntry.siteUrl), permission_level: normalizePermissionLevel(siteEntry.permissionLevel) }; }\nexport function toPercent(numerator: number, denominator: number): number { if (!Number.isFinite(numerator) || !Number.isFinite(denominator) || denominator <= 0) return 0; return (numerator / denominator) * 100; }\nexport function round(value: number, decimals = 2): number { if (!Number.isFinite(value)) return 0; const factor = 10 ** decimals; return Math.round(value * factor) / factor; }\nexport function normalizeSearchConsoleRow(row: SearchConsoleSearchAnalyticsRow, dimensions: readonly string[] = []) { const clicks = row.clicks ?? 0; const impressions = row.impressions ?? 0; const ctr = typeof row.ctr === 'number' ? row.ctr * 100 : toPercent(clicks, impressions); const keys = row.keys ?? []; return { keys, dimensions: dimensions.reduce<Record<string, string>>((accumulator, dimension, index) => { accumulator[dimension] = keys[index] ?? ''; return accumulator; }, {}), clicks: round(clicks, 2), impressions: round(impressions, 2), ctr_percent: round(ctr, 2), position: round(row.position ?? 0, 2) }; }\nexport function buildSearchConsoleQueryBody(input: { startDate: string; endDate: string; dimensions?: string[]; searchType?: string; dimensionFilters?: SearchConsoleDimensionFilter[]; aggregationType?: string; rowLimit?: number; startRow?: number; }): SearchConsoleSearchAnalyticsRequest { const dimensionFilterGroups: SearchConsoleDimensionFilterGroup[] | undefined = input.dimensionFilters && input.dimensionFilters.length > 0 ? [{ groupType: 'and', filters: input.dimensionFilters }] : undefined; return { startDate: input.startDate, endDate: input.endDate, dimensions: input.dimensions, type: input.searchType ?? 'web', dimensionFilterGroups, aggregationType: input.aggregationType, rowLimit: input.rowLimit, startRow: input.startRow }; }\nexport function buildPaginationMetadata(input: { startRow?: number; rowLimit?: number; returnedRows: number; }) { const startRow = input.startRow ?? 0; const rowLimit = input.rowLimit; const isPartial = Boolean(rowLimit) && input.returnedRows === rowLimit; const nextStartRow = isPartial ? startRow + input.returnedRows : undefined; return { is_partial: isPartial, start_row: startRow, row_limit: rowLimit, returned_rows: input.returnedRows, next_start_row: nextStartRow, continuation_instructions: nextStartRow ? 'This Search Console response may be truncated at row_limit. If you need additional rows, call the same tool again with startRow set to next_start_row.' : undefined }; }\nexport function parseBrandTerms(brandTerms?: string[]): string[] { return (brandTerms ?? []).map((term) => term.trim().toLowerCase()).filter(Boolean); }\nexport function isBrandedQuery(query: string, brandTerms?: string[]): boolean { const normalizedQuery = query.trim().toLowerCase(); const normalizedBrandTerms = parseBrandTerms(brandTerms); if (!normalizedQuery || normalizedBrandTerms.length === 0) return false; return normalizedBrandTerms.some((brandTerm) => normalizedQuery.includes(brandTerm)); }\nexport function classifyBrandLabel(query: string, brandTerms?: string[]) { if ((brandTerms ?? []).length === 0) return 'unknown'; return isBrandedQuery(query, brandTerms) ? 'brand' : 'non_brand'; }\nexport function sumSearchConsoleRows(rows: Array<{ clicks: number; impressions: number; ctr_percent: number; position: number }>) { const clicks = rows.reduce((total, row) => total + row.clicks, 0); const impressions = rows.reduce((total, row) => total + row.impressions, 0); const weightedCtr = impressions > 0 ? rows.reduce((total, row) => total + row.impressions * row.ctr_percent, 0) / impressions : 0; const weightedPosition = impressions > 0 ? rows.reduce((total, row) => total + row.impressions * row.position, 0) / impressions : 0; return { clicks: round(clicks), impressions: round(impressions), ctrPercent: round(weightedCtr), averagePosition: round(weightedPosition) }; }\nexport function scoreQuickWinOpportunity(input: { impressions: number; ctrPercent: number; position: number }) { return round(input.impressions * Math.max(0, 8 - input.ctrPercent) * Math.max(0.5, 20 - input.position) / 100); }\nexport function scoreHighImpressionLowClickOpportunity(input: { impressions: number; ctrPercent: number; position: number }) { return round(input.impressions * Math.max(0, 5 - input.ctrPercent) * Math.max(0.5, 15 - input.position) / 100); }\nexport function classifyQuickWinType(position: number, ctrPercent: number) { if (position > 0 && position <= 10 && ctrPercent < 4) return 'ctr'; if (position > 10 && position <= 20) return 'position'; return 'mixed'; }\nexport function looksLikeProductQuery(query: string, productTerms?: string[]) { if ((productTerms ?? []).some((term) => query.toLowerCase().includes(term.trim().toLowerCase()))) return true; return /\\b(comprar|precio|modelo|sku|talle|color|review|opiniones)\\b/i.test(query); }\nexport function buildComparisonMap<T>(rows: T[], getKey: (row: T) => string) { return new Map(rows.map((row) => [getKey(row), row])); }\nexport function computeChangePercent(current: number, previous: number) { if (previous === 0) return current > 0 ? 100 : 0; return round(((current - previous) / previous) * 100); }\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/src/tools/analytics/attribution-gaps.js

@@ -16,12 +16,13 @@ const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
 const attributionGapsSchema = z.object({
   startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format"),
   endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format"),
-  propertyId: z.string().optional().describe("GA4 property ID. If omitted, uses GA4_PROPERTY_ID"),
+  propertyId: z.string().optional().describe("GA4 property ID. If omitted, resolves profileId mapping first and then GA4_PROPERTY_ID."),
+  profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped GA4 property."),
   limit: z.number().int().min(10).max(100).optional().describe("Maximum source / medium rows to inspect")
 });
 async function attributionGapsHandler(params) {
   try {
-    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const propertyId = await resolveGa4PropertyId(params.propertyId, params.profileId);
     const limit = params.limit ?? 50;
     const [channelReport, sourceMediumReport, totalReport] = await Promise.all([
       runReport(propertyId, {

package/dist/src/tools/analytics/attribution-gaps.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/analytics/attribution-gaps.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  detectSeverity,\n  extractQuotaSnapshot,\n  getDimensionValue,\n  getMetricValueByName,\n  isProblematicAttributionValue,\n  resolveGa4PropertyId,\n  round,\n  toPercent,\n} from \"../../analytics/ga4-report-utils.js\";\nimport { runReport } from \"../../services/analytics/ga4-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nexport const attributionGapsSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format\"),\n  propertyId: z.string().optional().describe(\"GA4 property ID. If omitted, uses GA4_PROPERTY_ID\"),\n  limit: z.number().int().min(10).max(100).optional().describe(\"Maximum source / medium rows to inspect\"),\n});\n\nexport async function attributionGapsHandler(params: z.infer<typeof attributionGapsSchema>) {\n  try {\n    const propertyId = resolveGa4PropertyId(params.propertyId);\n    const limit = params.limit ?? 50;\n\n    const [channelReport, sourceMediumReport, totalReport] = await Promise.all([\n      runReport(propertyId, {\n        dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n        dimensions: [{ name: \"sessionDefaultChannelGroup\" }],\n        metrics: [{ name: \"sessions\" }, { name: \"totalUsers\" }],\n      }),\n      runReport(propertyId, {\n        dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n        dimensions: [{ name: \"sessionSourceMedium\" }],\n        metrics: [{ name: \"sessions\" }, { name: \"totalUsers\" }],\n        orderBys: [{ metric: { metricName: \"sessions\" }, desc: true }],\n        limit,\n        returnPropertyQuota: true,\n      }),\n      runReport(propertyId, {\n        dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n        metrics: [{ name: \"sessions\" }],\n      }),\n    ]);\n\n    const totalSessions = getMetricValueByName(\n      totalReport.rows?.[0] ?? {},\n      totalReport.metricHeaders,\n      \"sessions\"\n    );\n\n    const unassignedChannel = (channelReport.rows ?? []).find(\n      (row) => getDimensionValue(row) === \"Unassigned\"\n    );\n    const unassignedSessions = getMetricValueByName(\n      unassignedChannel ?? {},\n      channelReport.metricHeaders,\n      \"sessions\"\n    );\n\n    const problematicSourceMediumRows = (sourceMediumReport.rows ?? [])\n      .filter((row) => isProblematicAttributionValue(getDimensionValue(row)))\n      .map((row) => {\n        const sessions = getMetricValueByName(row, sourceMediumReport.metricHeaders, \"sessions\");\n        const users = getMetricValueByName(row, sourceMediumReport.metricHeaders, \"totalUsers\");\n\n        return {\n          source_medium: getDimensionValue(row),\n          sessions,\n          users,\n          session_share_percent: round(toPercent(sessions, totalSessions)),\n        };\n      });\n\n    const problematicSourceMediumSessions = problematicSourceMediumRows.reduce(\n      (total, row) => total + row.sessions,\n      0\n    );\n    const unassignedSharePercent = round(toPercent(unassignedSessions, totalSessions));\n    const problematicSourceMediumSharePercent = round(\n      toPercent(problematicSourceMediumSessions, totalSessions)\n    );\n\n    return object(\n      stripNulls({\n        property_id: propertyId,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        overview: {\n          total_sessions: totalSessions,\n          attribution_warning: \"Las se\u00F1ales se reportan por separado para evitar doble conteo entre dimensiones distintas de GA4.\",\n        },\n        unassigned_channel_group: {\n          sessions: unassignedSessions,\n          session_share_percent: unassignedSharePercent,\n          severity: detectSeverity(unassignedSharePercent),\n        },\n        problematic_source_medium: {\n          sessions: problematicSourceMediumSessions,\n          session_share_percent: problematicSourceMediumSharePercent,\n          severity: detectSeverity(problematicSourceMediumSharePercent),\n        },\n        problematic_source_mediums: problematicSourceMediumRows,\n        quota: extractQuotaSnapshot(sourceMediumReport),\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to detect GA4 attribution gaps\");\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  detectSeverity,\n  extractQuotaSnapshot,\n  getDimensionValue,\n  getMetricValueByName,\n  isProblematicAttributionValue,\n  resolveGa4PropertyId,\n  round,\n  toPercent,\n} from \"../../analytics/ga4-report-utils.js\";\nimport { runReport } from \"../../services/analytics/ga4-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nexport const attributionGapsSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format\"),\n  propertyId: z.string().optional().describe(\"GA4 property ID. If omitted, resolves profileId mapping first and then GA4_PROPERTY_ID.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped GA4 property.\"),\n  limit: z.number().int().min(10).max(100).optional().describe(\"Maximum source / medium rows to inspect\"),\n});\n\nexport async function attributionGapsHandler(params: z.infer<typeof attributionGapsSchema>) {\n  try {\n    const propertyId = await resolveGa4PropertyId(params.propertyId, params.profileId);\n    const limit = params.limit ?? 50;\n\n    const [channelReport, sourceMediumReport, totalReport] = await Promise.all([\n      runReport(propertyId, {\n        dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n        dimensions: [{ name: \"sessionDefaultChannelGroup\" }],\n        metrics: [{ name: \"sessions\" }, { name: \"totalUsers\" }],\n      }),\n      runReport(propertyId, {\n        dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n        dimensions: [{ name: \"sessionSourceMedium\" }],\n        metrics: [{ name: \"sessions\" }, { name: \"totalUsers\" }],\n        orderBys: [{ metric: { metricName: \"sessions\" }, desc: true }],\n        limit,\n        returnPropertyQuota: true,\n      }),\n      runReport(propertyId, {\n        dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n        metrics: [{ name: \"sessions\" }],\n      }),\n    ]);\n\n    const totalSessions = getMetricValueByName(\n      totalReport.rows?.[0] ?? {},\n      totalReport.metricHeaders,\n      \"sessions\"\n    );\n\n    const unassignedChannel = (channelReport.rows ?? []).find(\n      (row) => getDimensionValue(row) === \"Unassigned\"\n    );\n    const unassignedSessions = getMetricValueByName(\n      unassignedChannel ?? {},\n      channelReport.metricHeaders,\n      \"sessions\"\n    );\n\n    const problematicSourceMediumRows = (sourceMediumReport.rows ?? [])\n      .filter((row) => isProblematicAttributionValue(getDimensionValue(row)))\n      .map((row) => {\n        const sessions = getMetricValueByName(row, sourceMediumReport.metricHeaders, \"sessions\");\n        const users = getMetricValueByName(row, sourceMediumReport.metricHeaders, \"totalUsers\");\n\n        return {\n          source_medium: getDimensionValue(row),\n          sessions,\n          users,\n          session_share_percent: round(toPercent(sessions, totalSessions)),\n        };\n      });\n\n    const problematicSourceMediumSessions = problematicSourceMediumRows.reduce(\n      (total, row) => total + row.sessions,\n      0\n    );\n    const unassignedSharePercent = round(toPercent(unassignedSessions, totalSessions));\n    const problematicSourceMediumSharePercent = round(\n      toPercent(problematicSourceMediumSessions, totalSessions)\n    );\n\n    return object(\n      stripNulls({\n        property_id: propertyId,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        overview: {\n          total_sessions: totalSessions,\n          attribution_warning: \"Las se\u00F1ales se reportan por separado para evitar doble conteo entre dimensiones distintas de GA4.\",\n        },\n        unassigned_channel_group: {\n          sessions: unassignedSessions,\n          session_share_percent: unassignedSharePercent,\n          severity: detectSeverity(unassignedSharePercent),\n        },\n        problematic_source_medium: {\n          sessions: problematicSourceMediumSessions,\n          session_share_percent: problematicSourceMediumSharePercent,\n          severity: detectSeverity(problematicSourceMediumSharePercent),\n        },\n        problematic_source_mediums: problematicSourceMediumRows,\n        quota: extractQuotaSnapshot(sourceMediumReport),\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to detect GA4 attribution gaps\");\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/src/tools/analytics/channel-mix.js

@@ -16,11 +16,12 @@ const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
 const channelMixSchema = z.object({
   startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format"),
   endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format"),
-  propertyId: z.string().optional().describe("GA4 property ID. If omitted, uses GA4_PROPERTY_ID")
+  propertyId: z.string().optional().describe("GA4 property ID. If omitted, resolves profileId mapping first and then GA4_PROPERTY_ID."),
+  profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped GA4 property.")
 });
 async function channelMixHandler(params) {
   try {
-    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const propertyId = await resolveGa4PropertyId(params.propertyId, params.profileId);
     const report = await runReport(propertyId, {
       dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
       dimensions: [{ name: "sessionDefaultChannelGroup" }],

package/dist/src/tools/analytics/channel-mix.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/analytics/channel-mix.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  extractQuotaSnapshot,\n  getDimensionValue,\n  getMetricValueByName,\n  resolveGa4PropertyId,\n  round,\n  sumMetricValues,\n  toPercent,\n} from \"../../analytics/ga4-report-utils.js\";\nimport { isPaidDefaultChannelGroup } from \"../../analytics/ga4-channel-groups.js\";\nimport { runReport } from \"../../services/analytics/ga4-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nexport const channelMixSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format\"),\n  propertyId: z.string().optional().describe(\"GA4 property ID. If omitted, uses GA4_PROPERTY_ID\"),\n});\n\nexport async function channelMixHandler(params: z.infer<typeof channelMixSchema>) {\n  try {\n    const propertyId = resolveGa4PropertyId(params.propertyId);\n\n    const report = await runReport(propertyId, {\n      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n      dimensions: [{ name: \"sessionDefaultChannelGroup\" }],\n      metrics: [{ name: \"sessions\" }, { name: \"totalUsers\" }],\n      orderBys: [{ metric: { metricName: \"sessions\" }, desc: true }],\n      returnPropertyQuota: true,\n    });\n\n    const totalSessions = sumMetricValues(report.rows, report.metricHeaders, \"sessions\");\n    const totalUsers = sumMetricValues(report.rows, report.metricHeaders, \"totalUsers\");\n\n    const channels = (report.rows ?? []).map((row) => {\n      const sessions = getMetricValueByName(row, report.metricHeaders, \"sessions\");\n      const users = getMetricValueByName(row, report.metricHeaders, \"totalUsers\");\n\n      return {\n        channel: getDimensionValue(row),\n        sessions,\n        users,\n        session_share_percent: round(toPercent(sessions, totalSessions)),\n        user_share_percent: round(toPercent(users, totalUsers)),\n      };\n    });\n\n    const paidSessions = channels\n      .filter((channel) => isPaidDefaultChannelGroup(channel.channel))\n      .reduce((total, channel) => total + channel.sessions, 0);\n    const organicSessions = channels\n      .filter((channel) => channel.channel.startsWith(\"Organic\"))\n      .reduce((total, channel) => total + channel.sessions, 0);\n    const directSessions = channels\n      .filter((channel) => channel.channel === \"Direct\")\n      .reduce((total, channel) => total + channel.sessions, 0);\n\n    return object(\n      stripNulls({\n        property_id: propertyId,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        overview: {\n          total_sessions: totalSessions,\n          total_users: totalUsers,\n          top_channel: channels[0]?.channel,\n          paid_session_share_percent: round(toPercent(paidSessions, totalSessions)),\n          organic_session_share_percent: round(toPercent(organicSessions, totalSessions)),\n          direct_session_share_percent: round(toPercent(directSessions, totalSessions)),\n        },\n        channels,\n        quota: extractQuotaSnapshot(report),\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch GA4 channel mix\");\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,iCAAiC;AAC1C,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAE3B,MAAM,YAAY;AAEX,MAAM,mBAAmB,EAAE,OAAO;AAAA,EACvC,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,iCAAiC;AAAA,EACjF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,+BAA+B;AAAA,EAC7E,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,mDAAmD;AAChG,CAAC;AAED,eAAsB,kBAAkB,QAA0C;AAChF,MAAI;AACF,UAAM,aAAa,qBAAqB,OAAO,UAAU;AAEzD,UAAM,SAAS,MAAM,UAAU,YAAY;AAAA,MACzC,YAAY,CAAC,EAAE,WAAW,OAAO,WAAW,SAAS,OAAO,QAAQ,CAAC;AAAA,MACrE,YAAY,CAAC,EAAE,MAAM,6BAA6B,CAAC;AAAA,MACnD,SAAS,CAAC,EAAE,MAAM,WAAW,GAAG,EAAE,MAAM,aAAa,CAAC;AAAA,MACtD,UAAU,CAAC,EAAE,QAAQ,EAAE,YAAY,WAAW,GAAG,MAAM,KAAK,CAAC;AAAA,MAC7D,qBAAqB;AAAA,IACvB,CAAC;AAED,UAAM,gBAAgB,gBAAgB,OAAO,MAAM,OAAO,eAAe,UAAU;AACnF,UAAM,aAAa,gBAAgB,OAAO,MAAM,OAAO,eAAe,YAAY;AAElF,UAAM,YAAY,OAAO,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ;AAChD,YAAM,WAAW,qBAAqB,KAAK,OAAO,eAAe,UAAU;AAC3E,YAAM,QAAQ,qBAAqB,KAAK,OAAO,eAAe,YAAY;AAE1E,aAAO;AAAA,QACL,SAAS,kBAAkB,GAAG;AAAA,QAC9B;AAAA,QACA;AAAA,QACA,uBAAuB,MAAM,UAAU,UAAU,aAAa,CAAC;AAAA,QAC/D,oBAAoB,MAAM,UAAU,OAAO,UAAU,CAAC;AAAA,MACxD;AAAA,IACF,CAAC;AAED,UAAM,eAAe,SAClB,OAAO,CAAC,YAAY,0BAA0B,QAAQ,OAAO,CAAC,EAC9D,OAAO,CAAC,OAAO,YAAY,QAAQ,QAAQ,UAAU,CAAC;AACzD,UAAM,kBAAkB,SACrB,OAAO,CAAC,YAAY,QAAQ,QAAQ,WAAW,SAAS,CAAC,EACzD,OAAO,CAAC,OAAO,YAAY,QAAQ,QAAQ,UAAU,CAAC;AACzD,UAAM,iBAAiB,SACpB,OAAO,CAAC,YAAY,QAAQ,YAAY,QAAQ,EAChD,OAAO,CAAC,OAAO,YAAY,QAAQ,QAAQ,UAAU,CAAC;AAEzD,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,UAAU;AAAA,UACR,gBAAgB;AAAA,UAChB,aAAa;AAAA,UACb,aAAa,SAAS,CAAC,GAAG;AAAA,UAC1B,4BAA4B,MAAM,UAAU,cAAc,aAAa,CAAC;AAAA,UACxE,+BAA+B,MAAM,UAAU,iBAAiB,aAAa,CAAC;AAAA,UAC9E,8BAA8B,MAAM,UAAU,gBAAgB,aAAa,CAAC;AAAA,QAC9E;AAAA,QACA;AAAA,QACA,OAAO,qBAAqB,MAAM;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,iCAAiC;AAAA,EACrF;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  extractQuotaSnapshot,\n  getDimensionValue,\n  getMetricValueByName,\n  resolveGa4PropertyId,\n  round,\n  sumMetricValues,\n  toPercent,\n} from \"../../analytics/ga4-report-utils.js\";\nimport { isPaidDefaultChannelGroup } from \"../../analytics/ga4-channel-groups.js\";\nimport { runReport } from \"../../services/analytics/ga4-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nexport const channelMixSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format\"),\n  propertyId: z.string().optional().describe(\"GA4 property ID. If omitted, resolves profileId mapping first and then GA4_PROPERTY_ID.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped GA4 property.\"),\n});\n\nexport async function channelMixHandler(params: z.infer<typeof channelMixSchema>) {\n  try {\n    const propertyId = await resolveGa4PropertyId(params.propertyId, params.profileId);\n\n    const report = await runReport(propertyId, {\n      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n      dimensions: [{ name: \"sessionDefaultChannelGroup\" }],\n      metrics: [{ name: \"sessions\" }, { name: \"totalUsers\" }],\n      orderBys: [{ metric: { metricName: \"sessions\" }, desc: true }],\n      returnPropertyQuota: true,\n    });\n\n    const totalSessions = sumMetricValues(report.rows, report.metricHeaders, \"sessions\");\n    const totalUsers = sumMetricValues(report.rows, report.metricHeaders, \"totalUsers\");\n\n    const channels = (report.rows ?? []).map((row) => {\n      const sessions = getMetricValueByName(row, report.metricHeaders, \"sessions\");\n      const users = getMetricValueByName(row, report.metricHeaders, \"totalUsers\");\n\n      return {\n        channel: getDimensionValue(row),\n        sessions,\n        users,\n        session_share_percent: round(toPercent(sessions, totalSessions)),\n        user_share_percent: round(toPercent(users, totalUsers)),\n      };\n    });\n\n    const paidSessions = channels\n      .filter((channel) => isPaidDefaultChannelGroup(channel.channel))\n      .reduce((total, channel) => total + channel.sessions, 0);\n    const organicSessions = channels\n      .filter((channel) => channel.channel.startsWith(\"Organic\"))\n      .reduce((total, channel) => total + channel.sessions, 0);\n    const directSessions = channels\n      .filter((channel) => channel.channel === \"Direct\")\n      .reduce((total, channel) => total + channel.sessions, 0);\n\n    return object(\n      stripNulls({\n        property_id: propertyId,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        overview: {\n          total_sessions: totalSessions,\n          total_users: totalUsers,\n          top_channel: channels[0]?.channel,\n          paid_session_share_percent: round(toPercent(paidSessions, totalSessions)),\n          organic_session_share_percent: round(toPercent(organicSessions, totalSessions)),\n          direct_session_share_percent: round(toPercent(directSessions, totalSessions)),\n        },\n        channels,\n        quota: extractQuotaSnapshot(report),\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch GA4 channel mix\");\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/src/tools/analytics/ecommerce-tracking-health.js

@@ -13,11 +13,12 @@ const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
 const ecommerceTrackingHealthSchema = z.object({
   startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format"),
   endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format"),
-  propertyId: z.string().optional().describe("GA4 property ID. If omitted, uses GA4_PROPERTY_ID")
+  propertyId: z.string().optional().describe("GA4 property ID. If omitted, resolves profileId mapping first and then GA4_PROPERTY_ID."),
+  profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped GA4 property.")
 });
 async function ecommerceTrackingHealthHandler(params) {
   try {
-    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const propertyId = await resolveGa4PropertyId(params.propertyId, params.profileId);
     const report = await runReport(propertyId, {
       dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
       metrics: [

package/dist/src/tools/analytics/ecommerce-tracking-health.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/analytics/ecommerce-tracking-health.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  extractQuotaSnapshot,\n  getMetricValueByName,\n  resolveGa4PropertyId,\n  round,\n  toPercent,\n} from \"../../analytics/ga4-report-utils.js\";\nimport { runReport } from \"../../services/analytics/ga4-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nexport const ecommerceTrackingHealthSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format\"),\n  propertyId: z.string().optional().describe(\"GA4 property ID. If omitted, uses GA4_PROPERTY_ID\"),\n});\n\nexport async function ecommerceTrackingHealthHandler(\n  params: z.infer<typeof ecommerceTrackingHealthSchema>\n) {\n  try {\n    const propertyId = resolveGa4PropertyId(params.propertyId);\n    const report = await runReport(propertyId, {\n      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n      metrics: [\n        { name: \"itemViewEvents\" },\n        { name: \"addToCarts\" },\n        { name: \"checkouts\" },\n        { name: \"transactions\" },\n        { name: \"purchaseRevenue\" },\n        { name: \"refundAmount\" },\n      ],\n      returnPropertyQuota: true,\n    });\n\n    const row = report.rows?.[0] ?? {};\n    const itemViews = getMetricValueByName(row, report.metricHeaders, \"itemViewEvents\");\n    const addToCarts = getMetricValueByName(row, report.metricHeaders, \"addToCarts\");\n    const checkouts = getMetricValueByName(row, report.metricHeaders, \"checkouts\");\n    const transactions = getMetricValueByName(row, report.metricHeaders, \"transactions\");\n    const purchaseRevenue = getMetricValueByName(row, report.metricHeaders, \"purchaseRevenue\");\n    const refundAmount = getMetricValueByName(row, report.metricHeaders, \"refundAmount\");\n\n    const warnings: string[] = [];\n    if (itemViews === 0) {\n      warnings.push(\"No se detectaron view_item events en el rango consultado.\");\n    }\n    if (addToCarts === 0 && itemViews > 0) {\n      warnings.push(\"Hay view_item pero no add_to_cart. Revisar tagging de add_to_cart.\");\n    }\n    if (checkouts === 0 && addToCarts > 0) {\n      warnings.push(\"Hay add_to_cart pero no begin_checkout. Revisar continuidad del funnel.\");\n    }\n    if (transactions === 0 && checkouts > 0) {\n      warnings.push(\"Hay begin_checkout pero no purchase/transactions. Revisar tagging de compra.\");\n    }\n    if (purchaseRevenue > 0 && transactions === 0) {\n      warnings.push(\"Hay revenue pero no transactions. Revisar consistencia de ecommerce events.\");\n    }\n\n    return object(\n      stripNulls({\n        property_id: propertyId,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        currency_code: report.metadata?.currencyCode,\n        funnel: {\n          item_view_events: itemViews,\n          add_to_carts: addToCarts,\n          checkouts,\n          transactions,\n          purchase_revenue: round(purchaseRevenue),\n          refund_amount: round(refundAmount),\n          add_to_cart_rate_percent: round(toPercent(addToCarts, itemViews)),\n          checkout_rate_percent: round(toPercent(checkouts, addToCarts)),\n          purchase_rate_percent: round(toPercent(transactions, checkouts)),\n        },\n        warnings,\n        quota: extractQuotaSnapshot(report),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to evaluate GA4 ecommerce tracking health\"\n    );\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAE3B,MAAM,YAAY;AAEX,MAAM,gCAAgC,EAAE,OAAO;AAAA,EACpD,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,iCAAiC;AAAA,EACjF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,+BAA+B;AAAA,EAC7E,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,mDAAmD;AAChG,CAAC;AAED,eAAsB,+BACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,qBAAqB,OAAO,UAAU;AACzD,UAAM,SAAS,MAAM,UAAU,YAAY;AAAA,MACzC,YAAY,CAAC,EAAE,WAAW,OAAO,WAAW,SAAS,OAAO,QAAQ,CAAC;AAAA,MACrE,SAAS;AAAA,QACP,EAAE,MAAM,iBAAiB;AAAA,QACzB,EAAE,MAAM,aAAa;AAAA,QACrB,EAAE,MAAM,YAAY;AAAA,QACpB,EAAE,MAAM,eAAe;AAAA,QACvB,EAAE,MAAM,kBAAkB;AAAA,QAC1B,EAAE,MAAM,eAAe;AAAA,MACzB;AAAA,MACA,qBAAqB;AAAA,IACvB,CAAC;AAED,UAAM,MAAM,OAAO,OAAO,CAAC,KAAK,CAAC;AACjC,UAAM,YAAY,qBAAqB,KAAK,OAAO,eAAe,gBAAgB;AAClF,UAAM,aAAa,qBAAqB,KAAK,OAAO,eAAe,YAAY;AAC/E,UAAM,YAAY,qBAAqB,KAAK,OAAO,eAAe,WAAW;AAC7E,UAAM,eAAe,qBAAqB,KAAK,OAAO,eAAe,cAAc;AACnF,UAAM,kBAAkB,qBAAqB,KAAK,OAAO,eAAe,iBAAiB;AACzF,UAAM,eAAe,qBAAqB,KAAK,OAAO,eAAe,cAAc;AAEnF,UAAM,WAAqB,CAAC;AAC5B,QAAI,cAAc,GAAG;AACnB,eAAS,KAAK,2DAA2D;AAAA,IAC3E;AACA,QAAI,eAAe,KAAK,YAAY,GAAG;AACrC,eAAS,KAAK,oEAAoE;AAAA,IACpF;AACA,QAAI,cAAc,KAAK,aAAa,GAAG;AACrC,eAAS,KAAK,yEAAyE;AAAA,IACzF;AACA,QAAI,iBAAiB,KAAK,YAAY,GAAG;AACvC,eAAS,KAAK,8EAA8E;AAAA,IAC9F;AACA,QAAI,kBAAkB,KAAK,iBAAiB,GAAG;AAC7C,eAAS,KAAK,6EAA6E;AAAA,IAC7F;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,eAAe,OAAO,UAAU;AAAA,QAChC,QAAQ;AAAA,UACN,kBAAkB;AAAA,UAClB,cAAc;AAAA,UACd;AAAA,UACA;AAAA,UACA,kBAAkB,MAAM,eAAe;AAAA,UACvC,eAAe,MAAM,YAAY;AAAA,UACjC,0BAA0B,MAAM,UAAU,YAAY,SAAS,CAAC;AAAA,UAChE,uBAAuB,MAAM,UAAU,WAAW,UAAU,CAAC;AAAA,UAC7D,uBAAuB,MAAM,UAAU,cAAc,SAAS,CAAC;AAAA,QACjE;AAAA,QACA;AAAA,QACA,OAAO,qBAAqB,MAAM;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  extractQuotaSnapshot,\n  getMetricValueByName,\n  resolveGa4PropertyId,\n  round,\n  toPercent,\n} from \"../../analytics/ga4-report-utils.js\";\nimport { runReport } from \"../../services/analytics/ga4-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nexport const ecommerceTrackingHealthSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format\"),\n  propertyId: z.string().optional().describe(\"GA4 property ID. If omitted, resolves profileId mapping first and then GA4_PROPERTY_ID.\"),\n  profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped GA4 property.\"),\n});\n\nexport async function ecommerceTrackingHealthHandler(\n  params: z.infer<typeof ecommerceTrackingHealthSchema>\n) {\n  try {\n    const propertyId = await resolveGa4PropertyId(params.propertyId, params.profileId);\n    const report = await runReport(propertyId, {\n      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n      metrics: [\n        { name: \"itemViewEvents\" },\n        { name: \"addToCarts\" },\n        { name: \"checkouts\" },\n        { name: \"transactions\" },\n        { name: \"purchaseRevenue\" },\n        { name: \"refundAmount\" },\n      ],\n      returnPropertyQuota: true,\n    });\n\n    const row = report.rows?.[0] ?? {};\n    const itemViews = getMetricValueByName(row, report.metricHeaders, \"itemViewEvents\");\n    const addToCarts = getMetricValueByName(row, report.metricHeaders, \"addToCarts\");\n    const checkouts = getMetricValueByName(row, report.metricHeaders, \"checkouts\");\n    const transactions = getMetricValueByName(row, report.metricHeaders, \"transactions\");\n    const purchaseRevenue = getMetricValueByName(row, report.metricHeaders, \"purchaseRevenue\");\n    const refundAmount = getMetricValueByName(row, report.metricHeaders, \"refundAmount\");\n\n    const warnings: string[] = [];\n    if (itemViews === 0) {\n      warnings.push(\"No se detectaron view_item events en el rango consultado.\");\n    }\n    if (addToCarts === 0 && itemViews > 0) {\n      warnings.push(\"Hay view_item pero no add_to_cart. Revisar tagging de add_to_cart.\");\n    }\n    if (checkouts === 0 && addToCarts > 0) {\n      warnings.push(\"Hay add_to_cart pero no begin_checkout. Revisar continuidad del funnel.\");\n    }\n    if (transactions === 0 && checkouts > 0) {\n      warnings.push(\"Hay begin_checkout pero no purchase/transactions. Revisar tagging de compra.\");\n    }\n    if (purchaseRevenue > 0 && transactions === 0) {\n      warnings.push(\"Hay revenue pero no transactions. Revisar consistencia de ecommerce events.\");\n    }\n\n    return object(\n      stripNulls({\n        property_id: propertyId,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        currency_code: report.metadata?.currencyCode,\n        funnel: {\n          item_view_events: itemViews,\n          add_to_carts: addToCarts,\n          checkouts,\n          transactions,\n          purchase_revenue: round(purchaseRevenue),\n          refund_amount: round(refundAmount),\n          add_to_cart_rate_percent: round(toPercent(addToCarts, itemViews)),\n          checkout_rate_percent: round(toPercent(checkouts, addToCarts)),\n          purchase_rate_percent: round(toPercent(transactions, checkouts)),\n        },\n        warnings,\n        quota: extractQuotaSnapshot(report),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to evaluate GA4 ecommerce tracking health\"\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAE3B,MAAM,YAAY;AAEX,MAAM,gCAAgC,EAAE,OAAO;AAAA,EACpD,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,iCAAiC;AAAA,EACjF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,+BAA+B;AAAA,EAC7E,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,yFAAyF;AAAA,EACpI,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,uEAAuE;AACnH,CAAC;AAED,eAAsB,+BACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,MAAM,qBAAqB,OAAO,YAAY,OAAO,SAAS;AACjF,UAAM,SAAS,MAAM,UAAU,YAAY;AAAA,MACzC,YAAY,CAAC,EAAE,WAAW,OAAO,WAAW,SAAS,OAAO,QAAQ,CAAC;AAAA,MACrE,SAAS;AAAA,QACP,EAAE,MAAM,iBAAiB;AAAA,QACzB,EAAE,MAAM,aAAa;AAAA,QACrB,EAAE,MAAM,YAAY;AAAA,QACpB,EAAE,MAAM,eAAe;AAAA,QACvB,EAAE,MAAM,kBAAkB;AAAA,QAC1B,EAAE,MAAM,eAAe;AAAA,MACzB;AAAA,MACA,qBAAqB;AAAA,IACvB,CAAC;AAED,UAAM,MAAM,OAAO,OAAO,CAAC,KAAK,CAAC;AACjC,UAAM,YAAY,qBAAqB,KAAK,OAAO,eAAe,gBAAgB;AAClF,UAAM,aAAa,qBAAqB,KAAK,OAAO,eAAe,YAAY;AAC/E,UAAM,YAAY,qBAAqB,KAAK,OAAO,eAAe,WAAW;AAC7E,UAAM,eAAe,qBAAqB,KAAK,OAAO,eAAe,cAAc;AACnF,UAAM,kBAAkB,qBAAqB,KAAK,OAAO,eAAe,iBAAiB;AACzF,UAAM,eAAe,qBAAqB,KAAK,OAAO,eAAe,cAAc;AAEnF,UAAM,WAAqB,CAAC;AAC5B,QAAI,cAAc,GAAG;AACnB,eAAS,KAAK,2DAA2D;AAAA,IAC3E;AACA,QAAI,eAAe,KAAK,YAAY,GAAG;AACrC,eAAS,KAAK,oEAAoE;AAAA,IACpF;AACA,QAAI,cAAc,KAAK,aAAa,GAAG;AACrC,eAAS,KAAK,yEAAyE;AAAA,IACzF;AACA,QAAI,iBAAiB,KAAK,YAAY,GAAG;AACvC,eAAS,KAAK,8EAA8E;AAAA,IAC9F;AACA,QAAI,kBAAkB,KAAK,iBAAiB,GAAG;AAC7C,eAAS,KAAK,6EAA6E;AAAA,IAC7F;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,eAAe,OAAO,UAAU;AAAA,QAChC,QAAQ;AAAA,UACN,kBAAkB;AAAA,UAClB,cAAc;AAAA,UACd;AAAA,UACA;AAAA,UACA,kBAAkB,MAAM,eAAe;AAAA,UACvC,eAAe,MAAM,YAAY;AAAA,UACjC,0BAA0B,MAAM,UAAU,YAAY,SAAS,CAAC;AAAA,UAChE,uBAAuB,MAAM,UAAU,WAAW,UAAU,CAAC;AAAA,UAC7D,uBAAuB,MAAM,UAAU,cAAc,SAAS,CAAC;AAAA,QACjE;AAAA,QACA;AAAA,QACA,OAAO,qBAAqB,MAAM;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/analytics/engagement-overview.js

@@ -12,11 +12,12 @@ const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
 const engagementOverviewSchema = z.object({
   startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format"),
   endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format"),
-  propertyId: z.string().optional().describe("GA4 property ID. If omitted, uses GA4_PROPERTY_ID")
+  propertyId: z.string().optional().describe("GA4 property ID. If omitted, resolves profileId mapping first and then GA4_PROPERTY_ID."),
+  profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped GA4 property.")
 });
 async function engagementOverviewHandler(params) {
   try {
-    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const propertyId = await resolveGa4PropertyId(params.propertyId, params.profileId);
     const report = await runReport(propertyId, {
       dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
       metrics: [