New API docs

devksingh4 · devksingh4 · commit 5999c8f40147 · 2025-07-11T21:05:26.000-04:00
diff --git a/src/api/createSwagger.ts b/src/api/createSwagger.ts
@@ -4,27 +4,32 @@ import { writeFile, mkdir } from "fs/promises";
 import init from "./index.js"; // Assuming this is your Fastify app initializer
 
 const html = `
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="utf-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <meta name="description" content="ACM @ UIUC Core API Docs" />
-  <title>ACM @ UIUC Core API</title>
-  <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5.11.0/swagger-ui.css" />
-</head>
-<body>
-<div id="swagger-ui"></div>
-<script src="https://unpkg.com/swagger-ui-dist@5.11.0/swagger-ui-bundle.js" crossorigin></script>
-<script>
-  window.onload = () => {
-    window.ui = SwaggerUIBundle({
-      url: '/docs/openapi.json',
-      dom_id: '#swagger-ui',
-    });
-  };
-</script>
-</body>
+<!doctype html>
+<html>
+  <head>
+    <title>ACM @ UIUC Core API Reference</title>
+    <meta charset="utf-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1" />
+  </head>
+
+  <body>
+    <div id="app"></div>
+
+    <!-- Load the Script -->
+    <script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
+
+    <!-- Initialize the Scalar API Reference -->
+    <script>
+      Scalar.createApiReference('#app', {
+        // The URL of the OpenAPI/Swagger document
+        url: '/docs/openapi.json',
+        // Avoid CORS issues
+        proxyUrl: 'https://proxy.scalar.com',
+      })
+    </script>
+  </body>
 </html>
 `;
 /**
diff --git a/src/common/types/generic.ts b/src/common/types/generic.ts
@@ -3,13 +3,12 @@ import * as z from "zod/v4";
 
 export const illinoisSemesterId = z
   .string()
-  .min(1)
-  .max(4)
+  .length(4)
   .regex(/^(fa|sp|su|wi)\d{2}$/)
   .meta({
     description: "Short semester slug for a given semester.",
     id: "IllinoisSemesterId",
-    examples: ["sp25", "fa24"],
+    example: "fa24",
   });
 
 export const illinoisNetId = z
