@friggframework/devtools 2.0.0-next.60 → 2.0.0-next.62

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

@@ -1,362 +0,0 @@
-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

@@ -1,275 +0,0 @@
-# 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