Function generateAllTriggerDocs

scripts/generate-docs.ts:3761–3828

* Generate one MDX file per trigger provider and update the sidebar meta.json. * Hand-written docs (HANDWRITTEN_TRIGGER_DOCS) are never touched.

()

 * Hand-written docs (HANDWRITTEN_TRIGGER_DOCS) are never touched.
 */
async function generateAllTriggerDocs(): Promise<void> {
  try {
    console.log('Generating trigger documentation...')

    if (!fs.existsSync(TRIGGER_DOCS_OUTPUT_PATH)) {
      fs.mkdirSync(TRIGGER_DOCS_OUTPUT_PATH, { recursive: true })
    }

    const fullRegistry = await buildFullTriggerRegistry()
    const grouped = groupTriggersByProvider(fullRegistry)
    const colorMap = await buildProviderColorMap()

    const generatedProviders: string[] = []

    for (const [provider, triggers] of grouped) {
      if (SKIP_TRIGGER_PROVIDERS.has(provider)) {
        console.log(`Skipping trigger provider: ${provider} (covered by hand-written docs)`)
        continue
      }

      // The trigger lives on the same per-service integration page as the
      // service's actions (provider ≠ block type for a few services).
      const blockType = PROVIDER_TO_BLOCK_TYPE[provider] ?? provider
      const outputFilePath = path.join(DOCS_OUTPUT_PATH, `${blockType}.mdx`)
      const baseName = path.basename(outputFilePath, '.mdx')

      if (HANDWRITTEN_INTEGRATION_DOCS.has(baseName) || HANDWRITTEN_TRIGGER_DOCS.has(baseName)) {
        console.log(`Skipping ${provider} — hand-written page`)
        continue
      }

      const existing = fs.existsSync(outputFilePath)
        ? fs.readFileSync(outputFilePath, 'utf-8')
        : null

      if (existing?.includes('\n## Actions')) {
        // Actions page generated this run by the block pass — append the Triggers section.
        if (!existing.includes('\n## Triggers')) {
          fs.appendFileSync(outputFilePath, `\n${buildTriggersSection(triggers)}`)
        }
      } else {
        // Trigger-only service (no actions block) — (re)write the standalone page,
        // preserving manual content from the previous run. Cleanup spares these
        // pages (category 'triggers' blocks are in the canonical set).
        const providerColor = colorMap.get(blockType) ?? '#6B7280'
        const markdown = generateTriggerProviderDoc(provider, triggers, blockType, providerColor)
        const rawSections = existing ? extractManualContent(existing) : {}
        const manualSections = Object.fromEntries(
          Object.entries(rawSections).filter(([, v]) => v.length > 0)
        )
        const finalContent =
          Object.keys(manualSections).length > 0
            ? mergeWithManualContent(markdown, existing, manualSections)
            : markdown
        fs.writeFileSync(outputFilePath, finalContent)
      }

      generatedProviders.push(blockType)