@growth-labs/cms 0.5.4 → 0.5.5

package/src/ui/screens/social-share-data.ts

@@ -22,6 +22,13 @@ export const SHARE_MODES = ['author-social', 'owned-social', 'youtube', 'newslet
 
 export type ShareMode = (typeof SHARE_MODES)[number]
 
+export function requiresCanonicalAuthorRoster(
+	mode: ShareMode,
+	allowInlineAuthorCreation: boolean,
+): boolean {
+	return mode === 'author-social' && !allowInlineAuthorCreation
+}
+
 /**
  * Social platform options.
  * SOURCE OF TRUTH: @growth-labs/analytics src/utils/social.ts SOCIAL_PLATFORMS
@@ -91,6 +98,75 @@ export interface AuthorRef {
 	create?: boolean
 }
 
+export interface CanonicalAuthorEntry {
+	id: string
+	slug: string
+	displayName: string
+}
+
+export type CanonicalAuthorRosterStatus =
+	| { blocked: false; kind: 'not-required' | 'synchronized'; message: null }
+	| {
+			blocked: true
+			kind: 'loading' | 'missing-author' | 'out-of-sync' | 'unavailable'
+			message: string
+	  }
+
+export function canonicalAuthorRosterStatus({
+	enabled,
+	author,
+	authors,
+	loading,
+	error,
+}: {
+	enabled: boolean
+	author: AuthorRef
+	authors: CanonicalAuthorEntry[]
+	loading: boolean
+	error: string | null
+}): CanonicalAuthorRosterStatus {
+	if (!enabled) return { blocked: false, kind: 'not-required', message: null }
+
+	const id = author.id?.trim() ?? ''
+	const slug = author.slug?.trim().toLowerCase() ?? ''
+	const identity = id || slug
+	if (!identity) {
+		return {
+			blocked: true,
+			kind: 'missing-author',
+			message:
+				'No canonical author is linked to this content. Add or publish the author in the Authors screen, then retry.',
+		}
+	}
+	if (loading) {
+		return {
+			blocked: true,
+			kind: 'loading',
+			message: `Checking the synchronized author roster for canonical author ${identity}.`,
+		}
+	}
+	if (error) {
+		return {
+			blocked: true,
+			kind: 'unavailable',
+			message: `The author roster could not be verified for canonical author ${identity}. Refresh and retry; sharing is blocked until synchronization can be proven.`,
+		}
+	}
+
+	const synchronized =
+		id !== ''
+			? authors.some((candidate) => candidate.id === id)
+			: authors.some((candidate) => candidate.slug.trim().toLowerCase() === slug)
+	if (!synchronized) {
+		return {
+			blocked: true,
+			kind: 'out-of-sync',
+			message: `Author roster out of sync for canonical author ${identity}. Publish or synchronize that author in the Authors screen, refresh, and retry.`,
+		}
+	}
+	return { blocked: false, kind: 'synchronized', message: null }
+}
+
 /** A reference to a social handle — existing by id/username or inline-created. */
 export interface HandleRef {
 	id?: string
@@ -175,9 +251,7 @@ export interface ShareFormPrefill {
  */
 export function initShareForm(mode: ShareMode, prefill?: ShareFormPrefill): ShareFormState {
 	const defaultCampaign =
-		mode === 'author-social' || mode === 'owned-social'
-			? prefill?.campaign?.trim() || prefill?.contentSlug?.trim() || ''
-			: ''
+		mode === 'owned-social' ? prefill?.campaign?.trim() || prefill?.contentSlug?.trim() || '' : ''
 	const base: ShareFormState = {
 		mode,
 		destinationUrl: prefill?.destinationUrl ?? '',
@@ -281,7 +355,12 @@ export function shareFormReducer(state: ShareFormState, action: ShareFormAction)
 				mode,
 				// Mode-specific resets
 				platform: mode === 'youtube' ? 'youtube' : mode === 'newsletter' ? '' : '',
-				campaign: mode === 'youtube' || mode === 'newsletter' ? '' : state.campaign,
+				campaign:
+					mode === 'owned-social'
+						? state.campaign || state.contentSlug
+						: mode === 'author-social'
+							? ''
+							: '',
 				placements: mode === 'youtube' ? [...YOUTUBE_BUNDLE_PLACEMENTS] : [],
 				youtubeVideoId: mode === 'youtube' ? state.youtubeVideoId : '',
 				issue: mode === 'newsletter' ? state.issue : '',
@@ -289,15 +368,14 @@ export function shareFormReducer(state: ShareFormState, action: ShareFormAction)
 		}
 
 		case 'prefill-content': {
-			const shouldDefaultCampaign =
-				(state.mode === 'author-social' || state.mode === 'owned-social') && !state.campaign.trim()
+			const shouldDefaultCampaign = state.mode === 'owned-social' && !state.campaign.trim()
 			return {
 				...state,
 				destinationUrl: action.destinationUrl,
 				contentSlug: action.contentSlug,
 				contentType: action.contentType,
 				campaign: shouldDefaultCampaign ? action.contentSlug : state.campaign,
-				...(action.author ? { author: action.author } : {}),
+				author: action.author ?? {},
 			}
 		}
 
@@ -349,7 +427,6 @@ export interface AuthorSocialBatchPayload {
 	kind: 'author-social'
 	destinationUrl: string
 	platform: string
-	campaign: string
 	placement?: string
 	boostMode?: string
 	promoCode?: string
@@ -462,14 +539,16 @@ export function buildBatchPayloadFrom(state: ShareFormState): BuildPayloadResult
 
 	switch (state.mode) {
 		case 'author-social': {
-			if (!state.campaign.trim()) {
-				return { ok: false, error: 'Campaign is required for author-social.' }
+			if (!refHasContent(state.author)) {
+				return {
+					ok: false,
+					error: 'A canonical author is required for Author Social. Select a synchronized author.',
+				}
 			}
 			const payload: AuthorSocialBatchPayload = {
 				kind: 'author-social',
 				...shared,
 				platform: state.platform,
-				campaign: state.campaign.trim(),
 				...(state.placement && state.placement !== 'unknown' ? { placement: state.placement } : {}),
 				...(state.boostMode && state.boostMode !== 'none' ? { boostMode: state.boostMode } : {}),
 				...(nonEmpty(state.promoCode) ? { promoCode: state.promoCode } : {}),
@@ -701,7 +780,7 @@ export function toPlainText(output: ShareOutput): string {
  * given mode. The React form renders only these inputs; the request builders
  * read only these fields.
  *
- * 'author-social' → campaign, platform, author, destinationUrl, advanced
+ * 'author-social' → platform, author, destinationUrl, advanced
  * 'owned-social'  → campaign, platform, handle, (optional author), destinationUrl, advanced
  * 'youtube'       → youtubeVideoId, placements, (optional handle/author), destinationUrl (NO campaign)
  * 'newsletter'    → issue, (optional author/handle), destinationUrl (NO campaign/platform/boostMode)
@@ -711,7 +790,7 @@ export function relevantFields(mode: ShareMode): string[] {
 
 	switch (mode) {
 		case 'author-social':
-			return [...shared, 'campaign', 'platform', 'author', 'placement', 'boostMode', 'promoCode']
+			return [...shared, 'platform', 'author', 'placement', 'boostMode', 'promoCode']
 
 		case 'owned-social':
 			return [