From ef9f9934aa3b830a490660caad907cc1ad467158 Mon Sep 17 00:00:00 2001
From: Rory& <root@rory.gay>
Date: Fri, 31 Jul 2026 06:09:38 +0200
Subject: [PATCH] Hide missing schema declaration warnings for some static file
 endpoints

---
 assets/openapi.json | Bin 1038146 -> 1038151 bytes
 scripts/openapi.js  |  48 ++++++++++++++++++++++++++++++++------------
 2 files changed, 35 insertions(+), 13 deletions(-)

diff --git a/assets/openapi.json b/assets/openapi.json
index 7da3259efcc294b271fe1f2e05477f082116abce..8ddf135f048a0a5efb675970a82950623ef03af0 100644
GIT binary patch
delta 83
zcmX@K&i?p1`wh)Z9Ek;)dPVs~mCbET?QKkqKn$XpftUq|S%H`hh}nUd1Bf|+m<x!x
SftUw~d4ZU3dm9t~o+|*esT%nJ

delta 78
zcmX@U&i>Fk`wh)Z%=tMf&D~7x-As%?45FEVm<5PgftU@5*@2h?h&h3n3y8Uam<Nb?
NftYW5HxvJ!D*zjl8BYKJ

diff --git a/scripts/openapi.js b/scripts/openapi.js
index 28352fdfa..59eb33ea2 100644
--- a/scripts/openapi.js
+++ b/scripts/openapi.js
@@ -33,6 +33,7 @@ const schemas = JSON.parse(fs.readFileSync(SchemaPath, { encoding: "utf8" }));
 let missingRouteCount = 0;
 let missingResponseSchemaCount = 0;
 let missingRequestSchemaCount = 0;
+let missingResponseSchemaDeclarationCount = 0;
 
 let specification = {
     openapi: "3.1.0",
@@ -52,7 +53,7 @@ let specification = {
     },
     servers: [
         {
-            url: "https://old.server.spacebar.chat/api/",
+            url: "https://api.rory.server.spacebar.chat/api/",
             description: "Official Spacebar Instance",
         },
     ],
@@ -219,15 +220,35 @@ function apiRoutes(missingRoutes) {
                     };
             }
         } else {
-            console.log(
-                `${bgRedBright(" ")}\x1b[5m${white("\x1b[48;5;208mWARN")}${bgRedBright(" ")}\x1b[0m\x1b[34m`,
-                "Route",
-                method.toUpperCase(),
-                path,
-                "missing response schema:",
-                route.responses,
-                "\x1b[0m",
-            );
+            missingResponseSchemaDeclarationCount++;
+            // ignore static asset responses (schema-less)
+            if (
+                ![
+                    // Client web pages
+                    "/",
+                    "/widget",
+                    "/verify-email",
+                    // Generated files
+                    "/_spacebar/api/schemas.json",
+                    "/_spacebar/api/openapi.json",
+                    // Assets
+                    "/static/logo.png",
+                    // Whatever...
+                    "/readyz",
+                    "/healthz",
+                    "/-/readyz",
+                    "/-/healthz",
+                ].includes(path)
+            )
+                console.log(
+                    `${bgRedBright(" ")}\x1b[5m${white("\x1b[48;5;208mWARN")}${bgRedBright(" ")}\x1b[0m\x1b[34m`,
+                    "Route",
+                    method.toUpperCase(),
+                    path,
+                    "missing response schema:",
+                    route.responses,
+                    "\x1b[0m",
+                );
             obj.responses = {
                 default: {
                     description: "No description available",
@@ -302,9 +323,10 @@ async function main() {
         elapsedMs,
         "ms.",
     );
-    if (missingRouteCount) console.log("Found", missingRouteCount, "routes missing a route() middleware.");
-    if (missingRequestSchemaCount) console.log("Found", missingRequestSchemaCount, "routes missing request schemas.");
-    if (missingResponseSchemaCount) console.log("Found", missingResponseSchemaCount, "routes missing a response schemas.");
+    if (missingRouteCount) console.log("! Found", missingRouteCount, "routes missing a route() middleware !");
+    if (missingRequestSchemaCount) console.log("! Found", missingRequestSchemaCount, "routes missing request schemas !");
+    if (missingResponseSchemaCount) console.log("! Found", missingResponseSchemaCount, "routes missing a response schemas !");
+    if (missingResponseSchemaDeclarationCount) console.log("! Found", missingResponseSchemaDeclarationCount, "routes missing a response schema declaration !");
 }
 
 main().then(() => {});