@qwickapps/server 1.7.0 → 1.7.1

package/src/plugins/users/stores/in-memory-store.ts

@@ -0,0 +1,140 @@
+/**
+ * In-memory User Store for Demo/Testing
+ *
+ * Implements the UserStore interface with in-memory storage.
+ * Pre-populated with demo users for testing and showcase purposes.
+ */
+
+export function createInMemoryUserStore() {
+  const users = new Map<string, any>();
+  let idCounter = 1;
+
+  // Pre-populate demo users
+  const demoUsers = [
+    { email: 'demo@example.com', name: 'Demo User' },
+    { email: 'pro@example.com', name: 'Pro User' },
+    { email: 'enterprise@example.com', name: 'Enterprise User' },
+    { email: 'basic@example.com', name: 'Basic User' },
+  ];
+
+  demoUsers.forEach((u) => {
+    const id = String(idCounter++);
+    users.set(id, {
+      id,
+      email: u.email,
+      name: u.name,
+      created_at: new Date(),
+      updated_at: new Date(),
+    });
+  });
+
+  return {
+    name: 'in-memory',
+
+    async initialize() {
+      console.log('[InMemoryUserStore] Initialized with demo users');
+    },
+
+    async getById(id: string) {
+      return users.get(id) || null;
+    },
+
+    async getByEmail(email: string) {
+      for (const user of users.values()) {
+        if (user.email === email.toLowerCase()) {
+          return user;
+        }
+      }
+      return null;
+    },
+
+    async getByExternalId(externalId: string, provider: string) {
+      for (const user of users.values()) {
+        if (user.external_id === externalId && user.provider === provider) {
+          return user;
+        }
+      }
+      return null;
+    },
+
+    async create(input: any) {
+      const id = String(idCounter++);
+      const user = {
+        id,
+        email: input.email.toLowerCase(),
+        name: input.name || null,
+        external_id: input.external_id,
+        provider: input.provider,
+        picture: input.picture,
+        created_at: new Date(),
+        updated_at: new Date(),
+        metadata: input.metadata || {},
+      };
+      users.set(id, user);
+      return user;
+    },
+
+    async update(id: string, input: any) {
+      const user = users.get(id);
+      if (!user) return null;
+      Object.assign(user, input, { updated_at: new Date() });
+      return user;
+    },
+
+    async delete(id: string) {
+      return users.delete(id);
+    },
+
+    async search(params: any = {}) {
+      let result = Array.from(users.values());
+
+      if (params.query) {
+        const query = params.query.toLowerCase();
+        result = result.filter(
+          (u) =>
+            u.email.toLowerCase().includes(query) ||
+            (u.name && u.name.toLowerCase().includes(query))
+        );
+      }
+
+      if (params.provider) {
+        result = result.filter((u) => u.provider === params.provider);
+      }
+
+      const sortBy = params.sortBy || 'created_at';
+      const sortOrder = params.sortOrder || 'desc';
+      result.sort((a, b) => {
+        const aVal = a[sortBy];
+        const bVal = b[sortBy];
+        if (aVal < bVal) return sortOrder === 'asc' ? -1 : 1;
+        if (aVal > bVal) return sortOrder === 'asc' ? 1 : -1;
+        return 0;
+      });
+
+      const total = result.length;
+      const page = params.page || 1;
+      const limit = params.limit || 20;
+      const offset = (page - 1) * limit;
+      result = result.slice(offset, offset + limit);
+
+      return {
+        users: result,
+        total,
+        page,
+        limit,
+        totalPages: Math.ceil(total / limit),
+      };
+    },
+
+    async updateLastLogin(id: string) {
+      const user = users.get(id);
+      if (user) {
+        user.last_login_at = new Date();
+      }
+    },
+
+    async shutdown() {
+      console.log('[InMemoryUserStore] Shutdown');
+    },
+  };
+}

package/src/plugins/users/stores/index.ts

@@ -5,3 +5,4 @@
  */
 
 export { postgresUserStore } from './postgres-store.js';
+export { createInMemoryUserStore as inMemoryUserStore } from './in-memory-store.js';

package/src/testing/index.ts

@@ -0,0 +1 @@
+export { createPgMemPool } from './pg-mem-pool.js';

package/src/testing/pg-mem-pool.ts

@@ -0,0 +1,33 @@
+/**
+ * pg-mem Pool Adapter
+ *
+ * Provides a pg.Pool-compatible interface for pg-mem (in-memory PostgreSQL).
+ * Used by demos to run without requiring an actual PostgreSQL installation.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import { newDb } from 'pg-mem';
+
+/**
+ * Create an in-memory PostgreSQL database with a Pool-compatible interface
+ *
+ * @returns Pool-compatible interface backed by pg-mem
+ */
+export function createPgMemPool() {
+  const db = newDb();
+
+  // Get the Pool-compatible adapter from pg-mem
+  const { Pool } = db.adapters.createPg();
+  const pool = new Pool();
+
+  // Add a fake connection string for plugins that need it (like notifications)
+  // pg-mem doesn't use connection strings, but some plugins try to extract it
+  (pool as any).options = {
+    connectionString: 'postgresql://localhost/pgmem',
+  };
+
+  console.log('[pg-mem] In-memory PostgreSQL database created');
+
+  return pool;
+}

package/ui/src/api/controlPanelApi.ts

@@ -304,9 +304,18 @@ export interface WidgetContribution {
   title: string;
   /** Component name to render (matched by frontend widget registry) */
   component: string;
+  /**
+   * Widget type/category - determines which page(s) can display this widget
+   * - 'status': System health, service status, monitoring metrics (Dashboard)
+   * - 'maintenance': Operational tasks like seeding, service control, config (Maintenance page)
+   * - 'analytics': Charts, graphs, usage metrics (Dashboard or Analytics page)
+   * - 'monitoring': Performance, logs, real-time data (Monitoring page)
+   * - 'custom': Custom widgets for specific use cases
+   */
+  type: 'status' | 'maintenance' | 'analytics' | 'monitoring' | 'custom';
   /** Priority for ordering (lower = first, default: 100) */
   priority?: number;
-  /** Whether this widget is shown by default */
+  /** Whether this widget is shown by default on its designated page */
   showByDefault?: boolean;
   pluginId: string;
 }

package/ui/src/dashboard/PluginWidgetRenderer.tsx

@@ -19,12 +19,15 @@ interface WidgetContribution {
   id: string;
   title: string;
   component: string;
+  type: 'status' | 'maintenance' | 'analytics' | 'monitoring' | 'custom';
   priority?: number;
   showByDefault?: boolean;
   pluginId: string;
 }
 
 interface PluginWidgetRendererProps {
+  /** Filter widgets by type (e.g., 'status' for dashboard, 'maintenance' for maintenance page) */
+  widgetType?: 'status' | 'maintenance' | 'analytics' | 'monitoring' | 'custom';
   /** Only show widgets marked as showByDefault (default: true) */
   defaultOnly?: boolean;
   /** Additional widget IDs to show (beyond showByDefault) */
@@ -35,6 +38,7 @@ interface PluginWidgetRendererProps {
  * Renders widgets from plugins that have registered them via the server API
  */
 export function PluginWidgetRenderer({
+  widgetType,
   defaultOnly = true,
   additionalWidgetIds = [],
 }: PluginWidgetRendererProps) {
@@ -78,6 +82,10 @@ export function PluginWidgetRenderer({
   // Filter widgets to show
   const visibleWidgets = widgets
     .filter(widget => {
+      // Filter by widget type if specified
+      if (widgetType && widget.type !== widgetType) {
+        return false;
+      }
       // Show if marked as default, or if in additionalWidgetIds
       if (defaultOnly) {
         return widget.showByDefault || additionalWidgetIds.includes(widget.id);

package/ui/src/dashboard/builtInWidgets.tsx

@@ -16,7 +16,13 @@ import {
   AuthStatusWidget,
   NotificationsStatsWidget,
   CMSStatusWidget,
-  CMSMaintenanceWidget
+  CMSMaintenanceWidget,
+  SeedManagementWidget,
+  ServiceControlWidget,
+  EnvironmentConfigWidget,
+  DatabaseOpsWidget,
+  LogsMaintenanceWidget,
+  CacheMaintenanceWidget,
 } from './widgets';
 import { PreferencesPage } from '../pages/PreferencesPage';
 import type { WidgetComponent } from './WidgetComponentRegistry';
@@ -32,6 +38,12 @@ export const builtInWidgetComponents: Record<string, React.ComponentType> = {
   NotificationsStatsWidget: NotificationsStatsWidget,
   CMSStatusWidget: CMSStatusWidget,
   CMSMaintenanceWidget: CMSMaintenanceWidget,
+  SeedManagementWidget: SeedManagementWidget,
+  ServiceControlWidget: ServiceControlWidget,
+  EnvironmentConfigWidget: EnvironmentConfigWidget,
+  DatabaseOpsWidget: DatabaseOpsWidget,
+  LogsMaintenanceWidget: LogsMaintenanceWidget,
+  CacheMaintenanceWidget: CacheMaintenanceWidget,
   PreferencesPage: PreferencesPage,
 };
 
@@ -50,6 +62,12 @@ export function getBuiltInWidgetComponents(): WidgetComponent[] {
     { name: 'NotificationsStatsWidget', component: NotificationsStatsWidget },
     { name: 'CMSStatusWidget', component: CMSStatusWidget },
     { name: 'CMSMaintenanceWidget', component: CMSMaintenanceWidget },
+    { name: 'SeedManagementWidget', component: SeedManagementWidget },
+    { name: 'ServiceControlWidget', component: ServiceControlWidget },
+    { name: 'EnvironmentConfigWidget', component: EnvironmentConfigWidget },
+    { name: 'DatabaseOpsWidget', component: DatabaseOpsWidget },
+    { name: 'LogsMaintenanceWidget', component: LogsMaintenanceWidget },
+    { name: 'CacheMaintenanceWidget', component: CacheMaintenanceWidget },
     { name: 'PreferencesPage', component: PreferencesPage },
   ];
 }

package/ui/src/dashboard/widgets/CacheMaintenanceWidget.tsx

@@ -0,0 +1,195 @@
+/**
+ * Cache Maintenance Widget
+ *
+ * Provides cache management operations:
+ * - View cache statistics
+ * - Clear cache (flush all keys)
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import { useState, useEffect } from 'react';
+import {
+  Card,
+  CardContent,
+  Typography,
+  Button,
+  Alert,
+  Box,
+  Dialog,
+  DialogTitle,
+  DialogContent,
+  DialogContentText,
+  DialogActions,
+  CircularProgress,
+  Chip,
+} from '@mui/material';
+import DeleteIcon from '@mui/icons-material/Delete';
+import RefreshIcon from '@mui/icons-material/Refresh';
+import CheckCircleIcon from '@mui/icons-material/CheckCircle';
+import ErrorIcon from '@mui/icons-material/Error';
+
+interface CacheStats {
+  connected: boolean;
+  keyCount: number;
+  usedMemory?: string;
+}
+
+export function CacheMaintenanceWidget() {
+  const [stats, setStats] = useState<CacheStats | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [flushing, setFlushing] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [success, setSuccess] = useState<string | null>(null);
+  const [confirmOpen, setConfirmOpen] = useState(false);
+
+  const fetchStats = async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const response = await fetch('/api/cache:default/stats');
+      if (!response.ok) {
+        if (response.status === 404) {
+          throw new Error('Cache plugin not configured');
+        }
+        throw new Error('Failed to fetch cache stats');
+      }
+      const data = await response.json();
+      setStats(data);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Failed to fetch cache stats');
+      setStats(null);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    fetchStats();
+  }, []);
+
+  const handleFlushCache = async () => {
+    setConfirmOpen(false);
+    setFlushing(true);
+    setError(null);
+    setSuccess(null);
+
+    try {
+      const response = await fetch('/api/cache:default/flush', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+      });
+
+      if (!response.ok) {
+        const data = await response.json();
+        throw new Error(data.error || 'Failed to flush cache');
+      }
+
+      const data = await response.json();
+      setSuccess(
+        data.message + (data.deletedCount !== undefined ? ` (${data.deletedCount} keys deleted)` : '')
+      );
+
+      // Refresh stats
+      await fetchStats();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Failed to flush cache');
+    } finally {
+      setFlushing(false);
+    }
+  };
+
+  return (
+    <Card>
+      <CardContent>
+        <Typography variant="h6" gutterBottom>
+          Cache Management
+        </Typography>
+        <Typography variant="body2" color="text.secondary" sx={{ mb: 2 }}>
+          View cache statistics and clear cache
+        </Typography>
+
+        {error && (
+          <Alert severity="error" sx={{ mb: 2 }} onClose={() => setError(null)}>
+            {error}
+          </Alert>
+        )}
+
+        {success && (
+          <Alert severity="success" sx={{ mb: 2 }} onClose={() => setSuccess(null)}>
+            {success}
+          </Alert>
+        )}
+
+        {loading ? (
+          <Box sx={{ display: 'flex', justifyContent: 'center', p: 3 }}>
+            <CircularProgress size={30} />
+          </Box>
+        ) : stats ? (
+          <Box sx={{ mb: 2 }}>
+            <Box sx={{ display: 'flex', alignItems: 'center', gap: 1, mb: 1 }}>
+              <Typography variant="body2" color="text.secondary">
+                <strong>Status:</strong>
+              </Typography>
+              <Chip
+                size="small"
+                icon={stats.connected ? <CheckCircleIcon /> : <ErrorIcon />}
+                label={stats.connected ? 'Connected' : 'Disconnected'}
+                color={stats.connected ? 'success' : 'error'}
+              />
+            </Box>
+
+            <Typography variant="body2" color="text.secondary">
+              <strong>Key Count:</strong> {stats.keyCount.toLocaleString()}
+            </Typography>
+
+            {stats.usedMemory && (
+              <Typography variant="body2" color="text.secondary">
+                <strong>Memory Used:</strong> {stats.usedMemory}
+              </Typography>
+            )}
+          </Box>
+        ) : null}
+
+        <Box sx={{ display: 'flex', gap: 1 }}>
+          <Button
+            variant="outlined"
+            color="primary"
+            size="small"
+            startIcon={<RefreshIcon />}
+            onClick={fetchStats}
+            disabled={loading}
+          >
+            Refresh
+          </Button>
+          <Button
+            variant="contained"
+            color="error"
+            size="small"
+            startIcon={flushing ? <CircularProgress size={16} color="inherit" /> : <DeleteIcon />}
+            onClick={() => setConfirmOpen(true)}
+            disabled={!stats || !stats.connected || flushing || loading}
+          >
+            Flush Cache
+          </Button>
+        </Box>
+
+        <Dialog open={confirmOpen} onClose={() => setConfirmOpen(false)}>
+          <DialogTitle>Flush Cache</DialogTitle>
+          <DialogContent>
+            <DialogContentText>
+              Are you sure you want to flush the cache? This will delete{' '}
+              {stats?.keyCount.toLocaleString()} keys. This action cannot be undone.
+            </DialogContentText>
+          </DialogContent>
+          <DialogActions>
+            <Button onClick={() => setConfirmOpen(false)}>Cancel</Button>
+            <Button onClick={handleFlushCache} color="error" variant="contained">
+              Flush
+            </Button>
+          </DialogActions>
+        </Dialog>
+      </CardContent>
+    </Card>
+  );
+}

package/ui/src/dashboard/widgets/DatabaseOpsWidget.tsx

@@ -0,0 +1,29 @@
+/**
+ * Database Operations Widget
+ *
+ * Provides database backup, restore, and maintenance operations.
+ * Part of the maintenance plugin.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import { Card, CardContent, Typography, Alert } from '@mui/material';
+
+export function DatabaseOpsWidget() {
+  return (
+    <Card>
+      <CardContent>
+        <Typography variant="h6" gutterBottom>
+          Database Operations
+        </Typography>
+        <Typography variant="body2" color="text.secondary" sx={{ mb: 2 }}>
+          Backup, restore, and maintain database
+        </Typography>
+
+        <Alert severity="info">
+          Database operations UI coming soon. This will allow you to backup and restore your database.
+        </Alert>
+      </CardContent>
+    </Card>
+  );
+}

package/ui/src/dashboard/widgets/EnvironmentConfigWidget.tsx

@@ -0,0 +1,29 @@
+/**
+ * Environment Configuration Widget
+ *
+ * Displays and allows editing environment variables.
+ * Part of the maintenance plugin.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import { Card, CardContent, Typography, Alert } from '@mui/material';
+
+export function EnvironmentConfigWidget() {
+  return (
+    <Card>
+      <CardContent>
+        <Typography variant="h6" gutterBottom>
+          Environment Configuration
+        </Typography>
+        <Typography variant="body2" color="text.secondary" sx={{ mb: 2 }}>
+          View and manage environment variables
+        </Typography>
+
+        <Alert severity="info">
+          Environment configuration UI coming soon. This will allow you to view and edit environment variables.
+        </Alert>
+      </CardContent>
+    </Card>
+  );
+}