go-duck-cli 1.1.48 → 1.2.0

package/generators/config.js

@@ -207,6 +207,15 @@ type Config struct {
 			Enabled  bool   \`mapstructure:"enabled"\`
 			Provider string \`mapstructure:"provider"\`
 		} \`mapstructure:"serverless"\`
+		Integrations struct {
+			WSO2 struct {
+				Enabled             bool     \`mapstructure:"enabled"\`
+				PublisherURL        string   \`mapstructure:"publisher-url"\`
+				ClientID            string   \`mapstructure:"client-id"\`
+				ClientSecret        string   \`mapstructure:"client-secret"\`
+				GatewayEnvironments []string \`mapstructure:"gateway-environments"\`
+			} \`mapstructure:"wso2"\`
+		} \`mapstructure:"integrations"\`
 	} \`mapstructure:"go-duck"\`
 	Environment struct {
 		ActiveProfile string \`mapstructure:"active_profile"\`
@@ -267,6 +276,9 @@ func LoadConfig() (*Config, error) {
 	v.SetDefault("go-duck.serverless.provider", "aws")
 	v.SetDefault("go-duck.datasource.mongodb.enabled", false)
 	v.SetDefault("go-duck.datasource.mongodb.uri", "mongodb://localhost:27017")
+	v.SetDefault("go-duck.integrations.wso2.enabled", false)
+	v.SetDefault("go-duck.integrations.wso2.publisher-url", "https://localhost:9443/api/am/publisher/v3")
+	v.SetDefault("go-duck.integrations.wso2.gateway-environments", []string{"Production", "Sandbox"})
 
 	v.AutomaticEnv()
 	v.SetEnvKeyReplacer(strings.NewReplacer(".", "_", "-", "_"))

package/generators/wso2.js

@@ -0,0 +1,156 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+
+export const generateWSO2Integration = async (outputDir, config) => {
+    const integrationsDir = path.join(outputDir, 'integrations', 'wso2');
+    await fs.ensureDir(integrationsDir);
+
+    const wso2Go = `
+package wso2
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"mime/multipart"
+	"net/http"
+	"os"
+	"path/filepath"
+	"time"
+
+	"${config.name || 'go-duck'}/config"
+	"${config.name || 'go-duck'}/logger"
+)
+
+type TokenResponse struct {
+	AccessToken string \`json:"access_token"\`
+	Scope       string \`json:"scope"\`
+	TokenType   string \`json:"token_type"\`
+	ExpiresIn   int    \`json:"expires_in"\`
+}
+
+func RegisterAPI(appConfig *config.Config) error {
+	wso2Config := appConfig.GoDuck.Integrations.WSO2
+	if !wso2Config.Enabled {
+		return nil
+	}
+
+	logger.Info("Starting WSO2 APIM Publisher Registration...")
+
+	// 1. Authenticate to get OAuth2 Access Token
+	token, err := getAccessToken(wso2Config.PublisherURL, wso2Config.ClientID, wso2Config.ClientSecret)
+	if err != nil {
+		return fmt.Errorf("failed to authenticate with WSO2: %v", err)
+	}
+
+	// 2. Locate swagger.json
+	swaggerPath := filepath.Join("docs", "swagger.json")
+	if _, err := os.Stat(swaggerPath); os.IsNotExist(err) {
+		return fmt.Errorf("swagger.json not found at %s. Cannot register with WSO2", swaggerPath)
+	}
+
+	// 3. Register via /apis/import-openapi
+	err = importOpenAPI(wso2Config.PublisherURL, token, swaggerPath)
+	if err != nil {
+		return fmt.Errorf("failed to import OpenAPI to WSO2: %v", err)
+	}
+
+	logger.Info("Successfully registered API with WSO2 Publisher!")
+	return nil
+}
+
+func getAccessToken(publisherURL, clientID, clientSecret string) (string, error) {
+	// WSO2 DCR/Token endpoint is typically exposed at /oauth2/token on the Gateway or KM
+	// If the PublisherURL is https://localhost:9443/api/am/publisher/v3, 
+	// Token URL is typically https://localhost:9443/oauth2/token
+	baseURL := publisherURL[:len(publisherURL)-len("/api/am/publisher/v3")]
+	tokenURL := baseURL + "/oauth2/token"
+
+	data := "grant_type=client_credentials&scope=apim:api_create apim:api_publish"
+	req, err := http.NewRequest("POST", tokenURL, bytes.NewBufferString(data))
+	if err != nil {
+		return "", err
+	}
+
+	req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
+	req.SetBasicAuth(clientID, clientSecret)
+
+	client := &http.Client{Timeout: 10 * time.Second}
+	resp, err := client.Do(req)
+	if err != nil {
+		return "", err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		bodyBytes, _ := io.ReadAll(resp.Body)
+		return "", fmt.Errorf("token request failed with status %d: %s", resp.StatusCode, string(bodyBytes))
+	}
+
+	var tokenRes TokenResponse
+	if err := json.NewDecoder(resp.Body).Decode(&tokenRes); err != nil {
+		return "", err
+	}
+
+	return tokenRes.AccessToken, nil
+}
+
+func importOpenAPI(publisherURL, token, swaggerPath string) error {
+	importURL := publisherURL + "/apis/import-openapi"
+
+	file, err := os.Open(swaggerPath)
+	if err != nil {
+		return err
+	}
+	defer file.Close()
+
+	body := &bytes.Buffer{}
+	writer := multipart.NewWriter(body)
+
+	// Additional data fields
+	_ = writer.WriteField("additionalProperties", \`{"visibility":"PUBLIC"}\`)
+
+	// File field
+	part, err := writer.CreateFormFile("file", filepath.Base(swaggerPath))
+	if err != nil {
+		return err
+	}
+	_, err = io.Copy(part, file)
+	if err != nil {
+		return err
+	}
+
+	err = writer.Close()
+	if err != nil {
+		return err
+	}
+
+	req, err := http.NewRequest("POST", importURL, body)
+	if err != nil {
+		return err
+	}
+
+	req.Header.Set("Authorization", "Bearer "+token)
+	req.Header.Set("Content-Type", writer.FormDataContentType())
+
+	client := &http.Client{Timeout: 30 * time.Second}
+	resp, err := client.Do(req)
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK && resp.StatusCode != http.StatusCreated {
+		bodyBytes, _ := io.ReadAll(resp.Body)
+		return fmt.Errorf("import failed with status %d: %s", resp.StatusCode, string(bodyBytes))
+	}
+
+	return nil
+}
+`;
+
+    await fs.writeFile(path.join(integrationsDir, 'wso2.go'), wso2Go);
+    console.log(chalk.gray('  Generated WSO2 API Manager Integration client: integrations/wso2/wso2.go'));
+};

package/index.js

@@ -46,6 +46,7 @@ import { generateElasticsearchLayer } from './generators/elasticsearch.js';
 import { generateServerlessHandler } from './generators/serverless.js';
 import { generateRouterCode } from './generators/router.js';
 import { generateAIDocs } from './generators/ai_docs.js';
+import { generateWSO2Integration } from './generators/wso2.js';
 
 export const generateAuditCode = async (config, outputDir) => {
     const middlewareDir = path.join(outputDir, 'middleware');
@@ -575,6 +576,10 @@ program
         await generateAIDocs(config, entities, absoluteOutputDir, enums, openEntities);
         console.log(chalk.green('🤖 System-level AI Blueprint Documentation generated!'));
 
+        // 8.7 Generate WSO2 API Manager Integration
+        await generateWSO2Integration(absoluteOutputDir, config);
+        console.log(chalk.green('🌐 WSO2 API Manager Integration Module generated!'));
+
         // 9. Generate main.go
         const mainTemplatePath = path.resolve(__dirname, 'templates/go/main.go.hbs');
         if (await fs.pathExists(mainTemplatePath)) {
@@ -920,6 +925,15 @@ const generateYAMLConfigs = async (config, outputDir) => {
             enabled: cleanConfig.serverless?.enabled || false,
             provider: cleanConfig.serverless?.provider || 'aws'
         },
+        integrations: {
+            wso2: {
+                enabled: cleanConfig.integrations?.wso2?.enabled || false,
+                'publisher-url': cleanConfig.integrations?.wso2?.['publisher-url'] || 'https://localhost:9443/api/am/publisher/v3',
+                'client-id': cleanConfig.integrations?.wso2?.['client-id'] || '',
+                'client-secret': cleanConfig.integrations?.wso2?.['client-secret'] || '',
+                'gateway-environments': cleanConfig.integrations?.wso2?.['gateway-environments'] || ['Production', 'Sandbox']
+            }
+        },
         multitenancy: {
             enabled: cleanConfig.multitenancy?.enabled || false,
             'hide-silo-names': cleanConfig.multitenancy?.['hide-silo-names'] || false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "go-duck-cli",
-  "version": "1.1.48",
+  "version": "1.2.0",
   "description": "The Ultimate Evolutionary Go Microservice Scaffolder.",
   "main": "index.js",
   "type": "module",

package/templates/docs/pages/gdl-relationships.hbs

@@ -23,9 +23,10 @@
             <h2 class="text-3xl font-black mb-6 text-white m-0">The Social Network of Data</h2>
             <div class="bg-purple-800/50 backdrop-blur-md rounded-2xl p-8 border border-purple-500/30">
                 <pre class="text-indigo-200 font-mono text-base leading-relaxed overflow-x-auto m-0">
-<span class="text-purple-400">// relationship Type Parent to Child</span>
-relationship 1:m Customer to Order
-relationship m:1 Order to Customer
+<span class="text-purple-400">// relationship Type { Parent to Child }</span>
+relationship OneToMany {
+    Customer{orders} to Order{customer}
+}
                 </pre>
             </div>
             <p class="mt-8 text-purple-200 text-sm italic font-medium leading-relaxed m-0 border-l-2 border-purple-400 pl-6">
@@ -42,13 +43,17 @@ relationship m:1 Order to Customer
                 <div class="w-12 h-12 bg-purple-100 rounded-xl flex items-center justify-center mb-6 text-2xl group-hover:scale-110 transition-transform">👨‍👩‍👧</div>
                 <h3 class="text-xl font-bold text-slate-900 mb-4 m-0 font-mono">1:m (One-to-Many)</h3>
                 <p class="text-sm text-slate-600 leading-relaxed mb-6 italic">One parent entity owns multiple children. Perfect for Customers having many Orders.</p>
-                <div class="p-4 bg-slate-50 rounded-xl font-mono text-xs text-purple-700 font-bold border border-slate-100">relationship 1:m Customer to Order</div>
+                <div class="p-4 bg-slate-50 rounded-xl font-mono text-xs text-purple-700 font-bold border border-slate-100"><pre class="m-0">relationship OneToMany {
+  Customer{orders} to Order{customer}
+}</pre></div>
             </div>
             <div class="p-8 bg-white border border-slate-200 rounded-[2rem] shadow-sm hover:border-purple-200 transition-all group">
                 <div class="w-12 h-12 bg-purple-100 rounded-xl flex items-center justify-center mb-6 text-2xl group-hover:scale-110 transition-transform">🔗</div>
                 <h3 class="text-xl font-bold text-slate-900 mb-4 m-0 font-mono">m:1 (Many-to-One)</h3>
                 <p class="text-sm text-slate-600 leading-relaxed mb-6 italic">Multiple entities reference a single shared resource. Multiple Car entities belonging to a single Manufacturer.</p>
-                <div class="p-4 bg-slate-50 rounded-xl font-mono text-xs text-purple-700 font-bold border border-slate-100">relationship m:1 Car to Manufacturer</div>
+                <div class="p-4 bg-slate-50 rounded-xl font-mono text-xs text-purple-700 font-bold border border-slate-100"><pre class="m-0">relationship ManyToOne {
+  Car{manufacturer} to Manufacturer
+}</pre></div>
             </div>
         </div>
     </section>
@@ -62,7 +67,9 @@ relationship m:1 Order to Customer
                 <div>
                     <h4 class="text-lg font-bold text-purple-900 mb-2 m-0 font-mono">required</h4>
                     <p class="text-sm text-purple-800 leading-relaxed m-0 italic mb-4">By adding the `required` keyword to any relationship, GO-DUCK enforces strict existence checking at the database and API level.</p>
-                    <code class="px-3 py-1 bg-white text-purple-700 rounded-lg text-xs font-bold border border-purple-200">relationship 1:m Customer to Order required</code>
+                    <div class="p-4 bg-white rounded-lg font-mono text-xs text-purple-700 font-bold border border-purple-200"><pre class="m-0">relationship OneToMany {
+  Customer{orders} to Order{customer} required
+}</pre></div>
                 </div>
             </div>
         </div>

package/templates/docs/pages/gdl.hbs

@@ -55,7 +55,9 @@ entity Customer {
 }
 
 <span class="text-slate-500">// Define a directional relationship</span>
-relationship Customer 1:m Order
+relationship OneToMany {
+    Customer{orders} to Order{customer}
+}
             </pre>
         </div>
     </div>

package/templates/docs/pages/hybrid-store.hbs

@@ -56,7 +56,7 @@ entity Profile { <span class="text-slate-500">// MongoDB (document)</span>
 }</code></pre>
             </div>
             <p class="text-slate-400 text-sm italic leading-relaxed m-0 border-l border-emerald-500/30 pl-6">
-                GO-DUCK automatically detects that <code>Profile</code> is NoSQL and <code>User</code> is SQL. It generates a <code>uint64</code> owner ID in MongoDB and a <code>string</code> profile pointer in SQL, handling all casting and <code>gorm:"-"</code> shielding automatically.
+                GO-DUCK automatically detects that <code>Profile</code> is NoSQL and <code>User</code> is SQL. To ensure <strong>100% structural parity</strong> between PostgreSQL and MongoDB, the generator now unconditionally injects both <code>gorm:"..."</code> and <code>bson:"..."</code> tags onto every generated Go struct. This allows any model to seamlessly fallback or migrate between engines without any code changes, while still handling dynamic ID typing (<code>string</code> vs <code>uint64</code>) automatically.
             </p>
         </div>
     </div>

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 361% Elite Milestone Surpassed</p>
+                <p class="text-[11px] font-black text-indigo-900 uppercase tracking-[0.25em]">The 395% Elite Milestone Surpassed</p>
             </div>
             
             <!-- Heroic Logo Anchor (Enhanced) -->
@@ -59,7 +59,7 @@
                     <div class="relative z-10 flex flex-col lg:flex-row items-center justify-between gap-12">
                         <div class="max-w-xl text-center lg:text-left">
                             <h3 class="text-[11px] font-black text-indigo-500 uppercase tracking-[0.4em] mb-4 text-center lg:text-left">Operational Readiness</h3>
-                            <h2 class="text-5xl font-black text-slate-900 tracking-tighter mb-6 italic">The 361% Paradigm Status.</h2>
+                            <h2 class="text-5xl font-black text-slate-900 tracking-tighter mb-6 italic">The 395% Paradigm Status.</h2>
                             <p class="text-slate-500 leading-relaxed font-medium">GO-DUCK has evolved from a simple generator into a high-performance distributed orchestrator, achieving industrial compliance across all silo ecosystems.</p>
                         </div>
                         <div class="grid grid-cols-2 gap-8 text-center bg-slate-50 p-8 rounded-[2rem] border border-slate-100 shadow-inner">
@@ -110,6 +110,16 @@
                         <span class="px-4 py-1.5 bg-blue-100 text-blue-700 text-[9px] font-black rounded-lg">ZERO-LEAK PROXY</span>
                     </div>
                 </div>
+
+                <div class="lg:col-span-12 bg-white p-10 rounded-[2.5rem] border border-orange-100 shadow-sm hover:shadow-2xl transition-all group relative overflow-hidden cursor-crosshair bg-gradient-to-br from-white to-orange-50/30">
+                    <p class="text-[9px] font-bold text-orange-600 uppercase tracking-widest mb-4">Elite Extension (+15%)</p>
+                    <h4 class="text-2xl font-black text-slate-900 mb-3 tracking-tight italic">WSO2 API Gateway Integration</h4>
+                    <p class="text-slate-600 leading-relaxed mb-8">Natively orchestrates with WSO2 API Manager using automated OAuth2 Client Credentials Flow, pushing dynamic OpenAPI specifications to Gateways at boot time.</p>
+                    <div class="flex gap-3">
+                        <span class="px-4 py-1.5 bg-orange-100 text-orange-700 text-[9px] font-black rounded-lg">ZERO-TOUCH PROVISIONING</span>
+                        <span class="px-4 py-1.5 bg-orange-100 text-orange-700 text-[9px] font-black rounded-lg">WSO2 REST PROXY</span>
+                    </div>
+                </div>
             </div>
         </div>
     </section>
@@ -416,7 +426,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 361% ELITE MILESTONE &bull; SOVEREIGN CODE ORCHESTRATION
+                GO-DUCK &bull; THE 395% ELITE MILESTONE &bull; SOVEREIGN CODE ORCHESTRATION
             </div>
         </div>
     </section>

package/templates/docs/pages/integrations.hbs

@@ -81,3 +81,24 @@ class ApiProvider {
 }
 </code></pre>
 </section>
+
+<section class="mb-10">
+    <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-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>
+    </div>
+
+    <pre><code class="language-yaml">go-duck:
+  integrations:
+    wso2:
+      enabled: true
+      publisher-url: "https://localhost:9443/api/am/publisher/v3"
+      client-id: "YOUR_WSO2_CLIENT_ID"
+      client-secret: "YOUR_WSO2_CLIENT_SECRET"
+      gateway-environments:
+        - "Production"
+        - "Sandbox"
+</code></pre>
+</section>

package/templates/docs/pages/realtime.hbs

@@ -55,15 +55,15 @@ ws.onmessage = (event) => console.log("Received via WS:", event.data);</code></p
     <div class="grid grid-cols-1 md:grid-cols-2 gap-6 mb-8">
         <div class="bg-gray-50 p-6 rounded-xl border border-gray-200">
             <h4 class="font-bold text-blue-600 mb-2 font-mono">MQTT (Real-time UI)</h4>
-            <p class="text-sm text-gray-600 mb-4">Topic Pattern: <code>go-duck/events/{entity}/{action}</code></p>
-            <pre class="text-xs bg-slate-900 text-white p-3 rounded"><code># Listen to Car Deletions
-mosquitto_sub -t "go-duck/events/car/DELETE"</code></pre>
+            <p class="text-sm text-gray-600 mb-4">Topic Pattern: <code>{topicPrefix}/{tenantDB}/{entity}/{action}</code></p>
+            <pre class="text-xs bg-slate-900 text-white p-3 rounded"><code># Listen to Car Deletions in the tokyo tenant
+mosquitto_sub -t "go-duck/events/tokyo_silo/Car/DELETE"</code></pre>
         </div>
         <div class="bg-gray-50 p-6 rounded-xl border border-gray-200">
             <h4 class="font-bold text-green-600 mb-2 font-mono">NATS (High-Perf CQRS)</h4>
-            <p class="text-sm text-gray-600 mb-4">Subject Pattern: <code>go.duck.events.{entity}.{action}</code></p>
-            <pre class="text-xs bg-slate-900 text-white p-3 rounded"><code># Listen to any Car mutations
-nats sub "go.duck.events.car.>"</code></pre>
+            <p class="text-sm text-gray-600 mb-4">Subject Pattern: <code>events.{tenantDB}.{entity}.{action}</code></p>
+            <pre class="text-xs bg-slate-900 text-white p-3 rounded"><code># Listen to any Car mutations across all silos
+nats sub "events.*.Car.>"</code></pre>
         </div>
     </div>
 </section>

package/templates/docs/pages/wizard.hbs

@@ -62,7 +62,7 @@
                         <div class="flex-grow h-1.5 bg-slate-100 rounded-full overflow-hidden">
                             <div class="w-[88%] h-full bg-indigo-500 shadow-[0_0_8px_rgba(99,102,241,0.5)]"></div>
                         </div>
-                        <span class="text-[8px] font-black text-indigo-600 uppercase">361%</span>
+                        <span class="text-[8px] font-black text-indigo-600 uppercase">395%</span>
                     </div>
                 </div>
             </div>

package/templates/go/main.go.hbs

@@ -11,6 +11,7 @@ import (
 	"{{app_name}}/internal/server"
 	"{{app_name}}/internal/worker"
     "{{app_name}}/internal/repository"
+    "{{app_name}}/integrations/wso2"
     "gorm.io/driver/postgres"
     "gorm.io/gorm"
 )
@@ -49,7 +50,12 @@ func main() {
         go outboxWorker.Start(context.Background())
     }
 
-	// 5. Start HTTP Server
+	// 5. Register with WSO2 API Manager (if enabled)
+	if err := wso2.RegisterAPI(appConfig); err != nil {
+		logger.Error("WSO2 API Manager Registration failed: %v", err)
+	}
+
+	// 6. Start HTTP Server
 	port := fmt.Sprintf(":%d", appConfig.GoDuck.Server.Port)
 	logger.Info("Starting HTTP server on %s", port)
 	r.Run(port)

package/templates/go/router.go.hbs

@@ -14,7 +14,9 @@ import (
     "gorm.io/driver/postgres"
     "gorm.io/gorm"
     "gorm.io/plugin/opentelemetry/tracing"
+    {{#if multitenancy_enabled}}
     "{{app_name}}/management"
+    {{/if}}
     "{{app_name}}/middleware"
     "{{app_name}}/controllers"
     "{{app_name}}/models"
@@ -183,12 +185,14 @@ func SetupRouter(appConfig *config.Config) *gin.Engine {
     })
 
     // Management APIs (Run-time DB onboarding)
+    {{#if multitenancy_enabled}}
     mgmt := r.Group("/management")
     mgmt.Use(middleware.JWTMiddleware())
     mgmt.Use(middleware.SuperAdminRoleMiddleware(appConfig))
     {
         mgmt.POST("/tenant/assign", management.CreateDatabaseAndMigrate(masterDB))
     }
+    {{/if}}
 
     // Open Application APIs (No Auth)
     openApi := r.Group("/open/api")
@@ -241,7 +245,9 @@ func SetupRouter(appConfig *config.Config) *gin.Engine {
     api.Use(middleware.MeteringMiddleware(masterDB))
     {
         // Silo Portfolio
+        {{#if multitenancy_enabled}}
         api.GET("/silos/me", management.GetMySilos(masterDB))
+        {{/if}}
 
         // Business Reporting APIs
         meteringCtrl := controllers.MeteringController{DB: masterDB}