From dfefc26aeae1e24840970426ad08adbc5f675330 Mon Sep 17 00:00:00 2001
From: lemma <>
Date: Wed, 10 Jun 2026 00:46:18 -0500
Subject: [PATCH] Show author handle on publication cards.

Store resolvedHandle on publication DynamoDB records (indexer, backfill, API createPublication) and return it from listPublications and listSuggestions
---
 app/components/PublicationCard.tsx | 6 ++++--
 app/lib/api-client.ts              | 4 +++-
 app/routes/suggestions.tsx         | 4 ++--
 infra/api/src/index.ts             | 8 ++++++--
 infra/backfill/src/index.ts        | 7 +++++--
 infra/indexer/src/index.ts         | 2 ++
 6 files changed, 22 insertions(+), 9 deletions(-)

diff --git a/app/components/PublicationCard.tsx b/app/components/PublicationCard.tsx
index 66c7951..47c2338 100644
--- a/app/components/PublicationCard.tsx
+++ b/app/components/PublicationCard.tsx
@@ -3,7 +3,7 @@ import { Link } from 'react-router'
 import { RssIcon } from '@heroicons/react/24/outline'
 
 interface Props {
-  pub: { atUri: string; name: string; url: string; description?: string }
+  pub: { atUri: string; name: string; url: string; description?: string; authorHandle?: string }
   action?: React.ReactNode
 }
 
@@ -28,7 +28,9 @@ export default function PublicationCard({ pub, action }: Props) {
         ) : (
           <a href={pub.url} target="_blank" rel="noopener noreferrer" className="text-sm font-medium text-stone-900 dark:text-white truncate hover:underline">{pub.name}</a>
         )}
-        <p className="text-sm text-stone-500 dark:text-stone-400 truncate mt-0.5">{new URL(pub.url).host}</p>
+        <p className="text-sm text-stone-500 dark:text-stone-400 truncate mt-0.5">
+          {new URL(pub.url).host}{pub.authorHandle && ` · @${pub.authorHandle}`}
+        </p>
         {pub.description && (
           <p className="text-sm text-stone-500 dark:text-stone-400 truncate mt-0.5">{pub.description}</p>
         )}
diff --git a/app/lib/api-client.ts b/app/lib/api-client.ts
index 8572326..22c544e 100644
--- a/app/lib/api-client.ts
+++ b/app/lib/api-client.ts
@@ -28,6 +28,7 @@ export type Publication = {
   url: string
   name: string
   description?: string
+  authorHandle?: string
   preferences: { showInDiscover: boolean }
 }
 
@@ -102,6 +103,7 @@ export type SuggestionItem = {
   pubName: string
   pubUrl: string
   pubDescription?: string
+  authorHandle?: string
 }
 
 export type TimelineItem = {
@@ -1386,7 +1388,7 @@ export async function listSuggestions(session: OAuthSession): Promise<Suggestion
 
 export async function addSuggestions(
   session: OAuthSession,
-  pubs: Array<{ pubAtUri: string; rkey: string; authorDid: string; pubName: string; pubUrl: string; pubDescription?: string }>,
+  pubs: Array<{ pubAtUri: string; rkey: string; authorDid: string; pubName: string; pubUrl: string; pubDescription?: string; authorHandle?: string }>,
 ): Promise<{ added: number }> {
   const pdsUrl = await resolvePdsUrl(session.sub)
   const token = await getServiceToken(session, pdsUrl)
diff --git a/app/routes/suggestions.tsx b/app/routes/suggestions.tsx
index 0ae71a0..d6859a1 100644
--- a/app/routes/suggestions.tsx
+++ b/app/routes/suggestions.tsx
@@ -104,7 +104,7 @@ export default function Suggestions() {
             const authorDid = pub.atUri.slice('at://'.length).split('/')[0]
             if (!rkey || authorDid === session.sub) continue
             if (subscriptions?.some((s) => s.publicationAtUri === pub.atUri)) continue
-            candidates.push({ pubAtUri: pub.atUri, rkey, authorDid, pubName: pub.name, pubUrl: pub.url, pubDescription: pub.description })
+            candidates.push({ pubAtUri: pub.atUri, rkey, authorDid, pubName: pub.name, pubUrl: pub.url, pubDescription: pub.description, authorHandle: pub.authorHandle })
           }
         }
       }
@@ -233,7 +233,7 @@ export default function Suggestions() {
             return (
               <PublicationCard
                 key={item.pubAtUri}
-                pub={{ atUri: item.pubAtUri, name: item.pubName, url: item.pubUrl, description: item.pubDescription }}
+                pub={{ atUri: item.pubAtUri, name: item.pubName, url: item.pubUrl, description: item.pubDescription, authorHandle: item.authorHandle }}
                 action={
                   <>
                     <button
diff --git a/infra/api/src/index.ts b/infra/api/src/index.ts
index 37d4679..36b0576 100644
--- a/infra/api/src/index.ts
+++ b/infra/api/src/index.ts
@@ -94,6 +94,7 @@ async function listPublications(did: string): Promise<APIGatewayProxyResultV2> {
     url: item.url as string,
     name: item.name as string,
     description: item.description as string | undefined,
+    authorHandle: item.resolvedHandle as string | undefined,
     preferences: { showInDiscover: (item.preferences as { showInDiscover?: boolean } | undefined)?.showInDiscover ?? false },
   }));
   return json(200, publications);
@@ -123,10 +124,11 @@ async function createPublication(event: APIGatewayProxyEventV2, did: string): Pr
   }
 
   const sk = `pub#${rkey}`;
+  const resolvedHandle = await resolveAuthorHandle(did);
   const item: Record<string, unknown> = {
     PK: `u#${did}#pub`, SK: sk,
     entityType: 'publication',
-    atUri, url, name,
+    atUri, url, name, resolvedHandle,
     preferences: { showInDiscover },
   };
   if (description !== undefined) item.description = description;
@@ -972,11 +974,12 @@ async function listSuggestions(did: string): Promise<APIGatewayProxyResultV2> {
     pubName: item.pubName as string,
     pubUrl: item.pubUrl as string,
     pubDescription: item.pubDescription as string | undefined,
+    authorHandle: item.authorHandle as string | undefined,
   })))
 }
 
 async function addSuggestionsBulk(event: APIGatewayProxyEventV2, did: string): Promise<APIGatewayProxyResultV2> {
-  let pubs: Array<{ pubAtUri?: string; rkey?: string; authorDid?: string; pubName?: string; pubUrl?: string; pubDescription?: string }>
+  let pubs: Array<{ pubAtUri?: string; rkey?: string; authorDid?: string; pubName?: string; pubUrl?: string; pubDescription?: string; authorHandle?: string }>
   try {
     const body = JSON.parse(event.body ?? '{}') as { pubs?: unknown }
     if (!Array.isArray(body.pubs)) return json(400, { error: 'pubs array is required' })
@@ -1013,6 +1016,7 @@ async function addSuggestionsBulk(event: APIGatewayProxyEventV2, did: string): P
       show: true,
     }
     if (pub.pubDescription?.trim()) item.pubDescription = pub.pubDescription.trim()
+    if (pub.authorHandle?.trim()) item.authorHandle = pub.authorHandle.trim()
     try {
       await ddb.send(new PutCommand({
         TableName: TABLE,
diff --git a/infra/backfill/src/index.ts b/infra/backfill/src/index.ts
index 6b3c119..184a381 100644
--- a/infra/backfill/src/index.ts
+++ b/infra/backfill/src/index.ts
@@ -113,7 +113,8 @@ async function resolvePublicationMeta(atUri: string): Promise<{ url: string; nam
   }
 
   // Cache it so subsequent documents from the same publication don't re-fetch.
-  await upsertPublication(pubDid, pubRkey, value)
+  const handle = await resolveHandle(pubDid)
+  await upsertPublication(pubDid, pubRkey, value, handle)
 
   return { url: value.url.replace(/\/$/, ''), name: value.name ?? '' }
 }
@@ -124,6 +125,7 @@ async function upsertPublication(
   did: string,
   rkey: string,
   record: { url: string; name: string; description?: string; preferences?: { showInDiscover?: boolean } },
+  resolvedHandle: string,
 ): Promise<void> {
   const atUri = `at://${did}/site.standard.publication/${rkey}`
   const normalizedUrl = decodeURIComponent(record.url.replace(/\/$/, ''))
@@ -134,6 +136,7 @@ async function upsertPublication(
     atUri,
     url: normalizedUrl,
     name: record.name,
+    resolvedHandle,
     preferences: { showInDiscover: record.preferences?.showInDiscover ?? false },
   }
   if (record.description?.trim()) item.description = record.description.trim()
@@ -370,7 +373,7 @@ async function backfillPublicationsAndDocuments(did: string): Promise<void> {
   for (const { uri, value } of pubs) {
     const rkey = uri.split('/').pop()!
     try {
-      await upsertPublication(did, rkey, value)
+      await upsertPublication(did, rkey, value, resolvedHandle)
       console.log(`  pub  ${did}  ${rkey}  "${value.name}"`)
     } catch (err) {
       console.error(`  pub  ${did}  ${rkey}  ERROR: ${(err as Error).message}`)
diff --git a/infra/indexer/src/index.ts b/infra/indexer/src/index.ts
index 939037c..99e3454 100644
--- a/infra/indexer/src/index.ts
+++ b/infra/indexer/src/index.ts
@@ -147,6 +147,7 @@ type SubscriptionRecord = {
 async function upsertPublication(did: string, rkey: string, record: PublicationRecord) {
   const atUri = `at://${did}/site.standard.publication/${rkey}`
   const normalizedUrl = decodeURIComponent(record.url.replace(/\/$/, ''))
+  const resolvedHandle = await resolveAuthorHandle(did)
   const item: Record<string, unknown> = {
     PK: `u#${did}#pub`,
     SK: `pub#${rkey}`,
@@ -154,6 +155,7 @@ async function upsertPublication(did: string, rkey: string, record: PublicationR
     atUri,
     url: normalizedUrl,
     name: record.name,
+    resolvedHandle,
     preferences: { showInDiscover: record.preferences?.showInDiscover ?? false },
   }
   if (record.description?.trim()) item.description = record.description.trim()
-- 
2.51.2