Function writeIntegrationsJson

scripts/generate-docs.ts:769–954

* Collect all integration entries from block definitions and write integrations.json * to the shared integrations data directory (`apps/sim/lib/integrations`). * Applies the same visibility filters as the docs generation pipeline.

(iconMapping: Record<string, string>)

 * Applies the same visibility filters as the docs generation pipeline.
 */
async function writeIntegrationsJson(iconMapping: Record<string, string>): Promise<void> {
  try {
    if (!fs.existsSync(INTEGRATIONS_DATA_PATH)) {
      fs.mkdirSync(INTEGRATIONS_DATA_PATH, { recursive: true })
    }

    const triggerRegistry = await buildTriggerRegistry()
    const { desc: toolDescMap, name: toolNameMap } = await buildToolDescriptionMap()

    // Hand-authored, integration-specific landing content (install walkthrough,
    // privacy blurb), keyed by slug. Imported as pure data — its only import is
    // type-only and erased at runtime — and baked into the entries below so the
    // landing page reads a single source instead of augmenting at render time.
    const landingContentModule = await import(
      pathToFileURL(path.join(LANDING_INTEGRATIONS_DATA_PATH, 'landing-content.ts')).href
    )
    const landingContentMap = (landingContentModule.INTEGRATION_LANDING_CONTENT ?? {}) as Record<
      string,
      Record<string, unknown>
    >

    const integrations: IntegrationEntry[] = []
    const seenBaseTypes = new Set<string>()
    const blockFiles = (await glob(`${BLOCKS_PATH}/*.ts`)).sort()

    for (const blockFile of blockFiles) {
      const fileContent = fs.readFileSync(blockFile, 'utf-8')
      const switchCaseMap = extractSwitchCaseToolMapping(fileContent)
      const configs = extractAllBlockConfigs(fileContent)

      for (const config of configs) {
        const blockType = config.type

        // Canonical integrations filter: only third-party tool blocks visible in the toolbar.
        // `isIntegrationBlock` is the single source of truth for "is integration".
        if (!isIntegrationBlock(config)) continue

        // Every tools-category block MUST declare an `integrationType` from the canonical
        // 16-value enum (apps/sim/blocks/types.ts). Fail loudly so the catalog never
        // ships a tool without a category bucket.
        if (!config.integrationType) {
          throw new Error(
            `Block "${blockType}" has \`category: 'tools'\` but is missing required \`integrationType\`. ` +
              `Add one of the IntegrationType values from apps/sim/blocks/types.ts.`
          )
        }
        if (!INTEGRATION_CATEGORY_VALUES.has(config.integrationType as IntegrationType)) {
          throw new Error(
            `Block "${blockType}" has unrecognised \`integrationType: "${config.integrationType}"\`. ` +
              `Use one of: ${[...INTEGRATION_CATEGORY_VALUES].join(', ')}.`
          )
        }
        const integrationType = config.integrationType as IntegrationType

        // Deduplicate by stripped base type
        const baseType = stripVersionSuffix(blockType)
        if (seenBaseTypes.has(baseType)) continue
        seenBaseTypes.add(baseType)