@growth-labs/cms 0.8.8 → 0.8.15

package/src/routes/content.ts

@@ -38,6 +38,7 @@ import {
 	parseFrontsDefaultChannelTargets,
 	setFrontsChannelTargets,
 } from '../engine/fronts-publish-intent.js'
+import { classifyGoogleDriveUrl } from '../engine/google-drive-source.js'
 import { evaluateArticleBody } from '../engine/publish-guard.js'
 import {
 	createContent,
@@ -433,7 +434,34 @@ export function normaliseNextcloudShareUrl(value: string): string {
 	return url.toString()
 }
 
-const MediaSourceUrlSchema = z.string().url().transform(normaliseNextcloudShareUrl)
+// A Google Drive link is not run through the Nextcloud rewrite; it is kept as
+// the editor pasted it. The podcast schema accepts a valid Drive file link
+// (the Go plane fetches and measures it itself) and turns any other
+// drive.google.com / docs.google.com URL -- a Doc, a folder, a link with no
+// file id -- into a field-level issue, because stored as a plain https URL it
+// is an HTML page. The video schema refuses every Drive link: the video path
+// ingests over plain https and would fetch the viewer page.
+const PodcastSourceUrlSchema = z
+	.string()
+	.url()
+	.superRefine((value, ctx) => {
+		const link = classifyGoogleDriveUrl(value)
+		if (link.kind === 'drive_invalid') ctx.addIssue({ code: 'custom', message: link.reason })
+	})
+	.transform(normaliseNextcloudShareUrl)
+
+const VIDEO_DRIVE_SOURCE_UNSUPPORTED =
+	'Google Drive links are not yet supported for video; share a direct download link'
+
+const VideoSourceUrlSchema = z
+	.string()
+	.url()
+	.superRefine((value, ctx) => {
+		if (classifyGoogleDriveUrl(value).kind !== 'not_drive') {
+			ctx.addIssue({ code: 'custom', message: VIDEO_DRIVE_SOURCE_UNSUPPORTED })
+		}
+	})
+	.transform(normaliseNextcloudShareUrl)
 
 function buildSchemas(resolved: ReturnType<typeof resolveConfig>) {
 	const category = slugEnum(resolved.primaryCategorySlugs)
@@ -476,7 +504,7 @@ function buildSchemas(resolved: ReturnType<typeof resolveConfig>) {
 				videoId: z.string().min(1),
 				durationSeconds: z.number().int().positive().optional().nullable(),
 				thumbnailImageId: z.string().optional().nullable(),
-				processingSourceUrl: MediaSourceUrlSchema.optional().nullable(),
+				processingSourceUrl: VideoSourceUrlSchema.optional().nullable(),
 				processingSourceKind: z.string().min(1).optional().nullable(),
 			}),
 		}),
@@ -496,7 +524,7 @@ function buildSchemas(resolved: ReturnType<typeof resolveConfig>) {
 				// there because a video always has a slug-derived identity up front.
 				audioR2Key: z.string().default(''),
 				durationSeconds: z.number().int().positive().optional().nullable(),
-				processingSourceUrl: MediaSourceUrlSchema.optional().nullable(),
+				processingSourceUrl: PodcastSourceUrlSchema.optional().nullable(),
 				processingSourceKind: z.string().min(1).optional().nullable(),
 			}),
 		}),
@@ -561,7 +589,7 @@ const VideoContentUpdateSchema = z.object({
 	videoId: z.string().optional(),
 	durationSeconds: z.number().int().positive().optional().nullable(),
 	thumbnailImageId: z.string().optional().nullable(),
-	processingSourceUrl: MediaSourceUrlSchema.optional().nullable(),
+	processingSourceUrl: VideoSourceUrlSchema.optional().nullable(),
 	processingSourceKind: z.string().min(1).optional().nullable(),
 })
 
@@ -569,7 +597,7 @@ const PodcastContentUpdateSchema = z.object({
 	transcript: z.string().optional(),
 	audioR2Key: z.string().optional(),
 	durationSeconds: z.number().int().positive().optional().nullable(),
-	processingSourceUrl: MediaSourceUrlSchema.optional().nullable(),
+	processingSourceUrl: PodcastSourceUrlSchema.optional().nullable(),
 	processingSourceKind: z.string().min(1).optional().nullable(),
 })
 
@@ -990,6 +1018,22 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 			content.durationSeconds = null
 			return null
 		}
+		// A Drive podcast source is fetched and measured by the Go plane, not
+		// probed here: keep the editor's URL as pasted, store no duration and let
+		// the host's probe stay out of it (it would fetch the HTML viewer page).
+		if (type === 'podcast' && classifyGoogleDriveUrl(requestedUrl).kind === 'drive') {
+			content.processingSourceUrl = requestedUrl
+			content.processingSourceKind = 'https'
+			content.durationSeconds = null
+			return {
+				requestedUrl,
+				resolvedUrl: requestedUrl,
+				sourceKind: 'https',
+				durationSeconds: null,
+				ready: true,
+				blockers: [],
+			}
+		}
 		const storedDuration = positiveIntegerDuration(stored?.durationSeconds)
 		if (stored?.sourceUrl === requestedUrl && storedDuration !== null) {
 			content.processingSourceUrl = stored.sourceUrl
@@ -1081,11 +1125,22 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 	}
 
 	function mediaSourceReadinessFromStored(
+		type: ContentType,
 		stored: StoredMediaSource | null,
 	): MediaSourceReadiness | null {
 		if (!stored) return null
 		const sourceUrl = stored.sourceUrl?.trim()
 		if (!sourceUrl) return null
+		if (type === 'podcast' && classifyGoogleDriveUrl(sourceUrl).kind === 'drive') {
+			return {
+				requestedUrl: sourceUrl,
+				resolvedUrl: sourceUrl,
+				sourceKind: 'https',
+				durationSeconds: null,
+				ready: true,
+				blockers: [],
+			}
+		}
 		const durationSeconds = positiveIntegerDuration(stored.durationSeconds)
 		return {
 			requestedUrl: sourceUrl,
@@ -1140,6 +1195,72 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 		}
 	}
 
+	/**
+	 * The video sibling of maybeDispatchPodcastToFoundry: capture a sourced video
+	 * that holds no capture. A row with no trigger token is invisible to the
+	 * producer whatever its state says (trash and restore clears the token and
+	 * leaves `queued`), so only `ready` media and `failed` — the editor's Re-run
+	 * decision — are left alone. An archived item is inactive to the dispatcher;
+	 * it is captured once scheduling has made it active again.
+	 * The editor form captures after a save too, but it de-dupes on local state; a
+	 * later save that reset the capture left the video scheduled and never
+	 * prepared, with nothing to notice (Fronts, 2026-09-15..17).
+	 */
+	async function maybeCaptureVideoSource(
+		ctx: RouteContext,
+		contentId: string,
+	): Promise<DispatchResult | null> {
+		const hook = resolved.hooks.foundryVideo
+		if (!hook) return null
+		const readCapture = () =>
+			ctx.db
+				.prepare(
+					`SELECT vc.processing_source_url, vc.processing_trigger_token, vc.processing_state,
+						vc.hls_ready, ci.status
+					FROM video_content vc JOIN content_items ci ON ci.id = vc.content_id
+					WHERE vc.content_id = ?
+					LIMIT 1`,
+				)
+				.bind(contentId)
+				.first<{
+					processing_source_url: string | null
+					processing_trigger_token: string | null
+					processing_state: string | null
+					hls_ready: number | null
+					status: string
+				}>()
+		const row = await readCapture()
+		if (!row?.processing_source_url?.trim()) return null
+		if (row.processing_trigger_token?.trim()) return null
+		if (row.status === 'archived') return null
+		if (row.hls_ready === 1) return null
+		if (row.processing_state === 'ready' || row.processing_state === 'failed') return null
+		try {
+			return await dispatchToFoundry(ctx.db, contentId, hook, { ifUncaptured: true })
+		} catch (error) {
+			// The editor form fires its own capture after every save. Losing that
+			// race fails this call's compare-and-set, and the capture exists.
+			const raced = await readCapture()
+			if (raced?.processing_trigger_token?.trim()) return null
+			throw error
+		}
+	}
+
+	async function captureScheduledVideoAfterSave(
+		ctx: RouteContext,
+		contentId: string,
+	): Promise<PodcastFoundryAttempt> {
+		try {
+			return { result: await maybeCaptureVideoSource(ctx, contentId), reason: null }
+		} catch (error) {
+			if (error instanceof FoundryDispatchPrerequisiteError) {
+				return { result: null, reason: 'missing_duration' }
+			}
+			console.error('Scheduled video source capture failed after content save', error)
+			return { result: null, reason: 'dispatch_failed' }
+		}
+	}
+
 	function missingDurationResponse(): Response {
 		return json(
 			{
@@ -1422,6 +1543,33 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 				const publishAtSeconds = Math.floor(publishAtMs / 1000)
 				const expectedTargets = new Map<string, ScheduleFrontsChannelTargets | undefined>()
 				for (const id of ids) {
+					// Same gate as the single-item path: no item in a bulk schedule
+					// may take a slot with a body publish will refuse.
+					const bulkGuard = await evaluateContentBodyForPublish(ctx.db, id, 'cms.schedule', {
+						requireBody: false,
+					})
+					if (bulkGuard && !bulkGuard.ok) {
+						return json(
+							{
+								error: 'Article body failed pre-publish validation',
+								source: 'cms.schedule',
+								contentId: id,
+								errors: bulkGuard.errors,
+							},
+							422,
+						)
+					}
+					// And the same capture guarantee: no sourced video in a bulk
+					// schedule may take a slot the producer cannot see.
+					try {
+						await maybeCaptureVideoSource(ctx, id)
+					} catch (error) {
+						if (error instanceof FoundryDispatchPrerequisiteError) {
+							return missingDurationResponse()
+						}
+						console.error('Video source capture failed before bulk schedule', error)
+						return json({ error: 'Foundry dispatch failed', contentId: id }, 502)
+					}
 					const prepared = await prepareScheduleTargets(ctx, id)
 					if ('error' in prepared) return prepared.error
 					expectedTargets.set(id, prepared.targets)
@@ -1433,6 +1581,8 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 					if (targets !== undefined && !changed) {
 						return json({ error: 'schedule_targets_changed', contentId: id, scheduled }, 409)
 					}
+					// Covers an item that was archived above, now active again.
+					await captureScheduledVideoAfterSave(ctx, id)
 					scheduled.push(id)
 				}
 				return json({ scheduled })
@@ -1569,7 +1719,10 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 				: content
 			const mediaSourceReadiness =
 				item.type === 'video' || item.type === 'podcast'
-					? mediaSourceReadinessFromStored(await loadStoredMediaSource(ctx.db, id, item.type))
+					? mediaSourceReadinessFromStored(
+							item.type,
+							await loadStoredMediaSource(ctx.db, id, item.type),
+						)
 					: null
 
 			const aiLockedFields: string[] = (() => {
@@ -1738,6 +1891,12 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 				existing.type === 'podcast'
 					? await dispatchPodcastAfterSave(ctx, id)
 					: { result: null, reason: null }
+			// A scheduled video is committed to a slot: a save that reset its capture
+			// must not leave it unprepared until someone notices the missed publish.
+			const videoAttempt: PodcastFoundryAttempt =
+				existing.type === 'video' && existing.status === 'scheduled'
+					? await captureScheduledVideoAfterSave(ctx, id)
+					: { result: null, reason: null }
 
 			// If the slug changed, record the old slug as a redirect (spec §8)
 			// and drop any stale redirect row for the now-live slug — atomically,
@@ -1752,6 +1911,8 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 				podcastFoundryQueued: Boolean(podcastAttempt.result),
 				podcastFoundryCorrelationId: podcastAttempt.result?.correlationId ?? null,
 				podcastFoundryReason: podcastAttempt.reason,
+				videoFoundryQueued: Boolean(videoAttempt.result && !videoAttempt.result.skipped),
+				videoFoundryReason: videoAttempt.reason,
 				...(mediaSourceReadiness ? { mediaSourceReadiness } : {}),
 				// Present and empty when the body linted clean, so a client can
 				// distinguish "no warnings" from "this build does not report them".
@@ -1808,6 +1969,41 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 					return json({ error: 'Missing publish time' }, 400)
 				}
 
+				// A body the publish guard will refuse must not be allowed to take a
+				// slot. Scheduling was the one write in this lane that never ran
+				// the guard, so a defect an editor could not see at save time
+				// surfaced only when foundryd tried to publish — at 16:30 on a
+				// Monday, as a missed premium article (2026-09-15).
+				const scheduleGuard = await evaluateContentBodyForPublish(ctx.db, id, 'cms.schedule', {
+					// Claiming a slot before the piece is written stays allowed;
+					// claiming one with an already-broken body does not.
+					requireBody: false,
+				})
+				if (scheduleGuard && !scheduleGuard.ok) {
+					return json(
+						{
+							error: 'Article body failed pre-publish validation',
+							source: 'cms.schedule',
+							errors: scheduleGuard.errors,
+						},
+						422,
+					)
+				}
+				// A sourced video that holds no capture is invisible to the producer:
+				// it would take the slot and never publish. Capture it here, and refuse
+				// the slot if that cannot be done. A video with no source yet may still
+				// claim a slot early.
+				if (existing.type === 'video') {
+					try {
+						await maybeCaptureVideoSource(ctx, id)
+					} catch (error) {
+						if (error instanceof FoundryDispatchPrerequisiteError) {
+							return missingDurationResponse()
+						}
+						console.error('Video source capture failed before schedule', error)
+						return json({ error: 'Foundry dispatch failed' }, 502)
+					}
+				}
 				const prepared = await prepareScheduleTargets(ctx, id)
 				if ('error' in prepared) return prepared.error
 				const changed = await scheduleContent(
@@ -1820,6 +2016,8 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 				if (prepared.targets !== undefined && !changed) {
 					return json({ error: 'schedule_targets_changed', contentId: id }, 409)
 				}
+				// Covers an item that was archived above, now active again.
+				if (existing.type === 'video') await captureScheduledVideoAfterSave(ctx, id)
 
 				// Fire content.scheduled webhook.
 				await fireWebhook(ctx, 'content.scheduled', {
@@ -1835,6 +2033,10 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 			if (action === 'publish') {
 				const now = Math.floor(Date.now() / 1000)
 				const wasDraft = existing.status === 'draft'
+				const publishedAt =
+					existing.status === 'published' && existing.published_at !== null
+						? existing.published_at
+						: now
 				let podcastDispatch: DispatchResult | null = null
 				if (existing.type === 'podcast') {
 					try {
@@ -1929,7 +2131,7 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 					throw error
 				}
 				try {
-					await publishContent(ctx.db, id, now)
+					await publishContent(ctx.db, id, publishedAt, now)
 					await createRevision(ctx.db, id, ctx.userId || null)
 				} catch (error) {
 					if (error instanceof TagInputError) return tagInputErrorResponse(error)

package/src/ui/editor/ContentForm.tsx

@@ -485,7 +485,7 @@ export function ContentForm({
 						setForm((prev) => ({
 							...prev,
 							saving: false,
-							saveError: err.error ?? 'Save failed',
+							saveError: apiErrorMessage(err, 'Save failed'),
 						}))
 						return
 					}
@@ -1540,6 +1540,10 @@ function AudioBlock({
 				transcodes it, and hydrates the Audio R2 Key and duration automatically. Skip this once the
 				audio file is uploaded below.
 			</div>
+			<div style={assetHelp}>
+				A Google Drive share link to the audio file works too, if the file is shared with the Fronts
+				Google account or with anyone who has the link. Google Docs and folders are not audio files.
+			</div>
 
 			<div
 				style={{

package/src/ui/editor/editor-media-upload.ts

@@ -1,3 +1,4 @@
+import { apiErrorMessage } from '../api-error.js'
 import { slugifyTitle } from './content-payload.js'
 
 type FetchLike = (url: string, init?: RequestInit) => Promise<Response>
@@ -17,7 +18,7 @@ export async function uploadEditorImage(
 	})
 	if (!res.ok) {
 		const err = (await res.json().catch(() => ({ error: res.statusText }))) as { error?: string }
-		throw new Error(err.error ?? 'Image upload failed')
+		throw new Error(apiErrorMessage(err, 'Image upload failed'))
 	}
 	const body = (await res.json()) as { url?: string; publicUrl?: string }
 	const url = body.url || body.publicUrl

package/src/ui/inspector/PublishTab.tsx

@@ -12,6 +12,7 @@
 
 import { useCallback, useEffect, useState } from 'react'
 import type { ContentStatus } from '../../schema/types.js'
+import { apiErrorMessage } from '../api-error.js'
 import { Icon } from '../icons.js'
 import { Field } from './Field.js'
 import {
@@ -246,7 +247,7 @@ export function PublishTab({
 				const err = (await res.json().catch(() => ({ error: res.statusText }))) as {
 					error?: string
 				}
-				throw new Error(err.error ?? 'Could not add author')
+				throw new Error(apiErrorMessage(err, 'Could not add author'))
 			}
 			const created = (await res.json()) as CreatedAuthorResponse
 			const nextAuthor = { id: created.id, name }

package/src/ui/screens/LibraryScreen.tsx

@@ -12,6 +12,7 @@
 
 import { useCallback, useEffect, useReducer, useRef, useState } from 'react'
 import type { ContentStatus, ContentType, FrontsPublishStatus } from '../../schema/types.js'
+import { apiErrorMessage } from '../api-error.js'
 import { buildSharePrefill, ShareModal } from '../components/ShareModal.js'
 import { Icon } from '../icons.js'
 import { useWorkspace } from '../workspace-context.js'
@@ -1139,7 +1140,7 @@ function BulkBar({
 				const err = (await res.json().catch(() => ({ error: res.statusText }))) as {
 					error?: string
 				}
-				alert(`Bulk ${op} failed: ${err.error ?? res.statusText}`)
+				alert(`Bulk ${op} failed: ${apiErrorMessage(err, res.statusText)}`)
 				setBusy(false)
 				return
 			}
@@ -1241,7 +1242,7 @@ function ImportModal({
 				const err = (await res.json().catch(() => ({ error: res.statusText }))) as {
 					error?: string
 				}
-				setError(err.error ?? 'Parse failed')
+				setError(apiErrorMessage(err, 'Parse failed'))
 				return
 			}
 			const data = (await res.json()) as ParseResult
@@ -1266,7 +1267,7 @@ function ImportModal({
 				const err = (await res.json().catch(() => ({ error: res.statusText }))) as {
 					error?: string
 				}
-				setError(err.error ?? 'Confirm failed')
+				setError(apiErrorMessage(err, 'Confirm failed'))
 				setStep('preview')
 				return
 			}

package/src/ui/screens/SettingsScreen.tsx

@@ -24,6 +24,7 @@
 import { useCallback, useEffect, useReducer, useState } from 'react'
 import type { ApiKeyListEntry } from '../../engine/api-keys.js'
 import { WEBHOOK_EVENTS, type WebhookRecord } from '../../engine/webhooks.js'
+import { apiErrorMessage } from '../api-error.js'
 import { Icon } from '../icons.js'
 import { useWorkspace } from '../workspace-context.js'
 import {
@@ -552,7 +553,7 @@ function TeamSettings({ currentSubject }: { currentSubject: string | null }) {
 			const res = await fetch('/admin/api/settings/members')
 			if (!res.ok) {
 				const body = (await res.json().catch(() => ({}))) as { error?: string }
-				dispatch({ type: 'fetch-error', error: body.error ?? `HTTP ${res.status}` })
+				dispatch({ type: 'fetch-error', error: apiErrorMessage(body, `HTTP ${res.status}`) })
 				return
 			}
 			const body = (await res.json()) as {
@@ -600,7 +601,7 @@ function TeamSettings({ currentSubject }: { currentSubject: string | null }) {
 			})
 			if (!res.ok) {
 				const body = (await res.json().catch(() => ({}))) as { error?: string; reason?: string }
-				alert(body.reason ?? body.error ?? `Failed to change role (HTTP ${res.status})`)
+				alert(body.reason ?? apiErrorMessage(body, `Failed to change role (HTTP ${res.status})`))
 				return
 			}
 			dispatch({ type: 'update-role', userId, role: newRole })
@@ -629,7 +630,7 @@ function TeamSettings({ currentSubject }: { currentSubject: string | null }) {
 				error?: string
 			}
 			if (!res.ok) {
-				setInviteError(body.error ?? `HTTP ${res.status}`)
+				setInviteError(apiErrorMessage(body, `HTTP ${res.status}`))
 				return
 			}
 			setInviteSuccess(
@@ -905,7 +906,7 @@ function ApiSettings() {
 			const res = await fetch('/admin/api/settings/api-keys')
 			if (!res.ok) {
 				const body = (await res.json().catch(() => ({}))) as { error?: string }
-				dispatch({ type: 'fetch-error', error: body.error ?? `HTTP ${res.status}` })
+				dispatch({ type: 'fetch-error', error: apiErrorMessage(body, `HTTP ${res.status}`) })
 				return
 			}
 			const body = (await res.json()) as { apiKeys: ApiKeyListEntry[] }
@@ -937,7 +938,7 @@ function ApiSettings() {
 				error?: string
 			}
 			if (!res.ok) {
-				setCreateError(body.error ?? `HTTP ${res.status}`)
+				setCreateError(apiErrorMessage(body, `HTTP ${res.status}`))
 				return
 			}
 			// Show the one-time reveal modal
@@ -965,7 +966,7 @@ function ApiSettings() {
 				dispatch({ type: 'revoked', id })
 			} else {
 				const body = (await res.json().catch(() => ({}))) as { error?: string }
-				alert(body.error ?? `Failed to revoke (HTTP ${res.status})`)
+				alert(apiErrorMessage(body, `Failed to revoke (HTTP ${res.status})`))
 			}
 		} catch (err) {
 			alert(String(err))
@@ -1158,7 +1159,7 @@ function WebhooksSettings() {
 			const res = await fetch('/admin/api/settings/webhooks')
 			if (!res.ok) {
 				const body = (await res.json().catch(() => ({}))) as { error?: string }
-				dispatch({ type: 'fetch-error', error: body.error ?? `HTTP ${res.status}` })
+				dispatch({ type: 'fetch-error', error: apiErrorMessage(body, `HTTP ${res.status}`) })
 				return
 			}
 			const body = (await res.json()) as { webhooks: WebhookRecord[] }
@@ -1185,7 +1186,7 @@ function WebhooksSettings() {
 			})
 			const body = (await res.json().catch(() => ({}))) as { error?: string }
 			if (!res.ok) {
-				setCreateError(body.error ?? `HTTP ${res.status}`)
+				setCreateError(apiErrorMessage(body, `HTTP ${res.status}`))
 				return
 			}
 			setNewUrl('')
@@ -1206,7 +1207,7 @@ function WebhooksSettings() {
 			})
 			const body = (await res.json().catch(() => ({}))) as { error?: string }
 			if (!res.ok) {
-				alert(body.error ?? `Test failed (HTTP ${res.status})`)
+				alert(apiErrorMessage(body, `Test failed (HTTP ${res.status})`))
 				return
 			}
 			dispatch({ type: 'update-status', id, status: 'test' })
@@ -1228,7 +1229,7 @@ function WebhooksSettings() {
 				dispatch({ type: 'deleted', id })
 			} else {
 				const body = (await res.json().catch(() => ({}))) as { error?: string }
-				alert(body.error ?? `Failed to delete (HTTP ${res.status})`)
+				alert(apiErrorMessage(body, `Failed to delete (HTTP ${res.status})`))
 			}
 		} catch (err) {
 			alert(String(err))
@@ -1481,7 +1482,7 @@ function IntegrationsSettings() {
 			.then(async (res) => {
 				if (!res.ok) {
 					const body = (await res.json().catch(() => ({}))) as { error?: string }
-					setError(body.error ?? `HTTP ${res.status}`)
+					setError(apiErrorMessage(body, `HTTP ${res.status}`))
 					return
 				}
 				const body = (await res.json()) as IntegrationsData
@@ -1600,7 +1601,7 @@ function DomainsSettings() {
 			.then(async (res) => {
 				if (!res.ok) {
 					const body = (await res.json().catch(() => ({}))) as { error?: string }
-					setError(body.error ?? `HTTP ${res.status}`)
+					setError(apiErrorMessage(body, `HTTP ${res.status}`))
 					return
 				}
 				const body = (await res.json()) as DomainsData
@@ -1728,7 +1729,7 @@ export function SettingsScreen() {
 			})
 			if (!res.ok) {
 				const body = (await res.json().catch(() => ({}))) as { error?: string }
-				alert(body.error ?? `Failed to save settings (HTTP ${res.status})`)
+				alert(apiErrorMessage(body, `Failed to save settings (HTTP ${res.status})`))
 				return
 			}
 			// Re-fetch to ensure the UI is in sync with server state

package/src/ui/screens/TopicsScreen.tsx

@@ -30,6 +30,7 @@
 // confirm dialog. NO classes outside the broadsheet vocabulary.
 
 import { useCallback, useEffect, useReducer, useState } from 'react'
+import { apiErrorMessage } from '../api-error.js'
 import { Icon } from '../icons.js'
 import {
 	buildTopicCreateBody,
@@ -191,7 +192,7 @@ export function TopicsScreen() {
 				error?: string
 			}
 			if (!res.ok || !body.topic) {
-				setCreateError(body.error || `${res.status} ${res.statusText}`)
+				setCreateError(apiErrorMessage(body, `${res.status} ${res.statusText}`))
 				return
 			}
 			dispatchTopics({ type: 'create-ok', topic: body.topic })
@@ -219,7 +220,7 @@ export function TopicsScreen() {
 				error?: string
 			}
 			if (!res.ok || !body.topic) {
-				setRenameError(body.error || `${res.status} ${res.statusText}`)
+				setRenameError(apiErrorMessage(body, `${res.status} ${res.statusText}`))
 				return
 			}
 			dispatchTopics({ type: 'rename-ok', fromSlug: pendingRename.slug, topic: body.topic })

package/src/ui/screens/author-recovery.ts

@@ -1,3 +1,5 @@
+import { apiErrorMessage } from '../api-error.js'
+
 interface AuthorWriteFailureBody {
 	error?: string
 	errorClass?: string
@@ -17,7 +19,7 @@ export function formatAuthorWriteFailure(
 		body.author?.id ? `author id: ${body.author.id}` : '',
 		body.author?.slug ? `slug: ${body.author.slug}` : '',
 	].filter(Boolean)
-	const message = body.error || 'Author synchronization failed'
+	const message = apiErrorMessage(body, 'Author synchronization failed')
 	const classifiedMessage = message.includes(body.errorClass)
 		? message
 		: `${body.errorClass}: ${message}`