Fix/apiDocsBuild (#989)

* copy api json to docs

* copy api json to docs

* improvements

* fix web build

* mjs > js

web/.gitignore

@@ -3,6 +3,7 @@ node_modules
 /build
 /.svelte-kit
 /package
+static/docs/api/wanderer.openapi.json
 .env
 .env.*
 !.env.example

web/openapi.config.js

@@ -0,0 +1,12 @@
+export function openapiOptions(version) {
+	return {
+		info: {
+			title: 'Wanderer API',
+			version,
+			description: 'API documentation for wanderer backend',
+		},
+		outputPath: 'static/docs/api/wanderer.openapi.json',
+		include: ['src/routes/api/v1/**/*.{js,ts}'],
+		baseSchemasPath: 'src/lib/models/api/openapi_schemas.ts',
+	};
+}

web/package.json

@@ -5,6 +5,7 @@
   "scripts": {
     "dev": "vite dev",
     "build": "vite build",
+    "openapi:generate": "node scripts/generate-openapi.js",
     "start": "node watcher.js & node build",
     "preview": "vite preview",
     "test": "npm run test:integration && npm run test:unit",

web/scripts/generate-openapi.js

@@ -0,0 +1,18 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { generateSpec, writeSpec } from '../node_modules/sveltekit-openapi-generator/dist/generator.js';
+import { openapiOptions } from '../openapi.config.js';
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const webDir = resolve(scriptDir, '..');
+const packageJson = JSON.parse(readFileSync(resolve(webDir, 'package.json'), 'utf-8'));
+const { outputPath, ...generatorOptions } = openapiOptions(packageJson.version);
+
+const spec = generateSpec({
+  rootDir: webDir,
+  ...generatorOptions,
+});
+
+writeSpec(spec, resolve(webDir, outputPath));

web/vite.config.ts

@@ -4,20 +4,12 @@ import tailwindcss from '@tailwindcss/vite';
 import fs from 'fs';
 import openapiPlugin from 'sveltekit-openapi-generator';
 import { defineConfig } from 'vitest/config';
+import { openapiOptions } from './openapi.config.js';
 
 const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf-8'));
 
 export default defineConfig({
-	plugins: [enhancedImages(), openapiPlugin({
-		info: {
-			title: 'Wanderer API',
-			version: `${packageJson.version}`,
-			description: 'API documentation for wanderer backend',
-		},
-		outputPath: 'static/docs/api/wanderer.openapi.json',
-		include: ['src/routes/api/v1/**/*.{js,ts}'],
-		baseSchemasPath: 'src/lib/models/api/openapi_schemas.ts',
-	}), tailwindcss(), sveltekit()],
+	plugins: [enhancedImages(), openapiPlugin(openapiOptions(packageJson.version)), tailwindcss(), sveltekit()],
 	test: { include: ['src/**/*.{test,spec}.{js,ts}'] },
 	ssr: { noExternal: ['three'] },
 	...(process.env.WANDERER_ENV == "dev" ? {