@growth-labs/cms 0.6.7 → 0.6.8

package/src/integration/options.ts

@@ -13,6 +13,28 @@ const primaryCategorySchema = z.object({
 	label: z.string().min(1),
 })
 
+const contentTypeSchema = z.enum(['article', 'video', 'podcast', 'newsletter', 'page'])
+
+const primaryTopicControlSchema = z
+	.object({
+		label: z.string().trim().min(1).max(100),
+		contentTypes: z.array(contentTypeSchema).min(1),
+		options: z.array(primaryCategorySchema).min(1),
+	})
+	.strict()
+	.superRefine((control, ctx) => {
+		const slugs = control.options.map(({ slug }) => slug)
+		if (new Set(slugs).size !== slugs.length) {
+			ctx.addIssue({
+				code: 'custom',
+				path: ['options'],
+				message: 'primary topic option slugs must be unique',
+			})
+		}
+	})
+
+export type PrimaryTopicControl = z.output<typeof primaryTopicControlSchema>
+
 const contentMetadataKeySchema = z
 	.string()
 	.regex(/^[a-z][a-z0-9_]{0,63}$/, 'metadata keys must be lowercase snake_case')
@@ -106,6 +128,7 @@ export const cmsIntegrationOptionsSchema = z
 	.object({
 		workspaces: z.array(workspaceSchema).min(1, 'at least one workspace is required'),
 		primaryCategories: z.array(primaryCategorySchema).default([]),
+		primaryTopic: primaryTopicControlSchema.optional(),
 		contentMetadataSelects: contentMetadataSelectsSchema,
 		activeWorkspaceId: z.string().optional(),
 		adminBasePath: z.string().default('/admin'),

package/src/routes/config.ts

@@ -6,6 +6,7 @@
 import type { OgImageRenderer } from '../engine/og-render.js'
 import { nullProviders } from '../providers/null.js'
 import type { CmsProviders, FoundryDispatch, LlmDispatch } from '../providers/types.js'
+import type { ContentType } from '../schema/types.js'
 import type { Authz } from './context.js'
 
 /**
@@ -35,6 +36,8 @@ export interface CmsRouteConfig {
 	primaryTopicSlugs?: readonly [string, ...string[]]
 	/** Default primary topic for create (Fronts: 'global'). */
 	defaultPrimaryTopic?: string
+	/** Content types for which `primaryTopic` is required on create. */
+	requiredPrimaryTopicContentTypes?: readonly ContentType[]
 
 	/** R2 binding name recorded on media rows. Fronts default: 'PUBLIC_MEDIA'. */
 	mediaR2Binding?: string
@@ -66,6 +69,7 @@ export interface ResolvedCmsRouteConfig {
 	defaultPrimaryCategory: string
 	primaryTopicSlugs: readonly string[] | null
 	defaultPrimaryTopic: string
+	requiredPrimaryTopicContentTypes: readonly ContentType[]
 	mediaR2Binding: string
 	mediaSiteId: string
 	mediaPublicDomain: string
@@ -88,6 +92,7 @@ export function resolveConfig(config: CmsRouteConfig): ResolvedCmsRouteConfig {
 		defaultPrimaryCategory: config.defaultPrimaryCategory ?? 'analysis',
 		primaryTopicSlugs: config.primaryTopicSlugs ?? null,
 		defaultPrimaryTopic: config.defaultPrimaryTopic ?? 'global',
+		requiredPrimaryTopicContentTypes: config.requiredPrimaryTopicContentTypes ?? [],
 		mediaR2Binding: config.mediaR2Binding ?? 'PUBLIC_MEDIA',
 		mediaSiteId: config.mediaSiteId ?? 'fronts',
 		mediaPublicDomain: config.mediaPublicDomain ?? 'media.fronts.co',

package/src/routes/content.ts

@@ -392,13 +392,16 @@ function buildSchemas(resolved: ReturnType<typeof resolveConfig>) {
 		tags: z.array(z.string()).optional(),
 		metadata: ContentMetadataSchema.optional(),
 	})
+	const requiredTopicTypes = new Set(resolved.requiredPrimaryTopicContentTypes)
+	const baseSchemaFor = (type: ContentType) =>
+		requiredTopicTypes.has(type) ? BaseSchema.extend({ primaryTopic: topic }) : BaseSchema
 
 	const CreateSchema = z.discriminatedUnion('type', [
-		BaseSchema.extend({
+		baseSchemaFor('article').extend({
 			type: z.literal('article'),
 			content: BodyContentCreateSchema,
 		}),
-		BaseSchema.extend({
+		baseSchemaFor('video').extend({
 			type: z.literal('video'),
 			content: z.object({
 				script: z.string().default(''),
@@ -409,7 +412,7 @@ function buildSchemas(resolved: ReturnType<typeof resolveConfig>) {
 				processingSourceKind: z.string().min(1).optional().nullable(),
 			}),
 		}),
-		BaseSchema.extend({
+		baseSchemaFor('podcast').extend({
 			type: z.literal('podcast'),
 			content: z.object({
 				// Empty allowed: a podcast is created as a draft with audio uploaded
@@ -429,11 +432,11 @@ function buildSchemas(resolved: ReturnType<typeof resolveConfig>) {
 				processingSourceKind: z.string().min(1).optional().nullable(),
 			}),
 		}),
-		BaseSchema.extend({
+		baseSchemaFor('newsletter').extend({
 			type: z.literal('newsletter'),
 			content: BodyContentCreateSchema,
 		}),
-		BaseSchema.extend({
+		baseSchemaFor('page').extend({
 			type: z.literal('page'),
 			content: BodyContentCreateSchema,
 		}),

package/src/ui/api/_content-config.ts

@@ -1,6 +1,7 @@
 // src/ui/api/_content-config.ts — shared helpers for content + tag Astro endpoint adapters.
 // Builds a RouteContext and a ContentRouteConfig from an APIContext at request time.
 
+import { config } from 'virtual:growth-labs/cms/config'
 import type { APIContext } from 'astro'
 import type {
 	ContentRouteConfig,
@@ -62,8 +63,16 @@ export function toContentCtx(c: APIContext, params?: Record<string, string>): Ro
 export function toContentConfig(c: APIContext): ContentRouteConfig {
 	const locals = c.locals as { cmsHooks?: CmsHooksLocals }
 	const hooks = locals.cmsHooks ?? {}
+	const primaryTopicSlugs = config.primaryTopic?.options.map(
+		(option: { slug: string }) => option.slug,
+	)
 	return {
 		authz: buildSiteAuthz(c),
+		primaryTopicSlugs:
+			primaryTopicSlugs && primaryTopicSlugs.length > 0
+				? (primaryTopicSlugs as [string, ...string[]])
+				: undefined,
+		requiredPrimaryTopicContentTypes: config.primaryTopic?.contentTypes,
 		activeWorkspaceId: hooks.activeWorkspaceId,
 		hooks: {
 			llm: hooks.llm,

package/src/ui/client/mount.tsx

@@ -39,6 +39,7 @@ export async function mount(elementId = 'masthead-root') {
 	const screens = createCmsScreens({
 		allowInlineAuthorCreation: config.socialSharing.allowInlineAuthorCreation,
 		primaryCategories: config.primaryCategories,
+		primaryTopic: config.primaryTopic,
 		contentMetadataSelects: config.contentMetadataSelects,
 		surveyId: config.surveyResults?.surveyId,
 	})

package/src/ui/editor/ContentForm.tsx

@@ -21,7 +21,7 @@
 import { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react'
 import { type ContentMetadata, parseContentMetadata } from '../../engine/content-metadata.js'
 import { countWords, estimateReadTime } from '../../engine/publisher.js'
-import type { ContentMetadataSelectField } from '../../integration/options.js'
+import type { ContentMetadataSelectField, PrimaryTopicControl } from '../../integration/options.js'
 import type { ContentStatus, ContentType, FrontsPublishStatus } from '../../schema/types.js'
 import { Icon } from '../icons.js'
 import { uploadMediaAsset } from '../screens/media-upload.js'
@@ -76,6 +76,7 @@ export interface ContentFormProps {
 	/** Called when save state changes so editor chrome can show a real save action. */
 	onSaveStateChange?: (state: ContentSaveState) => void
 	primaryCategories?: Array<{ slug: string; label: string }>
+	primaryTopic?: PrimaryTopicControl
 	contentMetadataSelects?: ContentMetadataSelectField[]
 }
 
@@ -117,6 +118,7 @@ interface ExistingContentItem {
 	author_name?: string | null
 	author_slug?: string | null
 	channel?: string | null
+	primary_topic?: string | null
 	published_at?: number | null
 	hero_image_id?: string | null
 	hero_image_url?: string | null
@@ -165,6 +167,7 @@ interface FormState {
 	publishedAt: string | null
 	premium: boolean
 	channel: string | null
+	primaryTopic: string | null | undefined
 	metadata: ContentMetadata
 	heroImageId: string
 	heroImageUrl: string | null
@@ -224,6 +227,7 @@ function createEmptyFormState(docId: string | null, metadata: ContentMetadata =
 		publishedAt: null,
 		premium: false,
 		channel: null,
+		primaryTopic: undefined,
 		metadata,
 		heroImageId: '',
 		heroImageUrl: null,
@@ -270,8 +274,10 @@ export function ContentForm({
 	onFrontsPublishStatusChange,
 	onSaveStateChange,
 	primaryCategories = [],
+	primaryTopic,
 	contentMetadataSelects = EMPTY_CONTENT_METADATA_SELECTS,
 }: ContentFormProps) {
+	const primaryTopicEnabled = primaryTopic?.contentTypes.includes(contentType) ?? false
 	const metadataFields = useMemo(
 		() => contentMetadataSelects.filter((field) => field.contentTypes.includes(contentType)),
 		[contentMetadataSelects, contentType],
@@ -314,6 +320,7 @@ export function ContentForm({
 			}
 			const data = (await res.json()) as ExistingContentResponse
 			const next = contentResponseToFormState(data, contentType, docId)
+			if (!primaryTopicEnabled) next.primaryTopic = undefined
 			setForm((prev) => ({
 				...next,
 				aiOpen: prev.aiOpen,
@@ -334,6 +341,7 @@ export function ContentForm({
 		metadataFields,
 		onStatusChange,
 		onFrontsPublishStatusChange,
+		primaryTopicEnabled,
 		publishDraft,
 	])
 
@@ -402,7 +410,11 @@ export function ContentForm({
 			const draft: ContentDraftFields = currentForm
 
 			if (id === null) {
-				if (!canCreateContentDraft(contentType, draft)) {
+				if (
+					!canCreateContentDraft(contentType, draft, {
+						requirePrimaryTopic: primaryTopicEnabled,
+					})
+				) {
 					const mediaSource = foundryDispatchSourceForDraft(contentType, draft)
 					const missingMediaDuration =
 						mediaSource && normalizeMediaDurationSeconds(draft.durationSeconds) === null
@@ -537,7 +549,7 @@ export function ContentForm({
 				}
 			}
 		},
-		[contentType, onDocCreated, queueFoundryProcessing],
+		[contentType, onDocCreated, primaryTopicEnabled, queueFoundryProcessing],
 	)
 
 	useEffect(() => {
@@ -603,6 +615,13 @@ export function ContentForm({
 		scheduleAutosave(next)
 	}
 
+	function handlePrimaryTopicChange(value: string) {
+		const next = { ...latestForm.current, primaryTopic: value || null }
+		setForm(next)
+		publishDraft(next)
+		scheduleAutosave(next)
+	}
+
 	function handleMetadataSelectChange(field: ContentMetadataSelectField, value: string) {
 		const next = {
 			...latestForm.current,
@@ -999,6 +1018,28 @@ export function ContentForm({
 				</div>
 			)}
 
+			{primaryTopicEnabled && primaryTopic && (
+				<div style={fieldGroup}>
+					<label style={{ display: 'grid', gap: 6, fontSize: 12, color: 'var(--ink-muted)' }}>
+						{primaryTopic.label}
+						<select
+							value={form.primaryTopic ?? ''}
+							onChange={(event) => handlePrimaryTopicChange(event.currentTarget.value)}
+							aria-label={primaryTopic.label}
+							required
+							style={urlInput}
+						>
+							<option value="">Select {primaryTopic.label.toLowerCase()}…</option>
+							{primaryTopic.options.map((option) => (
+								<option key={option.slug} value={option.slug}>
+									{option.label}
+								</option>
+							))}
+						</select>
+					</label>
+				</div>
+			)}
+
 			{metadataFields.map((field) => {
 				const storedValue = form.metadata[field.key]
 				const value = typeof storedValue === 'string' ? storedValue : ''
@@ -1645,6 +1686,7 @@ function contentResponseToFormState(
 	next.publishedAt = unixSecondsToIso(item.published_at)
 	next.premium = item.visibility === 'premium'
 	next.channel = toNullableString(item.channel)
+	next.primaryTopic = toNullableString(item.primary_topic)
 	next.metadata = storedContentMetadata(item.metadata_json)
 	next.heroImageId = heroImageId
 	next.heroImageUrl = heroImageUrl || (heroImageId ? mediaUrlFromId(heroImageId) : null)

package/src/ui/editor/content-payload.ts

@@ -21,6 +21,7 @@ export interface ContentDraftFields {
 	podcastSourceKind?: string | null
 	durationSeconds: number | null
 	channel?: string | null
+	primaryTopic?: string | null
 	metadata?: ContentMetadata
 }
 
@@ -116,8 +117,10 @@ export function slugifyTitle(title: string): string {
 export function canCreateContentDraft(
 	contentType: ContentType,
 	draft: ContentDraftFields,
+	requirements: { requirePrimaryTopic?: boolean } = {},
 ): boolean {
 	if (draft.title.trim().length < 3) return false
+	if (requirements.requirePrimaryTopic && !draft.primaryTopic?.trim()) return false
 	if (contentType === 'article' || contentType === 'newsletter' || contentType === 'page') {
 		return draft.body.trim().length > 0
 	}
@@ -181,6 +184,10 @@ export function buildContentUpdatePayload(
 	if (draft.metadata !== undefined) payload.metadata = draft.metadata
 	const channel = draft.channel?.trim()
 	payload.primaryCategory = channel || null
+	if (draft.primaryTopic !== undefined) {
+		const primaryTopic = draft.primaryTopic?.trim()
+		payload.primaryTopic = primaryTopic || null
+	}
 	const heroImageId = draft.heroImageId?.trim()
 	if (heroImageId) {
 		payload.heroImageId = heroImageId
@@ -249,5 +256,6 @@ export function buildContentCreatePayload(
 		...buildContentUpdatePayload(contentType, draft),
 	}
 	if (payload.primaryCategory === null) delete payload.primaryCategory
+	if (payload.primaryTopic === null) delete payload.primaryTopic
 	return payload
 }

package/src/ui/screens/ContentRoute.tsx

@@ -8,7 +8,7 @@
 // This file creates thin stubs so the registry can compile now (Task 10).
 
 import { useReducer } from 'react'
-import type { ContentMetadataSelectField } from '../../integration/options.js'
+import type { ContentMetadataSelectField, PrimaryTopicControl } from '../../integration/options.js'
 import { type ContentType, contentViewReducer, initialContentView } from './content-view.js'
 import { EditorScreen } from './EditorScreen.js'
 import { LibraryScreen } from './LibraryScreen.js'
@@ -16,10 +16,12 @@ import { LibraryScreen } from './LibraryScreen.js'
 export function ContentRoute({
 	allowInlineAuthorCreation = true,
 	primaryCategories = [],
+	primaryTopic,
 	contentMetadataSelects = [],
 }: {
 	allowInlineAuthorCreation?: boolean
 	primaryCategories?: Array<{ slug: string; label: string }>
+	primaryTopic?: PrimaryTopicControl
 	contentMetadataSelects?: ContentMetadataSelectField[]
 }) {
 	const [view, dispatch] = useReducer(contentViewReducer, initialContentView)
@@ -52,6 +54,7 @@ export function ContentRoute({
 			onClose={handleClose}
 			allowInlineAuthorCreation={allowInlineAuthorCreation}
 			primaryCategories={primaryCategories}
+			primaryTopic={primaryTopic}
 			contentMetadataSelects={contentMetadataSelects}
 		/>
 	)

package/src/ui/screens/EditorScreen.tsx

@@ -17,7 +17,7 @@
 // is Playwright-smoked only.
 
 import { useCallback, useState } from 'react'
-import type { ContentMetadataSelectField } from '../../integration/options.js'
+import type { ContentMetadataSelectField, PrimaryTopicControl } from '../../integration/options.js'
 import type { ContentStatus, ContentType, FrontsPublishStatus } from '../../schema/types.js'
 import { buildSharePrefill, ShareModal } from '../components/ShareModal.js'
 import {
@@ -41,6 +41,7 @@ export interface EditorScreenProps {
 	onClose: () => void
 	allowInlineAuthorCreation?: boolean
 	primaryCategories?: Array<{ slug: string; label: string }>
+	primaryTopic?: PrimaryTopicControl
 	contentMetadataSelects?: ContentMetadataSelectField[]
 }
 
@@ -101,6 +102,7 @@ export function EditorScreen({
 	onClose,
 	allowInlineAuthorCreation = true,
 	primaryCategories = [],
+	primaryTopic,
 	contentMetadataSelects = [],
 }: EditorScreenProps) {
 	const contentType: ContentType = (docRef.contentType as ContentType | undefined) ?? 'article'
@@ -410,6 +412,7 @@ export function EditorScreen({
 								onFrontsPublishStatusChange={setFrontsPublishStatus}
 								onSaveStateChange={handleSaveStateChange}
 								primaryCategories={primaryCategories}
+								primaryTopic={primaryTopic}
 								contentMetadataSelects={contentMetadataSelects}
 							/>
 						</div>

package/src/ui/screens/registry.tsx

@@ -11,7 +11,7 @@
 // internal router state (which is not exported). The ContentRoute itself owns
 // the full open-doc reducer (which doc is open, new vs existing).
 
-import type { ContentMetadataSelectField } from '../../integration/options.js'
+import type { ContentMetadataSelectField, PrimaryTopicControl } from '../../integration/options.js'
 import type { ScreenRegistry } from '../components/CmsApp.js'
 import { useHashRouter } from '../use-hash-router.js'
 import { AnalyticsScreen } from './AnalyticsScreen.js'
@@ -43,11 +43,13 @@ function CalendarRoute() {
 export function createCmsScreens({
 	allowInlineAuthorCreation = true,
 	primaryCategories = [],
+	primaryTopic,
 	contentMetadataSelects = [],
 	surveyId,
 }: {
 	allowInlineAuthorCreation?: boolean
 	primaryCategories?: Array<{ slug: string; label: string }>
+	primaryTopic?: PrimaryTopicControl
 	contentMetadataSelects?: ContentMetadataSelectField[]
 	surveyId?: string
 } = {}): ScreenRegistry {
@@ -56,6 +58,7 @@ export function createCmsScreens({
 			<ContentRoute
 				allowInlineAuthorCreation={allowInlineAuthorCreation}
 				primaryCategories={primaryCategories}
+				primaryTopic={primaryTopic}
 				contentMetadataSelects={contentMetadataSelects}
 			/>
 		),