SvelteKit OpenAPI
Generator

import { sveltekit } from '@sveltejs/kit/vite';
import { defineConfig } from 'vite';
import openapiPlugin from 'sveltekit-openapi-generator';

export default defineConfig({
  plugins: [
    openapiPlugin({
      // OpenAPI info section
      info: {
        title: 'My API',
        version: '1.0.0',
        description: 'My API Description'
      },
      // OpenAPI servers configuration
      servers: [
        { url: 'https://api.example.com', description: 'Production' },
        { url: 'http://localhost:5173', description: 'Development' }
      ],
      // Path to shared schema definitions
      baseSchemasPath: 'src/lib/schemas.js',
      // Additional YAML files to include
      yamlFiles: ['src/lib/extra-specs.yaml'],
      // Path prefix for all routes
      prependPath: '/api',
      // Glob patterns to include
      include: ['src/routes/**/{+server,+page.server}.{js,ts}'],
      // Glob patterns to exclude
      exclude: ['**/node_modules/**', '**/.svelte-kit/**'],
      // Whether to fail on JSDoc parsing errors
      failOnErrors: false,
      // Output path for the spec file during build
      outputPath: 'static/openapi.json',
      // Debounce delay in milliseconds for file watching
      debounceMs: 200
    }),
    sveltekit()
  ]
});

/**
 * @swagger
 * /api/users:
 *   get:
 *     summary: Get all users
 *     tags:
 *       - Users
 *     responses:
 *       200:
 *         description: Success
 *         content:
 *           application/json:
 *             schema:
 *               type: array
 *               items:
 *                 $ref: '#/components/schemas/User'
 */
export async function GET({ url }) {
  const users = await db.getUsers();
  return json({ users });
}

/**
 * @swagger
 * components:
 *   schemas:
 *     User:
 *       type: object
 *       required:
 *         - id
 *         - email
 *       properties:
 *         id:
 *           type: string
 *           format: uuid
 *         email:
 *           type: string
 *           format: email
 *         name:
 *           type: string
 */