@canonry/canonry 4.141.0 → 4.142.0

package/assets/assets/{trash-2-1Yg9W-vs.js → trash-2-C_THWxO_.js}

@@ -1 +1 @@
-import{c as a}from"./index-D6EP4dQs.js";const t=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],h=a("circle-question-mark",t);const e=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],d=a("download",e);const o=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],p=a("external-link",o);const c=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],s=a("trash-2",c);export{h as C,d as D,p as E,s as T};
+import{c as a}from"./index-CYGBt2f0.js";const t=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],h=a("circle-question-mark",t);const e=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],d=a("download",e);const o=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],p=a("external-link",o);const c=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],s=a("trash-2",c);export{h as C,d as D,p as E,s as T};

package/assets/index.html

@@ -12,7 +12,7 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-D6EP4dQs.js"></script>
+    <script type="module" crossorigin src="./assets/index-CYGBt2f0.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/vendor-tanstack-Be8JdV5M.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-radix-CQ77EO2y.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-recharts-DSxTZhaH.js">

package/dist/{chunk-ZCFQGF3V.js → chunk-D7NJUGNQ.js}

@@ -43,7 +43,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-OJOA425V.js";
+} from "./chunk-LS6SEZVF.js";
 
 // src/config.ts
 import fs from "fs";
@@ -6277,8 +6277,11 @@ async function submitGscSitemapsFromMcp(client2, input) {
 }
 var gaWindowInputSchema = z2.object({
   project: projectNameSchema,
-  window: analyticsWindowSchema.optional()
+  window: analyticsWindowSchema.optional(),
+  startDate: z2.string().optional(),
+  endDate: z2.string().optional()
 });
+var GA_RANGE_PARAMS = ["window", "startDate", "endDate"];
 var gaTrafficInputSchema = gaWindowInputSchema.extend({
   limit: z2.number().int().positive().max(500).optional()
 });
@@ -7235,7 +7238,7 @@ var canonryMcpTools = [
     inputSchema: gaTrafficInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/ga/traffic"],
-    handler: (client2, input) => client2.gaTraffic(input.project, compactStringParams(input, ["limit", "window"]))
+    handler: (client2, input) => client2.gaTraffic(input.project, compactStringParams(input, ["limit", ...GA_RANGE_PARAMS]))
   }),
   defineTool({
     name: "canonry_ga_coverage",
@@ -7257,7 +7260,7 @@ var canonryMcpTools = [
     inputSchema: gaWindowInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/ga/ai-referral-history"],
-    handler: (client2, input) => client2.gaAiReferralHistory(input.project, compactStringParams(input, ["window"]))
+    handler: (client2, input) => client2.gaAiReferralHistory(input.project, compactStringParams(input, GA_RANGE_PARAMS))
   }),
   defineTool({
     name: "canonry_ga_ai_referral_daily",
@@ -7268,7 +7271,7 @@ var canonryMcpTools = [
     inputSchema: gaWindowInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/ga/ai-referral-daily"],
-    handler: (client2, input) => client2.gaAiReferralDaily(input.project, compactStringParams(input, ["window"]))
+    handler: (client2, input) => client2.gaAiReferralDaily(input.project, compactStringParams(input, GA_RANGE_PARAMS))
   }),
   defineTool({
     name: "canonry_ga_social_referral_history",
@@ -7279,7 +7282,7 @@ var canonryMcpTools = [
     inputSchema: gaWindowInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/ga/social-referral-history"],
-    handler: (client2, input) => client2.gaSocialReferralHistory(input.project, compactStringParams(input, ["window"]))
+    handler: (client2, input) => client2.gaSocialReferralHistory(input.project, compactStringParams(input, GA_RANGE_PARAMS))
   }),
   defineTool({
     name: "canonry_ga_social_referral_trend",
@@ -7312,7 +7315,7 @@ var canonryMcpTools = [
     inputSchema: gaWindowInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/ga/session-history"],
-    handler: (client2, input) => client2.gaSessionHistory(input.project, compactStringParams(input, ["window"]))
+    handler: (client2, input) => client2.gaSessionHistory(input.project, compactStringParams(input, GA_RANGE_PARAMS))
   }),
   // ----- Google Business Profile (Phase 1: auth + discovery) -----
   defineTool({

package/dist/{chunk-OJOA425V.js → chunk-LS6SEZVF.js}

@@ -262,6 +262,24 @@ var analysisDemandPeriodSchema = analysisPeriodSchema.extend({
   unreportedClicks: z2.number().int().nonnegative(),
   unreportedImpressions: z2.number().int().nonnegative()
 });
+var analysisEngagementPeriodSchema = analysisPeriodSchema.extend({
+  /** Sessions over the bucket. Additive, so this is a plain sum. */
+  sessions: z2.number().int().nonnegative(),
+  /**
+   * Sessions-weighted engagement rate over the days that carry a reading.
+   * A rate is not additive; sessions are, and GA4's engagementRate is
+   * engagedSessions / sessions, so the weighted mean reconstructs the bucket
+   * rate exactly. `null` when no day in the bucket carries a reading.
+   */
+  engagementRate: z2.number().min(0).max(1).nullable(),
+  dailyTotalUsers: z2.number().int().nonnegative().nullable(),
+  dailyNewUsers: z2.number().int().nonnegative().nullable(),
+  /** False when the bucket has no engagement reading at all. */
+  metricsAvailable: z2.boolean(),
+  daysInPeriod: z2.number().int().nonnegative(),
+  daysWithEngagementRate: z2.number().int().nonnegative(),
+  daysWithUserSplit: z2.number().int().nonnegative()
+});
 var gaMeasurementAnalysisDtoSchema = z2.object({
   window: gaMeasurementAnalysisWindowSchema,
   bucketDays: z2.literal(30),
@@ -299,6 +317,18 @@ var gaMeasurementAnalysisDtoSchema = z2.object({
       periods: z2.array(analysisEventPeriodSchema)
     }))
   }),
+  engagement: z2.object({
+    status: z2.enum(["ready", "unavailable"]),
+    /**
+     * Earliest date the project holds ANY engagement reading for, ignoring the
+     * requested window. Everything before it is unmeasured, not zero — this is
+     * the field a client report reads to label (or truncate) the pre-migration
+     * span instead of drawing a flat zero line across it.
+     */
+    availableFromDate: analysisDateSchema.nullable(),
+    latestDate: analysisDateSchema.nullable(),
+    periods: z2.array(analysisEngagementPeriodSchema)
+  }),
   searchDemand: z2.object({
     status: z2.enum(["ready", "unavailable"]),
     periods: z2.array(analysisDemandPeriodSchema),
@@ -4129,6 +4159,10 @@ function compactDateToIso(value) {
   if (value.length !== 8 || !/^\d{8}$/.test(value)) return value;
   return `${value.slice(0, 4)}-${value.slice(4, 6)}-${value.slice(6, 8)}`;
 }
+function parseBoundedRate(value) {
+  if (value === null) return null;
+  return value >= 0 && value <= 1 ? value : null;
+}
 
 // ../contracts/src/model-pointers.ts
 var modelPointerEventKindSchema = z10.enum(["introduced", "repointed", "retired"]);
@@ -6613,8 +6647,14 @@ var sourceBreakdownDtoSchema = z23.object({
   limit: z23.number().int().nullable()
 });
 function parseWindow(value) {
-  if (value === "7d" || value === "30d" || value === "90d" || value === "all") return value;
-  return "all";
+  if (value === void 0 || value === "") return "all";
+  const parsed = metricsWindowSchema.safeParse(value);
+  if (!parsed.success) {
+    throw validationError(
+      `Invalid window "${value}". Must be one of: ${metricsWindowSchema.options.join(", ")}.`
+    );
+  }
+  return parsed.data;
 }
 function windowCutoff(window) {
   if (window === "all") return null;
@@ -6623,6 +6663,31 @@ function windowCutoff(window) {
   d.setDate(d.getDate() - days);
   return d.toISOString();
 }
+var CALENDAR_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+function parseBoundaryDate(value, field) {
+  if (value === void 0 || value === "") return null;
+  const trimmed = value.trim();
+  const invalid = () => validationError(`Invalid ${field} "${value}". Expected a calendar date as YYYY-MM-DD.`);
+  if (!CALENDAR_DATE_PATTERN.test(trimmed)) throw invalid();
+  const parsed = /* @__PURE__ */ new Date(`${trimmed}T00:00:00Z`);
+  if (Number.isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== trimmed) throw invalid();
+  return trimmed;
+}
+function resolveDateRange(input) {
+  const window = parseWindow(input.window);
+  const startDate = parseBoundaryDate(input.startDate, "startDate");
+  const endDate = parseBoundaryDate(input.endDate, "endDate");
+  if (startDate && endDate && startDate > endDate) {
+    throw validationError(`Invalid date range: startDate "${startDate}" must be on or before endDate "${endDate}".`);
+  }
+  const cutoff = startDate ? null : windowCutoff(window)?.slice(0, 10) ?? null;
+  return {
+    startDate: startDate ?? cutoff,
+    endDate,
+    window,
+    explicitDates: startDate !== null || endDate !== null
+  };
+}
 
 // ../contracts/src/visibility-stats.ts
 import { z as z24 } from "zod";
@@ -7075,7 +7140,15 @@ var ga4TrafficSummaryDtoSchema = z27.object({
   totalOrganicSessions: z27.number(),
   /** Direct-channel sessions (sessions with no source — bookmarks, typed URLs, AI-driven traffic with stripped referrer). 0 for legacy rows from before the column was added. */
   totalDirectSessions: z27.number(),
-  totalUsers: z27.number(),
+  /**
+   * Null when the range has no un-dimensioned aggregate behind it.
+   *
+   * GA counts users as a COUNT DISTINCT at the grain requested, so users cannot
+   * be recovered by summing the landing-page dimensioned table. The rolling
+   * windows have a precomputed deduplicated row; an explicit calendar range does
+   * not, and reports the figure as unavailable rather than as an inflated sum.
+   */
+  totalUsers: z27.number().nullable(),
   topPages: z27.array(z27.object({
     landingPage: z27.string(),
     sessions: z27.number(),
@@ -10822,6 +10895,7 @@ export {
   formatAverageDelta,
   formatWindowCountDelta,
   compactDateToIso,
+  parseBoundedRate,
   evaluateModelPointerExposure,
   buildModelChangeNotice,
   googleConnectionDtoSchema,
@@ -10973,6 +11047,7 @@ export {
   sourceBreakdownDtoSchema,
   parseWindow,
   windowCutoff,
+  resolveDateRange,
   visibilityStatsDtoSchema,
   visibilityCompareDtoSchema,
   calendarMonthBounds,