@prenta/admin 1.6.2 → 1.7.0

package/src/lib/collection-routes.ts

@@ -24,6 +24,19 @@ export function editPathForDoc(
   return `/${collection}/${id}`
 }
 
+/** Editor route for an inbound-link suggestion source document. */
+export function sourceEditPath(
+  sourceCollection: string | undefined,
+  sourceEntityId: string,
+): string {
+  const collection = sourceCollection ?? 'pages'
+  return editPathForDoc(
+    { type: collection === 'pages' ? 'page' : 'post' },
+    collection,
+    sourceEntityId,
+  )
+}
+
 /** The route that starts a new document in the correct editor. */
 export function newPathForCollection(
   col: CollectionRouteMeta | undefined,

package/src/lib/seo-service.ts

@@ -417,7 +417,7 @@ export interface SeoFixFieldChange {
 export interface SeoIssueFixSuggestion {
   autoFixable: boolean
   source?: 'deterministic' | 'ai'
-  fixStrategy?: 'redirect' | 'fix-link'
+  fixStrategy?: 'redirect' | 'fix-link' | 'insert-link'
   aiUnavailable?: boolean
   fingerprint: string
   patch: Record<string, unknown>
@@ -498,6 +498,7 @@ export const SEO_INLINE_FIX_ISSUE_TYPES = new Set([
   'duplicate-meta-description',
   'missing-structured-data',
   'broken-internal-link',
+  'orphan-page',
 ])
 
 export function isInlineSeoFixIssue(type: string): boolean {
@@ -1125,6 +1126,23 @@ export interface LinkSuggestion {
   anchorText: string
   confidence: number
   excerpt: string
+  fingerprint: string
+  wrappable: boolean
+  sourceCollection?: string
+}
+
+export async function applySeoInternalLink(input: {
+  sourceEntityId: string
+  targetEntityId: string
+  anchorText: string
+  fingerprint: string
+}): Promise<{ error?: string }> {
+  const res = await cmsApi('/seo/links/apply', {
+    method: 'POST',
+    body: JSON.stringify(input),
+  })
+  if (res.error) return { error: res.error }
+  return {}
 }
 
 export async function fetchLinkGraphSnapshot(): Promise<LinkGraphSnapshot> {

package/src/views/SEO.tsx

@@ -249,11 +249,12 @@ export function SEO({ onNavigate, initialTab = 'overview' }: SEOProps) {
                 <ContentTab
                   initialEntityType={deepLink.entityType}
                   initialEntityId={deepLink.entityId}
+                  onNavigate={onNavigate}
                 />
               )}
             </Tabs.Content>
             <Tabs.Content value="links" tabIndex={-1}>
-              {activeTab === 'links' && <LinksTab onNavigate={onNavigate} />}
+              {activeTab === 'links' && <LinksTab onNavigate={onNavigate} planInfo={planInfo} />}
             </Tabs.Content>
             <Tabs.Content value="technical" tabIndex={-1}>
               {activeTab === 'technical' && <TechnicalTab />}

package/src/views/page-editor/PageSectionEditor.tsx

@@ -1013,6 +1013,7 @@ export function PageSectionEditor({
                         onDraftChange={handlePageSettings}
                         onClose={() => setRailTab('sections')}
                         onSaved={handleSeoSaved}
+                        onNavigate={onNavigate}
                       />
                     )}
                   </div>

package/src/views/post-editor/PostSectionEditor.tsx

@@ -849,6 +849,7 @@ export function PostSectionEditor({
                         onDraftChange={handleFields}
                         onClose={() => setRailTab('sections')}
                         onSaved={handleSeoSaved}
+                        onNavigate={onNavigate}
                       />
                     )}
                   </div>

package/src/views/seo/ContentTab.tsx

@@ -44,9 +44,11 @@ function parseEntityType(value: string | null | undefined): SeoEntityType | null
 export function ContentTab({
   initialEntityType,
   initialEntityId,
+  onNavigate,
 }: {
   initialEntityType?: string | null
   initialEntityId?: string | null
+  onNavigate?: (path: string) => void
 }) {
   const { data, loading, error, refetch } = useSeoResource(fetchSeoContentRecords, [])
   const [search, setSearch] = useState('')
@@ -194,6 +196,7 @@ export function ContentTab({
               entityId={selection.id}
               onClose={() => setSelection(null)}
               onSaved={refetch}
+              onNavigate={onNavigate}
             />
           )}
         </InspectorPane>

package/src/views/seo/LinksTab.tsx

@@ -17,6 +17,7 @@ import {
 } from 'lucide-react'
 import { toast } from 'sonner'
 import {
+  applySeoInternalLink,
   fetchLinkGraphSnapshot,
   fetchLinkHealthIssues,
   fetchLinkSuggestions,
@@ -24,7 +25,9 @@ import {
   type LinkGraphEntityRef,
   type LinkSuggestion,
 } from '../../lib/seo-service.js'
-import { editPathForDoc } from '../../lib/collection-routes.js'
+import { editPathForDoc, sourceEditPath } from '../../lib/collection-routes.js'
+import { hasPlanFeature, type PlanInfo } from '../../lib/plan.js'
+import { PlanUpgradeCallout } from '../../components/PlanUpgradeCallout.js'
 import {
   SectionCard,
   SeoLoading,
@@ -88,10 +91,39 @@ function ActionCard({
 function SuggestionList({
   suggestions,
   loading,
+  targetEntityId,
+  onNavigate,
+  onApplied,
+  planInfo,
 }: {
   suggestions: LinkSuggestion[]
   loading: boolean
+  targetEntityId: string
+  onNavigate?: (path: string) => void
+  onApplied?: (suggestion: LinkSuggestion) => void
+  planInfo?: PlanInfo | null
 }) {
+  const [applyingKey, setApplyingKey] = useState<string | null>(null)
+  const inlineApplyEnabled = hasPlanFeature(planInfo, 'seo.inlineApply')
+
+  async function handleApprove(suggestion: LinkSuggestion) {
+    const key = `${suggestion.sourceEntityId}-${suggestion.fingerprint}`
+    setApplyingKey(key)
+    const res = await applySeoInternalLink({
+      sourceEntityId: suggestion.sourceEntityId,
+      targetEntityId,
+      anchorText: suggestion.anchorText,
+      fingerprint: suggestion.fingerprint,
+    })
+    setApplyingKey(null)
+    if (res.error) {
+      toast.error(res.error)
+      return
+    }
+    toast.success('Link added.')
+    onApplied?.(suggestion)
+  }
+
   if (loading) {
     return (
       <p className="text-muted-foreground flex items-center gap-2 text-sm">
@@ -108,26 +140,64 @@ function SuggestionList({
     )
   }
   return (
-    <ul className="divide-border divide-y rounded-lg border">
-      {suggestions.map((s) => (
-        <li key={`${s.sourceEntityId}-${s.anchorText}`} className="px-4 py-3">
-          <p className="text-foreground text-sm font-medium">{s.sourceTitle}</p>
-          <p className="text-muted-foreground mt-0.5 text-xs">
-            Link &ldquo;{s.anchorText}&rdquo; → {s.sourceUrl || 'target page'}{' '}
-            <span className="text-muted-foreground/80 tabular-nums">
-              ({Math.round(s.confidence * 100)}% match)
-            </span>
-          </p>
-          {s.excerpt && (
-            <p className="text-muted-foreground mt-1 line-clamp-2 text-xs">{s.excerpt}</p>
-          )}
-        </li>
-      ))}
-    </ul>
+    <div className="space-y-3">
+      {!inlineApplyEnabled && suggestions.some((s) => s.wrappable) ? (
+        <PlanUpgradeCallout feature="seo.inlineApply" upgradeUrl={planInfo?.upgradeUrl} />
+      ) : null}
+      <ul className="divide-border divide-y rounded-lg border">
+        {suggestions.map((s) => {
+          const key = `${s.sourceEntityId}-${s.fingerprint || s.anchorText}`
+          const busy = applyingKey === key
+          return (
+            <li key={key} className="px-4 py-3">
+              <p className="text-foreground text-sm font-medium">{s.sourceTitle}</p>
+              <p className="text-muted-foreground mt-0.5 text-xs">
+                Link &ldquo;{s.anchorText}&rdquo; → {s.sourceUrl || 'target page'}{' '}
+                <span className="text-muted-foreground/80 tabular-nums">
+                  ({Math.round(s.confidence * 100)}% match)
+                </span>
+              </p>
+              {s.excerpt && (
+                <p className="text-muted-foreground mt-1 line-clamp-2 text-xs">{s.excerpt}</p>
+              )}
+              {s.wrappable && inlineApplyEnabled ? (
+                <div className="mt-2">
+                  <button
+                    type="button"
+                    className={btnPrimary}
+                    disabled={busy}
+                    onClick={() => void handleApprove(s)}
+                  >
+                    {busy ? <Loader2 className="h-4 w-4 animate-spin" aria-hidden /> : null}
+                    Approve link
+                  </button>
+                </div>
+              ) : onNavigate ? (
+                <div className="mt-2">
+                  <button
+                    type="button"
+                    className={btnSecondary}
+                    onClick={() => onNavigate(sourceEditPath(s.sourceCollection, s.sourceEntityId))}
+                  >
+                    Open in editor
+                  </button>
+                </div>
+              ) : null}
+            </li>
+          )
+        })}
+      </ul>
+    </div>
   )
 }
 
-export function LinksTab({ onNavigate }: { onNavigate?: (path: string) => void }) {
+export function LinksTab({
+  onNavigate,
+  planInfo,
+}: {
+  onNavigate?: (path: string) => void
+  planInfo?: PlanInfo | null
+}) {
   const { data, loading, error, refetch } = useSeoResource(fetchLinkGraphSnapshot, [])
   const [indexing, setIndexing] = useState(false)
   const [healthLoading, setHealthLoading] = useState(false)
@@ -379,7 +449,26 @@ export function LinksTab({ onNavigate }: { onNavigate?: (path: string) => void }
               <p className="text-foreground mb-2 text-sm font-medium">
                 AI suggestions for &ldquo;{selectedOrphan.title}&rdquo;
               </p>
-              <SuggestionList suggestions={suggestions} loading={suggestLoading} />
+              <SuggestionList
+                suggestions={suggestions}
+                loading={suggestLoading}
+                targetEntityId={selectedOrphan.id}
+                onNavigate={onNavigate}
+                planInfo={planInfo}
+                onApplied={(applied) => {
+                  setSuggestions((prev) =>
+                    prev.filter(
+                      (row) =>
+                        !(
+                          row.fingerprint === applied.fingerprint &&
+                          row.sourceEntityId === applied.sourceEntityId
+                        ),
+                    ),
+                  )
+                  refetch()
+                  void loadSuggestions(selectedOrphan)
+                }}
+              />
             </div>
           )}
         </div>