vtorio/app/api/openapi.json/route.ts

import { NextResponse } from 'next/server';

const openApiSpec = {
  openapi: '3.0.0',
  info: {
    title: 'Vtorio API',
    version: '1.0.0',
    description: 'File upload and management API for Vtorio application',
  },
  servers: [
    {
      url: 'http://localhost:3000',
      description: 'Development server',
    },
  ],
  components: {
    schemas: {
      File: {
        type: 'object',
        properties: {
          id: { type: 'string' },
          filename: { type: 'string' },
          mimetype: { type: 'string' },
          size: { type: 'number' },
          createdAt: { type: 'string', format: 'date-time' },
          updatedAt: { type: 'string', format: 'date-time' },
        },
      },
    },
  },
  paths: {
    '/api/upload': {
      post: {
        summary: 'Upload a file',
        description: 'Upload a file to the server and store it in the database',
        tags: ['Files'],
        requestBody: {
          required: true,
          content: {
            'multipart/form-data': {
              schema: {
                type: 'object',
                properties: {
                  file: {
                    type: 'string',
                    format: 'binary',
                    description: 'The file to upload',
                  },
                },
                required: ['file'],
              },
            },
          },
        },
        responses: {
          '200': {
            description: 'File uploaded successfully',
            content: {
              'application/json': {
                schema: {
                  type: 'object',
                  properties: {
                    success: { type: 'boolean', example: true },
                    file: {
                      type: 'object',
                      properties: {
                        id: { type: 'string', example: 'clh123abc456' },
                        filename: { type: 'string', example: 'document.pdf' },
                        mimetype: { type: 'string', example: 'application/pdf' },
                        size: { type: 'number', example: 1024000 },
                        createdAt: { type: 'string', format: 'date-time' },
                      },
                    },
                  },
                },
              },
            },
          },
          '400': {
            description: 'Bad request - No file provided',
            content: {
              'application/json': {
                schema: {
                  type: 'object',
                  properties: {
                    success: { type: 'boolean', example: false },
                    error: { type: 'string', example: 'No file provided' },
                  },
                },
              },
            },
          },
          '500': {
            description: 'Internal server error',
            content: {
              'application/json': {
                schema: {
                  type: 'object',
                  properties: {
                    success: { type: 'boolean', example: false },
                    error: { type: 'string', example: 'Failed to upload file' },
                  },
                },
              },
            },
          },
        },
      },
    },
    '/api/files': {
      get: {
        summary: 'List all files',
        description: 'Get a list of all uploaded files with metadata',
        tags: ['Files'],
        responses: {
          '200': {
            description: 'List of files retrieved successfully',
            content: {
              'application/json': {
                schema: {
                  type: 'object',
                  properties: {
                    success: { type: 'boolean', example: true },
                    files: {
                      type: 'array',
                      items: {
                        type: 'object',
                        properties: {
                          id: { type: 'string', example: 'clh123abc456' },
                          filename: { type: 'string', example: 'document.pdf' },
                          mimetype: { type: 'string', example: 'application/pdf' },
                          size: { type: 'number', example: 1024000 },
                          createdAt: { type: 'string', format: 'date-time' },
                          updatedAt: { type: 'string', format: 'date-time' },
                        },
                      },
                    },
                  },
                },
              },
            },
          },
          '500': {
            description: 'Internal server error',
            content: {
              'application/json': {
                schema: {
                  type: 'object',
                  properties: {
                    success: { type: 'boolean', example: false },
                    error: { type: 'string', example: 'Failed to list files' },
                  },
                },
              },
            },
          },
        },
      },
    },
    '/api/files/{id}': {
      get: {
        summary: 'Download a file',
        description: 'Download a specific file by its ID',
        tags: ['Files'],
        parameters: [
          {
            name: 'id',
            in: 'path',
            required: true,
            description: 'The ID of the file to download',
            schema: {
              type: 'string',
              example: 'clh123abc456',
            },
          },
        ],
        responses: {
          '200': {
            description: 'File downloaded successfully',
            content: {
              'application/octet-stream': {
                schema: {
                  type: 'string',
                  format: 'binary',
                },
              },
            },
            headers: {
              'Content-Type': {
                description: 'MIME type of the file',
                schema: { type: 'string' },
              },
              'Content-Disposition': {
                description: 'Attachment header with filename',
                schema: { type: 'string' },
              },
              'Content-Length': {
                description: 'Size of the file in bytes',
                schema: { type: 'integer' },
              },
            },
          },
          '404': {
            description: 'File not found',
            content: {
              'application/json': {
                schema: {
                  type: 'object',
                  properties: {
                    error: { type: 'string', example: 'File not found' },
                  },
                },
              },
            },
          },
          '500': {
            description: 'Internal server error',
            content: {
              'application/json': {
                schema: {
                  type: 'object',
                  properties: {
                    error: { type: 'string', example: 'Failed to retrieve file' },
                  },
                },
              },
            },
          },
        },
      },
    },
  },
};

export const GET = async () => {
  return NextResponse.json(openApiSpec, {
    headers: {
      'Content-Type': 'application/json',
    },
  });
};