fix: Clean up whitespace and improve code formatting in API Docs server
Some checks failed
Integration Tests / integration-tests (push) Failing after 19s
Integration Tests / performance-tests (push) Has been skipped
API Docs (Node.js Express) / test (20) (push) Successful in 1m29s
API Docs (Node.js Express) / build (push) Successful in 31s

### Summary of Changes
- Removed unnecessary whitespace in the `generateUnifiedSpec` function to enhance code readability.
- Standardized formatting in the `operationsSorter` function for consistency.

### Expected Results
- Improved code clarity and maintainability, making it easier for developers to read and understand the API Docs server code.
This commit is contained in:
GSRN
2025-09-18 12:05:47 +02:00
parent 651e1fe5eb
commit 8abc2fd55a

View File

@@ -156,7 +156,7 @@ async function generateUnifiedSpec () {
// Fetch specs from all services
for (const [serviceKey, service] of Object.entries(SERVICES)) {
const spec = await fetchServiceSpec(serviceKey, service)
// Collect original tags before modifying them
const subCategories = new Set()
if (spec.paths) {
@@ -176,13 +176,13 @@ async function generateUnifiedSpec () {
for (const [path, methods] of Object.entries(spec.paths)) {
const prefixedPath = `/${serviceKey}${path}`
const updatedMethods = {}
for (const [method, operation] of Object.entries(methods)) {
// Use only the main service name as the primary tag
// Store original category in metadata for internal organization
const originalTags = operation.tags || ['General']
const category = originalTags[0] || 'General'
updatedMethods[method] = {
...operation,
tags: [service.name], // Only main service tag for top-level grouping
@@ -193,7 +193,7 @@ async function generateUnifiedSpec () {
'x-category': category
}
}
unifiedSpec.paths[prefixedPath] = updatedMethods
}
}
@@ -351,11 +351,11 @@ app.get('/', swaggerUi.setup(null, {
filter: true,
showExtensions: true,
showCommonExtensions: true,
operationsSorter: function(a, b) {
operationsSorter: function (a, b) {
// Sort by summary (which includes category tags)
const summaryA = a.get('summary') || '';
const summaryB = b.get('summary') || '';
return summaryA.localeCompare(summaryB);
const summaryA = a.get('summary') || ''
const summaryB = b.get('summary') || ''
return summaryA.localeCompare(summaryB)
},
tagsSorter: 'alpha'
},