Function generateOpenAPI

apps/api/scripts/generate-openapi.ts:93–164

()

  return result
}

async function generateOpenAPI() {
  // Stub env for OpenAPI generation when missing (e.g. Vercel Next build)
  const stubs: Record<string, string> = {
    ANTHROPIC_API_KEY: 'sk-ant-dummy-for-openapi-generation',
    OLLAMA_BASE_URL: 'https://ollama.example.com',
    OPEN_ROUTER_API_KEY: 'sk-or-v1-dummy-for-openapi-generation',
    PGLITE: 'true',
    ENCRYPTION_KEY: 'deadbeef'.repeat(8), // 64-char hex (valid, not weak)
    JWT_SECRET: 'openapi-gen-jwt-secret-placeholder-32ch',
    ALLOWED_ORIGINS: 'https://openapi-gen.example',
    APP_NAME: 'OpenAPI Generation',
    WEB_APP_URL: 'https://openapi-gen.example',
  }
  for (const [k, v] of Object.entries(stubs)) if (!process.env[k]) process.env[k] = v

  const { default: app } = await import('../src/app.js')

  // Create Fastify instance (same as production)
  const fastify = Fastify({
    logger: false, // Disable logging for generation
    pluginTimeout: 30000, // Increase timeout for plugin loading (30 seconds)
  })

  try {
    // Register @fastify/swagger FIRST (before routes)
    // Swagger needs to scan routes as they're registered
    await fastify.register(swagger, {
      openapi: {
        info: {
          title: 'Basilic API',
          version: '1.0.0',
          description: 'Basilic API documentation',
        },
        ...openapiSecurity,
      },
    })

    // Register app (which autoloads plugins + routes)
    // Swagger will automatically scan route schemas as they're registered
    await fastify.register(app, { allowTest: false })

    // Wait for Fastify to be ready before generating OpenAPI
    await fastify.ready()

    // Generate OpenAPI JSON
    const openApiDocument = fastify.swagger()

    // Post-process to remove default-valued fields from required arrays
    const processedDocument = removeDefaultsFromRequired(openApiDocument) as typeof openApiDocument

    // Write to openapi.json
    const outputPath = join(scriptDir, '../openapi/openapi.json')
    await writeFile(outputPath, JSON.stringify(processedDocument, null, 2), 'utf-8')

    console.log('OpenAPI spec generated:', outputPath)
  } catch (error) {
    console.error('Failed to generate OpenAPI spec', error)