@prenta/admin 1.15.0 → 1.16.0

package/src/lib/seo-service.ts

@@ -1140,6 +1140,111 @@ export async function fetchAiCrawlerActivity(): Promise<AiCrawlerActivity> {
   return res.data ?? { enabled: false, rows: [], totals: { hits: 0, bots: 0, honeypot: 0 } }
 }
 
+// ─── AI visibility (GEO measurement) ────────────────────────────────────────
+// Mirrors `packages/cms-core/src/seo/geo-report.ts` (`SeoGeoReport`) and the
+// `GET /seo/geo?days=N` route. The server is the contract; keep in lock-step.
+
+export type SeoGeoDays = 7 | 28 | 90
+export type SeoGeoBotCategory = 'training' | 'retrieval' | 'search'
+/**
+ * `blocked_still_crawling` = robots.txt disallows this bot's category, yet it
+ * was observed in the window — the signal the tab surfaces most prominently.
+ */
+export type SeoGeoBotPolicy = 'allowed' | 'blocked' | 'blocked_still_crawling'
+
+/** A top-path row's optional join to the document behind it. */
+export interface SeoGeoEntityRef {
+  entityId?: string
+  entityTitle?: string
+  /** Collection slug of the matched document; routes the editor link. */
+  collection?: string
+}
+
+/**
+ * Why `enabled` is `false`: the kill switch in Settings → SEO (`settings`) or
+ * the GEO tables are not migrated on the CMS database (`unavailable`).
+ */
+export type SeoGeoDisabledReason = 'settings' | 'unavailable'
+
+export interface SeoGeoReport {
+  enabled: boolean
+  /** Present only when `enabled` is `false`. */
+  disabledReason?: SeoGeoDisabledReason
+  window: { from: string; to: string; days: number }
+  /** ISO date of the earliest recorded row, or null when nothing has arrived. */
+  firstSeenAt: string | null
+  crawl: {
+    /** Whole-window crawl volume (incl. the capped "other" bucket). */
+    total: { hits: number; prevHits: number | null }
+    series: Array<{ date: string; hits: Record<string, number> }>
+    bots: Array<{
+      bot: string
+      category: SeoGeoBotCategory
+      hits: number
+      /** `null` when the prior window is not fully covered by data. */
+      prevHits: number | null
+      lastSeenAt: string | null
+      policy: SeoGeoBotPolicy
+    }>
+    topPaths: Array<SeoGeoEntityRef & { path: string; hits: number; bots: string[] }>
+    /** Hits that rolled into the capped "other" bucket. */
+    otherHits: number
+  }
+  referrals: {
+    total: { visits: number; prevVisits: number | null }
+    engines: Array<{ engine: string; visits: number; prevVisits: number | null }>
+    topPaths: Array<SeoGeoEntityRef & { path: string; visits: number; engines: string[] }>
+    /** Visits that rolled into the capped "other" bucket. */
+    otherVisits: number
+  }
+}
+
+export async function fetchSeoGeo(days: SeoGeoDays): Promise<SeoGeoReport> {
+  const res = await cmsApi<SeoGeoReport>(`/seo/geo?days=${days}`)
+  throwIfError(res)
+  // Validate the shape before handing it to the tab — an unexpected body must
+  // render the error state, not crash in render. `crawl.total` is the newest
+  // field on the wire; a `@prenta/core` deployed before it lands here.
+  const d = res.data
+  if (!d || typeof d.enabled !== 'boolean' || typeof d.crawl?.total?.hits !== 'number') {
+    throw new Error('Unexpected AI visibility response')
+  }
+  return d
+}
+
+// Mirrors `GET|PUT /seo/geo-settings` (`routes/seo-geo.ts`). The server clamps
+// `retentionDays` to `SEO_GEO_RETENTION` itself; the card clamps first so the
+// value it shows is the value that lands.
+export const SEO_GEO_RETENTION = { min: 7, max: 365 } as const
+
+export interface SeoGeoSettings {
+  /** Kill switch: when off the server drops incoming beacons. */
+  enabled: boolean
+  /** Daily-bucket retention, 7–365 days. */
+  retentionDays: number
+}
+
+export type SeoGeoSettingsPatch = Partial<SeoGeoSettings>
+
+/** Resolves `null` on an error envelope or a malformed body so the card renders its error state. */
+export async function fetchGeoSettings(): Promise<SeoGeoSettings | null> {
+  const res = await cmsApi<SeoGeoSettings>('/seo/geo-settings')
+  const d = res.data
+  if (!d || typeof d.enabled !== 'boolean' || typeof d.retentionDays !== 'number') return null
+  return { enabled: d.enabled, retentionDays: d.retentionDays }
+}
+
+export async function updateGeoSettings(
+  patch: SeoGeoSettingsPatch,
+): Promise<{ ok: boolean; error?: string }> {
+  const res = await cmsApi<{ ok: boolean }>('/seo/geo-settings', {
+    method: 'PUT',
+    body: JSON.stringify(patch),
+  })
+  if (res.error) return { ok: false, error: res.error }
+  return { ok: true }
+}
+
 export interface RobotsConfig {
   body: string
   generated: boolean

package/src/views/SEO.tsx

@@ -1,11 +1,11 @@
 'use client'
 
 /**
- * SEO Operations Center — seven-tab workflow surface (Overview / Content /
- * Links / Technical / Redirects / Audit / Proposals). Tab + deep-link state is
- * driven by the `?tab=` query string so audits, issues, redirects, proposals,
- * and content editors are all linkable. All data flows through
- * `lib/seo-service.ts`.
+ * SEO Operations Center — eight-tab workflow surface (Overview / Content /
+ * Links / Technical / AI visibility / Redirects / Audit / Proposals). Tab +
+ * deep-link state is driven by the `?tab=` query string so audits, issues,
+ * redirects, proposals, and content editors are all linkable. All data flows
+ * through `lib/seo-service.ts`.
  */
 import * as Tabs from '@radix-ui/react-tabs'
 import {
@@ -18,6 +18,7 @@ import {
   Bot,
   Link2,
   Inbox,
+  Radar,
 } from 'lucide-react'
 import { useCallback, useEffect, useMemo, useState } from 'react'
 import { toast } from 'sonner'
@@ -35,6 +36,7 @@ import { RedirectsTab } from './seo/RedirectsTab.js'
 import { AuditTab } from './seo/AuditTab.js'
 import { LinksTab } from './seo/LinksTab.js'
 import { ProposalsTab } from './seo/ProposalsTab.js'
+import { AiVisibilityTab } from './seo/AiVisibilityTab.js'
 
 export interface SEOProps {
   onNavigate?: (path: string) => void
@@ -46,6 +48,7 @@ const TABS = [
   { id: 'content', label: 'Content SEO', icon: FileText },
   { id: 'links', label: 'Links', icon: Link2 },
   { id: 'technical', label: 'Technical', icon: Settings2 },
+  { id: 'ai-visibility', label: 'AI visibility', icon: Radar },
   { id: 'redirects', label: 'Redirects', icon: ArrowRightLeft },
   { id: 'audit', label: 'Audit', icon: ClipboardCheck },
   { id: 'proposals', label: 'Proposals', icon: Inbox },
@@ -74,6 +77,7 @@ export const SEO_DEEP_PATHS = [
   '/seo/links',
   '/seo/audit',
   '/seo/proposals',
+  '/seo/ai-visibility',
   '/seo',
 ] as const
 
@@ -96,6 +100,8 @@ export function seoTabForPath(pathname: string): TabId | null {
       return 'audit'
     case '/seo/proposals':
       return 'proposals'
+    case '/seo/ai-visibility':
+      return 'ai-visibility'
     case '/seo':
       return 'overview'
     default:
@@ -281,7 +287,10 @@ export function SEO({ onNavigate, initialTab = 'overview' }: SEOProps) {
               {activeTab === 'links' && <LinksTab onNavigate={onNavigate} planInfo={planInfo} />}
             </Tabs.Content>
             <Tabs.Content value="technical" tabIndex={-1}>
-              {activeTab === 'technical' && <TechnicalTab />}
+              {activeTab === 'technical' && <TechnicalTab onNavigate={onNavigate} />}
+            </Tabs.Content>
+            <Tabs.Content value="ai-visibility" tabIndex={-1}>
+              {activeTab === 'ai-visibility' && <AiVisibilityTab onNavigate={onNavigate} />}
             </Tabs.Content>
             <Tabs.Content value="redirects" tabIndex={-1}>
               {activeTab === 'redirects' && <RedirectsTab onNavigate={onNavigate} />}