feat: openapi survey create

server/api/openapi.json.ts

@@ -0,0 +1,5 @@
+import { openApiDocument } from '../openapi'
+
+export default defineEventHandler(() => {
+ return openApiDocument
+})

server/openapi.ts

@@ -0,0 +1,13 @@
+import { generateOpenApiDocument } from 'trpc-openapi'
+
+import { appRouter } from './trpc/routers'
+
+// Generate OpenAPI schema document
+export const openApiDocument = generateOpenApiDocument(appRouter, {
+ title: 'Example CRUD API',
+ description: 'OpenAPI compliant REST API built using tRPC with Next.js',
+ version: '1.0.0',
+ baseUrl: 'https://wsa.qinguan.me/api',
+ docsUrl: 'https://github.com/jlalmes/trpc-openapi',
+ tags: ['auth', 'users', 'posts'],
+})

server/trpc/routers/survey/index.ts

@@ -42,19 +42,21 @@ export const surveyRouter = router({
  return await ctx.prisma.survey.findMany()
  }),
 
- create: protectedProcedure.input(
- z.object({
- title: z.string(),
- description: z.string(),
- workshop: z.boolean(),
- questions: questionsSchema,
- permissions: surveyPermissionSchema,
+ create: protectedProcedure
+ .meta({ openapi: { method: 'POST', path: '/surveys' } })
+ .input(
+ z.object({
+ title: z.string(),
+ description: z.string(),
+ workshop: z.boolean(),
+ questions: questionsSchema,
+ permissions: surveyPermissionSchema,
+ }),
+ ).mutation(async ({ ctx, input }) => {
+ return await ctx.prisma.survey.create({
+ data: input,
+ })
  }),
- ).mutation(async ({ ctx, input }) => {
- return await ctx.prisma.survey.create({
- data: input,
- })
- }),
 
  update: protectedProcedure.input(
  z.object({

server/trpc/trpc.ts

@@ -9,6 +9,7 @@
  */
 import { TRPCError, initTRPC } from '@trpc/server'
 import superjson from 'superjson'
+import type { OpenApiMeta } from 'trpc-nuxt'
 import type { Context } from '~/server/trpc/context'
 
 interface Meta {
@@ -19,6 +20,7 @@ interface Meta {
 const t = initTRPC
  .context<Context>()
  .meta<Meta>()
+ .meta<OpenApiMeta>()
  .create({
  transformer: superjson,
  defaultMeta: {