@ainyc/canonry 1.40.1 → 1.44.0

package/dist/cli.js

@@ -28,7 +28,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-FXHVGU5S.js";
+} from "./chunk-C3LF36DQ.js";
 import {
   apiKeys,
   competitors,
@@ -38,7 +38,7 @@ import {
   projects,
   querySnapshots,
   runs
-} from "./chunk-FOWWBLXD.js";
+} from "./chunk-AATIMNOX.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -355,7 +355,7 @@ async function backfillAnswerVisibilityCommand(opts) {
   console.log(`  Errors:   ${providerErrors}`);
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-PDZOIB7L.js");
+  const { IntelligenceService } = await import("./intelligence-service-36ERONKI.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -907,6 +907,15 @@ var ApiClient = class {
   async gaAiReferralHistory(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/ai-referral-history`);
   }
+  async gaSocialReferralHistory(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/social-referral-history`);
+  }
+  async gaSocialReferralTrend(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/social-referral-trend`);
+  }
+  async gaAttributionTrend(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/attribution-trend`);
+  }
   async gaSessionHistory(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/session-history`);
   }
@@ -1709,14 +1718,21 @@ async function gaStatus(project, format) {
 }
 async function gaSync(project, opts) {
   const client = getClient3();
-  const result = await client.gaSync(project, { days: opts?.days });
+  const body = {};
+  if (opts?.days) body.days = opts.days;
+  if (opts?.only) body.only = opts.only;
+  const result = await client.gaSync(project, body);
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
   console.log(`GA4 sync complete for "${project}".`);
+  if (result.syncedComponents) {
+    console.log(`  Components:  ${result.syncedComponents.join(", ")}`);
+  }
   console.log(`  Page rows:   ${result.rowCount}`);
   console.log(`  AI rows:     ${result.aiReferralCount}`);
+  console.log(`  Social rows: ${result.socialReferralCount}`);
   console.log(`  Period:      ${result.days} days`);
   console.log(`  Synced at:   ${result.syncedAt}`);
 }
@@ -1729,7 +1745,7 @@ async function gaTraffic(project, opts) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  if (result.topPages.length === 0 && result.aiReferrals.length === 0) {
+  if (result.topPages.length === 0 && result.aiReferrals.length === 0 && result.socialReferrals.length === 0) {
     console.log('No GA4 traffic data. Run "canonry ga sync <project>" first.');
     return;
   }
@@ -1756,6 +1772,23 @@ async function gaTraffic(project, opts) {
     }
     console.log();
   }
+  if (result.socialReferrals.length > 0) {
+    const chanWidth = 12;
+    if (result.socialSessions > 0) {
+      const share = result.totalSessions > 0 ? Math.round(result.socialSessions / result.totalSessions * 100) : 0;
+      console.log(`  Social Sessions:         ${result.socialSessions} (${share}% of total)`);
+    }
+    console.log("  SOCIAL REFERRAL SOURCES");
+    console.log(`  ${"SOURCE".padEnd(25)}  ${"MEDIUM".padEnd(15)}  ${"CHANNEL".padEnd(chanWidth)}  ${"SESSIONS".padEnd(10)}${"USERS".padEnd(8)}`);
+    console.log(`  ${"\u2500".repeat(25)}  ${"\u2500".repeat(15)}  ${"\u2500".repeat(chanWidth)}  ${"\u2500".repeat(10)}${"\u2500".repeat(8)}`);
+    for (const ref of result.socialReferrals) {
+      const chanLabel = ref.channelGroup === "Paid Social" ? "paid" : "organic";
+      console.log(
+        `  ${ref.source.padEnd(25)}  ${ref.medium.padEnd(15)}  ${chanLabel.padEnd(chanWidth)}  ${String(ref.sessions).padEnd(10)}${String(ref.users).padEnd(8)}`
+      );
+    }
+    console.log();
+  }
   if (result.topPages.length > 0) {
     const pageWidth = Math.min(60, Math.max(15, ...result.topPages.map((r) => r.landingPage.length)));
     console.log(`  TOP LANDING PAGES`);
@@ -1798,6 +1831,31 @@ async function gaAiReferralHistory(project, format) {
     );
   }
 }
+async function gaSocialReferralHistory(project, format) {
+  const client = getClient3();
+  const result = await client.gaSocialReferralHistory(project);
+  if (format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  if (result.length === 0) {
+    console.log('No social referral history. Run "canonry ga sync <project>" first.');
+    return;
+  }
+  const dateWidth = 12;
+  const sourceWidth = Math.min(30, Math.max(10, ...result.map((r) => r.source.length)));
+  const chanWidth = 12;
+  console.log(`GA4 Social Referral History for "${project}":
+`);
+  console.log(`  ${"DATE".padEnd(dateWidth)}  ${"SOURCE".padEnd(sourceWidth)}  ${"CHANNEL".padEnd(chanWidth)}  ${"SESSIONS".padEnd(10)}${"USERS".padEnd(8)}`);
+  console.log(`  ${"\u2500".repeat(dateWidth)}  ${"\u2500".repeat(sourceWidth)}  ${"\u2500".repeat(chanWidth)}  ${"\u2500".repeat(10)}${"\u2500".repeat(8)}`);
+  for (const row of result) {
+    const chanLabel = row.channelGroup === "Paid Social" ? "paid" : "organic";
+    console.log(
+      `  ${row.date.padEnd(dateWidth)}  ${row.source.padEnd(sourceWidth)}  ${chanLabel.padEnd(chanWidth)}  ${String(row.sessions).padEnd(10)}${String(row.users).padEnd(8)}`
+    );
+  }
+}
 async function gaCoverage(project, format) {
   const client = getClient3();
   const result = await client.gaCoverage(project);
@@ -1821,6 +1879,182 @@ async function gaCoverage(project, format) {
     );
   }
 }
+async function gaSocialReferralSummary(project, opts) {
+  const client = getClient3();
+  const traffic = await client.gaTraffic(project);
+  if (opts?.trend) {
+    const trend = await client.gaSocialReferralTrend(project);
+    if (opts.format === "json") {
+      console.log(JSON.stringify({
+        socialSessions: traffic.socialSessions,
+        socialUsers: traffic.socialUsers,
+        totalSessions: traffic.totalSessions,
+        socialSharePct: traffic.socialSharePct,
+        topSources: traffic.socialReferrals.slice(0, 5).map((r) => ({ source: r.source, sessions: r.sessions, channel: r.channelGroup })),
+        trend
+      }, null, 2));
+      return;
+    }
+    console.log(`Social Traffic Summary for "${project}"
+`);
+    console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePct}% of ${traffic.totalSessions} total)`);
+    console.log(`  Users:    ${traffic.socialUsers}`);
+    console.log();
+    const fmtTrend = (pct) => pct === null ? "n/a" : `${pct >= 0 ? "+" : ""}${pct}%`;
+    console.log(`  7d trend:  ${fmtTrend(trend.trend7dPct)} (${trend.socialSessions7d} vs ${trend.socialSessionsPrev7d})`);
+    console.log(`  30d trend: ${fmtTrend(trend.trend30dPct)} (${trend.socialSessions30d} vs ${trend.socialSessionsPrev30d})`);
+    if (trend.biggestMover) {
+      const m = trend.biggestMover;
+      console.log(`  Mover:     ${m.source} (${m.changePct >= 0 ? "+" : ""}${m.changePct}%, ${m.sessionsPrev7d}\u2192${m.sessions7d})`);
+    }
+    console.log();
+    if (traffic.socialReferrals.length > 0) {
+      console.log("  TOP SOURCES");
+      for (const ref of traffic.socialReferrals.slice(0, 5)) {
+        const chanLabel = ref.channelGroup === "Paid Social" ? "paid" : "organic";
+        console.log(`    ${ref.source.padEnd(20)} ${String(ref.sessions).padEnd(8)} sessions  (${chanLabel})`);
+      }
+    }
+    return;
+  }
+  if (opts?.format === "json") {
+    console.log(JSON.stringify({
+      socialSessions: traffic.socialSessions,
+      socialUsers: traffic.socialUsers,
+      totalSessions: traffic.totalSessions,
+      socialSharePct: traffic.socialSharePct,
+      topSources: traffic.socialReferrals.slice(0, 5).map((r) => ({ source: r.source, sessions: r.sessions, channel: r.channelGroup }))
+    }, null, 2));
+    return;
+  }
+  console.log(`Social Traffic Summary for "${project}"
+`);
+  console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePct}% of ${traffic.totalSessions} total)`);
+  console.log(`  Users:    ${traffic.socialUsers}`);
+  if (traffic.socialReferrals.length > 0) {
+    console.log();
+    console.log("  TOP SOURCES");
+    for (const ref of traffic.socialReferrals.slice(0, 5)) {
+      const chanLabel = ref.channelGroup === "Paid Social" ? "paid" : "organic";
+      console.log(`    ${ref.source.padEnd(20)} ${String(ref.sessions).padEnd(8)} sessions  (${chanLabel})`);
+    }
+  }
+}
+async function gaAttribution(project, opts) {
+  const client = getClient3();
+  const traffic = await client.gaTraffic(project);
+  const fmtTrend = (pct) => pct === null ? "n/a" : `${pct >= 0 ? "+" : ""}${pct}%`;
+  if (opts?.trend) {
+    const trend = await client.gaAttributionTrend(project);
+    if (opts.format === "json") {
+      console.log(JSON.stringify({
+        totalSessions: traffic.totalSessions,
+        totalUsers: traffic.totalUsers,
+        organicSessions: traffic.totalOrganicSessions,
+        aiSessions: traffic.aiSessionsDeduped,
+        aiUsers: traffic.aiUsersDeduped,
+        socialSessions: traffic.socialSessions,
+        socialUsers: traffic.socialUsers,
+        aiSharePct: traffic.aiSharePct,
+        socialSharePct: traffic.socialSharePct,
+        organicSharePct: traffic.organicSharePct,
+        aiReferrals: traffic.aiReferrals,
+        socialReferrals: traffic.socialReferrals,
+        trend
+      }, null, 2));
+      return;
+    }
+    if (traffic.totalSessions === 0) {
+      console.log('No GA4 traffic data. Run "canonry ga sync <project>" first.');
+      return;
+    }
+    console.log(`GA4 Attribution Overview for "${project}"
+`);
+    console.log(`  Total Sessions:   ${traffic.totalSessions}`);
+    console.log(`  Total Users:      ${traffic.totalUsers}`);
+    console.log();
+    console.log("  CHANNEL BREAKDOWN                  7d trend     30d trend");
+    console.log(`    Organic Search: ${String(traffic.totalOrganicSessions).padEnd(6)} (${String(traffic.organicSharePct).padStart(2)}%)    ${fmtTrend(trend.organic.trend7dPct).padEnd(12)} ${fmtTrend(trend.organic.trend30dPct)}`);
+    console.log(`    AI Referrals:   ${String(traffic.aiSessionsDeduped).padEnd(6)} (${String(traffic.aiSharePct).padStart(2)}%)    ${fmtTrend(trend.ai.trend7dPct).padEnd(12)} ${fmtTrend(trend.ai.trend30dPct)}`);
+    console.log(`    Social:         ${String(traffic.socialSessions).padEnd(6)} (${String(traffic.socialSharePct).padStart(2)}%)    ${fmtTrend(trend.social.trend7dPct).padEnd(12)} ${fmtTrend(trend.social.trend30dPct)}`);
+    const otherSessions2 = traffic.totalSessions - traffic.totalOrganicSessions - traffic.aiSessionsDeduped - traffic.socialSessions;
+    if (otherSessions2 > 0) {
+      const otherPct = traffic.totalSessions > 0 ? Math.round(otherSessions2 / traffic.totalSessions * 100) : 0;
+      console.log(`    Other:          ${String(otherSessions2).padEnd(6)} (${String(otherPct).padStart(2)}%)`);
+    }
+    console.log(`    \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
+    console.log(`    Total:          ${String(traffic.totalSessions).padEnd(6)}         ${fmtTrend(trend.total.trend7dPct).padEnd(12)} ${fmtTrend(trend.total.trend30dPct)}`);
+    if (trend.aiBiggestMover) {
+      const m = trend.aiBiggestMover;
+      console.log(`
+  AI Mover:     ${m.source} (${m.changePct >= 0 ? "+" : ""}${m.changePct}%, ${m.sessionsPrev7d}\u2192${m.sessions7d} sessions/7d)`);
+    }
+    if (trend.socialBiggestMover) {
+      const m = trend.socialBiggestMover;
+      console.log(`  Social Mover: ${m.source} (${m.changePct >= 0 ? "+" : ""}${m.changePct}%, ${m.sessionsPrev7d}\u2192${m.sessions7d} sessions/7d)`);
+    }
+    if (traffic.lastSyncedAt) {
+      console.log(`
+  Last synced: ${traffic.lastSyncedAt}`);
+    }
+    return;
+  }
+  if (opts?.format === "json") {
+    console.log(JSON.stringify({
+      totalSessions: traffic.totalSessions,
+      totalUsers: traffic.totalUsers,
+      organicSessions: traffic.totalOrganicSessions,
+      aiSessions: traffic.aiSessionsDeduped,
+      aiUsers: traffic.aiUsersDeduped,
+      socialSessions: traffic.socialSessions,
+      socialUsers: traffic.socialUsers,
+      aiSharePct: traffic.aiSharePct,
+      socialSharePct: traffic.socialSharePct,
+      organicSharePct: traffic.organicSharePct,
+      aiReferrals: traffic.aiReferrals,
+      socialReferrals: traffic.socialReferrals
+    }, null, 2));
+    return;
+  }
+  if (traffic.totalSessions === 0) {
+    console.log('No GA4 traffic data. Run "canonry ga sync <project>" first.');
+    return;
+  }
+  console.log(`GA4 Attribution Overview for "${project}"
+`);
+  console.log(`  Total Sessions:   ${traffic.totalSessions}`);
+  console.log(`  Total Users:      ${traffic.totalUsers}`);
+  console.log();
+  console.log("  CHANNEL BREAKDOWN");
+  console.log(`    Organic Search: ${traffic.totalOrganicSessions} sessions (${traffic.organicSharePct}%)`);
+  console.log(`    AI Referrals:   ${traffic.aiSessionsDeduped} sessions (${traffic.aiSharePct}%)`);
+  console.log(`    Social:         ${traffic.socialSessions} sessions (${traffic.socialSharePct}%)`);
+  const otherSessions = traffic.totalSessions - traffic.totalOrganicSessions - traffic.aiSessionsDeduped - traffic.socialSessions;
+  if (otherSessions > 0) {
+    const otherPct = traffic.totalSessions > 0 ? Math.round(otherSessions / traffic.totalSessions * 100) : 0;
+    console.log(`    Other:          ${otherSessions} sessions (${otherPct}%)`);
+  }
+  if (traffic.aiReferrals.length > 0) {
+    console.log();
+    console.log("  AI SOURCES");
+    for (const ref of traffic.aiReferrals.slice(0, 10)) {
+      const dimLabel = ref.sourceDimension === "first_user" ? "first-visit" : ref.sourceDimension === "manual_utm" ? "utm" : "session";
+      console.log(`    ${ref.source.padEnd(25)} ${String(ref.sessions).padEnd(8)} sessions  (${dimLabel})`);
+    }
+  }
+  if (traffic.socialReferrals.length > 0) {
+    console.log();
+    console.log("  SOCIAL SOURCES");
+    for (const ref of traffic.socialReferrals.slice(0, 10)) {
+      const chanLabel = ref.channelGroup === "Paid Social" ? "paid" : "organic";
+      console.log(`    ${ref.source.padEnd(25)} ${String(ref.sessions).padEnd(8)} sessions  (${chanLabel})`);
+    }
+  }
+  if (traffic.lastSyncedAt) {
+    console.log(`
+  Last synced: ${traffic.lastSyncedAt}`);
+  }
+}
 
 // src/cli-commands/ga.ts
 var GA_CLI_COMMANDS = [
@@ -1864,16 +2098,19 @@ var GA_CLI_COMMANDS = [
   },
   {
     path: ["ga", "sync"],
-    usage: "canonry ga sync <project> [--days 30] [--format json]",
+    usage: "canonry ga sync <project> [--days 30] [--only traffic|ai|social] [--format json]",
     options: {
-      days: stringOption()
+      days: stringOption(),
+      only: stringOption()
     },
     run: async (input) => {
-      const project = requireProject(input, "ga.sync", "canonry ga sync <project> [--days 30] [--format json]");
+      const project = requireProject(input, "ga.sync", "canonry ga sync <project> [--days 30] [--only traffic|ai|social] [--format json]");
       const daysStr = getString(input.values, "days");
       const days = daysStr ? parseInt(daysStr, 10) : void 0;
+      const only = getString(input.values, "only");
       await gaSync(project, {
         days,
+        only,
         format: input.format
       });
     }
@@ -1910,14 +2147,50 @@ var GA_CLI_COMMANDS = [
       await gaAiReferralHistory(project, input.format);
     }
   },
+  {
+    path: ["ga", "social-referral-history"],
+    usage: "canonry ga social-referral-history <project> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "ga.social-referral-history", "canonry ga social-referral-history <project> [--format json]");
+      await gaSocialReferralHistory(project, input.format);
+    }
+  },
+  {
+    path: ["ga", "social-referral-summary"],
+    usage: "canonry ga social-referral-summary <project> [--trend] [--format json]",
+    options: {
+      trend: { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const project = requireProject(input, "ga.social-referral-summary", "canonry ga social-referral-summary <project> [--trend] [--format json]");
+      await gaSocialReferralSummary(project, {
+        trend: input.values.trend === true,
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["ga", "attribution"],
+    usage: "canonry ga attribution <project> [--trend] [--format json]",
+    options: {
+      trend: { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const project = requireProject(input, "ga.attribution", "canonry ga attribution <project> [--trend] [--format json]");
+      await gaAttribution(project, {
+        trend: input.values.trend === true,
+        format: input.format
+      });
+    }
+  },
   {
     path: ["ga"],
-    usage: "canonry ga <connect|disconnect|status|sync|traffic|coverage|ai-referral-history> <project> [args]",
+    usage: "canonry ga <subcommand> <project> [args]",
     run: async (input) => {
       unknownSubcommand(input.positionals[0], {
         command: "ga",
-        usage: "canonry ga <connect|disconnect|status|sync|traffic|coverage|ai-referral-history> <project> [args]",
-        available: ["connect", "disconnect", "status", "sync", "traffic", "coverage", "ai-referral-history"]
+        usage: "canonry ga <subcommand> <project> [args]",
+        available: ["connect", "disconnect", "status", "sync", "traffic", "coverage", "ai-referral-history", "social-referral-history", "social-referral-summary", "attribution"]
       });
     }
   }
@@ -5937,7 +6210,10 @@ async function serveCommand(format = "text") {
   const db = createClient(config.database);
   migrate(db);
   const app = await createServer({ config, db });
+  let shuttingDown = false;
   const shutdown = () => {
+    if (shuttingDown) return;
+    shuttingDown = true;
     app.close().then(() => {
       process.exit(0);
     }).catch(() => {

package/dist/index.js

@@ -1,8 +1,8 @@
 import {
   createServer,
   loadConfig
-} from "./chunk-FXHVGU5S.js";
-import "./chunk-FOWWBLXD.js";
+} from "./chunk-C3LF36DQ.js";
+import "./chunk-AATIMNOX.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-PDZOIB7L.js → intelligence-service-36ERONKI.js}

@@ -1,6 +1,6 @@
 import {
   IntelligenceService
-} from "./chunk-FOWWBLXD.js";
+} from "./chunk-AATIMNOX.js";
 export {
   IntelligenceService
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "1.40.1",
+  "version": "1.44.0",
   "type": "module",
   "description": "The ultimate open-source AEO monitoring tool - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -54,20 +54,20 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0"
+    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsup && tsx build-web.ts",