Function generateOpenApi

backend/scripts/generate-openapi.ts:10–38

()

import { cleanupOpenApiDoc } from 'nestjs-zod';

async function generateOpenApi() {
  // Skip ingest services that require external connections during OpenAPI generation
  process.env.SKIP_INGEST_SERVICES = 'true';
  process.env.SHIPSEC_SKIP_MIGRATION_CHECK = 'true';

  const { AppModule } = await import('../src/app.module');

  const app = await NestFactory.create(AppModule, {
    logger: ['error', 'warn'],
  });

  // Set global prefix to match production
  app.setGlobalPrefix('api/v1');

  const config = new DocumentBuilder()
    .setTitle('ShipSec Studio API')
    .setDescription('ShipSec backend API specification')
    .setVersion('0.1.0')
    .addServer('/api/v1', 'API v1')
    .build();

  const document = SwaggerModule.createDocument(app, config);
  const cleaned = cleanupOpenApiDoc(document);
  const repoRootSpecPath = join(__dirname, '..', '..', 'openapi.json');
  const payload = JSON.stringify(cleaned, null, 2);

  writeFileSync(repoRootSpecPath, payload);
  await app.close();
}

console.log('Script started');
generateOpenApi()