@friggframework/devtools 2.0.0-next.29 → 2.0.0-next.30

package/management-ui/server/api/users.js

@@ -0,0 +1,362 @@
+import express from 'express'
+import path from 'path'
+import fs from 'fs-extra'
+import crypto from 'crypto'
+import { createStandardResponse, createErrorResponse, ERROR_CODES, asyncHandler } from '../utils/response.js'
+import { wsHandler } from '../websocket/handler.js'
+import simulationRouter from './users/simulation.js'
+import sessionsRouter from './users/sessions.js'
+
+const router = express.Router();
+
+// Mount sub-routes
+router.use('/simulation', simulationRouter);
+router.use('/sessions', sessionsRouter);
+
+// Helper to get users data file path
+async function getUsersFilePath() {
+    const dataDir = path.join(process.cwd(), '../../../backend/data');
+    await fs.ensureDir(dataDir);
+    return path.join(dataDir, 'dummy-users.json');
+}
+
+// Helper to load users
+async function loadUsers() {
+    try {
+        const filePath = await getUsersFilePath();
+        if (await fs.pathExists(filePath)) {
+            return await fs.readJson(filePath);
+        }
+        return { users: [] };
+    } catch (error) {
+        console.error('Error loading users:', error);
+        return { users: [] };
+    }
+}
+
+// Helper to save users
+async function saveUsers(data) {
+    const filePath = await getUsersFilePath();
+    await fs.writeJson(filePath, data, { spaces: 2 });
+}
+
+// Helper to generate dummy user data
+function generateDummyUser(data = {}) {
+    const id = data.id || crypto.randomBytes(16).toString('hex');
+    const firstName = data.firstName || 'Test';
+    const lastName = data.lastName || 'User';
+    const email = data.email || `user_${Date.now()}@example.com`;
+    
+    return {
+        id,
+        appUserId: data.appUserId || `app_user_${crypto.randomBytes(8).toString('hex')}`,
+        appOrgId: data.appOrgId || `app_org_${crypto.randomBytes(8).toString('hex')}`,
+        firstName,
+        lastName,
+        email,
+        username: data.username || email.split('@')[0],
+        avatar: data.avatar || `https://ui-avatars.com/api/?name=${firstName}+${lastName}`,
+        role: data.role || 'user',
+        status: data.status || 'active',
+        createdAt: data.createdAt || new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        metadata: data.metadata || {},
+        connections: data.connections || []
+    };
+}
+
+// Get all users
+router.get('/', async (req, res) => {
+    try {
+        const { page = 1, limit = 10, search, role, status } = req.query;
+        const data = await loadUsers();
+        let users = data.users || [];
+        
+        // Apply filters
+        if (search) {
+            const searchLower = search.toLowerCase();
+            users = users.filter(user => 
+                user.email.toLowerCase().includes(searchLower) ||
+                user.firstName.toLowerCase().includes(searchLower) ||
+                user.lastName.toLowerCase().includes(searchLower) ||
+                user.username.toLowerCase().includes(searchLower)
+            );
+        }
+        
+        if (role) {
+            users = users.filter(user => user.role === role);
+        }
+        
+        if (status) {
+            users = users.filter(user => user.status === status);
+        }
+        
+        // Pagination
+        const startIndex = (page - 1) * limit;
+        const endIndex = startIndex + parseInt(limit);
+        const paginatedUsers = users.slice(startIndex, endIndex);
+        
+        res.json({
+            users: paginatedUsers,
+            total: users.length,
+            page: parseInt(page),
+            limit: parseInt(limit),
+            totalPages: Math.ceil(users.length / limit)
+        });
+    } catch (error) {
+        res.status(500).json({
+            error: error.message,
+            details: 'Failed to fetch users'
+        });
+    }
+});
+
+// Get single user
+router.get('/:id', async (req, res) => {
+    const { id } = req.params;
+    
+    try {
+        const data = await loadUsers();
+        const user = data.users.find(u => u.id === id);
+        
+        if (!user) {
+            return res.status(404).json({
+                error: 'User not found'
+            });
+        }
+        
+        res.json(user);
+    } catch (error) {
+        res.status(500).json({
+            error: error.message,
+            details: 'Failed to fetch user'
+        });
+    }
+});
+
+// Create new user
+router.post('/', async (req, res) => {
+    try {
+        const userData = req.body;
+        const newUser = generateDummyUser(userData);
+        
+        const data = await loadUsers();
+        
+        // Check if email already exists
+        if (data.users.some(u => u.email === newUser.email)) {
+            return res.status(400).json({
+                error: 'Email already exists'
+            });
+        }
+        
+        data.users.push(newUser);
+        await saveUsers(data);
+        
+        // Broadcast user creation
+        wsHandler.broadcast('user-update', {
+            action: 'created',
+            user: newUser,
+            timestamp: new Date().toISOString()
+        });
+        
+        res.status(201).json(newUser);
+    } catch (error) {
+        res.status(500).json({
+            error: error.message,
+            details: 'Failed to create user'
+        });
+    }
+});
+
+// Update user
+router.put('/:id', async (req, res) => {
+    const { id } = req.params;
+    const updates = req.body;
+    
+    try {
+        const data = await loadUsers();
+        const userIndex = data.users.findIndex(u => u.id === id);
+        
+        if (userIndex === -1) {
+            return res.status(404).json({
+                error: 'User not found'
+            });
+        }
+        
+        // Update user
+        const updatedUser = {
+            ...data.users[userIndex],
+            ...updates,
+            id, // Prevent ID from being changed
+            updatedAt: new Date().toISOString()
+        };
+        
+        data.users[userIndex] = updatedUser;
+        await saveUsers(data);
+        
+        // Broadcast user update
+        wsHandler.broadcast('user-update', {
+            action: 'updated',
+            user: updatedUser,
+            timestamp: new Date().toISOString()
+        });
+        
+        res.json(updatedUser);
+    } catch (error) {
+        res.status(500).json({
+            error: error.message,
+            details: 'Failed to update user'
+        });
+    }
+});
+
+// Delete user
+router.delete('/:id', async (req, res) => {
+    const { id } = req.params;
+    
+    try {
+        const data = await loadUsers();
+        const userIndex = data.users.findIndex(u => u.id === id);
+        
+        if (userIndex === -1) {
+            return res.status(404).json({
+                error: 'User not found'
+            });
+        }
+        
+        const deletedUser = data.users[userIndex];
+        data.users.splice(userIndex, 1);
+        await saveUsers(data);
+        
+        // Broadcast user deletion
+        wsHandler.broadcast('user-update', {
+            action: 'deleted',
+            userId: id,
+            timestamp: new Date().toISOString()
+        });
+        
+        res.json({
+            status: 'success',
+            message: 'User deleted',
+            user: deletedUser
+        });
+    } catch (error) {
+        res.status(500).json({
+            error: error.message,
+            details: 'Failed to delete user'
+        });
+    }
+});
+
+// Bulk create users
+router.post('/bulk', async (req, res) => {
+    const { count = 10 } = req.body;
+    
+    try {
+        const data = await loadUsers();
+        const newUsers = [];
+        
+        for (let i = 0; i < count; i++) {
+            const user = generateDummyUser({
+                firstName: `Test${i + 1}`,
+                lastName: `User${i + 1}`,
+                email: `test.user${i + 1}_${Date.now()}@example.com`,
+                role: i % 3 === 0 ? 'admin' : 'user',
+                status: i % 5 === 0 ? 'inactive' : 'active',
+                appUserId: `app_user_test_${i + 1}`,
+                appOrgId: `app_org_${Math.floor(i / 5) + 1}` // Group users into orgs
+            });
+            newUsers.push(user);
+        }
+        
+        data.users.push(...newUsers);
+        await saveUsers(data);
+        
+        // Broadcast bulk creation
+        wsHandler.broadcast('user-update', {
+            action: 'bulk-created',
+            count: newUsers.length,
+            timestamp: new Date().toISOString()
+        });
+        
+        res.json({
+            status: 'success',
+            message: `Created ${count} dummy users`,
+            users: newUsers
+        });
+    } catch (error) {
+        res.status(500).json({
+            error: error.message,
+            details: 'Failed to create bulk users'
+        });
+    }
+});
+
+// Delete all users
+router.delete('/', async (req, res) => {
+    try {
+        await saveUsers({ users: [] });
+        
+        // Broadcast deletion
+        wsHandler.broadcast('user-update', {
+            action: 'all-deleted',
+            timestamp: new Date().toISOString()
+        });
+        
+        res.json({
+            status: 'success',
+            message: 'All users deleted'
+        });
+    } catch (error) {
+        res.status(500).json({
+            error: error.message,
+            details: 'Failed to delete all users'
+        });
+    }
+});
+
+// User statistics
+router.get('/stats/summary', async (req, res) => {
+    try {
+        const data = await loadUsers();
+        const users = data.users || [];
+        
+        const stats = {
+            total: users.length,
+            byRole: {},
+            byStatus: {},
+            recentlyCreated: 0,
+            recentlyUpdated: 0
+        };
+        
+        const now = new Date();
+        const dayAgo = new Date(now - 24 * 60 * 60 * 1000);
+        
+        users.forEach(user => {
+            // Count by role
+            stats.byRole[user.role] = (stats.byRole[user.role] || 0) + 1;
+            
+            // Count by status
+            stats.byStatus[user.status] = (stats.byStatus[user.status] || 0) + 1;
+            
+            // Count recently created
+            if (new Date(user.createdAt) > dayAgo) {
+                stats.recentlyCreated++;
+            }
+            
+            // Count recently updated
+            if (new Date(user.updatedAt) > dayAgo) {
+                stats.recentlyUpdated++;
+            }
+        });
+        
+        res.json(stats);
+    } catch (error) {
+        res.status(500).json({
+            error: error.message,
+            details: 'Failed to get user statistics'
+        });
+    }
+});
+
+export default router

package/management-ui/server/api-contract.md

@@ -0,0 +1,275 @@
+# Frigg Management UI API Contract
+
+## Overview
+This document defines the API contract for CLI-GUI communication in the Frigg Management UI, implementing Phase 1 requirements from RFC 0001.
+
+## Base Configuration
+- **Base URL**: `http://localhost:3001/api`
+- **WebSocket**: `ws://localhost:3001`
+- **Content-Type**: `application/json`
+- **Protocol**: REST API + WebSocket for real-time updates
+
+## Standard Response Format
+
+### Success Response
+```json
+{
+  "status": "success",
+  "data": any,
+  "message": string,
+  "timestamp": ISO8601
+}
+```
+
+### Error Response
+```json
+{
+  "status": "error",
+  "error": {
+    "code": string,
+    "message": string,
+    "details": any
+  },
+  "timestamp": ISO8601
+}
+```
+
+## API Endpoints
+
+### 1. Project Management
+#### GET /api/project/status
+Get current project status and configuration.
+
+**Response:**
+```json
+{
+  "status": "success",
+  "data": {
+    "name": "my-frigg-app",
+    "version": "1.0.0",
+    "friggVersion": "2.5.0",
+    "status": "running|stopped|starting|stopping",
+    "pid": number|null,
+    "uptime": number,
+    "port": number,
+    "environment": "development|staging|production",
+    "lastStarted": ISO8601|null
+  }
+}
+```
+
+#### POST /api/project/start
+Start the Frigg project.
+
+**Request:**
+```json
+{
+  "stage": "dev|staging|production",
+  "verbose": boolean,
+  "port": number
+}
+```
+
+#### POST /api/project/stop
+Stop the Frigg project.
+
+#### POST /api/project/restart
+Restart the Frigg project with optional new configuration.
+
+### 2. Integration Management
+#### GET /api/integrations
+List all available and installed integrations.
+
+**Response:**
+```json
+{
+  "status": "success",
+  "data": {
+    "installed": [
+      {
+        "id": string,
+        "name": string,
+        "displayName": string,
+        "version": string,
+        "description": string,
+        "status": "active|inactive|error",
+        "installedAt": ISO8601,
+        "configRequired": boolean
+      }
+    ],
+    "available": [
+      {
+        "name": string,
+        "displayName": string,
+        "description": string,
+        "version": string,
+        "category": string,
+        "documentation": string
+      }
+    ]
+  }
+}
+```
+
+#### POST /api/integrations/install
+Install a new integration.
+
+**Request:**
+```json
+{
+  "name": string,
+  "version": string,
+  "autoConfig": boolean
+}
+```
+
+#### DELETE /api/integrations/:id
+Uninstall an integration.
+
+#### PUT /api/integrations/:id/configure
+Configure an integration.
+
+**Request:**
+```json
+{
+  "config": Record<string, any>
+}
+```
+
+### 3. Environment Management
+#### GET /api/environment
+Get environment variables.
+
+**Response:**
+```json
+{
+  "status": "success",
+  "data": {
+    "variables": Record<string, string>,
+    "stage": "development|staging|production",
+    "source": "file|aws-parameter-store"
+  }
+}
+```
+
+#### PUT /api/environment
+Update environment variables.
+
+**Request:**
+```json
+{
+  "variables": Record<string, string>,
+  "stage": string,
+  "writeToFile": boolean
+}
+```
+
+### 4. User Management (Test/Development)
+#### GET /api/users
+Get test users for development.
+
+#### POST /api/users
+Create a test user.
+
+#### DELETE /api/users/:id
+Delete a test user.
+
+### 5. Connection Management
+#### GET /api/connections
+Get active connections and entities.
+
+#### POST /api/connections/:integration/test
+Test a connection for an integration.
+
+#### GET /api/connections/:integration/entities
+Get entities for a specific integration.
+
+### 6. CLI Interface
+#### POST /api/cli/execute
+Execute CLI commands from the GUI.
+
+**Request:**
+```json
+{
+  "command": string,
+  "args": string[],
+  "options": Record<string, any>
+}
+```
+
+#### GET /api/cli/commands
+Get available CLI commands.
+
+### 7. Logs and Monitoring
+#### GET /api/logs
+Get application logs.
+
+**Query Parameters:**
+- `limit`: number (default: 100)
+- `level`: "error|warn|info|debug"
+- `since`: ISO8601
+- `component`: string
+
+#### DELETE /api/logs
+Clear logs.
+
+## WebSocket Events
+
+### Connection Management
+- `connection` - Client connected
+- `disconnect` - Client disconnected
+- `error` - Connection error
+
+### Project Events
+- `project:status` - Project status changed
+- `project:logs` - New log entries
+- `project:error` - Project error occurred
+
+### Integration Events
+- `integrations:update` - Integration list changed
+- `integrations:install` - Integration installed
+- `integrations:uninstall` - Integration removed
+- `integrations:configure` - Integration configured
+
+### Environment Events
+- `environment:update` - Environment variables changed
+- `environment:sync` - Environment synced with remote
+
+### CLI Events
+- `cli:output` - CLI command output
+- `cli:complete` - CLI command completed
+- `cli:error` - CLI command error
+
+## Error Codes
+
+### General Errors
+- `INVALID_REQUEST` - Invalid request format
+- `UNAUTHORIZED` - Authentication required
+- `FORBIDDEN` - Insufficient permissions
+- `NOT_FOUND` - Resource not found
+- `INTERNAL_ERROR` - Server error
+
+### Project Errors
+- `PROJECT_NOT_FOUND` - No Frigg project found
+- `PROJECT_ALREADY_RUNNING` - Project is already running
+- `PROJECT_NOT_RUNNING` - Project is not running
+- `PROJECT_START_FAILED` - Failed to start project
+- `PROJECT_STOP_FAILED` - Failed to stop project
+
+### Integration Errors
+- `INTEGRATION_NOT_FOUND` - Integration not found
+- `INTEGRATION_ALREADY_INSTALLED` - Integration already installed
+- `INTEGRATION_INSTALL_FAILED` - Installation failed
+- `INTEGRATION_CONFIG_INVALID` - Invalid configuration
+
+### Environment Errors
+- `ENV_READ_FAILED` - Failed to read environment
+- `ENV_WRITE_FAILED` - Failed to write environment
+- `ENV_SYNC_FAILED` - Failed to sync with remote
+
+## Security Considerations
+- Local development only (no external network calls)
+- Environment variables properly masked in responses
+- File system access limited to project directory
+- Process management restricted to Frigg processes
+- WebSocket connections authenticated via session