go-duck-cli 1.3.31 → 1.3.36

package/README.md

@@ -59,8 +59,9 @@ GO-DUCK has officially reached the **410% Achievement Status**, evolving from a
 | **Silo Discovery & Privacy Proxy** | 🚀 **ELITE (+10%)** | Silo discovery API with physical DB name masking. |
 | **Universal Storage Mesh** | 🚀 **ELITE (+25%)** | Dynamic Hot-Swapping Registry and Distributed Cross-Scan API retrieval. |
 | **WSO2 API Gateway Integration** | 🚀 **ELITE (+15%)** | Automated OpenAPI registration & proxy mapping. |
+| **API Gateway Standards & Swagger UI** | 🚀 **ELITE (+10%)** | Keycloak SSO, Glassmorphism UI, JHipster `/v3/api-docs` compliance. |
 | **Full-Spectrum GDL Evolution** | 🚀 **ELITE (+15%)** | Native DROP/ALTER migrations with dead-code purging. |
-| **TOTAL ACHIEVEMENT STATUS** | 🏆 **410%** | **ELITE STATUS CONFIRMED.** 👑 |
+| **TOTAL ACHIEVEMENT STATUS** | 🏆 **420%** | **ELITE STATUS CONFIRMED.** 👑 |
 
 ### ✨ Primary Features (The 410% Core)
 
@@ -75,6 +76,8 @@ GO-DUCK has officially reached the **410% Achievement Status**, evolving from a
 *   **Distributed Saga Consistency**: Integrated **Transactional Outbox** pattern and background workers in every silo to guarantee eventual consistency across the federation.
 *   **Zero-Trust Identity Registry**: Decoupled mapping layer ensuring physical database names and internal IDs never leak to the client.
 *   **Universal Storage Mesh**: Dynamic Multi-Provider Registry allowing hot-swapping at runtime via `?provider=` queries, alongside Distributed Cross-Scan endpoints to auto-locate files across AWS, GCS, SFTP, and GitHub lakes.
+*   **Enterprise API Gateway Compatibility**: Natively exposes the Swagger/OpenAPI JSON specification at `/v3/api-docs` to ensure drop-in compatibility with **JHipster**, **WSO2 API Manager**, and Spring Boot ecosystems.
+*   **Next-Gen Swagger UI**: A fully glassmorphism-styled Swagger UI with seamless Keycloak SSO integration. Features automatic JWT token refresh, dynamic `X-Tenant-ID` header injection, and CLI metadata branding.
 *   **Spring-style Elasticsearch Search**: Real-time sync for entities marked with `@Searchable`, supporting native `query_string` syntax (wildcards like `*`, booleans, ranges, and fuzzy matching).
 *   **SaaS Quota Engine**: Redis-backed API bandwidth tracking with dynamic, hierarchical limits (User vs. Role mapping).
 *   **Resilience Layer**: Sony/Gobreaker Integration + Zero-Trust Distributed Redis Rate Limiter.

package/generators/config.js

@@ -2,6 +2,11 @@ import fs from 'fs-extra';
 import path from 'path';
 import chalk from 'chalk';
 
+const toKebabCase = (str) => {
+	if (!str) return '';
+	return str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+};
+
 export const generateConfigLoader = async (outputDir, configObj) => {
 	const configDir = path.join(outputDir, 'config');
 	await fs.ensureDir(configDir);
@@ -243,7 +248,7 @@ func LoadConfig() (*Config, error) {
 	// Default values
 	v.SetDefault("go-duck.server.rest.port", 8080)
 	v.SetDefault("go-duck.server.rest.protocol", "json")
-	v.SetDefault("go-duck.server.rest.api-path-prefix", "/${configObj.name || 'api'}/api")
+	v.SetDefault("go-duck.server.rest.api-path-prefix", "/${toKebabCase(configObj.name) || 'api'}/api")
 	v.SetDefault("go-duck.security.rate-limit.rps", 100.0)
 	v.SetDefault("go-duck.security.rate-limit.burst", 200)
 	v.SetDefault("go-duck.logging.datadog.enabled", false)

package/generators/router.js

@@ -19,10 +19,17 @@ export const generateRouterCode = async (outputDir, config, entities, openEntiti
     const templateSource = await fs.readFile(templatePath, 'utf8');
     const template = Handlebars.compile(templateSource);
 
+    const packageJsonPath = path.resolve(__dirname, '../package.json');
+    const packageJson = await fs.readJson(packageJsonPath);
+    const cliVersion = packageJson.version;
+    const generatedDate = new Date().toISOString();
+
     const content = template({
         app_name: config.name,
         entities,
-        openEntities
+        openEntities,
+        cli_version: cliVersion,
+        generated_date: generatedDate
     });
 
     await fs.writeFile(path.join(routerDir, 'router.go'), content);

package/index.js

@@ -875,13 +875,21 @@ const generateYAMLConfigs = async (config, outputDir) => {
         delete cleanConfig.datasource['multitenancy-databases'];
     }
 
+    const toKebabCase = (str) => {
+        if (!str) return '';
+        return str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+    };
+
+    const rawApiPrefix = cleanConfig.server?.rest?.['api-path-prefix'] || `/${cleanConfig.name || 'api'}/api`;
+    const kebabApiPrefix = rawApiPrefix.split('/').map(segment => toKebabCase(segment)).join('/');
+
     const extendedConfig = {
         ...cleanConfig,
         server: {
             rest: {
                 port: cleanConfig.server?.rest?.port || cleanConfig.server?.port || 8080,
                 protocol: cleanConfig.server?.rest?.protocol || 'json',
-                'api-path-prefix': cleanConfig.server?.rest?.['api-path-prefix'] || `/${cleanConfig.name || 'api'}/api`
+                'api-path-prefix': kebabApiPrefix
             },
             'read-timeout': cleanConfig.server?.['read-timeout'] || '30s',
             'write-timeout': cleanConfig.server?.['write-timeout'] || '30s',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "go-duck-cli",
-  "version": "1.3.31",
+  "version": "1.3.36",
   "description": "The Ultimate Evolutionary Go Microservice Scaffolder.",
   "main": "index.js",
   "type": "module",
@@ -10,6 +10,9 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "author": "heavenscode",
   "license": "ISC",
   "dependencies": {
@@ -21,5 +24,23 @@
     "inquirer": "^8.2.7",
     "js-yaml": "^4.1.1",
     "open": "^11.0.0"
+  },
+  "keywords": [
+    "go",
+    "golang",
+    "microservice",
+    "scaffold",
+    "cli",
+    "generator",
+    "go-duck"
+  ],
+  
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/heavenscode/go-duck.git"
+  },
+  "homepage": "https://goduck.theheavenscode.com",
+  "bugs": {
+    "url": "https://github.com/heavenscode/go-duck/issues"
   }
 }

package/templates/docs/pages/index.hbs

@@ -16,7 +16,7 @@
                     <span class="animate-ping absolute inline-flex h-full w-full rounded-full bg-emerald-400 opacity-75"></span>
                     <span class="relative inline-flex rounded-full h-3 w-3 bg-emerald-500"></span>
                 </span>
-                <p class="text-[11px] font-black text-indigo-900 uppercase tracking-[0.25em]">The 395% Elite Milestone Surpassed</p>
+                <p class="text-[11px] font-black text-indigo-900 uppercase tracking-[0.25em]">The 420% Elite Milestone Surpassed</p>
             </div>
             
             <!-- Heroic Logo Anchor (Enhanced) -->
@@ -121,6 +121,16 @@
                     </div>
                 </div>
 
+                <div class="lg:col-span-12 bg-white p-10 rounded-[2.5rem] border border-amber-100 shadow-sm hover:shadow-2xl transition-all group relative overflow-hidden cursor-crosshair bg-gradient-to-br from-white to-amber-50/30">
+                    <p class="text-[9px] font-bold text-amber-600 uppercase tracking-widest mb-4">Elite Extension (+10%)</p>
+                    <h4 class="text-2xl font-black text-slate-900 mb-3 tracking-tight italic">API Gateway Standards & Swagger UI</h4>
+                    <p class="text-slate-600 leading-relaxed mb-8">Natively exposes OpenAPI JSON at the JHipster-standard <code>/v3/api-docs</code> endpoint. Features a completely re-engineered, glassmorphism Swagger UI deeply integrated with Keycloak SSO and automatic token refreshing.</p>
+                    <div class="flex gap-3">
+                        <span class="px-4 py-1.5 bg-amber-100 text-amber-700 text-[9px] font-black rounded-lg">JHIPSTER COMPATIBLE</span>
+                        <span class="px-4 py-1.5 bg-amber-100 text-amber-700 text-[9px] font-black rounded-lg">KEYCLOAK SSO UI</span>
+                    </div>
+                </div>
+
                 <div class="lg:col-span-12 bg-white p-10 rounded-[2.5rem] border border-fuchsia-100 shadow-sm hover:shadow-2xl transition-all group relative overflow-hidden cursor-crosshair bg-gradient-to-br from-white to-fuchsia-50/30">
                     <p class="text-[9px] font-bold text-fuchsia-600 uppercase tracking-widest mb-4">Elite Extension (+12%)</p>
                     <h4 class="text-2xl font-black text-slate-900 mb-3 tracking-tight italic">K8s Network Isolation & NodePorts</h4>
@@ -436,7 +446,7 @@
                 </div>
 
             <div class="mt-24 text-slate-500 font-mono text-[10px] uppercase tracking-[0.6em] font-black relative z-10">
-                GO-DUCK &bull; THE 395% ELITE MILESTONE &bull; SOVEREIGN CODE ORCHESTRATION
+                GO-DUCK &bull; THE 420% ELITE MILESTONE &bull; SOVEREIGN CODE ORCHESTRATION
             </div>
         </div>
     </section>

package/templates/docs/pages/integrations.hbs

@@ -86,8 +86,13 @@ class ApiProvider {
     <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">3. WSO2 API Manager Integration</h2>
     <p class="mb-4">GO-DUCK generated APIs can automatically register themselves with a <strong>WSO2 API Manager</strong> instance on startup. This uses the WSO2 Publisher REST API to import your dynamically generated OpenAPI 3.0 specs.</p>
     
+    <div class="bg-indigo-50 border-l-4 border-indigo-500 p-4 mb-6 rounded-r">
+        <h4 class="font-bold text-indigo-900 mb-1">Standard API Gateway Discovery</h4>
+        <p class="text-sm text-indigo-800">For external gateways (Kong, Apigee) and ecosystems like <strong>JHipster</strong> and <strong>Spring Boot</strong>, your microservice natively exposes its OpenAPI JSON at the standard <code>/v3/api-docs</code> endpoint. Legacy systems can still use <code>/swagger.json</code>.</p>
+    </div>
+
     <div class="bg-blue-50 border-l-4 border-blue-500 p-4 mb-6 rounded-r">
-        <p class="text-blue-900"><strong>Configuration:</strong> Enable this by adding the <code>wso2</code> block to your <code>config.yaml</code>.</p>
+        <p class="text-blue-900"><strong>WSO2 Configuration:</strong> Enable this by adding the <code>wso2</code> block to your <code>config.yaml</code>.</p>
     </div>
 
     <pre><code class="language-yaml">go-duck:

package/templates/go/router.go.hbs

@@ -163,7 +163,10 @@ func SetupRouter(appConfig *config.Config) *gin.Engine {
     })
 
     // Swagger Docs & UI
-    r.StaticFile("/swagger.json", "./docs/swagger.json")
+    // Expose standard OpenAPI endpoints (JHipster / Spring / WSO2 compatibility)
+    r.StaticFile("/v3/api-docs", "./docs/swagger.json")
+    r.StaticFile("/swagger.json", "./docs/swagger.json") // Legacy fallback
+    r.StaticFile("/logo.png", "./docs/web/logo.png")
     r.GET("/swagger", func(c *gin.Context) {
         swaggerHTML := `<!DOCTYPE html>
 <html lang="en">
@@ -273,8 +276,13 @@ func SetupRouter(appConfig *config.Config) *gin.Engine {
 <body>
   <div class="top-nav">
     <div class="nav-brand">
-      <svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2L2 7l10 5 10-5-10-5zM2 17l10 5 10-5M2 12l10 5 10-5"/></svg>
-      GO-DUCK API Explorer
+      <img src="/logo.png" alt="GO-DUCK Logo" style="height: 32px; width: auto;" />
+      <div style="display: flex; flex-direction: column; line-height: 1.2;">
+        <span>{{app_name}} API Explorer</span>
+        <span style="font-size: 0.65em; font-weight: normal; color: #94a3b8;">
+          GO-DUCK v{{cli_version}} • Generated: {{generated_date}}
+        </span>
+      </div>
     </div>
     <div class="nav-controls">
       <div class="status-indicator">
@@ -340,9 +348,9 @@ func SetupRouter(appConfig *config.Config) *gin.Engine {
           }, 60000); // Check every minute
         }
 
-        // Initialize Swagger UI with Interceptor
-        window.ui = SwaggerUIBundle({
-          url: "/swagger.json",
+        // 4. Initialize Swagger UI
+        const ui = SwaggerUIBundle({
+          url: "/v3/api-docs",
           dom_id: '#swagger-ui',
           deepLinking: true,
           presets: [
@@ -367,7 +375,7 @@ func SetupRouter(appConfig *config.Config) *gin.Engine {
         
         // Still load swagger without auth interceptor
         window.ui = SwaggerUIBundle({
-          url: "/swagger.json",
+          url: "/v3/api-docs",
           dom_id: '#swagger-ui',
           deepLinking: true,
           presets: [