chore: Add automatic api doc generation (#1397)

Fixes: HDX-2888

Author: teeohhem

.gitignore

@@ -35,9 +35,6 @@ packages/app/.vercel
 packages/app/coverage
 packages/app/out
 
-# OpenAPI spec
-packages/public/openapi.json
-
 # optional npm cache directory
 **/.npm
 

.husky/pre-commit

@@ -1,4 +1,6 @@
 #!/usr/bin/env sh
+set -e
+
 . "$(dirname -- "$0")/_/husky.sh"
 
 npx lint-staged

package.json

@@ -41,6 +41,11 @@
     "release": "npx changeset tag && npx changeset publish"
   },
   "lint-staged": {
+    "packages/api/src/routers/external-api/**/*.ts": [
+      "prettier --write --ignore-unknown",
+      "eslint --fix --quiet",
+      "sh -c 'cd packages/api && yarn run docgen && git add openapi.json'"
+    ],
     "**/*.{ts,tsx}": [
       "prettier --write --ignore-unknown",
       "eslint --fix --quiet"