topics.js

import path from 'path'
import fs from 'fs'

import { describe, expect, test } from 'vitest'
import walk from 'walk-sync'
import { difference } from 'lodash-es'

import readFrontmatter from '#src/frame/lib/read-frontmatter.js'
import allowedTopics from '../../../data/allowed-topics.js'

const contentDir = path.join(process.cwd(), 'content')
const topics = walk(contentDir, { includeBasePath: true })
  .filter((filename) => filename.endsWith('.md') && !filename.includes('README'))
  .map((filename) => {
    const fileContent = fs.readFileSync(filename, 'utf8')
    const { data, errors } = readFrontmatter(fileContent)
    if (errors.length > 0) {
      console.warn(errors)
      throw new Error(`More than 0 front-matter errors`)
    }
    return data.topics || []
  })
  .flat()

const allUsedTopics = [...new Set(topics)].sort()

describe('Check for allowed frontmatter topics', () => {
  test('all used topics are allowed in /data/allowed-topics.js', () => {
    expect(allUsedTopics.length).toBeGreaterThan(0)
    const unusedTopics = difference(allUsedTopics, allowedTopics)
    expect(unusedTopics).toEqual([])
  })

  test('all allowed topics are used by at least one content file', () => {
    expect(allowedTopics.length).toBeGreaterThan(0)
    const disallowedTopics = difference(allowedTopics, allUsedTopics)
    expect(disallowedTopics).toEqual([])
  })
})