From aab9bf01bb562228f1f532a4309bafcf1cc917dd Mon Sep 17 00:00:00 2001
From: didavila <diego.davilafreitas@gmail.com>
Date: Fri, 27 Mar 2026 14:46:06 +0100
Subject: [PATCH] feat: sort parameters in buildTagsMapFromAnalysis by required
 status

---
 src/generators/clean-arch.generator.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/generators/clean-arch.generator.ts b/src/generators/clean-arch.generator.ts
index 82a1c8d..25bc013 100644
--- a/src/generators/clean-arch.generator.ts
+++ b/src/generators/clean-arch.generator.ts
@@ -123,6 +123,12 @@ export function buildTagsMapFromAnalysis(
         const hasQueryParams = (op.parameters || []).some((p) => p.in === 'query');
         const hasBodyParam = !!op.requestBody;
 
+        // Sort: required params first, optional params last (TypeScript requirement)
+        allParams.sort((a, b) => {
+          if (a.required === b.required) return 0;
+          return a.required ? -1 : 1;
+        });
+
         tagsMap[tag].push({
           nickname: op.operationId || `${method}${pathKey.replace(/\//g, '_')}`,
           summary: op.summary || '',