npm - @ainyc/canonry - Versions diffs - 4.139.1 → 4.142.0 - Mend

@ainyc/canonry 4.139.1 → 4.142.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (30) hide show

package/assets/assets/{trash-2-CnEPNBqu.js → trash-2-C_THWxO_.js} RENAMED Viewed

	@@ -1 +1 @@
1	- import{c as a}from"./index-~~iRW7X23W~~.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};
1	+ 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 CHANGED Viewed

@@ -12,12 +12,12 @@
     <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-iRW7X23W.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">
     <link rel="modulepreload" crossorigin href="./assets/vendor-markdown-6dwjPOKK.js">
-    <link rel="stylesheet" crossorigin href="./assets/index-CntuM6Th.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-BDo9nl4O.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-IYTHIAAE.js → chunk-D7NJUGNQ.js} RENAMED Viewed

@@ -23,6 +23,7 @@ import {
   discoveryRunRequestSchema,
   gaMeasurementAnalysisWindowSchema,
   gaMeasurementHostScopeSchema,
+  gscPerformanceOrderBySchema,
   keywordBatchRequestSchema,
   keywordGenerateRequestSchema,
   notificationCreateRequestSchema,
@@ -42,7 +43,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-OA2EGCUS.js";
+} from "./chunk-LS6SEZVF.js";
 // src/config.ts
 import fs from "fs";
@@ -2067,6 +2068,18 @@ var getApiV1ProjectsByNameGoogleGscPerformanceDaily = (options) => {
     ...options
   });
 };
+var getApiV1ProjectsByNameGoogleGscTopPages = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/google/gsc/top-pages",
+    ...options
+  });
+};
 var postApiV1ProjectsByNameGoogleGscInspect = (options) => {
   return (options.client ?? client).post({
     security: [
@@ -5139,6 +5152,15 @@ var ApiClient = class {
       })
     );
   }
+  async gscTopPages(project, params) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameGoogleGscTopPages({
+        client: this.heyClient,
+        path: { name: project },
+        query: params
+      })
+    );
+  }
   async gscInspect(project, url) {
     return this.invoke(
       () => postApiV1ProjectsByNameGoogleGscInspect({
@@ -6140,7 +6162,9 @@ var gscPerformanceInputSchema = z2.object({
   endDate: z2.string().optional(),
   query: z2.string().optional(),
   page: z2.string().optional(),
-  limit: z2.number().int().positive().max(500).optional(),
+  limit: z2.number().int().positive().max(5e3).optional(),
+  offset: z2.number().int().nonnegative().optional(),
+  orderBy: gscPerformanceOrderBySchema.optional(),
   window: analyticsWindowSchema.optional()
 });
 var gscPerformanceDailyInputSchema = z2.object({
@@ -6149,6 +6173,13 @@ var gscPerformanceDailyInputSchema = z2.object({
   endDate: z2.string().optional(),
   window: analyticsWindowSchema.optional()
 });
+var gscTopPagesInputSchema = z2.object({
+  project: projectNameSchema,
+  startDate: z2.string().optional(),
+  endDate: z2.string().optional(),
+  limit: z2.number().int().positive().max(500).optional(),
+  window: analyticsWindowSchema.optional()
+});
 var gscInspectionsInputSchema = z2.object({
   project: projectNameSchema,
   url: z2.string().optional(),
@@ -6246,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()
 });
@@ -7074,13 +7108,13 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_gsc_performance",
     title: "Get GSC performance",
-    description: "Get stored Google Search Console performance rows for a Canonry project.",
+    description: "Get stored Google Search Console performance rows for a Canonry project. Rows are ordered by clicks descending unless orderBy says otherwise, and the response reports totalMatching / truncated / latestAvailableDate. Never sum these rows for a property total, use canonry_gsc_performance_daily.",
     access: "read",
     tier: "gsc",
     inputSchema: gscPerformanceInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/google/gsc/performance"],
-    handler: (client2, input) => client2.gscPerformance(input.project, compactStringParams(input, ["startDate", "endDate", "query", "page", "limit", "window"]))
+    handler: (client2, input) => client2.gscPerformance(input.project, compactStringParams(input, ["startDate", "endDate", "query", "page", "limit", "offset", "orderBy", "window"]))
   }),
   defineTool({
     name: "canonry_gsc_performance_daily",
@@ -7093,6 +7127,17 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/google/gsc/performance/daily"],
     handler: (client2, input) => client2.gscPerformanceDaily(input.project, compactStringParams(input, ["startDate", "endDate", "window"]))
   }),
+  defineTool({
+    name: "canonry_gsc_top_pages",
+    title: "Get top GSC pages",
+    description: 'Get the project\'s pages ranked by summed GSC clicks, aggregated in SQL. The rows are a RANKING and their clicks/impressions do NOT add up to the site total: Google withholds rare queries and repeats one impression per ranking page. Read the window total from the returned `totals` block (labelled totalsSource "property-daily"), which is null when no property-level figure covers the window. Never sum the rows.',
+    access: "read",
+    tier: "gsc",
+    inputSchema: gscTopPagesInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/google/gsc/top-pages"],
+    handler: (client2, input) => client2.gscTopPages(input.project, compactStringParams(input, ["startDate", "endDate", "limit", "window"]))
+  }),
   defineTool({
     name: "canonry_gsc_inspections",
     title: "List GSC inspections",
@@ -7193,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",
@@ -7215,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",
@@ -7226,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",
@@ -7237,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",
@@ -7270,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-OA2EGCUS.js → chunk-LS6SEZVF.js} RENAMED Viewed

@@ -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"]);
@@ -4408,6 +4442,13 @@ var gscSearchDataDtoSchema = z11.object({
   ctr: z11.number(),
   position: z11.number()
 });
+var gscPerformanceOrderBySchema = z11.enum(["clicks", "impressions", "date"]);
+var gscPerformanceResponseDtoSchema = z11.object({
+  rows: z11.array(gscSearchDataDtoSchema),
+  totalMatching: z11.number(),
+  truncated: z11.boolean(),
+  latestAvailableDate: z11.string().nullable()
+});
 var gscPerformanceDailyPointSchema = z11.object({
   date: z11.string(),
   clicks: z11.number(),
@@ -4423,6 +4464,38 @@ var gscPerformanceDailyDtoSchema = z11.object({
   }),
   daily: z11.array(gscPerformanceDailyPointSchema)
 });
+var gscTopPageRowSchema = z11.object({
+  page: z11.string(),
+  clicks: z11.number(),
+  impressions: z11.number(),
+  ctr: z11.number()
+});
+var gscTopPagesDtoSchema = z11.object({
+  rows: z11.array(gscTopPageRowSchema),
+  totals: z11.object({
+    clicks: z11.number(),
+    impressions: z11.number(),
+    ctr: z11.number(),
+    days: z11.number(),
+    /** First date the property-level totals actually cover. */
+    coveredFrom: z11.string().nullable(),
+    /** Last date the property-level totals actually cover. */
+    coveredThrough: z11.string().nullable(),
+    /**
+     * False when the totals span less than the ranked rows above.
+     *
+     * The dimensioned and property-level tables sync independently, so a
+     * 30-day totals sync can sit next to months of dimensioned rows. Printing
+     * both as one period would misstate the window the totals belong to.
+     */
+    complete: z11.boolean()
+  }).nullable(),
+  totalsSource: z11.literal("property-daily"),
+  /** First date the ranked rows cover, so a caller can compare spans. */
+  rankedFrom: z11.string().nullable(),
+  /** Last date the ranked rows cover. */
+  rankedThrough: z11.string().nullable()
+});
 var gscUrlInspectionDtoSchema = z11.object({
   id: z11.string(),
   url: z11.string(),
@@ -6574,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;
@@ -6584,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";
@@ -7036,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(),
@@ -10783,11 +10895,14 @@ export {
   formatAverageDelta,
   formatWindowCountDelta,
   compactDateToIso,
+  parseBoundedRate,
   evaluateModelPointerExposure,
   buildModelChangeNotice,
   googleConnectionDtoSchema,
-  gscSearchDataDtoSchema,
+  gscPerformanceOrderBySchema,
+  gscPerformanceResponseDtoSchema,
   gscPerformanceDailyDtoSchema,
+  gscTopPagesDtoSchema,
   gscUrlInspectionDtoSchema,
   gscDeindexedRowSchema,
   gscCoverageSummaryDtoSchema,
@@ -10932,6 +11047,7 @@ export {
   sourceBreakdownDtoSchema,
   parseWindow,
   windowCutoff,
+  resolveDateRange,
   visibilityStatsDtoSchema,
   visibilityCompareDtoSchema,
   calendarMonthBounds,