Function loadBlogPosts

modules/blog.ts:90–151

* Scans the blog directory for .md files and extracts validated frontmatter. * Returns all posts (including drafts) sorted by date descending. * Resolves Bluesky avatars at build time.

(
  blogDir: string,
  options: {
    imagesDir: string
    resolveAvatars: boolean
  },
)

 * Resolves Bluesky avatars at build time.
 */
async function loadBlogPosts(
  blogDir: string,
  options: {
    imagesDir: string
    resolveAvatars: boolean
  },
): Promise<BlogPostFrontmatter[]> {
  const { imagesDir, resolveAvatars } = options
  const files = await Array.fromAsync(glob(join(blogDir, '**/*.md').replace(/\\/g, '/')))

  // First pass: extract raw frontmatter and collect all Bluesky handles
  const rawPosts: Array<{ frontmatter: Record<string, unknown> }> = []
  const allHandles = new Set<string>()

  for (const file of files) {
    const { data: frontmatter } = read(file)

    // Normalise slug → path (same logic as standard-site-sync)
    if (typeof frontmatter.slug === 'string' && !frontmatter.path) {
      frontmatter.path = `/blog/${frontmatter.slug}`
    }
    // Normalise date to ISO string
    if (frontmatter.date) {
      const raw = frontmatter.date
      frontmatter.date = new Date(raw instanceof Date ? raw : String(raw)).toISOString()
    }

    // Validate authors before resolving so we can extract handles
    const authorsResult = safeParse(array(AuthorSchema), frontmatter.authors)
    if (authorsResult.success) {
      for (const author of authorsResult.output) {
        if (author.blueskyHandle) {
          allHandles.add(author.blueskyHandle)
        }
      }
    }

    rawPosts.push({ frontmatter })
  }

  // Batch-fetch all Bluesky avatars in a single request when avatar resolution is enabled.
  const avatarMap = resolveAvatars
    ? await fetchBlueskyAvatars(imagesDir, [...allHandles])
    : new Map<string, string>()

  // Second pass: validate with raw schema, then enrich authors with avatars
  const posts: BlogPostFrontmatter[] = []

  for (const { frontmatter } of rawPosts) {
    const result = safeParse(RawBlogPostSchema, frontmatter)
    if (!result.success) continue

    posts.push({
      ...result.output,
      authors: resolveAuthors(result.output.authors, avatarMap),
    })
  }