implement nextjs api example

Author: ivandotv

.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["humao.rest-client"]
+}

example/.eslintrc.json

@@ -4,16 +4,24 @@
   "private": true,
   "scripts": {
     "dev": "next dev",
+    "debug": "NODE_OPTIONS='--inspect' next dev",
     "build": "next build",
     "start": "next start",
     "lint": "next lint"
   },
   "dependencies": {
+    "@koa/router": "^10.1.1",
+    "koa": "^2.13.4",
+    "koa-body": "^5.0.0",
     "next": "12.1.6",
+    "nextjs-koa-api": "workspace:^0.0.0",
+    "on-finished": "^2.4.1",
     "react": "18.1.0",
     "react-dom": "18.1.0"
   },
   "devDependencies": {
+    "@types/koa": "^2.13.4",
+    "@types/koa__router": "^8.0.11",
     "@types/node": "^17.0.30",
     "@types/react": "18.0.8",
     "@types/react-dom": "18.0.3",

example/package.json

@@ -1,14 +1,16 @@
-POST http://localhost:3000/api/hello
-Content-Type: application/json
+GET  http://localhost:3000/api/
 
-{
-	"name":"ivan"
-}
+### trigger error
+GET  http://localhost:3000/api/throw
 
 ###
-GET http://localhost:3000/api/instance
+POST http://localhost:3000/api/hello
 Content-Type: application/json
 
 {
-	"name":"ivan-a"
+	"name":"Luigi"
 }
+
+### nested router
+GET http://localhost:3000/api/nested/hello
+Content-Type: application/json

example/pages/_app.tsx

@@ -0,0 +1,45 @@
+import { KoaApi, withKoaApi } from 'nextjs-koa-api'
+
+const api = new KoaApi({
+  router: {
+    prefix: '/api'
+  }
+})
+
+api.use(async (ctx, next) => {
+  try {
+    await next()
+  } catch (err: any) {
+    //catch all errors
+    err as Error
+    ctx.status = err.statusCode || err.status || 500
+    ctx.body = {
+      message: err.message
+    }
+  }
+})
+
+api.router
+  .get('/hello', (ctx) => {
+    ctx.body = {
+      method: 'GET',
+      route: '/hello'
+    }
+  })
+  .post('/hello', (ctx) => {
+    ctx.body = ctx.request.body
+  })
+  .get('/throw', () => {
+    throw new Error('my error')
+  })
+
+// create nested router
+const subRouter = api.createNewRouter().get('/', (ctx) => {
+  ctx.body = `nested params: ${JSON.stringify(ctx.params)}`
+})
+
+//mount nested router
+//https://github.com/koajs/router/blob/master/API.md#nested-routers
+api.router.use('/nested/:data', subRouter.routes(), subRouter.allowedMethods())
+
+export default withKoaApi(api)