Rework

.github/workflows/pull_request.yaml

@@ -0,0 +1,17 @@
+name: Code quality
+
+on:
+  pull_request:
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Biome
+        uses: biomejs/setup-biome@v2
+        with:
+          version: latest
+      - name: Run Biome
+        run: biome ci .

api/Dockerfile

@@ -13,7 +13,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-FROM oven/bun:1.0.29
+FROM oven/bun:1.1.3
 
 ARG BUILD_SHA=default_value
 ENV __BUILD_SHA=$BUILD_SHA

api/package.json

@@ -1,57 +1,58 @@
 {
-  "type": "module",
-  "private": true,
-  "name": "docs-page-api",
-  "version": "1.0.0",
-  "main": "src/app.ts",
-  "author": "Invertase <[email protected]>",
-  "license": "MIT",
-  "dependencies": {
-    "@code-hike/mdx": "0.7.2",
-    "@mdx-js/mdx": "2.2.1",
-    "@octokit/graphql": "5.0.0",
-    "@types/cors": "^2.8.12",
-    "@types/express": "^4.17.13",
-    "@types/morgan": "^1.9.3",
-    "@types/node": "^18.0.0",
-    "a2a": "^0.2.0",
-    "camelcase": "7.0.0",
-    "cors": "2.8.5",
-    "dotenv": "16.0.1",
-    "esbuild": "0.14.47",
-    "express": "4.18.1",
-    "express-basic-auth": "^1.2.1",
-    "gray-matter": "4.0.3",
-    "hast-util-heading-rank": "2.1.1",
-    "hast-util-parse-selector": "3.1.0",
-    "is-badge": "^2.1.0",
-    "js-yaml": "4.1.0",
-    "mdx-bundler": "9.0.1",
-    "morgan": "1.10.0",
-    "node-fetch": "3.2.6",
-    "pm2": "5.3.0",
-    "probot": "12.2.8",
-    "rehype-accessible-emojis": "0.3.2",
-    "rehype-katex": "6.0.2",
-    "rehype-slug": "5.0.1",
-    "remark-comment": "1.0.0",
-    "remark-gfm": "3.0.1",
-    "remark-math": "5.1.1",
-    "remark-parse": "10.0.1",
-    "shiki": "1.1.7",
-    "unist-util-visit": "4.1.0",
-    "zod": "3.22.4",
-    "zod-validation-error": "0.2.2"
-  },
-  "scripts": {
-    "dev": "bun run src/app.ts --hot",
-    "start": "bun run src/app.ts"
-  },
-  "devDependencies": {
-    "@octokit/webhooks-types": "^6.2.4",
-    "@types/js-yaml": "^4.0.5",
-    "rollup": "3.9.1",
-    "ts-node": "^10.8.1",
-    "typescript": "4.7.4"
-  }
+	"type": "module",
+	"private": true,
+	"name": "docs-page-api",
+	"version": "1.0.0",
+	"main": "src/app.ts",
+	"author": "Invertase <[email protected]>",
+	"license": "MIT",
+	"dependencies": {
+		"@code-hike/mdx": "0.7.2",
+		"@mdx-js/mdx": "2.2.1",
+		"@octokit/graphql": "5.0.0",
+		"@octokit/webhooks": "^13.2.7",
+		"@types/express": "^4.17.13",
+		"@types/morgan": "^1.9.3",
+		"@types/node": "^18.0.0",
+		"a2a": "^0.2.0",
+		"camelcase": "7.0.0",
+		"dotenv": "16.0.1",
+		"esbuild": "0.14.47",
+		"express": "4.18.1",
+		"express-basic-auth": "^1.2.1",
+		"gray-matter": "4.0.3",
+		"hast-util-heading-rank": "2.1.1",
+		"hast-util-parse-selector": "3.1.0",
+		"is-badge": "^2.1.0",
+		"js-yaml": "4.1.0",
+		"lodash.get": "^4.4.2",
+		"mdx-bundler": "9.0.1",
+		"morgan": "1.10.0",
+		"node-fetch": "3.2.6",
+		"octokit": "^4.0.2",
+		"rehype-accessible-emojis": "0.3.2",
+		"rehype-katex": "6.0.2",
+		"rehype-slug": "5.0.1",
+		"remark-comment": "1.0.0",
+		"remark-gfm": "3.0.1",
+		"remark-math": "5.1.1",
+		"remark-parse": "10.0.1",
+		"shiki": "1.1.7",
+		"unist-util-visit": "4.1.0",
+		"zod": "3.22.4",
+		"zod-to-json-schema": "^3.23.1",
+		"zod-validation-error": "0.2.2"
+	},
+	"scripts": {
+		"dev": "bun run src/app.ts --hot",
+		"start": "bun run src/app.ts"
+	},
+	"devDependencies": {
+		"@octokit/webhooks-types": "^6.2.4",
+		"@types/js-yaml": "^4.0.5",
+		"@types/lodash.get": "^4.4.9",
+		"rollup": "3.9.1",
+		"ts-node": "^10.8.1",
+		"typescript": "5.5.2"
+	}
 }

api/src/app.ts

@@ -1,37 +1,35 @@
-import express, { Router, text } from 'express';
-import morgan from 'morgan';
-import cors from 'cors';
-import { config } from 'dotenv';
+import { config } from "dotenv";
+import express, { Router, text } from "express";
+import morgan from "morgan";
 
-import bundle from './routes/bundle';
-import preview from './routes/preview';
-import mdx from './routes/mdx';
-import probot from './probot';
-import { notFound } from './res';
+import { notFound } from "./res";
+import bundle from "./routes/bundle";
+import preview from "./routes/preview";
+import schema from "./routes/schema";
+import githubWebhook from "./routes/webhooks.github";
 
 config();
 
 const PORT = process.env.PORT || 8080;
 const app = express();
 app.use(text());
-app.use(cors());
-app.use(morgan('dev'));
+app.use(morgan("dev"));
 app.use(express.json());
 app.use(
-  express.urlencoded({
-    extended: true,
-  }),
+	express.urlencoded({
+		extended: true,
+	}),
 );
-app.use(probot);
 
 const router = Router();
-router.get('/status', (_, res) => res.status(200).send('OK'));
-router.post('/preview', preview);
-router.get('/bundle', bundle);
-router.post('/mdx', mdx);
-router.all('*', (_, res) => notFound(res));
+router.get("/status", (_, res) => res.status(200).send("OK"));
+router.get("/schema.json", schema);
+router.post("/preview", preview);
+router.get("/bundle", bundle);
+router.post("/webhooks/github", githubWebhook);
+router.all("*", (_, res) => notFound(res));
 app.use(router);
 
 app.listen(PORT, () => {
-  console.log(`docs.page api server is running at http://localhost:${PORT}`);
+	console.log(`docs.page api server is running at http://localhost:${PORT}`);
 });

api/src/bundler/error.ts

@@ -0,0 +1,23 @@
+export class BundlerError extends Error {
+	code: number;
+	name: string;
+	source?: string;
+
+	constructor({
+		code,
+		name,
+		message,
+		source,
+	}: {
+		code: number;
+		name: string;
+		message: string;
+		source?: string;
+	}) {
+		super(message);
+		this.code = code;
+		this.name = name;
+		this.message = message;
+		this.source = source;
+	}
+}