@yoryoboy/bi-mcp 1.0.1

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

@@ -0,0 +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": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAE3B,MAAM,YAAY;AAEX,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,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;AAAA,EAC9F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,yCAAyC;AACxG,CAAC;AAED,eAAsB,uBAAuB,QAA+C;AAC1F,MAAI;AACF,UAAM,aAAa,qBAAqB,OAAO,UAAU;AACzD,UAAM,QAAQ,OAAO,SAAS;AAE9B,UAAM,CAAC,eAAe,oBAAoB,WAAW,IAAI,MAAM,QAAQ,IAAI;AAAA,MACzE,UAAU,YAAY;AAAA,QACpB,YAAY,CAAC,EAAE,WAAW,OAAO,WAAW,SAAS,OAAO,QAAQ,CAAC;AAAA,QACrE,YAAY,CAAC,EAAE,MAAM,6BAA6B,CAAC;AAAA,QACnD,SAAS,CAAC,EAAE,MAAM,WAAW,GAAG,EAAE,MAAM,aAAa,CAAC;AAAA,MACxD,CAAC;AAAA,MACD,UAAU,YAAY;AAAA,QACpB,YAAY,CAAC,EAAE,WAAW,OAAO,WAAW,SAAS,OAAO,QAAQ,CAAC;AAAA,QACrE,YAAY,CAAC,EAAE,MAAM,sBAAsB,CAAC;AAAA,QAC5C,SAAS,CAAC,EAAE,MAAM,WAAW,GAAG,EAAE,MAAM,aAAa,CAAC;AAAA,QACtD,UAAU,CAAC,EAAE,QAAQ,EAAE,YAAY,WAAW,GAAG,MAAM,KAAK,CAAC;AAAA,QAC7D;AAAA,QACA,qBAAqB;AAAA,MACvB,CAAC;AAAA,MACD,UAAU,YAAY;AAAA,QACpB,YAAY,CAAC,EAAE,WAAW,OAAO,WAAW,SAAS,OAAO,QAAQ,CAAC;AAAA,QACrE,SAAS,CAAC,EAAE,MAAM,WAAW,CAAC;AAAA,MAChC,CAAC;AAAA,IACH,CAAC;AAED,UAAM,gBAAgB;AAAA,MACpB,YAAY,OAAO,CAAC,KAAK,CAAC;AAAA,MAC1B,YAAY;AAAA,MACZ;AAAA,IACF;AAEA,UAAM,qBAAqB,cAAc,QAAQ,CAAC,GAAG;AAAA,MACnD,CAAC,QAAQ,kBAAkB,GAAG,MAAM;AAAA,IACtC;AACA,UAAM,qBAAqB;AAAA,MACzB,qBAAqB,CAAC;AAAA,MACtB,cAAc;AAAA,MACd;AAAA,IACF;AAEA,UAAM,+BAA+B,mBAAmB,QAAQ,CAAC,GAC9D,OAAO,CAAC,QAAQ,8BAA8B,kBAAkB,GAAG,CAAC,CAAC,EACrE,IAAI,CAAC,QAAQ;AACZ,YAAM,WAAW,qBAAqB,KAAK,mBAAmB,eAAe,UAAU;AACvF,YAAM,QAAQ,qBAAqB,KAAK,mBAAmB,eAAe,YAAY;AAEtF,aAAO;AAAA,QACL,eAAe,kBAAkB,GAAG;AAAA,QACpC;AAAA,QACA;AAAA,QACA,uBAAuB,MAAM,UAAU,UAAU,aAAa,CAAC;AAAA,MACjE;AAAA,IACF,CAAC;AAEH,UAAM,kCAAkC,4BAA4B;AAAA,MAClE,CAAC,OAAO,QAAQ,QAAQ,IAAI;AAAA,MAC5B;AAAA,IACF;AACA,UAAM,yBAAyB,MAAM,UAAU,oBAAoB,aAAa,CAAC;AACjF,UAAM,sCAAsC;AAAA,MAC1C,UAAU,iCAAiC,aAAa;AAAA,IAC1D;AAEA,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,qBAAqB;AAAA,QACvB;AAAA,QACA,0BAA0B;AAAA,UACxB,UAAU;AAAA,UACV,uBAAuB;AAAA,UACvB,UAAU,eAAe,sBAAsB;AAAA,QACjD;AAAA,QACA,2BAA2B;AAAA,UACzB,UAAU;AAAA,UACV,uBAAuB;AAAA,UACvB,UAAU,eAAe,mCAAmC;AAAA,QAC9D;AAAA,QACA,4BAA4B;AAAA,QAC5B,OAAO,qBAAqB,kBAAkB;AAAA,MAChD,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,uCAAuC;AAAA,EAC3F;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,74 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  extractQuotaSnapshot,
+  getDimensionValue,
+  getMetricValueByName,
+  resolveGa4PropertyId,
+  round,
+  sumMetricValues,
+  toPercent
+} from "../../analytics/ga4-report-utils.js";
+import { isPaidDefaultChannelGroup } from "../../analytics/ga4-channel-groups.js";
+import { runReport } from "../../services/analytics/ga4-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+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")
+});
+async function channelMixHandler(params) {
+  try {
+    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const report = await runReport(propertyId, {
+      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
+      dimensions: [{ name: "sessionDefaultChannelGroup" }],
+      metrics: [{ name: "sessions" }, { name: "totalUsers" }],
+      orderBys: [{ metric: { metricName: "sessions" }, desc: true }],
+      returnPropertyQuota: true
+    });
+    const totalSessions = sumMetricValues(report.rows, report.metricHeaders, "sessions");
+    const totalUsers = sumMetricValues(report.rows, report.metricHeaders, "totalUsers");
+    const channels = (report.rows ?? []).map((row) => {
+      const sessions = getMetricValueByName(row, report.metricHeaders, "sessions");
+      const users = getMetricValueByName(row, report.metricHeaders, "totalUsers");
+      return {
+        channel: getDimensionValue(row),
+        sessions,
+        users,
+        session_share_percent: round(toPercent(sessions, totalSessions)),
+        user_share_percent: round(toPercent(users, totalUsers))
+      };
+    });
+    const paidSessions = channels.filter((channel) => isPaidDefaultChannelGroup(channel.channel)).reduce((total, channel) => total + channel.sessions, 0);
+    const organicSessions = channels.filter((channel) => channel.channel.startsWith("Organic")).reduce((total, channel) => total + channel.sessions, 0);
+    const directSessions = channels.filter((channel) => channel.channel === "Direct").reduce((total, channel) => total + channel.sessions, 0);
+    return object(
+      stripNulls({
+        property_id: propertyId,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        overview: {
+          total_sessions: totalSessions,
+          total_users: totalUsers,
+          top_channel: channels[0]?.channel,
+          paid_session_share_percent: round(toPercent(paidSessions, totalSessions)),
+          organic_session_share_percent: round(toPercent(organicSessions, totalSessions)),
+          direct_session_share_percent: round(toPercent(directSessions, totalSessions))
+        },
+        channels,
+        quota: extractQuotaSnapshot(report)
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to fetch GA4 channel mix");
+  }
+}
+export {
+  channelMixHandler,
+  channelMixSchema
+};
+//# sourceMappingURL=channel-mix.js.map

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

@@ -0,0 +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;",
+  "names": []
+}

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

@@ -0,0 +1,89 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  extractQuotaSnapshot,
+  getMetricValueByName,
+  resolveGa4PropertyId,
+  round,
+  toPercent
+} from "../../analytics/ga4-report-utils.js";
+import { runReport } from "../../services/analytics/ga4-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+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")
+});
+async function ecommerceTrackingHealthHandler(params) {
+  try {
+    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const report = await runReport(propertyId, {
+      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
+      metrics: [
+        { name: "itemViewEvents" },
+        { name: "addToCarts" },
+        { name: "checkouts" },
+        { name: "transactions" },
+        { name: "purchaseRevenue" },
+        { name: "refundAmount" }
+      ],
+      returnPropertyQuota: true
+    });
+    const row = report.rows?.[0] ?? {};
+    const itemViews = getMetricValueByName(row, report.metricHeaders, "itemViewEvents");
+    const addToCarts = getMetricValueByName(row, report.metricHeaders, "addToCarts");
+    const checkouts = getMetricValueByName(row, report.metricHeaders, "checkouts");
+    const transactions = getMetricValueByName(row, report.metricHeaders, "transactions");
+    const purchaseRevenue = getMetricValueByName(row, report.metricHeaders, "purchaseRevenue");
+    const refundAmount = getMetricValueByName(row, report.metricHeaders, "refundAmount");
+    const warnings = [];
+    if (itemViews === 0) {
+      warnings.push("No se detectaron view_item events en el rango consultado.");
+    }
+    if (addToCarts === 0 && itemViews > 0) {
+      warnings.push("Hay view_item pero no add_to_cart. Revisar tagging de add_to_cart.");
+    }
+    if (checkouts === 0 && addToCarts > 0) {
+      warnings.push("Hay add_to_cart pero no begin_checkout. Revisar continuidad del funnel.");
+    }
+    if (transactions === 0 && checkouts > 0) {
+      warnings.push("Hay begin_checkout pero no purchase/transactions. Revisar tagging de compra.");
+    }
+    if (purchaseRevenue > 0 && transactions === 0) {
+      warnings.push("Hay revenue pero no transactions. Revisar consistencia de ecommerce events.");
+    }
+    return object(
+      stripNulls({
+        property_id: propertyId,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        currency_code: report.metadata?.currencyCode,
+        funnel: {
+          item_view_events: itemViews,
+          add_to_carts: addToCarts,
+          checkouts,
+          transactions,
+          purchase_revenue: round(purchaseRevenue),
+          refund_amount: round(refundAmount),
+          add_to_cart_rate_percent: round(toPercent(addToCarts, itemViews)),
+          checkout_rate_percent: round(toPercent(checkouts, addToCarts)),
+          purchase_rate_percent: round(toPercent(transactions, checkouts))
+        },
+        warnings,
+        quota: extractQuotaSnapshot(report)
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to evaluate GA4 ecommerce tracking health"
+    );
+  }
+}
+export {
+  ecommerceTrackingHealthHandler,
+  ecommerceTrackingHealthSchema
+};
+//# sourceMappingURL=ecommerce-tracking-health.js.map

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

@@ -0,0 +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;",
+  "names": []
+}

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

@@ -0,0 +1,71 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  extractQuotaSnapshot,
+  getMetricValueByName,
+  resolveGa4PropertyId,
+  round
+} from "../../analytics/ga4-report-utils.js";
+import { runReport } from "../../services/analytics/ga4-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+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")
+});
+async function engagementOverviewHandler(params) {
+  try {
+    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const report = await runReport(propertyId, {
+      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
+      metrics: [
+        { name: "sessions" },
+        { name: "engagedSessions" },
+        { name: "engagementRate" },
+        { name: "averageSessionDuration" },
+        { name: "screenPageViews" },
+        { name: "screenPageViewsPerSession" },
+        { name: "bounceRate" },
+        { name: "userEngagementDuration" }
+      ],
+      returnPropertyQuota: true
+    });
+    const row = report.rows?.[0] ?? {};
+    return object(
+      stripNulls({
+        property_id: propertyId,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        overview: {
+          sessions: getMetricValueByName(row, report.metricHeaders, "sessions"),
+          engaged_sessions: getMetricValueByName(row, report.metricHeaders, "engagedSessions"),
+          engagement_rate_percent: round(
+            getMetricValueByName(row, report.metricHeaders, "engagementRate") * 100
+          ),
+          bounce_rate_percent: round(getMetricValueByName(row, report.metricHeaders, "bounceRate") * 100),
+          average_session_duration_seconds: round(
+            getMetricValueByName(row, report.metricHeaders, "averageSessionDuration")
+          ),
+          views: getMetricValueByName(row, report.metricHeaders, "screenPageViews"),
+          views_per_session: round(
+            getMetricValueByName(row, report.metricHeaders, "screenPageViewsPerSession")
+          ),
+          user_engagement_duration_seconds: round(
+            getMetricValueByName(row, report.metricHeaders, "userEngagementDuration")
+          )
+        },
+        quota: extractQuotaSnapshot(report)
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to fetch GA4 engagement overview");
+  }
+}
+export {
+  engagementOverviewHandler,
+  engagementOverviewSchema
+};
+//# sourceMappingURL=engagement-overview.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/analytics/engagement-overview.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  extractQuotaSnapshot,\n  getMetricValueByName,\n  resolveGa4PropertyId,\n  round,\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 engagementOverviewSchema = 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 engagementOverviewHandler(params: z.infer<typeof engagementOverviewSchema>) {\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: \"sessions\" },\n        { name: \"engagedSessions\" },\n        { name: \"engagementRate\" },\n        { name: \"averageSessionDuration\" },\n        { name: \"screenPageViews\" },\n        { name: \"screenPageViewsPerSession\" },\n        { name: \"bounceRate\" },\n        { name: \"userEngagementDuration\" },\n      ],\n      returnPropertyQuota: true,\n    });\n\n    const row = report.rows?.[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          sessions: getMetricValueByName(row, report.metricHeaders, \"sessions\"),\n          engaged_sessions: getMetricValueByName(row, report.metricHeaders, \"engagedSessions\"),\n          engagement_rate_percent: round(\n            getMetricValueByName(row, report.metricHeaders, \"engagementRate\") * 100\n          ),\n          bounce_rate_percent: round(getMetricValueByName(row, report.metricHeaders, \"bounceRate\") * 100),\n          average_session_duration_seconds: round(\n            getMetricValueByName(row, report.metricHeaders, \"averageSessionDuration\")\n          ),\n          views: getMetricValueByName(row, report.metricHeaders, \"screenPageViews\"),\n          views_per_session: round(\n            getMetricValueByName(row, report.metricHeaders, \"screenPageViewsPerSession\")\n          ),\n          user_engagement_duration_seconds: round(\n            getMetricValueByName(row, report.metricHeaders, \"userEngagementDuration\")\n          ),\n        },\n        quota: extractQuotaSnapshot(report),\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch GA4 engagement overview\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAE3B,MAAM,YAAY;AAEX,MAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,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,0BAA0B,QAAkD;AAChG,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,WAAW;AAAA,QACnB,EAAE,MAAM,kBAAkB;AAAA,QAC1B,EAAE,MAAM,iBAAiB;AAAA,QACzB,EAAE,MAAM,yBAAyB;AAAA,QACjC,EAAE,MAAM,kBAAkB;AAAA,QAC1B,EAAE,MAAM,4BAA4B;AAAA,QACpC,EAAE,MAAM,aAAa;AAAA,QACrB,EAAE,MAAM,yBAAyB;AAAA,MACnC;AAAA,MACA,qBAAqB;AAAA,IACvB,CAAC;AAED,UAAM,MAAM,OAAO,OAAO,CAAC,KAAK,CAAC;AAEjC,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,UAAU,qBAAqB,KAAK,OAAO,eAAe,UAAU;AAAA,UACpE,kBAAkB,qBAAqB,KAAK,OAAO,eAAe,iBAAiB;AAAA,UACnF,yBAAyB;AAAA,YACvB,qBAAqB,KAAK,OAAO,eAAe,gBAAgB,IAAI;AAAA,UACtE;AAAA,UACA,qBAAqB,MAAM,qBAAqB,KAAK,OAAO,eAAe,YAAY,IAAI,GAAG;AAAA,UAC9F,kCAAkC;AAAA,YAChC,qBAAqB,KAAK,OAAO,eAAe,wBAAwB;AAAA,UAC1E;AAAA,UACA,OAAO,qBAAqB,KAAK,OAAO,eAAe,iBAAiB;AAAA,UACxE,mBAAmB;AAAA,YACjB,qBAAqB,KAAK,OAAO,eAAe,2BAA2B;AAAA,UAC7E;AAAA,UACA,kCAAkC;AAAA,YAChC,qBAAqB,KAAK,OAAO,eAAe,wBAAwB;AAAA,UAC1E;AAAA,QACF;AAAA,QACA,OAAO,qBAAqB,MAAM;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,yCAAyC;AAAA,EAC7F;AACF;",
+  "names": []
+}

package/dist/src/tools/analytics/index.js

@@ -0,0 +1,12 @@
+export * from "./list-accessible-properties.js";
+export * from "./property-info.js";
+export * from "./channel-mix.js";
+export * from "./source-medium-breakdown.js";
+export * from "./revenue-overview.js";
+export * from "./revenue-trend.js";
+export * from "./revenue-by-channel.js";
+export * from "./top-landing-pages.js";
+export * from "./engagement-overview.js";
+export * from "./attribution-gaps.js";
+export * from "./ecommerce-tracking-health.js";
+//# sourceMappingURL=index.js.map

package/dist/src/tools/analytics/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/analytics/index.ts"],
+  "sourcesContent": ["export * from \"./list-accessible-properties.js\";\nexport * from \"./property-info.js\";\nexport * from \"./channel-mix.js\";\nexport * from \"./source-medium-breakdown.js\";\nexport * from \"./revenue-overview.js\";\nexport * from \"./revenue-trend.js\";\nexport * from \"./revenue-by-channel.js\";\nexport * from \"./top-landing-pages.js\";\nexport * from \"./engagement-overview.js\";\nexport * from \"./attribution-gaps.js\";\nexport * from \"./ecommerce-tracking-health.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/src/tools/analytics/list-accessible-properties.js

@@ -0,0 +1,46 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { listAccountSummaries } from "../../services/analytics/ga4-client.js";
+import { getDefaultGa4PropertyId } from "../../config/google.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const listAccessiblePropertiesSchema = z.object({});
+async function listAccessiblePropertiesHandler(_params) {
+  try {
+    const { accountSummaries, nextPageToken } = await listAccountSummaries();
+    const defaultPropertyId = getDefaultGa4PropertyId();
+    const accounts = accountSummaries.map((account) => ({
+      account_id: account.account.replace("accounts/", ""),
+      account_name: account.displayName,
+      properties: (account.propertySummaries ?? []).map((property) => {
+        const propertyId = property.property.replace("properties/", "");
+        return {
+          property_id: propertyId,
+          property_name: property.displayName,
+          property_type: property.propertyType,
+          is_default_property: propertyId === defaultPropertyId
+        };
+      })
+    }));
+    const totalProperties = accounts.reduce((total, account) => total + account.properties.length, 0);
+    return object(
+      stripNulls({
+        metadata: {
+          is_partial: Boolean(nextPageToken),
+          next_page_token: nextPageToken,
+          continuation_instructions: nextPageToken ? "This response includes only the first page of accessible GA4 account summaries. Do not assume the account or property list is complete. If you need the full universe, request the next page using next_page_token." : void 0
+        },
+        total_accounts: accounts.length,
+        total_properties: totalProperties,
+        default_property_id: defaultPropertyId,
+        accounts
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to list accessible GA4 properties");
+  }
+}
+export {
+  listAccessiblePropertiesHandler,
+  listAccessiblePropertiesSchema
+};
+//# sourceMappingURL=list-accessible-properties.js.map

package/dist/src/tools/analytics/list-accessible-properties.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/analytics/list-accessible-properties.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listAccountSummaries } from \"../../services/analytics/ga4-client.js\";\nimport { getDefaultGa4PropertyId } from \"../../config/google.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const listAccessiblePropertiesSchema = z.object({});\n\nexport async function listAccessiblePropertiesHandler(\n  _params: z.infer<typeof listAccessiblePropertiesSchema>\n) {\n  try {\n    const { accountSummaries, nextPageToken } = await listAccountSummaries();\n    const defaultPropertyId = getDefaultGa4PropertyId();\n\n    const accounts = accountSummaries.map((account) => ({\n      account_id: account.account.replace(\"accounts/\", \"\"),\n      account_name: account.displayName,\n      properties: (account.propertySummaries ?? []).map((property) => {\n        const propertyId = property.property.replace(\"properties/\", \"\");\n\n        return {\n          property_id: propertyId,\n          property_name: property.displayName,\n          property_type: property.propertyType,\n          is_default_property: propertyId === defaultPropertyId,\n        };\n      }),\n    }));\n\n    const totalProperties = accounts.reduce((total, account) => total + account.properties.length, 0);\n\n    return object(\n      stripNulls({\n        metadata: {\n          is_partial: Boolean(nextPageToken),\n          next_page_token: nextPageToken,\n          continuation_instructions: nextPageToken\n            ? \"This response includes only the first page of accessible GA4 account summaries. Do not assume the account or property list is complete. If you need the full universe, request the next page using next_page_token.\"\n            : undefined,\n        },\n        total_accounts: accounts.length,\n        total_properties: totalProperties,\n        default_property_id: defaultPropertyId,\n        accounts,\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to list accessible GA4 properties\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,4BAA4B;AACrC,SAAS,+BAA+B;AACxC,SAAS,kBAAkB;AAEpB,MAAM,iCAAiC,EAAE,OAAO,CAAC,CAAC;AAEzD,eAAsB,gCACpB,SACA;AACA,MAAI;AACF,UAAM,EAAE,kBAAkB,cAAc,IAAI,MAAM,qBAAqB;AACvE,UAAM,oBAAoB,wBAAwB;AAElD,UAAM,WAAW,iBAAiB,IAAI,CAAC,aAAa;AAAA,MAClD,YAAY,QAAQ,QAAQ,QAAQ,aAAa,EAAE;AAAA,MACnD,cAAc,QAAQ;AAAA,MACtB,aAAa,QAAQ,qBAAqB,CAAC,GAAG,IAAI,CAAC,aAAa;AAC9D,cAAM,aAAa,SAAS,SAAS,QAAQ,eAAe,EAAE;AAE9D,eAAO;AAAA,UACL,aAAa;AAAA,UACb,eAAe,SAAS;AAAA,UACxB,eAAe,SAAS;AAAA,UACxB,qBAAqB,eAAe;AAAA,QACtC;AAAA,MACF,CAAC;AAAA,IACH,EAAE;AAEF,UAAM,kBAAkB,SAAS,OAAO,CAAC,OAAO,YAAY,QAAQ,QAAQ,WAAW,QAAQ,CAAC;AAEhG,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,UACR,YAAY,QAAQ,aAAa;AAAA,UACjC,iBAAiB;AAAA,UACjB,2BAA2B,gBACvB,wNACA;AAAA,QACN;AAAA,QACA,gBAAgB,SAAS;AAAA,QACzB,kBAAkB;AAAA,QAClB,qBAAqB;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,0CAA0C;AAAA,EAC9F;AACF;",
+  "names": []
+}

package/dist/src/tools/analytics/property-info.js

@@ -0,0 +1,54 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { findPropertySummary, resolveGa4PropertyId } from "../../analytics/ga4-report-utils.js";
+import { getMetadata, listAccountSummaries } from "../../services/analytics/ga4-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const propertyInfoSchema = z.object({
+  propertyId: z.string().optional().describe("GA4 property ID. If omitted, uses GA4_PROPERTY_ID")
+});
+async function propertyInfoHandler(params) {
+  try {
+    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const [{ accountSummaries }, metadata] = await Promise.all([
+      listAccountSummaries(),
+      getMetadata(propertyId)
+    ]);
+    const propertySummary = findPropertySummary(accountSummaries, propertyId);
+    const dimensions = metadata.dimensions ?? [];
+    const metrics = metadata.metrics ?? [];
+    return object(
+      stripNulls({
+        property: {
+          property_id: propertyId,
+          property_name: propertySummary?.propertyName,
+          property_type: propertySummary?.propertyType,
+          account_id: propertySummary?.accountId,
+          account_name: propertySummary?.accountName
+        },
+        capabilities: {
+          supports_ecommerce: metrics.some((metric) => metric.apiName === "purchaseRevenue") && metrics.some((metric) => metric.apiName === "transactions"),
+          supports_google_ads_dimensions: dimensions.some(
+            (dimension) => dimension.apiName.startsWith("sessionGoogleAds")
+          ),
+          supports_search_console_metrics: metrics.some(
+            (metric) => metric.apiName.startsWith("organicGoogleSearch")
+          ),
+          custom_channel_groups: dimensions.filter((dimension) => dimension.apiName.includes("CustomChannelGroup")).map((dimension) => dimension.apiName)
+        },
+        metadata_summary: {
+          total_dimensions: dimensions.length,
+          total_metrics: metrics.length,
+          sample_dimensions: dimensions.slice(0, 12).map((dimension) => dimension.apiName),
+          sample_metrics: metrics.slice(0, 12).map((metric) => metric.apiName)
+        }
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to fetch GA4 property info");
+  }
+}
+export {
+  propertyInfoHandler,
+  propertyInfoSchema
+};
+//# sourceMappingURL=property-info.js.map

package/dist/src/tools/analytics/property-info.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/analytics/property-info.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { findPropertySummary, resolveGa4PropertyId } from \"../../analytics/ga4-report-utils.js\";\nimport { getMetadata, listAccountSummaries } from \"../../services/analytics/ga4-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const propertyInfoSchema = z.object({\n  propertyId: z.string().optional().describe(\"GA4 property ID. If omitted, uses GA4_PROPERTY_ID\"),\n});\n\nexport async function propertyInfoHandler(params: z.infer<typeof propertyInfoSchema>) {\n  try {\n    const propertyId = resolveGa4PropertyId(params.propertyId);\n\n    const [{ accountSummaries }, metadata] = await Promise.all([\n      listAccountSummaries(),\n      getMetadata(propertyId),\n    ]);\n\n    const propertySummary = findPropertySummary(accountSummaries, propertyId);\n    const dimensions = metadata.dimensions ?? [];\n    const metrics = metadata.metrics ?? [];\n\n    return object(\n      stripNulls({\n        property: {\n          property_id: propertyId,\n          property_name: propertySummary?.propertyName,\n          property_type: propertySummary?.propertyType,\n          account_id: propertySummary?.accountId,\n          account_name: propertySummary?.accountName,\n        },\n        capabilities: {\n          supports_ecommerce:\n            metrics.some((metric) => metric.apiName === \"purchaseRevenue\") &&\n            metrics.some((metric) => metric.apiName === \"transactions\"),\n          supports_google_ads_dimensions: dimensions.some((dimension) =>\n            dimension.apiName.startsWith(\"sessionGoogleAds\")\n          ),\n          supports_search_console_metrics: metrics.some((metric) =>\n            metric.apiName.startsWith(\"organicGoogleSearch\")\n          ),\n          custom_channel_groups: dimensions\n            .filter((dimension) => dimension.apiName.includes(\"CustomChannelGroup\"))\n            .map((dimension) => dimension.apiName),\n        },\n        metadata_summary: {\n          total_dimensions: dimensions.length,\n          total_metrics: metrics.length,\n          sample_dimensions: dimensions.slice(0, 12).map((dimension) => dimension.apiName),\n          sample_metrics: metrics.slice(0, 12).map((metric) => metric.apiName),\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch GA4 property info\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,qBAAqB,4BAA4B;AAC1D,SAAS,aAAa,4BAA4B;AAClD,SAAS,kBAAkB;AAEpB,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,mDAAmD;AAChG,CAAC;AAED,eAAsB,oBAAoB,QAA4C;AACpF,MAAI;AACF,UAAM,aAAa,qBAAqB,OAAO,UAAU;AAEzD,UAAM,CAAC,EAAE,iBAAiB,GAAG,QAAQ,IAAI,MAAM,QAAQ,IAAI;AAAA,MACzD,qBAAqB;AAAA,MACrB,YAAY,UAAU;AAAA,IACxB,CAAC;AAED,UAAM,kBAAkB,oBAAoB,kBAAkB,UAAU;AACxE,UAAM,aAAa,SAAS,cAAc,CAAC;AAC3C,UAAM,UAAU,SAAS,WAAW,CAAC;AAErC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,UACR,aAAa;AAAA,UACb,eAAe,iBAAiB;AAAA,UAChC,eAAe,iBAAiB;AAAA,UAChC,YAAY,iBAAiB;AAAA,UAC7B,cAAc,iBAAiB;AAAA,QACjC;AAAA,QACA,cAAc;AAAA,UACZ,oBACE,QAAQ,KAAK,CAAC,WAAW,OAAO,YAAY,iBAAiB,KAC7D,QAAQ,KAAK,CAAC,WAAW,OAAO,YAAY,cAAc;AAAA,UAC5D,gCAAgC,WAAW;AAAA,YAAK,CAAC,cAC/C,UAAU,QAAQ,WAAW,kBAAkB;AAAA,UACjD;AAAA,UACA,iCAAiC,QAAQ;AAAA,YAAK,CAAC,WAC7C,OAAO,QAAQ,WAAW,qBAAqB;AAAA,UACjD;AAAA,UACA,uBAAuB,WACpB,OAAO,CAAC,cAAc,UAAU,QAAQ,SAAS,oBAAoB,CAAC,EACtE,IAAI,CAAC,cAAc,UAAU,OAAO;AAAA,QACzC;AAAA,QACA,kBAAkB;AAAA,UAChB,kBAAkB,WAAW;AAAA,UAC7B,eAAe,QAAQ;AAAA,UACvB,mBAAmB,WAAW,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,cAAc,UAAU,OAAO;AAAA,UAC/E,gBAAgB,QAAQ,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,WAAW,OAAO,OAAO;AAAA,QACrE;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,mCAAmC;AAAA,EACvF;AACF;",
+  "names": []
+}

package/dist/src/tools/analytics/revenue-by-channel.js

@@ -0,0 +1,70 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  extractQuotaSnapshot,
+  getDimensionValue,
+  getMetricValueByName,
+  resolveGa4PropertyId,
+  round,
+  sumMetricValues,
+  toPercent
+} from "../../analytics/ga4-report-utils.js";
+import { runReport } from "../../services/analytics/ga4-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+const revenueByChannelSchema = 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")
+});
+async function revenueByChannelHandler(params) {
+  try {
+    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const report = await runReport(propertyId, {
+      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
+      dimensions: [{ name: "sessionDefaultChannelGroup" }],
+      metrics: [{ name: "transactions" }, { name: "purchaseRevenue" }, { name: "sessions" }],
+      orderBys: [{ metric: { metricName: "purchaseRevenue" }, desc: true }],
+      returnPropertyQuota: true
+    });
+    const totalRevenue = sumMetricValues(report.rows, report.metricHeaders, "purchaseRevenue");
+    const totalTransactions = sumMetricValues(report.rows, report.metricHeaders, "transactions");
+    const channels = (report.rows ?? []).map((row) => {
+      const revenue = getMetricValueByName(row, report.metricHeaders, "purchaseRevenue");
+      const transactions = getMetricValueByName(row, report.metricHeaders, "transactions");
+      const sessions = getMetricValueByName(row, report.metricHeaders, "sessions");
+      return {
+        channel: getDimensionValue(row),
+        sessions,
+        transactions,
+        purchase_revenue: round(revenue),
+        revenue_share_percent: round(toPercent(revenue, totalRevenue)),
+        transaction_share_percent: round(toPercent(transactions, totalTransactions))
+      };
+    });
+    return object(
+      stripNulls({
+        property_id: propertyId,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        currency_code: report.metadata?.currencyCode,
+        overview: {
+          total_purchase_revenue: round(totalRevenue),
+          total_transactions: totalTransactions,
+          top_revenue_channel: channels[0]?.channel
+        },
+        channels,
+        quota: extractQuotaSnapshot(report)
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to fetch GA4 revenue by channel");
+  }
+}
+export {
+  revenueByChannelHandler,
+  revenueByChannelSchema
+};
+//# sourceMappingURL=revenue-by-channel.js.map

package/dist/src/tools/analytics/revenue-by-channel.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/analytics/revenue-by-channel.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 { 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 revenueByChannelSchema = 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 revenueByChannelHandler(params: z.infer<typeof revenueByChannelSchema>) {\n  try {\n    const propertyId = resolveGa4PropertyId(params.propertyId);\n    const report = await runReport(propertyId, {\n      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],\n      dimensions: [{ name: \"sessionDefaultChannelGroup\" }],\n      metrics: [{ name: \"transactions\" }, { name: \"purchaseRevenue\" }, { name: \"sessions\" }],\n      orderBys: [{ metric: { metricName: \"purchaseRevenue\" }, desc: true }],\n      returnPropertyQuota: true,\n    });\n\n    const totalRevenue = sumMetricValues(report.rows, report.metricHeaders, \"purchaseRevenue\");\n    const totalTransactions = sumMetricValues(report.rows, report.metricHeaders, \"transactions\");\n\n    const channels = (report.rows ?? []).map((row) => {\n      const revenue = getMetricValueByName(row, report.metricHeaders, \"purchaseRevenue\");\n      const transactions = getMetricValueByName(row, report.metricHeaders, \"transactions\");\n      const sessions = getMetricValueByName(row, report.metricHeaders, \"sessions\");\n\n      return {\n        channel: getDimensionValue(row),\n        sessions,\n        transactions,\n        purchase_revenue: round(revenue),\n        revenue_share_percent: round(toPercent(revenue, totalRevenue)),\n        transaction_share_percent: round(toPercent(transactions, totalTransactions)),\n      };\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        overview: {\n          total_purchase_revenue: round(totalRevenue),\n          total_transactions: totalTransactions,\n          top_revenue_channel: channels[0]?.channel,\n        },\n        channels,\n        quota: extractQuotaSnapshot(report),\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch GA4 revenue by channel\");\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,iBAAiB;AAC1B,SAAS,kBAAkB;AAE3B,MAAM,YAAY;AAEX,MAAM,yBAAyB,EAAE,OAAO;AAAA,EAC7C,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,wBAAwB,QAAgD;AAC5F,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,YAAY,CAAC,EAAE,MAAM,6BAA6B,CAAC;AAAA,MACnD,SAAS,CAAC,EAAE,MAAM,eAAe,GAAG,EAAE,MAAM,kBAAkB,GAAG,EAAE,MAAM,WAAW,CAAC;AAAA,MACrF,UAAU,CAAC,EAAE,QAAQ,EAAE,YAAY,kBAAkB,GAAG,MAAM,KAAK,CAAC;AAAA,MACpE,qBAAqB;AAAA,IACvB,CAAC;AAED,UAAM,eAAe,gBAAgB,OAAO,MAAM,OAAO,eAAe,iBAAiB;AACzF,UAAM,oBAAoB,gBAAgB,OAAO,MAAM,OAAO,eAAe,cAAc;AAE3F,UAAM,YAAY,OAAO,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ;AAChD,YAAM,UAAU,qBAAqB,KAAK,OAAO,eAAe,iBAAiB;AACjF,YAAM,eAAe,qBAAqB,KAAK,OAAO,eAAe,cAAc;AACnF,YAAM,WAAW,qBAAqB,KAAK,OAAO,eAAe,UAAU;AAE3E,aAAO;AAAA,QACL,SAAS,kBAAkB,GAAG;AAAA,QAC9B;AAAA,QACA;AAAA,QACA,kBAAkB,MAAM,OAAO;AAAA,QAC/B,uBAAuB,MAAM,UAAU,SAAS,YAAY,CAAC;AAAA,QAC7D,2BAA2B,MAAM,UAAU,cAAc,iBAAiB,CAAC;AAAA,MAC7E;AAAA,IACF,CAAC;AAED,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,UAAU;AAAA,UACR,wBAAwB,MAAM,YAAY;AAAA,UAC1C,oBAAoB;AAAA,UACpB,qBAAqB,SAAS,CAAC,GAAG;AAAA,QACpC;AAAA,QACA;AAAA,QACA,OAAO,qBAAqB,MAAM;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,wCAAwC;AAAA,EAC5F;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,77 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  extractQuotaSnapshot,
+  getMetricValueByName,
+  resolveGa4PropertyId,
+  round,
+  toPercent
+} from "../../analytics/ga4-report-utils.js";
+import { runReport } from "../../services/analytics/ga4-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+const revenueOverviewSchema = 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")
+});
+async function revenueOverviewHandler(params) {
+  try {
+    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const report = await runReport(propertyId, {
+      dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
+      metrics: [
+        { name: "sessions" },
+        { name: "totalUsers" },
+        { name: "transactions" },
+        { name: "purchaseRevenue" },
+        { name: "averagePurchaseRevenue" },
+        { name: "totalPurchasers" },
+        { name: "purchaserRate" }
+      ],
+      returnPropertyQuota: true
+    });
+    const row = report.rows?.[0] ?? {};
+    const sessions = getMetricValueByName(row, report.metricHeaders, "sessions");
+    const totalUsers = getMetricValueByName(row, report.metricHeaders, "totalUsers");
+    const transactions = getMetricValueByName(row, report.metricHeaders, "transactions");
+    const purchaseRevenue = getMetricValueByName(row, report.metricHeaders, "purchaseRevenue");
+    const averagePurchaseRevenue = getMetricValueByName(
+      row,
+      report.metricHeaders,
+      "averagePurchaseRevenue"
+    );
+    const totalPurchasers = getMetricValueByName(row, report.metricHeaders, "totalPurchasers");
+    const purchaserRate = getMetricValueByName(row, report.metricHeaders, "purchaserRate");
+    return object(
+      stripNulls({
+        property_id: propertyId,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        currency_code: report.metadata?.currencyCode,
+        overview: {
+          sessions,
+          total_users: totalUsers,
+          transactions,
+          total_purchasers: totalPurchasers,
+          purchase_revenue: round(purchaseRevenue),
+          average_purchase_revenue: round(averagePurchaseRevenue),
+          purchaser_rate_percent: round(purchaserRate * 100),
+          transactions_per_session_percent: round(toPercent(transactions, sessions)),
+          transactions_per_user_percent: round(toPercent(transactions, totalUsers)),
+          revenue_per_session: round(sessions > 0 ? purchaseRevenue / sessions : 0)
+        },
+        quota: extractQuotaSnapshot(report)
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to fetch GA4 revenue overview");
+  }
+}
+export {
+  revenueOverviewHandler,
+  revenueOverviewSchema
+};
+//# sourceMappingURL=revenue-overview.js.map