boredgame/src/lib/server/api/configure-open-api.ts

import { apiReference } from '@scalar/hono-api-reference';
import { createOpenApiDocument } from 'hono-zod-openapi';
import packageJSON from '../../../../package.json';
import type { AppOpenAPI } from './common/utils/hono';

export default function configureOpenAPI(app: AppOpenAPI) {
  createOpenApiDocument(app, {
    info: {
      title: 'Bored Game API',
      description: 'Bored Game API',
      version: packageJSON.version,
    },
    components: {
      securitySchemes: {
        bearerAuth: {
          type: 'http',
          scheme: 'bearer',
        },
        cookieAuth: {
          type: 'apiKey',
          name: 'session',
          in: 'cookie',
        },
      },
    },
  });

  app.get(
    '/reference',
    apiReference({
      theme: 'kepler',
      layout: 'classic',
      defaultHttpClient: {
        targetKey: 'javascript',
        clientKey: 'fetch',
      },
      spec: {
        url: '/api/doc',
      },
    }),
  );
}