kybernus 2.4.0 → 3.0.1

package/add-features/websocket/INSTRUCTIONS.md

@@ -0,0 +1,63 @@
+# WebSocket
+
+## Files generated
+
+- `websocket.ts` or `AppGateway.ts` in the root of `src/`
+
+## Install dependencies
+
+### Node.js Express
+```bash
+npm install ws
+npm install -D @types/ws
+```
+
+### NestJS (uses socket.io)
+```bash
+npm install @nestjs/websockets @nestjs/platform-socket.io socket.io
+```
+
+---
+
+## Integration
+
+### Node.js Express — update `app.ts` / `index.ts`:
+```typescript
+import http from 'http';
+import app from './app'; // your express app
+import { setupWebSocket } from './websocket';
+
+const server = http.createServer(app);
+setupWebSocket(server);
+
+server.listen(process.env.PORT || 3000, () => {
+  console.log(`Server running on port ${process.env.PORT || 3000}`);
+});
+```
+> ⚠️ Replace `app.listen(...)` with `server.listen(...)` — WebSocket requires the raw HTTP server.
+
+### NestJS — register the Gateway in your module:
+```typescript
+import { AppGateway } from './websocket'; // or AppGateway
+
+@Module({
+  providers: [AppGateway],
+})
+export class AppModule {}
+```
+
+---
+
+## Testing WebSocket connection
+
+```bash
+# Install wscat
+npm install -g wscat
+
+# Connect (Express)
+wscat -c ws://localhost:3000
+
+# Connect (NestJS / socket.io)
+# Use the socket.io client in the browser or:
+npm install -g socket.io-client
+```

package/add-features/websocket/java-spring.java

@@ -0,0 +1,60 @@
+package com.example.config;
+
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.socket.config.annotation.EnableWebSocket;
+import org.springframework.web.socket.config.annotation.WebSocketConfigurer;
+import org.springframework.web.socket.config.annotation.WebSocketHandlerRegistry;
+import org.springframework.web.socket.handler.TextWebSocketHandler;
+import org.springframework.web.socket.WebSocketSession;
+import org.springframework.web.socket.TextMessage;
+
+import java.util.Collections;
+import java.util.Set;
+import java.util.concurrent.ConcurrentHashMap;
+
+/**
+ * WebSocket configuration for Spring Boot.
+ * Generated by: kybernus add websocket
+ *
+ * WebSocket endpoint: ws://localhost:8080/ws
+ */
+@Configuration
+@EnableWebSocket
+public class WebSocketConfig implements WebSocketConfigurer {
+
+    @Override
+    public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
+        registry.addHandler(new AppWebSocketHandler(), "/ws")
+                .setAllowedOrigins("*");
+    }
+
+    static class AppWebSocketHandler extends TextWebSocketHandler {
+        private final Set<WebSocketSession> sessions = Collections.newSetFromMap(new ConcurrentHashMap<>());
+
+        @Override
+        public void afterConnectionEstablished(WebSocketSession session) throws Exception {
+            sessions.add(session);
+            session.sendMessage(new TextMessage("{\"event\":\"connected\",\"data\":\"Welcome!\"}"));
+        }
+
+        @Override
+        protected void handleTextMessage(WebSocketSession session, TextMessage message) throws Exception {
+            String payload = message.getPayload();
+            session.sendMessage(new TextMessage("{\"event\":\"echo\",\"data\":\"" + payload + "\"}"));
+        }
+
+        @Override
+        public void afterConnectionClosed(WebSocketSession session, org.springframework.web.socket.CloseStatus status) {
+            sessions.remove(session);
+        }
+
+        public void broadcast(String message) {
+            sessions.forEach(session -> {
+                try {
+                    session.sendMessage(new TextMessage(message));
+                } catch (Exception ignored) {
+                }
+            });
+        }
+    }
+}

package/add-features/websocket/nestjs.ts

@@ -0,0 +1,38 @@
+import {
+    WebSocketGateway,
+    WebSocketServer as WsServer,
+    SubscribeMessage,
+    MessageBody,
+    OnGatewayConnection,
+    OnGatewayDisconnect,
+} from '@nestjs/websockets';
+import { Server, Socket } from 'socket.io';
+
+@WebSocketGateway({
+    cors: {
+        origin: '*',
+    },
+})
+export class AppGateway implements OnGatewayConnection, OnGatewayDisconnect {
+    @WsServer()
+    server: Server;
+
+    handleConnection(client: Socket) {
+        console.log(`🔌 Client connected: ${client.id}`);
+        client.emit('connected', { message: 'Welcome!' });
+    }
+
+    handleDisconnect(client: Socket) {
+        console.log(`🔌 Client disconnected: ${client.id}`);
+    }
+
+    @SubscribeMessage('message')
+    handleMessage(@MessageBody() data: string): void {
+        console.log('📨 Received:', data);
+        this.server.emit('message', { event: 'echo', data });
+    }
+
+    broadcast(event: string, data: unknown): void {
+        this.server.emit(event, data);
+    }
+}

package/add-features/websocket/nodejs-express.ts

@@ -0,0 +1,38 @@
+import { Server } from 'http';
+import { WebSocketServer, WebSocket } from 'ws';
+
+let wss: WebSocketServer;
+
+export function setupWebSocket(server: Server): void {
+    wss = new WebSocketServer({ server });
+
+    wss.on('connection', (ws: WebSocket) => {
+        console.log('🔌 WebSocket client connected');
+
+        ws.on('message', (data) => {
+            const message = data.toString();
+            console.log('📨 Received:', message);
+
+            // Echo back to sender
+            ws.send(JSON.stringify({ event: 'echo', data: message }));
+        });
+
+        ws.on('close', () => {
+            console.log('🔌 WebSocket client disconnected');
+        });
+
+        ws.send(JSON.stringify({ event: 'connected', data: 'Welcome!' }));
+    });
+
+    console.log('🔌 WebSocket server ready');
+}
+
+export function broadcast(event: string, data: unknown): void {
+    if (!wss) return;
+    const payload = JSON.stringify({ event, data });
+    wss.clients.forEach((client) => {
+        if (client.readyState === WebSocket.OPEN) {
+            client.send(payload);
+        }
+    });
+}

package/add-features/websocket/python-fastapi.py

@@ -0,0 +1,41 @@
+"""
+WebSocket support for FastAPI.
+Apply by importing setup_websocket_routes(app) in your main.py.
+"""
+
+from fastapi import FastAPI, WebSocket, WebSocketDisconnect
+from typing import List
+
+
+class ConnectionManager:
+    def __init__(self):
+        self.active_connections: List[WebSocket] = []
+
+    async def connect(self, websocket: WebSocket):
+        await websocket.accept()
+        self.active_connections.append(websocket)
+
+    def disconnect(self, websocket: WebSocket):
+        self.active_connections.remove(websocket)
+
+    async def broadcast(self, message: str):
+        for connection in self.active_connections:
+            await connection.send_text(message)
+
+
+manager = ConnectionManager()
+
+
+def setup_websocket_routes(app: FastAPI) -> None:
+    @app.websocket("/ws")
+    async def websocket_endpoint(websocket: WebSocket):
+        await manager.connect(websocket)
+        try:
+            while True:
+                data = await websocket.receive_text()
+                await websocket.send_text(f"Echo: {data}")
+                await manager.broadcast(f"Client says: {data}")
+        except WebSocketDisconnect:
+            manager.disconnect(websocket)
+
+    print("🔌 WebSocket endpoint registered at /ws")

package/dist/cli/commands/add.d.ts

@@ -0,0 +1,11 @@
+/**
+ * add.ts
+ *
+ * `kybernus add [feature]` command.
+ * Adds an infrastructure feature (swagger, redis, websocket, husky, auth)
+ * to any project — Kybernus-generated or standalone.
+ * If `.kybernusrc.json` is not found, prompts for stack + architecture.
+ */
+import { Command } from 'commander';
+export declare const addCommand: Command;
+//# sourceMappingURL=add.d.ts.map

package/dist/cli/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBpC,eAAO,MAAM,UAAU,SA4EjB,CAAC"}

package/dist/cli/commands/add.js

@@ -0,0 +1,102 @@
+/**
+ * add.ts
+ *
+ * `kybernus add [feature]` command.
+ * Adds an infrastructure feature (swagger, redis, websocket, husky, auth)
+ * to any project — Kybernus-generated or standalone.
+ * If `.kybernusrc.json` is not found, prompts for stack + architecture.
+ */
+import { Command } from 'commander';
+import * as clack from '@clack/prompts';
+import color from 'picocolors';
+import { generateFeature, getSupportedFeatures, } from '../../core/features/feature-generator.js';
+import { readProjectConfig, exitIfCancelled, displayFeatureResult, handleGenerateError, promptArchitecture, } from '../utils/cli-helpers.js';
+const STACK_OPTIONS = [
+    { value: 'nodejs-express', label: 'Node.js Express' },
+    { value: 'nestjs', label: 'NestJS' },
+    { value: 'python-fastapi', label: 'Python FastAPI' },
+    { value: 'java-spring', label: 'Java Spring Boot' },
+    { value: 'nextjs', label: 'Next.js' },
+];
+export const addCommand = new Command('add')
+    .argument('[feature]', 'Feature to add (swagger, redis, websocket, husky, auth)')
+    .description('Add infrastructure features to your project')
+    .action(async (featureArg) => {
+    clack.intro(color.bgCyan(color.black(' kybernus add ')));
+    const cwd = process.cwd();
+    // Try to read project config — if not found, enter guided wizard mode
+    const config = await readProjectConfig(cwd, { requireExistence: false });
+    let stack;
+    let architecture;
+    if (config) {
+        stack = config.stack;
+        architecture = config.architecture;
+        clack.log.info(`Project: ${color.cyan(config.projectName)} (${color.white(stack)})`);
+    }
+    else {
+        clack.log.warn('No .kybernusrc.json found — this project was not generated by Kybernus.');
+        clack.log.info('No problem! Just tell us your stack so we can generate the right files.');
+        const selectedStack = await clack.select({
+            message: 'What is the stack of this project?',
+            options: STACK_OPTIONS,
+        });
+        exitIfCancelled(selectedStack);
+        stack = selectedStack;
+        architecture = await promptArchitecture();
+    }
+    // --- Resolve feature ---
+    const supported = getSupportedFeatures(stack);
+    if (supported.length === 0) {
+        clack.log.error(`No addable features available for stack "${stack}" yet.`);
+        clack.outro(color.red('Nothing added.'));
+        process.exit(0);
+    }
+    let feature = featureArg;
+    if (feature && !supported.includes(feature)) {
+        clack.log.warn(`Feature "${feature}" is not available for stack "${stack}".`);
+        clack.log.info(`Available: ${supported.join(', ')}`);
+        process.exit(1);
+    }
+    if (!feature) {
+        const selected = await clack.select({
+            message: 'Which feature do you want to add?',
+            options: supported.map((f) => ({
+                value: f,
+                label: FEATURE_LABELS[f],
+                hint: FEATURE_HINTS[f],
+            })),
+        });
+        exitIfCancelled(selected);
+        feature = selected;
+    }
+    // --- Generate ---
+    const spinner = clack.spinner();
+    spinner.start(`Adding ${color.cyan(feature)}...`);
+    try {
+        const result = await generateFeature(feature, stack, cwd, architecture);
+        spinner.stop(`${color.green('✅')} Feature "${color.cyan(feature)}" added!`);
+        displayFeatureResult(result);
+    }
+    catch (err) {
+        handleGenerateError(err, spinner);
+    }
+    clack.outro(color.green('Done! Follow the instructions file to complete the setup.'));
+});
+// ─────────────────────────────────────────────────────────────────
+// Feature metadata (labels/hints for the interactive picker)
+// ─────────────────────────────────────────────────────────────────
+const FEATURE_LABELS = {
+    swagger: 'Swagger / OpenAPI Docs',
+    redis: 'Redis Cache',
+    websocket: 'WebSocket Server',
+    husky: 'Husky + Commitlint',
+    auth: 'JWT Authentication',
+};
+const FEATURE_HINTS = {
+    swagger: 'Auto-generated API documentation at /api/docs',
+    redis: 'Redis client + docker-compose service',
+    websocket: 'Real-time WS/socket.io server setup',
+    husky: 'Git hooks for linting and conventional commits',
+    auth: 'JWT sign/verify, middleware, and password hashing + bcrypt',
+};
+//# sourceMappingURL=add.js.map

package/dist/cli/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/auth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * auth.ts
+ *
+ * `kybernus auth` command.
+ * Generates a complete, modular JWT authentication flow for the project.
+ * Works both in Kybernus-generated projects (reads .kybernusrc.json automatically)
+ * and in standalone projects (prompts for stack + architecture).
+ */
+import { Command } from 'commander';
+export declare const authCommand: Command;
+//# sourceMappingURL=auth.d.ts.map

package/dist/cli/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,eAAO,MAAM,WAAW,SAyDlB,CAAC"}

package/dist/cli/commands/auth.js

@@ -0,0 +1,71 @@
+/**
+ * auth.ts
+ *
+ * `kybernus auth` command.
+ * Generates a complete, modular JWT authentication flow for the project.
+ * Works both in Kybernus-generated projects (reads .kybernusrc.json automatically)
+ * and in standalone projects (prompts for stack + architecture).
+ */
+import { Command } from 'commander';
+import * as clack from '@clack/prompts';
+import color from 'picocolors';
+import { generateFeature } from '../../core/features/feature-generator.js';
+import { readProjectConfig, exitIfCancelled, promptArchitecture, displayFeatureResult, handleGenerateError, } from '../utils/cli-helpers.js';
+const STACK_OPTIONS = [
+    { value: 'nodejs-express', label: 'Node.js Express' },
+    { value: 'nestjs', label: 'NestJS' },
+    { value: 'python-fastapi', label: 'Python FastAPI' },
+    { value: 'java-spring', label: 'Java Spring Boot' },
+    { value: 'nextjs', label: 'Next.js' },
+];
+export const authCommand = new Command('auth')
+    .description('Add JWT authentication boilerplate to your project')
+    .action(async () => {
+    clack.intro(color.bgMagenta(color.black(' kybernus auth ')));
+    const cwd = process.cwd();
+    // Try to read project config; if not found, enter guided wizard mode
+    let config = await readProjectConfig(cwd, { requireExistence: false });
+    let stack;
+    let architecture;
+    if (config) {
+        // Kybernus project: all info is already known
+        stack = config.stack;
+        architecture = config.architecture;
+        clack.log.info(`Project: ${color.cyan(config.projectName)} (${color.white(stack)} / ${color.white(architecture)})`);
+    }
+    else {
+        // Standalone project: ask the user for stack + architecture
+        clack.log.warn('No .kybernusrc.json found — this project was not generated by Kybernus.');
+        clack.log.info('No problem! Answer a couple of questions so we can generate the right files.');
+        const selectedStack = await clack.select({
+            message: 'What is the stack of this project?',
+            options: STACK_OPTIONS,
+        });
+        exitIfCancelled(selectedStack);
+        stack = selectedStack;
+        architecture = await promptArchitecture();
+    }
+    // Confirm before writing
+    const confirm = await clack.confirm({
+        message: `Generate JWT auth for ${color.cyan(stack)} (${color.white(architecture)})?`,
+    });
+    exitIfCancelled(confirm);
+    if (!confirm) {
+        clack.cancel('Cancelled.');
+        process.exit(0);
+    }
+    // Generate
+    const spinner = clack.spinner();
+    spinner.start(`Adding JWT auth for ${color.cyan(stack)}...`);
+    try {
+        const result = await generateFeature('auth', stack, cwd, architecture);
+        spinner.stop(`${color.green('✅')} JWT authentication added!`);
+        displayFeatureResult(result);
+        clack.log.warn(`Don't forget to set ${color.yellow('JWT_SECRET')} in your .env file!`);
+    }
+    catch (err) {
+        handleGenerateError(err, spinner);
+    }
+    clack.outro(color.green('Done! Open AUTH.md for the integration guide.'));
+});
+//# sourceMappingURL=auth.js.map

package/dist/cli/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/cli/commands/auth.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/deploy.d.ts

@@ -0,0 +1,10 @@
+/**
+ * deploy.ts
+ *
+ * `kybernus deploy` command.
+ * Generates production-ready deployment configuration files for the chosen
+ * cloud provider. Works in Kybernus-generated projects and standalone projects.
+ */
+import { Command } from 'commander';
+export declare const deployCommand: Command;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/cli/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqCpC,eAAO,MAAM,aAAa,SA4FpB,CAAC"}

package/dist/cli/commands/deploy.js

@@ -0,0 +1,110 @@
+/**
+ * deploy.ts
+ *
+ * `kybernus deploy` command.
+ * Generates production-ready deployment configuration files for the chosen
+ * cloud provider. Works in Kybernus-generated projects and standalone projects.
+ */
+import { Command } from 'commander';
+import * as clack from '@clack/prompts';
+import color from 'picocolors';
+import { generateDeploy, isProviderSupported, } from '../../core/deploy/deploy-generator.js';
+import { readProjectConfig, exitIfCancelled, } from '../utils/cli-helpers.js';
+// ─────────────────────────────────────────────────────────────────
+// Metadata
+// ─────────────────────────────────────────────────────────────────
+const PROVIDER_OPTIONS = [
+    { value: 'vercel', label: 'Vercel', hint: 'Great for Next.js, Node.js, and Python — zero-config' },
+    { value: 'railway', label: 'Railway', hint: 'Supports all stacks — easy Postgres provisioning' },
+    { value: 'fly', label: 'Fly.io', hint: 'Supports all stacks — runs Docker containers globally' },
+    { value: 'render', label: 'Render', hint: 'Supports all stacks — generous free tier' },
+];
+const STACK_OPTIONS = [
+    { value: 'nodejs-express', label: 'Node.js Express' },
+    { value: 'nestjs', label: 'NestJS' },
+    { value: 'python-fastapi', label: 'Python FastAPI' },
+    { value: 'java-spring', label: 'Java Spring Boot' },
+    { value: 'nextjs', label: 'Next.js' },
+];
+// ─────────────────────────────────────────────────────────────────
+// Command
+// ─────────────────────────────────────────────────────────────────
+export const deployCommand = new Command('deploy')
+    .description('Generate deployment configuration files for cloud providers')
+    .action(async () => {
+    clack.intro(color.bgBlue(color.white(' kybernus deploy ')));
+    const cwd = process.cwd();
+    const config = await readProjectConfig(cwd, { requireExistence: false });
+    let stack;
+    if (config) {
+        stack = config.stack;
+        clack.log.info(`Project: ${color.cyan(config.projectName)} (${color.white(stack)})`);
+    }
+    else {
+        clack.log.warn('No .kybernusrc.json found — this project was not generated by Kybernus.');
+        clack.log.info('No problem! Just tell us your stack.');
+        const selectedStack = await clack.select({
+            message: 'What is the stack of this project?',
+            options: STACK_OPTIONS,
+        });
+        exitIfCancelled(selectedStack);
+        stack = selectedStack;
+    }
+    // --- Select provider ---
+    const supportedProviders = PROVIDER_OPTIONS.filter((p) => isProviderSupported(p.value, stack));
+    if (supportedProviders.length === 0) {
+        clack.log.error(`No supported cloud providers found for stack "${stack}".`);
+        process.exit(1);
+    }
+    const selectedProvider = await clack.select({
+        message: 'Which cloud provider do you want to deploy to?',
+        options: supportedProviders.map((p) => ({
+            value: p.value,
+            label: p.label,
+            hint: p.hint,
+        })),
+    });
+    exitIfCancelled(selectedProvider);
+    const provider = selectedProvider;
+    // --- Ask about Dockerfile (providers that use containers) ---
+    const PROVIDERS_WITH_DOCKERFILE = ['railway', 'fly', 'render'];
+    let includeDockerfile = false;
+    if (PROVIDERS_WITH_DOCKERFILE.includes(provider)) {
+        const dockerAnswer = await clack.confirm({
+            message: `Include a ${color.yellow('Dockerfile')}? ${color.dim('(skip if your project already has one)')}`,
+            initialValue: false,
+        });
+        exitIfCancelled(dockerAnswer);
+        includeDockerfile = dockerAnswer;
+    }
+    // --- Confirm ---
+    const confirm = await clack.confirm({
+        message: `Generate ${color.cyan(provider)} deployment config for ${color.cyan(stack)}?`,
+    });
+    exitIfCancelled(confirm);
+    if (!confirm) {
+        clack.cancel('Cancelled.');
+        process.exit(0);
+    }
+    // --- Generate ---
+    const spinner = clack.spinner();
+    spinner.start(`Generating ${color.cyan(provider)} config...`);
+    try {
+        const result = await generateDeploy(provider, stack, cwd, includeDockerfile);
+        spinner.stop(`${color.green('✅')} Deploy config generated!`);
+        clack.log.step('Files created:');
+        for (const file of result.copiedFiles) {
+            clack.log.info(`  ${color.dim('→')} ${file}`);
+        }
+        if (result.instructionsPath) {
+            clack.log.step(`📖 Deployment guide: ${color.yellow(result.instructionsPath)}`);
+        }
+    }
+    catch (err) {
+        spinner.stop();
+        clack.log.error(`❌ ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    clack.outro(color.green('Done! Open DEPLOY.md for the next steps.'));
+});
+//# sourceMappingURL=deploy.js.map

package/dist/cli/commands/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const doctorCommand: Command;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,aAAa,SA8GpB,CAAC"}