supabase/apps/www/scripts/generateMdContent.mjs

// @ts-check

/**
 * Scans content/md/ and emits a TypeScript module exporting the markdown
 * content as a Map plus the slug allowlist as a Set. Static imports of the
 * generated file make the content traceable by @vercel/nft so it ends up in
 * the serverless bundle without runtime fs.readFile.
 *
 * Drop a new .md file in content/md/ and the route handler picks it up on
 * the next content:build — no constant to edit.
 */

import { promises as fs } from 'fs'
import path from 'path'
import { fileURLToPath } from 'url'

const __dirname = path.dirname(fileURLToPath(import.meta.url))
const contentDir = path.join(__dirname, '../content/md')
const outputPath = path.join(__dirname, '../app/api-v2/md/content.generated.ts')

// 'pricing' is served dynamically via generatePricingContent() instead of
// from a .md file; it still needs to be in MD_PAGES so middleware rewrites
// /pricing.md to the API route.
const DYNAMIC_SLUGS = ['pricing']

async function collectMdFiles(dir, prefix = '') {
  const results = []
  const dirents = await fs.readdir(dir, { withFileTypes: true })
  for (const dirent of dirents) {
    const slug = prefix ? `${prefix}/${dirent.name}` : dirent.name
    if (dirent.isDirectory()) {
      results.push(...(await collectMdFiles(path.join(dir, dirent.name), slug)))
    } else if (dirent.name.endsWith('.md')) {
      results.push(slug.replace(/\.md$/, ''))
    }
  }
  return results
}

// homepage first (it's the site overview), then everything else alphabetical.
function sortSlugs(a, b) {
  if (a === 'homepage') return -1
  if (b === 'homepage') return 1
  return a.localeCompare(b)
}

const slugs = (await collectMdFiles(contentDir)).sort(sortSlugs)

if (slugs.length === 0) {
  console.error('❌ No .md files found in content/md/')
  process.exit(1)
}

// A static file with the same slug as a dynamic generator would land in both
// MD_CONTENT and the dynamic append path, so /llms-full.txt would emit it
// twice. Fail the build instead of shipping a duplicate.
const collisions = slugs.filter((s) => DYNAMIC_SLUGS.includes(s))
if (collisions.length > 0) {
  console.error(
    `❌ Slug collision: [${collisions.join(', ')}] is reserved for a dynamic generator. ` +
      `Remove the corresponding file from content/md/ or update DYNAMIC_SLUGS.`
  )
  process.exit(1)
}

const entries = []
const errors = []
for (const slug of slugs) {
  const filePath = path.join(contentDir, `${slug}.md`)
  try {
    const content = await fs.readFile(filePath, 'utf-8')
    entries.push(`  [${JSON.stringify(slug)}, ${JSON.stringify(content)}]`)
  } catch (err) {
    errors.push(`${slug}.md: ${err.message}`)
  }
}

if (errors.length > 0) {
  console.error('❌ Failed to read .md files:')
  errors.forEach((e) => console.error(`   ${e}`))
  process.exit(1)
}

const allSlugs = [...slugs, ...DYNAMIC_SLUGS]
const pageEntries = allSlugs.map((s) => `  ${JSON.stringify(s)}`).join(',\n')

const output = `// AUTO-GENERATED by scripts/generateMdContent.mjs — do not edit
export const MD_CONTENT = new Map<string, string>([
${entries.join(',\n')},
])

export const MD_PAGES = new Set<string>([
${pageEntries},
])
`

await fs.writeFile(outputPath, output, 'utf-8')
console.log(`✅ Generated ${outputPath} (${entries.length} files, ${allSlugs.length} pages)`)