simstudioai--sim/apps/sim/lib/content/schema.ts

import { z } from 'zod'

export const AuthorSchema = z
  .object({
    id: z.string().min(1),
    name: z.string().min(1),
    url: z.string().url().optional(),
    xHandle: z.string().optional(),
    avatarUrl: z.string().optional(), // allow relative or absolute
  })
  .strict()

export type Author = z.infer<typeof AuthorSchema>

/**
 * Frontmatter schema shared by every content section (blog, library, and any
 * future section). Section-specific behavior lives in the section's registry
 * instantiation, not in this schema.
 */
export const ContentFrontmatterSchema = z
  .object({
    slug: z.string().min(1),
    title: z.string().min(5),
    description: z.string().min(20),
    date: z.coerce.date(),
    updated: z.coerce.date().optional(),
    authors: z.array(z.string()).min(1),
    readingTime: z.number().int().positive().optional(),
    tags: z.array(z.string()).default([]),
    ogImage: z.string().min(1), // local path (e.g. /blog/<slug>/cover.jpg) - rendered via next/image without `unoptimized`
    ogAlt: z.string().optional(),
    about: z.array(z.string()).optional(),
    timeRequired: z.string().optional(),
    faq: z
      .array(
        z.object({
          q: z.string().min(1),
          a: z.string().min(1),
        })
      )
      .optional(),
    canonical: z.string().url(),
    draft: z.boolean().default(false),
    featured: z.boolean().default(false),
  })
  .strict()

export type ContentFrontmatter = z.infer<typeof ContentFrontmatterSchema>

export interface ContentMeta {
  slug: string
  title: string
  description: string
  date: string // ISO
  updated?: string // ISO
  author: Author
  authors: Author[]
  readingTime?: number
  tags: string[]
  ogImage: string
  ogAlt?: string
  about?: string[]
  timeRequired?: string
  faq?: { q: string; a: string }[]
  wordCount?: number
  canonical: string
  draft: boolean
  featured: boolean
}

export interface ContentPost extends ContentMeta {
  Content: React.ComponentType
  headings?: { text: string; id: string }[]
}

export interface TagWithCount {
  tag: string
  count: number
}