import { SOURCE_TYPES, type SourceType } from "~/lib/shared-schemas"; import { STANDARD_SITE_DOCUMENT_COLLECTION } from "./standard-site/constants"; import { parseAtUri, type ParsedAtUri } from "~/lib/at-uri"; export type { ParsedAtUri }; export const ANSWER_CONTENT_COLLECTION = "at.askimut.answerContent"; export const BLUESKY_POST_COLLECTION = "app.bsky.feed.post"; export type ProjectionKind = "full-text" | "excerpt" | "none"; export type VerificationState = "verified" | "unverified" | "stale" | "unavailable"; /** Cached Answer Content state passed into background revalidation. */ export interface CachedAnswerContentState { cid: string | null; content: string | null; originUrl: string | null; title?: string | null; originMetadata?: OriginMetadata | null; sourceType?: SourceType; } /** Cached origin metadata persisted alongside external Answer Content. */ export interface OriginMetadata { title?: string | null; labels?: unknown; projectionKind?: ProjectionKind; truncated?: boolean; verificationState?: VerificationState; verifiedAt?: string; } export type LinkInputKind = | "at-uri" | "bsky-url" | "askimut-permalink" | "https-url" | "malformed" | "unsupported"; export interface NormalizedAnswerContentResult { canonicalAtUri: string; cid: string | null; ownerDid: string; projectedText: string | null; sourceType: SourceType; originUrl: string | null; title?: string | null; originMetadata?: OriginMetadata; projectionKind: ProjectionKind; verificationState: VerificationState; /** Whether the content lives outside Askimut and should be cached locally. */ isExternal: boolean; } export { parseAtUri }; export function isAskimutAnswerContentAtUri(uri: string): boolean { const parsed = parseAtUri(uri); return parsed?.collection === ANSWER_CONTENT_COLLECTION; } export function isBlueskyPostAtUri(uri: string): boolean { const parsed = parseAtUri(uri); return parsed?.collection === BLUESKY_POST_COLLECTION; } export function isExternalAtUri(uri: string): boolean { return uri.startsWith("at://") && !uri.includes(ANSWER_CONTENT_COLLECTION); } export function isStandardSiteDocumentAtUri(uri: string): boolean { const parsed = parseAtUri(uri); return parsed?.collection === STANDARD_SITE_DOCUMENT_COLLECTION; } export function deriveAnswerContentSourceType( atUri: string | null | undefined, storedSourceType?: string | null, ): SourceType { if (storedSourceType) return storedSourceType as SourceType; if (!atUri) return SOURCE_TYPES.ASKIMUT; if (isBlueskyPostAtUri(atUri)) return SOURCE_TYPES.BLUESKY; if (isStandardSiteDocumentAtUri(atUri)) return SOURCE_TYPES.STANDARD_SITE; if (isAskimutAnswerContentAtUri(atUri)) return SOURCE_TYPES.ASKIMUT; return SOURCE_TYPES.ASKIMUT; } export function parseOriginMetadata(sourceData?: string | null): OriginMetadata | null { if (!sourceData?.trim()) return null; try { const parsed: unknown = JSON.parse(sourceData); if (!parsed || typeof parsed !== "object") return null; return parsed as OriginMetadata; } catch { return null; } } export function buildOriginMetadata( result: Pick< NormalizedAnswerContentResult, "title" | "originMetadata" | "projectionKind" | "verificationState" >, ): string { const payload: OriginMetadata = { title: result.title ?? result.originMetadata?.title ?? null, labels: result.originMetadata?.labels, projectionKind: result.projectionKind, truncated: result.originMetadata?.truncated ?? false, verificationState: result.verificationState, verifiedAt: result.originMetadata?.verifiedAt ?? new Date().toISOString(), }; return JSON.stringify(payload); } export interface AnswerContentAttribution { sourceType: SourceType; sourceUri?: string; sourceData?: string; } export function answerContentAttribution( answerContent: | { atUri?: string | null; sourceType?: string | null; originUrl?: string | null; originMetadata?: string | null; } | null | undefined, ): AnswerContentAttribution { if (!answerContent) { return { sourceType: SOURCE_TYPES.ASKIMUT }; } const sourceType = deriveAnswerContentSourceType( answerContent.atUri, answerContent.sourceType, ); let sourceUri: string | undefined; if (answerContent.originUrl) { sourceUri = answerContent.originUrl; } else if (sourceType === SOURCE_TYPES.BLUESKY && answerContent.atUri) { sourceUri = answerContent.atUri; } else if (sourceType === SOURCE_TYPES.STANDARD_SITE && answerContent.atUri) { sourceUri = answerContent.atUri; } return { sourceType, sourceUri, sourceData: answerContent.originMetadata ?? undefined, }; }