@siyahjs/swagger NPM

@siyahjs/swagger

Plugin for siyah to auto-generate Swagger page.

Installation

bun add @siyahjs/swagger

Example

import { Siyah, t } from 'siyah'
import { swagger } from '@siyahjs/swagger'

const app = new Siyah()
    .use(swagger())
    .get('/', () => 'hi', { response: t.String({ description: 'sample description' }) })
    .post(
        '/json/:id',
        ({ body, params: { id }, query: { name } }) => ({
            ...body,
            id,
            name
        }),
        {
            params: t.Object({
                id: t.String()
            }),
            query: t.Object({
                name: t.String()
            }),
            body: t.Object({
                username: t.String(),
                password: t.String()
            }),
            response: t.Object({
                username: t.String(),
                password: t.String(),
                id: t.String(),
                name: t.String()
            }, { description: 'sample description' })
        }
    )
    .listen(8080);

Then go to http://localhost:8080/swagger.