fix: build-time cache tags

Author: jmattheis

api-docs-fetcher.ts

@@ -0,0 +1,13 @@
+export const fetchUrls = async () => {
+  const res = await fetch('https://api.github.com/repos/gotify/server/tags', {
+    headers: {Accept: 'application/vnd.github.v3+json'},
+  });
+  if (!res.ok) {
+    throw Error('could not fetch tags');
+  }
+  const tags: {name: string}[] = await res.json();
+  return tags.map((tag) => ({
+    url: `https://raw.githubusercontent.com/gotify/server/${tag.name}/docs/spec.json`,
+    name: tag.name,
+  }));
+};

api-docs.data.ts

@@ -0,0 +1,8 @@
+import {fetchUrls} from './api-docs-fetcher';
+
+// This is evaluated at build-time: https://vitepress.dev/guide/data-loading
+export default {
+  async load() {
+    return fetchUrls();
+  },
+};

api-docs.md

@@ -5,7 +5,30 @@ head:
   - [link, {rel: stylesheet, href: /swagger/swagger-ui.css}]
   - [script, {src: /swagger/swagger-ui-bundle.js}]
   - [script, {src: /swagger/swagger-ui-standalone-preset.js}]
-  - [script, {src: /swagger/init.js}]
 ---
 
 <div id="swagger-ui"></div>
+
+<script setup>
+import { data as urls } from './api-docs.data.ts'
+import { onMounted } from 'vue'
+import { fetchUrls } from './api-docs-fetcher.ts'
+
+onMounted(() => {
+  fetchUrls()
+    .catch((e) => {
+      console.log("Failed to load tags", e)
+      return urls;
+    })
+    .then(urls => {
+      window.SwaggerUIBundle({
+        urls,
+        dom_id: '#swagger-ui',
+        deepLinking: true,
+        presets: [window.SwaggerUIBundle.presets.apis, window.SwaggerUIStandalonePreset],
+        plugins: [window.SwaggerUIBundle.plugins.DownloadUrl],
+        layout: 'StandaloneLayout',
+      })
+    })
+})
+</script>