go-duck-cli 1.3.2 → 1.3.5

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. Now features a **Live Interactive MQTT Dictionary**, allowing users to instantly subscribe or publish payloads directly from the docs via WebSockets!
 *   **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/ai_docs.js

@@ -5,6 +5,9 @@ export const generateAIDocs = async (config, entities, outputDir, enums, openEnt
     const aiDocsDir = path.join(outputDir, 'docs', 'ai');
     await fs.ensureDir(aiDocsDir);
 
+    const apiPrefixRaw = config.server?.rest?.['api-path-prefix'] || '/api';
+    const apiPrefix = apiPrefixRaw.endsWith('/') ? apiPrefixRaw.slice(0, -1) : apiPrefixRaw;
+
     // 1. ARCHITECTURE.md
     const appName = config.name || 'go-duck-app';
     const hasMongo = config.datasource?.mongodb?.enabled;
@@ -32,7 +35,7 @@ export const generateAIDocs = async (config, entities, outputDir, enums, openEnt
     archContent += `- **Active**: ${storageActive ? 'Yes' : 'No'}\n`;
     if (storageActive) {
         archContent += `- **Enabled Nodes**: ${Object.keys(config.storage).filter(k => config.storage[k]?.enabled).join(', ')}\n`;
-        archContent += `- **Endpoints**: \n  - Upload: \`POST /api/storage/upload?provider=\`\n  - Exact Retrieve: \`GET /api/storage/download/*key?provider=\`\n  - Cross-Scan Locate: \`GET /api/storage/scan/*key\`\n`;
+        archContent += `- **Endpoints**: \n  - Upload: \`POST ${apiPrefix}/storage/upload?provider=\`\n  - Exact Retrieve: \`GET ${apiPrefix}/storage/download/*key?provider=\`\n  - Cross-Scan Locate: \`GET ${apiPrefix}/storage/scan/*key\`\n`;
     }
     const bootstrapActive = config.storage?.bootstrap?.enabled;
     if (bootstrapActive) {
@@ -53,25 +56,25 @@ export const generateAIDocs = async (config, entities, outputDir, enums, openEnt
 
     // 2. ENDPOINTS.md
     let endpointsContent = `# REST & gRPC API Surface\n\n`;
-    endpointsContent += `## Base Path: \`/api\`\n\n`;
+    endpointsContent += `## Base Path: \`${apiPrefix}\`\n\n`;
     endpointsContent += `### Standard Entity Endpoints\n`;
     for (const entity of entities) {
         const routeName = entity.name.toLowerCase() + 's';
         endpointsContent += `\n#### ${entity.name}\n`;
-        endpointsContent += `- \`GET /api/${routeName}\` (Pagination & dynamic sorting, e.g. \`?page=1&size=10&eager=true&sort=id,asc\`)\n`;
-        endpointsContent += `- \`GET /api/${routeName}/:id\`\n`;
-        endpointsContent += `- \`POST /api/${routeName}\`\n`;
-        endpointsContent += `- \`PUT /api/${routeName}/:id\`\n`;
-        endpointsContent += `- \`DELETE /api/${routeName}/:id\`\n`;
-        endpointsContent += `- \`POST /api/${routeName}/bulk\` (Bulk Create/Update)\n`;
+        endpointsContent += `- \`GET ${apiPrefix}/${routeName}\` (Pagination & dynamic sorting, e.g. \`?page=1&size=10&eager=true&sort=id,asc\`)\n`;
+        endpointsContent += `- \`GET ${apiPrefix}/${routeName}/:id\`\n`;
+        endpointsContent += `- \`POST ${apiPrefix}/${routeName}\`\n`;
+        endpointsContent += `- \`PUT ${apiPrefix}/${routeName}/:id\`\n`;
+        endpointsContent += `- \`DELETE ${apiPrefix}/${routeName}/:id\`\n`;
+        endpointsContent += `- \`POST ${apiPrefix}/${routeName}/bulk\` (Bulk Create/Update)\n`;
         if (entity.isSearchable) {
-            endpointsContent += `- \`GET /api/search/${routeName}?q={query}\` (Elasticsearch)\n`;
+            endpointsContent += `- \`GET ${apiPrefix}/search/${routeName}?q={query}\` (Elasticsearch)\n`;
         }
     }
 
     endpointsContent += `\n## Infrastructure & Management APIs (SuperAdmin Protected)\n`;
-    endpointsContent += `- \`GET /api/admin/audit\` (Fetches Global Delta logs from the Centralized Audit Engine)\n`;
-    endpointsContent += `- \`POST /api/admin/metering/limit\` (Set SaaS Quota limits)\n`;
+    endpointsContent += `- \`GET ${apiPrefix}/admin/audit\` (Fetches Global Delta logs from the Centralized Audit Engine)\n`;
+    endpointsContent += `- \`POST ${apiPrefix}/admin/metering/limit\` (Set SaaS Quota limits)\n`;
     endpointsContent += `- \`POST /management/tenant/assign\` (Dynamically initialize new Tenant DBs)\n`;
 
     endpointsContent += `\n## Open APIs (No JWT required)\n`;

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/devops.js

@@ -13,10 +13,15 @@ export const generateDeploymentArtifacts = async (config, projectRootDir) => {
     await fs.ensureDir(keycloakDir);
     await fs.ensureDir(githubDir);
 
+    const toKebabCase = (str) => {
+        if (!str) return '';
+        return str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+    };
     const appName = config.name || 'go-duck';
+    const k8sAppName = toKebabCase(appName);
     const parts = appName.split(/[-_]/);
     const shortName = (parts.length > 1 ? parts.map(w => w[0]).join('') : appName).substring(0, 10).toLowerCase() || 'goduck';
-    const appPort = config.server?.port || 8080;
+    const appPort = config.server?.rest?.port || 8080;
     const keycloakHost = config.security?.['keycloak-host'] || 'http://localhost:8180';
     const keycloakPort = keycloakHost.includes(':') ? keycloakHost.split(':').pop() : '8080';
 
@@ -75,9 +80,11 @@ FROM gcr.io/distroless/static-debian12
 WORKDIR /app
 
 COPY --from=builder /app/server .
+
 COPY --from=builder /app/application.yml .
 COPY --from=builder /app/application-dev.yml .
 COPY --from=builder /app/application-prod.yml .
+COPY --from=builder /app/docs/ /app/docs/
 
 EXPOSE ${appPort}
 ENV GO_PROFILE=prod
@@ -210,10 +217,26 @@ services:
       - GO_DUCK_DATASOURCE_PASSWORD=${config.datasource?.password || 'password'}
       - GO_DUCK_DATASOURCE_DATABASE=${config.datasource?.database || 'go_duck_master'}
       - GO_DUCK_DATASOURCE_PORT=5432
+      - GO_DUCK_DATASOURCE_MONGODB_ENABLED=${config.datasource?.mongodb?.enabled ? 'true' : 'false'}
+      - GO_DUCK_DATASOURCE_MONGODB_URI=mongodb://mongodb:27017
+      - GO_DUCK_DATASOURCE_MONGODB_DATABASE=${config.datasource?.mongodb?.database || 'goduck_document_store'}
       - GO_DUCK_CACHE_REDIS_HOST=redis:6379
+      - GO_DUCK_CACHE_REDIS_PASSWORD=${config.cache?.redis?.password || ''}
       - GO_DUCK_MESSAGING_MQTT_BROKER=tcp://mosquitto:1883
+      - GO_DUCK_MESSAGING_MQTT_USERNAME=${config.messaging?.mqtt?.username || 'dev_user'}
+      - GO_DUCK_MESSAGING_MQTT_PASSWORD=${config.messaging?.mqtt?.password || 'dev_password'}
       - GO_DUCK_TELEMETRY_OTEL_ENDPOINT=otel-collector:4317
       - GO_DUCK_ELASTICSEARCH_ADDRESSES=http://elasticsearch:9200
+      - GO_DUCK_ELASTICSEARCH_USERNAME=${config.elasticsearch?.username || 'elastic'}
+      - GO_DUCK_ELASTICSEARCH_PASSWORD=${config.elasticsearch?.password || 'changeme'}
+      - GO_DUCK_SECURITY_KEYCLOAK_HOST=http://keycloak:8080
+      - GO_DUCK_SECURITY_KEYCLOAK_REALM=${config.security?.['keycloak-realm'] || 'go-duck-realm'}
+      - GO_DUCK_SECURITY_KEYCLOAK_APP_CLIENT_ID=${config.security?.['keycloak-app-client-id'] || 'go-duck-app'}
+      - GO_DUCK_SECURITY_KEYCLOAK_SERVICE_CLIENT_ID=${config.security?.['keycloak-service-client-id'] || 'go-duck-service'}
+      - GO_DUCK_SECURITY_KEYCLOAK_SERVICE_SECRET=${config.security?.['keycloak-service-secret'] || 'service-secret-123'}
+      - GO_DUCK_STORAGE_MINIO_ENDPOINT=http://minio:9000
+      - GO_DUCK_STORAGE_MINIO_ACCESS_KEY=${config.storage?.minio?.['access-key'] || 'minioadmin'}
+      - GO_DUCK_STORAGE_MINIO_SECRET_KEY=${config.storage?.minio?.['secret-key'] || 'minioadmin'}
     restart: always
     networks:
       - go-duck-net
@@ -244,10 +267,26 @@ services:
       - GO_DUCK_DATASOURCE_PASSWORD=${config.datasource?.password || 'password'}
       - GO_DUCK_DATASOURCE_DATABASE=${config.datasource?.database || 'go_duck_master'}
       - GO_DUCK_DATASOURCE_PORT=5432
+      - GO_DUCK_DATASOURCE_MONGODB_ENABLED=${config.datasource?.mongodb?.enabled ? 'true' : 'false'}
+      - GO_DUCK_DATASOURCE_MONGODB_URI=mongodb://mongodb:27017
+      - GO_DUCK_DATASOURCE_MONGODB_DATABASE=${config.datasource?.mongodb?.database || 'goduck_document_store'}
       - GO_DUCK_CACHE_REDIS_HOST=redis:6379
+      - GO_DUCK_CACHE_REDIS_PASSWORD=${config.cache?.redis?.password || ''}
       - GO_DUCK_MESSAGING_MQTT_BROKER=tcp://mosquitto:1883
+      - GO_DUCK_MESSAGING_MQTT_USERNAME=${config.messaging?.mqtt?.username || 'dev_user'}
+      - GO_DUCK_MESSAGING_MQTT_PASSWORD=${config.messaging?.mqtt?.password || 'dev_password'}
       - GO_DUCK_TELEMETRY_OTEL_ENDPOINT=otel-collector:4317
       - GO_DUCK_ELASTICSEARCH_ADDRESSES=http://elasticsearch:9200
+      - GO_DUCK_ELASTICSEARCH_USERNAME=${config.elasticsearch?.username || 'elastic'}
+      - GO_DUCK_ELASTICSEARCH_PASSWORD=${config.elasticsearch?.password || 'changeme'}
+      - GO_DUCK_SECURITY_KEYCLOAK_HOST=http://keycloak:8080
+      - GO_DUCK_SECURITY_KEYCLOAK_REALM=${config.security?.['keycloak-realm'] || 'go-duck-realm'}
+      - GO_DUCK_SECURITY_KEYCLOAK_APP_CLIENT_ID=${config.security?.['keycloak-app-client-id'] || 'go-duck-app'}
+      - GO_DUCK_SECURITY_KEYCLOAK_SERVICE_CLIENT_ID=${config.security?.['keycloak-service-client-id'] || 'go-duck-service'}
+      - GO_DUCK_SECURITY_KEYCLOAK_SERVICE_SECRET=${config.security?.['keycloak-service-secret'] || 'service-secret-123'}
+      - GO_DUCK_STORAGE_MINIO_ENDPOINT=http://minio:9000
+      - GO_DUCK_STORAGE_MINIO_ACCESS_KEY=${config.storage?.minio?.['access-key'] || 'minioadmin'}
+      - GO_DUCK_STORAGE_MINIO_SECRET_KEY=${config.storage?.minio?.['secret-key'] || 'minioadmin'}
     depends_on:
       postgres:
         condition: service_healthy
@@ -436,21 +475,21 @@ echo "========================================="
     const k8sAppYaml = `apiVersion: apps/v1
 kind: Deployment
 metadata:
-  name: ${appName}
+  name: ${k8sAppName}
   labels:
-    app: ${appName}
+    app: ${k8sAppName}
 spec:
   replicas: 1
   selector:
     matchLabels:
-      app: ${appName}
+      app: ${k8sAppName}
   template:
     metadata:
       labels:
-        app: ${appName}
+        app: ${k8sAppName}
     spec:
       containers:
-        - name: ${appName}
+        - name: ${k8sAppName}
           image: ${appName}:latest
           env:
             - name: GO_PROFILE
@@ -458,7 +497,7 @@ spec:
             - name: GO_DUCK_SERVER_REST_PORT
               value: "${appPort}"
             - name: GO_DUCK_DATASOURCE_HOST
-              value: postgres.${shortName}-postgres-k8s.svc.cluster.local
+              value: postgres.${k8sAppName}-postgres-k8s.svc.cluster.local
             - name: GO_DUCK_DATASOURCE_USERNAME
               value: "${config.datasource?.username || 'postgres'}"
             - name: GO_DUCK_DATASOURCE_PASSWORD
@@ -467,18 +506,48 @@ spec:
               value: "${config.datasource?.database || 'go_duck_master'}"
             - name: GO_DUCK_DATASOURCE_PORT
               value: "5432"
+            - name: GO_DUCK_DATASOURCE_MONGODB_ENABLED
+              value: "${config.datasource?.mongodb?.enabled ? 'true' : 'false'}"
+            - name: GO_DUCK_DATASOURCE_MONGODB_URI
+              value: mongodb://mongodb.${k8sAppName}-mongodb-k8s.svc.cluster.local:27017
+            - name: GO_DUCK_DATASOURCE_MONGODB_DATABASE
+              value: "${config.datasource?.mongodb?.database || 'goduck_document_store'}"
             - name: GO_DUCK_CACHE_REDIS_HOST
-              value: redis.${shortName}-redis-k8s.svc.cluster.local:6379
+              value: redis.${k8sAppName}-redis-k8s.svc.cluster.local:6379
+            - name: GO_DUCK_CACHE_REDIS_PASSWORD
+              value: "${config.cache?.redis?.password || ''}"
             - name: GO_DUCK_MESSAGING_MQTT_BROKER
-              value: tcp://mosquitto.${shortName}-mosquitto-k8s.svc.cluster.local:1883
+              value: tcp://mosquitto.${k8sAppName}-mosquitto-k8s.svc.cluster.local:1883
+            - name: GO_DUCK_MESSAGING_MQTT_USERNAME
+              value: "${config.messaging?.mqtt?.username || 'dev_user'}"
+            - name: GO_DUCK_MESSAGING_MQTT_PASSWORD
+              value: "${config.messaging?.mqtt?.password || 'dev_password'}"
             - name: GO_DUCK_MESSAGING_NATS_URL
-              value: nats://nats.${shortName}-nats-k8s.svc.cluster.local:4222
+              value: nats://nats.${k8sAppName}-nats-k8s.svc.cluster.local:4222
             - name: GO_DUCK_TELEMETRY_OTEL_ENDPOINT
-              value: otel-collector.${shortName}-otel-collector-k8s.svc.cluster.local:4317
+              value: otel-collector.${k8sAppName}-otel-collector-k8s.svc.cluster.local:4317
             - name: GO_DUCK_ELASTICSEARCH_ADDRESSES
-              value: http://elasticsearch.${shortName}-elasticsearch-k8s.svc.cluster.local:9200
+              value: http://elasticsearch.${k8sAppName}-elasticsearch-k8s.svc.cluster.local:9200
+            - name: GO_DUCK_ELASTICSEARCH_USERNAME
+              value: "${config.elasticsearch?.username || 'elastic'}"
+            - name: GO_DUCK_ELASTICSEARCH_PASSWORD
+              value: "${config.elasticsearch?.password || 'changeme'}"
             - name: GO_DUCK_SECURITY_KEYCLOAK_HOST
-              value: http://keycloak.${shortName}-keycloak-k8s.svc.cluster.local:8080
+              value: http://keycloak.${k8sAppName}-keycloak-k8s.svc.cluster.local:8080
+            - name: GO_DUCK_SECURITY_KEYCLOAK_REALM
+              value: "${config.security?.['keycloak-realm'] || 'go-duck-realm'}"
+            - name: GO_DUCK_SECURITY_KEYCLOAK_APP_CLIENT_ID
+              value: "${config.security?.['keycloak-app-client-id'] || 'go-duck-app'}"
+            - name: GO_DUCK_SECURITY_KEYCLOAK_SERVICE_CLIENT_ID
+              value: "${config.security?.['keycloak-service-client-id'] || 'go-duck-service'}"
+            - name: GO_DUCK_SECURITY_KEYCLOAK_SERVICE_SECRET
+              value: "${config.security?.['keycloak-service-secret'] || 'service-secret-123'}"
+            - name: GO_DUCK_STORAGE_MINIO_ENDPOINT
+              value: "http://minio.${k8sAppName}-minio-k8s.svc.cluster.local:9000"
+            - name: GO_DUCK_STORAGE_MINIO_ACCESS_KEY
+              value: "${config.storage?.minio?.['access-key'] || 'minioadmin'}"
+            - name: GO_DUCK_STORAGE_MINIO_SECRET_KEY
+              value: "${config.storage?.minio?.['secret-key'] || 'minioadmin'}"
           ports:
             - name: http
               containerPort: ${appPort}
@@ -488,7 +557,7 @@ spec:
 apiVersion: v1
 kind: Service
 metadata:
-  name: ${appName}
+  name: ${k8sAppName}
 spec:
   type: NodePort
   ports:
@@ -501,7 +570,7 @@ spec:
       targetPort: grpc
       nodePort: 30090
   selector:
-    app: ${appName}
+    app: ${k8sAppName}
 `;
 
     const k8sPostgresYaml = `apiVersion: v1
@@ -939,7 +1008,7 @@ spec:
     await fs.writeFile(path.join(k8sDir, 'mosquitto.conf'), mosquittoConf);
     // Namespace calculation: unique namespace per service
     const applyNs = (yamlString, serviceName) => {
-        const nsName = `${shortName}-${serviceName}-k8s`;
+        const nsName = `${k8sAppName}-${serviceName}-k8s`;
         const nsBlock = `apiVersion: v1\nkind: Namespace\nmetadata:\n  name: ${nsName}\n---\n`;
         return nsBlock + yamlString.replace(/^metadata:$/gm, `metadata:\n  namespace: ${nsName}`);
     };
@@ -950,7 +1019,7 @@ spec:
     // We conditionally add minio if storage is enabled (or any blob provider), but for safety we'll just generate its namespace always.
     servicesList.push('minio');
 
-    const k8sNamespaceYaml = servicesList.map(svc => `apiVersion: v1\nkind: Namespace\nmetadata:\n  name: ${shortName}-${svc}-k8s`).join('\n---\n');
+    const k8sNamespaceYaml = servicesList.map(svc => `apiVersion: v1\nkind: Namespace\nmetadata:\n  name: ${k8sAppName}-${svc}-k8s`).join('\n---\n');
 
     await fs.writeFile(path.join(k8sDir, 'namespace.yaml'), k8sNamespaceYaml);
 

package/generators/docs.js

@@ -72,7 +72,7 @@ export const generateDocumentation = async (config, entities, outputDir, enums =
         entities: entities,
         enums: enums,
         openEntities: openEntities,
-        serverPort: config.server?.port || 8080,
+        serverPort: config.server?.rest?.port || 8080,
         grpcPort: grpcPort,
         mqttPort: mqttPort
     };

package/generators/mqtt-topics.js

@@ -0,0 +1,54 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+
+export const generateMQTTTopicsJSON = async (config, entities, outputDir) => {
+    const docsDir = path.join(outputDir, 'docs');
+    await fs.ensureDir(docsDir);
+
+    const jsonFilePath = path.join(docsDir, 'mqtt_topics.json5');
+    const needle = '// needle-mqtt-topics-add-below';
+
+    let content = '';
+    if (await fs.pathExists(jsonFilePath)) {
+        content = await fs.readFile(jsonFilePath, 'utf8');
+    } else {
+        content = `{
+  "topics": {
+    // Custom topics can be added here manually.
+    
+    ${needle}
+  }
+}`;
+    }
+
+    const topicPrefix = config.messaging?.mqtt?.['topic-prefix'] || 'go-duck/events';
+    let newEntries = '';
+
+    for (const entity of entities) {
+        const entityName = entity.name.toLowerCase();
+        const baseTopic = `${topicPrefix}/${entityName}`;
+
+        const createdTopic = `"${baseTopic}/created"`;
+        if (!content.includes(createdTopic)) {
+            newEntries += `    // Auto-generated topics for ${entity.name}\n`;
+            newEntries += `    ${createdTopic}: "Triggered when a new ${entity.name} is created.",\n`;
+            newEntries += `    "${baseTopic}/updated": "Triggered when an existing ${entity.name} is updated.",\n`;
+            newEntries += `    "${baseTopic}/deleted": "Triggered when a ${entity.name} is deleted.",\n\n`;
+        }
+    }
+
+    if (newEntries.length > 0) {
+        if (content.includes(needle)) {
+            content = content.replace(needle, newEntries + `    ${needle}`);
+        } else {
+            // Fallback if needle is missing somehow
+            content = content.replace(/}\s*}$/, `,\n${newEntries}\n  }\n}`);
+        }
+        
+        await fs.writeFile(jsonFilePath, content);
+        console.log(chalk.gray('  Updated MQTT Topics Dictionary: mqtt_topics.json5'));
+    } else {
+        console.log(chalk.gray('  MQTT Topics Dictionary up to date.'));
+    }
+};

package/generators/postman.js

@@ -4,6 +4,9 @@ import chalk from 'chalk';
 
 export const generatePostmanCollection = async (config, entities, outputDir, openEntities = []) => {
     const docsDir = path.join(outputDir, 'docs');
+    const apiPrefixRaw = config.server?.rest?.['api-path-prefix'] || '/api';
+    const apiPrefix = apiPrefixRaw.endsWith('/') ? apiPrefixRaw.slice(0, -1) : apiPrefixRaw;
+    const apiPathArr = apiPrefix.split('/').filter(p => p !== '');
     await fs.ensureDir(docsDir);
 
     const collection = {
@@ -15,7 +18,7 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
         item: [],
         variable: [
             { key: "host", value: "localhost", type: "string" },
-            { key: "port", value: String(config.server?.port || 8080), type: "string" },
+            { key: "port", value: String(config.server?.rest?.port || 8080), type: "string" },
             { key: "tenant", value: "tenant_1", type: "string" },
             { key: "token", value: "", type: "string" },
             { key: "keycloak_url", value: config.security?.['keycloak-host'] || "http://localhost:8180", type: "string" },
@@ -140,11 +143,11 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                         { key: "X-Tenant-ID", value: "{{tenant}}" }
                     ],
                     url: {
-                        raw: "http://{{host}}:{{port}}/api/admin/audit",
+                        raw: `http://{{host}}:{{port}}${apiPrefix}/admin/audit`,
                         protocol: "http",
                         host: ["{{host}}"],
                         port: "{{port}}",
-                        path: ["api", "admin", "audit"]
+                        path: [...apiPathArr, "admin", "audit"]
                     }
                 }
             },
@@ -157,11 +160,11 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                         { key: "X-Tenant-ID", value: "{{tenant}}" }
                     ],
                     url: {
-                        raw: "http://{{host}}:{{port}}/api/metering/usage",
+                        raw: `http://{{host}}:{{port}}${apiPrefix}/metering/usage`,
                         protocol: "http",
                         host: ["{{host}}"],
                         port: "{{port}}",
-                        path: ["api", "metering", "usage"]
+                        path: [...apiPathArr, "metering", "usage"]
                     }
                 }
             }
@@ -361,8 +364,9 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
             else if (f.type === 'Float' || f.type === 'BigDecimal') obj[f.name] = 99.99;
             else if (f.type === 'Boolean') obj[f.name] = true;
             else if (f.type === 'LocalDate') obj[f.name] = "2024-01-01";
-            else if (f.type === 'Instant') obj[f.name] = "2024-01-01T12:00:00Z";
+            else if (f.type === 'Instant' || f.type === 'DateTime' || f.type === 'Datetime') obj[f.name] = "2024-01-01T12:00:00Z";
             else if (f.type === 'JSON' || f.type === 'JSONB') obj[f.name] = {"attribute": "example_value"};
+            else if (f.isEnum) obj[f.name] = "ACTIVE"; // Safe fallback for enums
             else obj[f.name] = "test";
         }
         return JSON.stringify(obj, null, 2);
@@ -390,7 +394,7 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                 request: {
                     method: "GET",
                     header: [ { key: "X-Tenant-ID", value: "{{tenant}}" } ],
-                    url: { raw: `http://{{host}}:{{port}}/open/api/${name}s?page=1&size=10&eager=true&sort=id,asc`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["open", "api", `${name}s`], query: [ { key: "page", value: "1" }, { key: "size", value: "10" }, { key: "eager", value: "true" }, { key: "sort", value: "id,asc" } ] }
+                    url: { raw: `http://{{host}}:{{port}}/open${apiPrefix}/${name}s?page=1&size=10&eager=true&sort=id,asc`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["open", ...apiPathArr, `${name}s`], query: [ { key: "page", value: "1" }, { key: "size", value: "10" }, { key: "eager", value: "true" }, { key: "sort", value: "id,asc" } ] }
                 }
             });
             publicItems.push({
@@ -398,7 +402,7 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                 request: {
                     method: "GET",
                     header: [ { key: "X-Tenant-ID", value: "{{tenant}}" } ],
-                    url: { raw: `http://{{host}}:{{port}}/open/api/${name}s/1`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["open", "api", `${name}s`, "1"] }
+                    url: { raw: `http://{{host}}:{{port}}/open${apiPrefix}/${name}s/1`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["open", ...apiPathArr, `${name}s`, "1"] }
                 }
             });
         }
@@ -409,7 +413,7 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                     method: "POST",
                     header: [ { key: "X-Tenant-ID", value: "{{tenant}}" }, { key: "Content-Type", value: "application/json" } ],
                     body: { mode: "raw", raw: generateDummyJson(entity.fields) },
-                    url: { raw: `http://{{host}}:{{port}}/open/api/${name}s`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["open", "api", `${name}s`] }
+                    url: { raw: `http://{{host}}:{{port}}/open${apiPrefix}/${name}s`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["open", ...apiPathArr, `${name}s`] }
                 }
             });
         }
@@ -425,7 +429,7 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                 request: {
                     method: "GET",
                     header: [ { key: "Authorization", value: "Bearer {{token}}" }, { key: "X-Tenant-ID", value: "{{tenant}}" } ],
-                    url: { raw: `http://{{host}}:{{port}}/api/${name}s?page=1&size=10&eager=true&sort=id,asc`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["api", `${name}s`], query: [ { key: "page", value: "1" }, { key: "size", value: "10" }, { key: "eager", value: "true" }, { key: "sort", value: "id,asc" } ] }
+                    url: { raw: `http://{{host}}:{{port}}${apiPrefix}/${name}s?page=1&size=10&eager=true&sort=id,asc`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: [...apiPathArr, `${name}s`], query: [ { key: "page", value: "1" }, { key: "size", value: "10" }, { key: "eager", value: "true" }, { key: "sort", value: "id,asc" } ] }
                 }
             },
             {
@@ -434,7 +438,7 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                     method: "POST",
                     header: [ { key: "Authorization", value: "Bearer {{token}}" }, { key: "X-Tenant-ID", value: "{{tenant}}" }, { key: "Content-Type", value: "application/json" } ],
                     body: { mode: "raw", raw: generateDummyJson(entity.fields) },
-                    url: { raw: `http://{{host}}:{{port}}/api/${name}s`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["api", `${name}s`] }
+                    url: { raw: `http://{{host}}:{{port}}${apiPrefix}/${name}s`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: [...apiPathArr, `${name}s`] }
                 }
             },
             {
@@ -442,7 +446,7 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                 request: {
                     method: "GET",
                     header: [ { key: "Authorization", value: "Bearer {{token}}" }, { key: "X-Tenant-ID", value: "{{tenant}}" } ],
-                    url: { raw: `http://{{host}}:{{port}}/api/${name}s/1`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["api", `${name}s`, "1"] }
+                    url: { raw: `http://{{host}}:{{port}}${apiPrefix}/${name}s/1`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: [...apiPathArr, `${name}s`, "1"] }
                 }
             },
             {
@@ -450,7 +454,7 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                 request: {
                     method: "GET",
                     header: [ { key: "Authorization", value: "Bearer {{token}}" }, { key: "X-Tenant-ID", value: "{{tenant}}" } ],
-                    url: { raw: `http://{{host}}:{{port}}/api/rpc/${name}?id=gt.0`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["api", "rpc", name], query: [ { key: "id", value: "gt.0" } ] }
+                    url: { raw: `http://{{host}}:{{port}}${apiPrefix}/rpc/${name}?id=gt.0`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: [...apiPathArr, "rpc", name], query: [ { key: "id", value: "gt.0" } ] }
                 }
             }
         ];
@@ -461,7 +465,7 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                 request: {
                     method: "GET",
                     header: [ { key: "Authorization", value: "Bearer {{token}}" }, { key: "X-Tenant-ID", value: "{{tenant}}" } ],
-                    url: { raw: `http://{{host}}:{{port}}/api/search/${name}?q=Sample`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: ["api", "search", name], query: [ { key: "q", value: "Sample" } ] }
+                    url: { raw: `http://{{host}}:{{port}}${apiPrefix}/search/${name}?q=Sample`, protocol: "http", host: ["{{host}}"], port: "{{port}}", path: [...apiPathArr, "search", name], query: [ { key: "q", value: "Sample" } ] }
                 }
             });
         }
@@ -513,11 +517,11 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                         ]
                     },
                     url: {
-                        raw: "http://{{host}}:{{port}}/api/storage/upload?provider=sftp",
+                        raw: `http://{{host}}:{{port}}${apiPrefix}/storage/upload?provider=sftp`,
                         protocol: "http",
                         host: ["{{host}}"],
                         port: "{{port}}",
-                        path: ["api", "storage", "upload"],
+                        path: [...apiPathArr, "storage", "upload"],
                         query: [{ key: "provider", value: "sftp" }]
                     }
                 }
@@ -531,11 +535,11 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                         { key: "X-Tenant-ID", value: "{{tenant}}" }
                     ],
                     url: {
-                        raw: "http://{{host}}:{{port}}/api/storage/download/farm/animals/photo.jpg?provider=sftp",
+                        raw: `http://{{host}}:{{port}}${apiPrefix}/storage/download/farm/animals/photo.jpg?provider=sftp`,
                         protocol: "http",
                         host: ["{{host}}"],
                         port: "{{port}}",
-                        path: ["api", "storage", "download", "farm", "animals", "photo.jpg"],
+                        path: [...apiPathArr, "storage", "download", "farm", "animals", "photo.jpg"],
                         query: [{ key: "provider", value: "sftp" }]
                     }
                 }
@@ -549,11 +553,11 @@ export const generatePostmanCollection = async (config, entities, outputDir, ope
                         { key: "X-Tenant-ID", value: "{{tenant}}" }
                     ],
                     url: {
-                        raw: "http://{{host}}:{{port}}/api/storage/scan/farm/animals/photo.jpg",
+                        raw: `http://{{host}}:{{port}}${apiPrefix}/storage/scan/farm/animals/photo.jpg`,
                         protocol: "http",
                         host: ["{{host}}"],
                         port: "{{port}}",
-                        path: ["api", "storage", "scan", "farm", "animals", "photo.jpg"]
+                        path: [...apiPathArr, "storage", "scan", "farm", "animals", "photo.jpg"]
                     }
                 }
             }

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);