fix: move MD configuration up the integration pipeline, don't break on GitHub API rate limit

Author: zlataovce

astro.config.ts

@@ -19,6 +19,16 @@ const prod = process.env.NODE_ENV === "production";
 export default defineConfig({
   site: prod ? "https://docs.papermc.io" : undefined,
   integrations: [
+    // save Markdown renderer configuration to globals for use by the on-demand renderer
+    // order matters - we want this to use only our configuration
+    {
+      name: "docs:config-md",
+      hooks: {
+        "astro:config:setup": ({ config }) => {
+          globalThis.markdownConfig = { ...config.markdown };
+        },
+      },
+    },
     starlight({
       title: "PaperMC Docs",
       social: [
@@ -394,15 +404,6 @@ export default defineConfig({
       pad: 50,
       skipGeneration: !prod, // comment out if you have D2 locally and want to use it during dev
     }),
-    // save Markdown renderer configuration to globals for use by the on-demand renderer
-    {
-      name: "docs:config-md",
-      hooks: {
-        "astro:config:done": ({ config }) => {
-          globalThis.markdownConfig = config.markdown;
-        },
-      },
-    },
   ],
   build: {
     inlineStylesheets: "always",

src/utils/versions.ts

@@ -44,9 +44,13 @@ const waterfallProject: Project = await fetch("https://api.papermc.io/v2/project
 
 export const LATEST_WATERFALL_RELEASE = waterfallProject.versions[waterfallProject.versions.length - 1];
 
+interface Tag {
+  name: string;
+}
+
 const userdevVersions: string[] = await fetch("https://api.github.com/repos/PaperMC/paperweight/tags")
-  .then((r) => r.json())
-  .then((json) => json.map((e) => e.name.substring(1)));
+  .then((r) => (r.ok ? r.json() : [{ name: "v0.0.0" }]))
+  .then((tags: Tag[]) => tags.map((t) => t.name.substring(1)));
 
 export const LATEST_USERDEV_RELEASE = userdevVersions[0];