OpenAPI spec at /api/docs with a Scalar viewer, opt-in via FEAT_API_DOCS

package.json

@@ -5,7 +5,7 @@
 	"type": "module",
 	"scripts": {
 		"dev": "npx vite dev",
-		"prebuild": "npx license-checker --json --production | jq 'to_entries | map({name: (.key | split(\"@\")[0:-1] | join(\"@\")), version: (.key | split(\"@\")[-1]), license: .value.licenses, repository: .value.repository}) | sort_by(.name)' > src/lib/data/dependencies.json.tmp && mv src/lib/data/dependencies.json.tmp src/lib/data/dependencies.json || true",
+		"prebuild": "npx license-checker --json --production | jq 'to_entries | map({name: (.key | split(\"@\")[0:-1] | join(\"@\")), version: (.key | split(\"@\")[-1]), license: .value.licenses, repository: .value.repository}) | sort_by(.name)' > src/lib/data/dependencies.json.tmp && mv src/lib/data/dependencies.json.tmp src/lib/data/dependencies.json || true && npm run generate:openapi",
 		"build": "npx vite build",
 		"start": "node ./server.js",
 		"preview": "node ./build/index.js",
@@ -50,7 +50,9 @@
 		"test:quick": "bun test tests/api-smoke.test.ts tests/notifications.test.ts",
 		"test:integration": "bun test tests/api-smoke.test.ts tests/crud-operations.test.ts tests/scheduling.test.ts tests/hawser-connection.test.ts",
 		"test:e2e": "npx playwright test tests/e2e/",
-		"generate:legal": "node scripts/generate-legal-pages.ts"
+		"generate:legal": "node scripts/generate-legal-pages.ts",
+		"generate:openapi": "npx tsx scripts/generate-openapi.ts",
+		"generate:openapi:check": "npx tsx scripts/generate-openapi.ts --check"
 	},
 	"dependencies": {
 		"@1password/sdk": "0.4.1-beta.1",
@@ -82,8 +84,10 @@
 		"devalue": "5.8.1",
 		"drizzle-orm": "0.45.2",
 		"fast-xml-parser": "5.7.3",
+		"isomorphic-dompurify": "3.22.0",
 		"js-yaml": "4.3.1",
 		"ldapts": "8.1.3",
+		"marked": "18.0.9",
 		"modern-tar": "0.8.0",
 		"nodemailer": "9.0.1",
 		"otpauth": "9.4.1",
@@ -100,6 +104,7 @@
 		"@layerstack/tailwind": "^1.0.1",
 		"@lucide/svelte": "^0.562.0",
 		"@playwright/test": "1.57.0",
+		"@scalar/api-reference": "1.64.0",
 		"@sveltejs/adapter-node": "^5.2.0",
 		"@sveltejs/kit": "2.50.0",
 		"@sveltejs/vite-plugin-svelte": "6.2.4",
@@ -131,6 +136,7 @@
 		"tailwind-merge": "^3.4.0",
 		"tailwind-variants": "^3.2.2",
 		"tailwindcss": "^4.1.18",
+		"tsx": "4.23.1",
 		"tw-animate-css": "^1.4.0",
 		"typescript": "^5.9.3",
 		"vite": "^7.3.1"