@qwickapps/server 1.7.0 → 1.7.2

package/src/plugins/devices/index.ts

@@ -68,8 +68,6 @@ export {
 } from './token-utils.js';
 export type { DeviceTokenPair } from './token-utils.js';
 
-// UI Components
-export { DevicesStatusWidget } from './DevicesStatusWidget.js';
-export type { DevicesStatusWidgetProps } from './DevicesStatusWidget.js';
-export { DevicesManagementPage } from './DevicesManagementPage.js';
-export type { DevicesManagementPageProps } from './DevicesManagementPage.js';
+// UI Components are exported from main package index (@qwickapps/server)
+// Do NOT export here to avoid loading UI dependencies when importing plugins
+

package/src/plugins/entitlements/entitlements-plugin.ts

@@ -21,7 +21,9 @@ import type {
   EntitlementStats,
 } from './types.js';
 import type { AuthenticatedRequest } from '../auth/types.js';
-import { getCache, type CacheInstance } from '../cache-plugin.js';
+import { getCache, hasCache, type CacheInstance } from '../cache-plugin.js';
+import { hasPostgres, getPostgres } from '../postgres-plugin.js';
+import { postgresEntitlementSource } from './sources/index.js';
 
 // Plugin state
 let primarySource: EntitlementSource | null = null;
@@ -35,67 +37,103 @@ let cacheEnabled = true;
 let cacheVersion = 1;
 
 /**
- * Create the Entitlements plugin
+ * Create the Entitlements plugin with smart defaults
+ *
+ * Config is optional - plugin will use defaults and get dependencies from registry.
+ * Gracefully handles missing dependencies with clear log messages.
  */
-export function createEntitlementsPlugin(config: EntitlementsPluginConfig): Plugin {
-  const debug = config.debug || false;
-  // Routes are mounted under /api by the control panel, so don't include /api in prefix
-  const apiPrefix = config.api?.prefix || ''; // Framework adds /entitlements prefix automatically (empty string to avoid double slash)
-  const apiEnabled = config.api?.enabled !== false;
-  const enableWriteApi = config.api?.enableWrite !== false;
-
-  function log(message: string, data?: Record<string, unknown>) {
-    if (debug) {
-      console.log(`[EntitlementsPlugin] ${message}`, data || '');
+export function createEntitlementsPlugin(config: Partial<EntitlementsPluginConfig> = {}): Plugin {
+  function log(message: string, data?: Record<string, unknown>, isError = false) {
+    const prefix = '[EntitlementsPlugin]';
+    if (isError) {
+      console.error(`${prefix} ${message}`, data || '');
+    } else if (config.debug) {
+      console.log(`${prefix} ${message}`, data || '');
     }
   }
 
-  // Cache key helpers
-  const keys = {
-    entitlements: (email: string) => `${cacheKeyPrefix}user:${email.toLowerCase()}`,
-    mapping: (source: string, id: string) => `${cacheKeyPrefix}mapping:${source}:${id}`,
-  };
-
   return {
     id: 'entitlements',
     name: 'Entitlements',
     version: '1.0.0',
 
     async onStart(_pluginConfig: PluginConfig, registry: PluginRegistry): Promise<void> {
+      const logger = registry.getLogger('entitlements');
+
+      // Check for postgres in registry (needed for default source)
+      if (!hasPostgres()) {
+        logger.warn('No Database! Entitlements plugin disabled.');
+        registry.registerHealthCheck({
+          name: 'entitlements-source',
+          type: 'custom',
+          check: async () => ({
+            healthy: false,
+            details: {
+              error: 'PostgreSQL not available',
+              state: 'disabled',
+            },
+          }),
+        });
+        return;
+      }
+
+      // Smart defaults - get dependencies from registry
+      const source = config.source ?? postgresEntitlementSource({
+        pool: () => getPostgres().getPool(),
+        autoCreateTables: true,
+      });
+
+      const debug = config.debug ?? false;
+      const apiPrefix = config.api?.prefix ?? '/entitlements';
+      const apiEnabled = config.api?.enabled ?? true;
+      const enableWriteApi = config.api?.enableWrite ?? true;
+
       log('Starting entitlements plugin');
 
       // Initialize primary source
-      await config.source.initialize();
-      primarySource = config.source;
-      log('Primary source initialized', { source: config.source.name });
+      await source.initialize();
+      primarySource = source;
+      log('Primary source initialized', { source: source.name });
 
       // Initialize additional sources
       additionalSources = config.additionalSources || [];
-      for (const source of additionalSources) {
-        await source.initialize();
-        log('Additional source initialized', { source: source.name });
+      for (const additionalSource of additionalSources) {
+        await additionalSource.initialize();
+        log('Additional source initialized', { source: additionalSource.name });
       }
 
       // Store config
-      pluginConfig = config;
+      pluginConfig = { ...config, source, debug };
 
-      // Setup caching if enabled
+      // Setup caching if enabled and available
       cacheEnabled = config.cache?.enabled !== false;
       if (cacheEnabled) {
-        try {
-          const instanceName = config.cache?.instanceName || 'default';
-          cacheInstance = getCache(instanceName);
-          cacheKeyPrefix = config.cache?.keyPrefix || 'entitlements:';
-          cacheTtl = config.cache?.ttl || 300;
-          cacheMappingTtl = config.cache?.mappingTtl || cacheTtl * 2;
-          log('Cache configured', { instanceName, prefix: cacheKeyPrefix, ttl: cacheTtl });
-        } catch {
-          log('Cache not available, running without caching');
+        if (hasCache()) {
+          try {
+            const instanceName = config.cache?.instanceName || 'default';
+            cacheInstance = getCache(instanceName);
+            cacheKeyPrefix = config.cache?.keyPrefix || 'entitlements:';
+            cacheTtl = config.cache?.ttl || 300;
+            cacheMappingTtl = config.cache?.mappingTtl || cacheTtl * 2;
+            log('Cache configured', { instanceName, prefix: cacheKeyPrefix, ttl: cacheTtl });
+          } catch {
+            log('Cache instance not available, running without caching');
+            cacheEnabled = false;
+            cacheInstance = null;
+          }
+        } else {
+          log('Cache plugin not available, running without caching');
           cacheEnabled = false;
           cacheInstance = null;
         }
       }
 
+      // Cache key helpers
+      const keys = {
+        entitlements: (email: string) => `${cacheKeyPrefix}user:${email.toLowerCase()}`,
+        mapping: (sourceId: string, id: string) => `${cacheKeyPrefix}mapping:${sourceId}:${id}`,
+      };
+
       // Register health check
       registry.registerHealthCheck({
         name: 'entitlements-source',
@@ -104,8 +142,8 @@ export function createEntitlementsPlugin(config: EntitlementsPluginConfig): Plug
           try {
             // Use source's isHealthy() method if available (avoids API calls)
             // Otherwise just check that source is initialized
-            if (config.source.isHealthy) {
-              const healthy = await config.source.isHealthy();
+            if (source.isHealthy) {
+              const healthy = await source.isHealthy();
               return { healthy };
             }
             // Source is healthy if initialized (we got here means it started)
@@ -145,9 +183,9 @@ export function createEntitlementsPlugin(config: EntitlementsPluginConfig): Plug
             try {
               const sources = [
                 {
-                  name: config.source.name,
-                  description: config.source.description,
-                  readonly: config.source.readonly ?? false,
+                  name: source.name,
+                  description: source.description,
+                  readonly: source.readonly ?? false,
                   primary: true,
                 },
                 ...additionalSources.map((s) => ({
@@ -159,8 +197,8 @@ export function createEntitlementsPlugin(config: EntitlementsPluginConfig): Plug
               ];
 
               res.json({
-                readonly: config.source.readonly ?? false,
-                writeEnabled: enableWriteApi && !config.source.readonly,
+                readonly: source.readonly ?? false,
+                writeEnabled: enableWriteApi && !source.readonly,
                 cacheEnabled,
                 cacheTtl,
                 sources,
@@ -311,7 +349,7 @@ export function createEntitlementsPlugin(config: EntitlementsPluginConfig): Plug
         });
 
         // Write endpoints (grant/revoke) - only if enabled and source is writable
-        if (enableWriteApi && !config.source.readonly) {
+        if (enableWriteApi && !source.readonly) {
           // Grant entitlement
           registry.addRoute({
             method: 'post',

package/src/plugins/entitlements/index.ts

@@ -33,7 +33,7 @@ export {
 } from './entitlements-plugin.js';
 
 // Sources
-export { postgresEntitlementSource } from './sources/index.js';
+export { postgresEntitlementSource, inMemoryEntitlementSource } from './sources/index.js';
 
 // Types
 export type {
@@ -50,8 +50,6 @@ export type {
   EntitlementStats,
 } from './types.js';
 
-// UI Components
-export { EntitlementsStatusWidget } from './EntitlementsStatusWidget.js';
-export type { EntitlementsStatusWidgetProps } from './EntitlementsStatusWidget.js';
-export { EntitlementsManagementPage } from './EntitlementsManagementPage.js';
-export type { EntitlementsManagementPageProps } from './EntitlementsManagementPage.js';
+// UI Components are exported from main package index (@qwickapps/server)
+// Do NOT export here to avoid loading UI dependencies when importing plugins
+

package/src/plugins/entitlements/sources/in-memory-source.ts

@@ -0,0 +1,76 @@
+/**
+ * In-memory Entitlement Source for Demo/Testing
+ *
+ * Implements the EntitlementSource interface with in-memory storage.
+ * Pre-populated with demo data for testing and showcase purposes.
+ */
+
+import type { EntitlementSource, EntitlementDefinition } from '../types.js';
+
+export function createInMemoryEntitlementSource(): EntitlementSource {
+  const userEntitlements = new Map<string, string[]>();
+  const availableEntitlements: EntitlementDefinition[] = [
+    { id: '1', name: 'premium', category: 'subscription', description: 'Premium subscription tier' },
+    { id: '2', name: 'pro', category: 'subscription', description: 'Professional subscription tier' },
+    { id: '3', name: 'enterprise', category: 'subscription', description: 'Enterprise subscription tier' },
+    { id: '4', name: 'beta-access', category: 'features', description: 'Access to beta features' },
+    { id: '5', name: 'api-access', category: 'features', description: 'API access enabled' },
+    { id: '6', name: 'support-priority', category: 'support', description: 'Priority support access' },
+  ];
+
+  // Pre-populate some demo data
+  userEntitlements.set('demo@example.com', ['premium', 'api-access']);
+  userEntitlements.set('pro@example.com', ['pro', 'beta-access', 'api-access']);
+  userEntitlements.set('enterprise@example.com', ['enterprise', 'beta-access', 'api-access', 'support-priority']);
+
+  return {
+    name: 'in-memory',
+    description: 'In-memory entitlement source for demo/testing',
+    readonly: false,
+
+    async initialize() {
+      console.log('[InMemorySource] Initialized with demo data');
+    },
+
+    async getEntitlements(identifier: string): Promise<string[]> {
+      return userEntitlements.get(identifier.toLowerCase()) || [];
+    },
+
+    async getAllAvailable(): Promise<EntitlementDefinition[]> {
+      return availableEntitlements;
+    },
+
+    async getUsersWithEntitlement(entitlement: string) {
+      const emails: string[] = [];
+      userEntitlements.forEach((ents, email) => {
+        if (ents.includes(entitlement)) {
+          emails.push(email);
+        }
+      });
+      return { emails, total: emails.length };
+    },
+
+    async addEntitlement(identifier: string, entitlement: string) {
+      const email = identifier.toLowerCase();
+      const current = userEntitlements.get(email) || [];
+      if (!current.includes(entitlement)) {
+        current.push(entitlement);
+        userEntitlements.set(email, current);
+      }
+    },
+
+    async removeEntitlement(identifier: string, entitlement: string) {
+      const email = identifier.toLowerCase();
+      const current = userEntitlements.get(email) || [];
+      const index = current.indexOf(entitlement);
+      if (index > -1) {
+        current.splice(index, 1);
+        userEntitlements.set(email, current);
+      }
+    },
+
+    async shutdown() {
+      console.log('[InMemorySource] Shutdown');
+    },
+  };
+}

package/src/plugins/entitlements/sources/index.ts

@@ -7,3 +7,4 @@
  */
 
 export { postgresEntitlementSource } from './postgres-source.js';
+export { createInMemoryEntitlementSource as inMemoryEntitlementSource } from './in-memory-source.js';

package/src/plugins/entitlements/types.ts

@@ -200,10 +200,17 @@ export interface EntitlementsApiConfig {
 
 /**
  * Entitlements plugin configuration
+ *
+ * All properties are optional - plugin will use smart defaults:
+ * - source: Postgres entitlement source using registry's postgres instance
+ * - cache: Uses cache from registry if available
+ * - api.prefix: '/entitlements'
+ * - api.enabled: true
+ * - debug: false
  */
 export interface EntitlementsPluginConfig {
-  /** Primary entitlement source */
-  source: EntitlementSource;
+  /** Primary entitlement source (default: postgres source from registry) */
+  source?: EntitlementSource;
 
   /** Additional sources to query (results are merged) */
   additionalSources?: EntitlementSource[];

package/src/plugins/health-plugin.ts

@@ -39,6 +39,7 @@ export function createHealthPlugin(config: HealthPluginConfig): Plugin {
           id: 'service-health',
           title: 'Service Health',
           component: 'ServiceHealthWidget',
+          type: 'status',
           priority: 10,
           showByDefault: true,
           pluginId: 'health',

package/src/plugins/index.ts

@@ -93,6 +93,7 @@ export {
   linkUserIdentifiers,
   findOrCreateUser,
   postgresUserStore,
+  inMemoryUserStore,
 } from './users/index.js';
 export type {
   UsersPluginConfig,
@@ -111,7 +112,7 @@ export type {
 } from './users/index.js';
 
 // Tenants plugin (multi-tenant data isolation, depends on Users)
-export { createTenantsPlugin, getTenantStore, postgresTenantStore } from './tenants/index.js';
+export { createTenantsPlugin, getTenantStore, postgresTenantStore, inMemoryTenantStore } from './tenants/index.js';
 export type {
   TenantsPluginConfig,
   TenantStore,
@@ -139,6 +140,7 @@ export {
   unbanUser,
   listActiveBans,
   postgresBanStore,
+  inMemoryBanStore,
 } from './bans/index.js';
 export type {
   BansPluginConfig,
@@ -198,6 +200,7 @@ export {
   requireAnyEntitlement,
   requireAllEntitlements,
   postgresEntitlementSource,
+  inMemoryEntitlementSource,
 } from './entitlements/index.js';
 export type {
   EntitlementsPluginConfig,

package/src/plugins/logs-plugin.ts

@@ -7,7 +7,7 @@
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
 
-import { existsSync, readFileSync, statSync } from 'fs';
+import { existsSync, readFileSync, statSync, truncateSync, unlinkSync } from 'fs';
 import { resolve } from 'path';
 import type { Request, Response } from 'express';
 import type { Plugin, PluginConfig, PluginRegistry } from '../core/plugin-registry.js';
@@ -165,6 +165,60 @@ export function createLogsPlugin(config: LogsPluginConfig = {}): Plugin {
         },
       });
 
+      // Register /clear route (slug prefix added automatically by framework)
+      registry.addRoute({
+        method: 'post',
+        path: '/clear',
+        pluginId: 'logs',
+        handler: (req: Request, res: Response) => {
+          try {
+            const sources = getSources();
+            const sourceName = (req.body.source as string) || sources[0]?.name;
+            const source = sources.find((s) => s.name === sourceName);
+
+            if (!source) {
+              return res.status(404).json({ error: `Source "${sourceName}" not found` });
+            }
+
+            if (source.type !== 'file' || !source.path) {
+              return res.status(400).json({ error: 'Clear only available for file sources' });
+            }
+
+            const resolvedPath = resolve(source.path);
+            if (!existsSync(resolvedPath)) {
+              return res.status(404).json({ error: `Log file not found: ${source.path}` });
+            }
+
+            // Truncate the file (clear contents but keep file)
+            truncateSync(resolvedPath, 0);
+            logger.info(`Cleared log file: ${source.name} (${source.path})`);
+
+            return res.json({
+              success: true,
+              message: `Log file "${source.name}" cleared successfully`,
+              source: source.name,
+            });
+          } catch (error) {
+            logger.error('Failed to clear log file', { error });
+            return res.status(500).json({
+              error: 'Failed to clear log file',
+              message: error instanceof Error ? error.message : String(error),
+            });
+          }
+        },
+      });
+
+      // Register maintenance widget
+      registry.addWidget({
+        id: 'logs-maintenance',
+        title: 'Log Management',
+        component: 'LogsMaintenanceWidget',
+        type: 'maintenance',
+        priority: 50,
+        showByDefault: true,
+        pluginId: 'logs',
+      });
+
       const sources = getSources();
       logger.debug(`Logs plugin initialized with ${sources.length} sources`);
     },

package/src/plugins/maintenance-plugin.ts

@@ -362,22 +362,65 @@ export function createMaintenancePlugin(config: MaintenancePluginConfig = {}): P
         });
       }
 
+      // Register maintenance widgets
+      if (config.enableSeeds !== false) {
+        registry.addWidget({
+          id: 'seed-management',
+          title: 'Seed Management',
+          component: 'SeedManagementWidget',
+          type: 'maintenance',
+          priority: 10,
+          showByDefault: true, // Show by default on maintenance page
+          pluginId: 'maintenance',
+        });
+      }
+
       // TODO: Register service control routes
       if (config.enableServiceControl !== false) {
         logger.debug('Service control enabled');
         // Routes will be added in #703
+
+        registry.addWidget({
+          id: 'service-control',
+          title: 'Service Control',
+          component: 'ServiceControlWidget',
+          type: 'maintenance',
+          priority: 20,
+          showByDefault: false,
+          pluginId: 'maintenance',
+        });
       }
 
       // TODO: Register environment variable management routes
       if (config.enableEnvManagement !== false) {
         logger.debug('Environment variable management enabled');
         // Routes will be added in #704
+
+        registry.addWidget({
+          id: 'environment-config',
+          title: 'Environment Configuration',
+          component: 'EnvironmentConfigWidget',
+          type: 'maintenance',
+          priority: 30,
+          showByDefault: false,
+          pluginId: 'maintenance',
+        });
       }
 
       // TODO: Register database operation routes
       if (config.enableDatabaseOps !== false) {
         logger.debug('Database operations enabled');
         // Routes will be added in #705
+
+        registry.addWidget({
+          id: 'database-ops',
+          title: 'Database Operations',
+          component: 'DatabaseOpsWidget',
+          type: 'maintenance',
+          priority: 40,
+          showByDefault: false,
+          pluginId: 'maintenance',
+        });
       }
 
       // Register UI page

package/src/plugins/notifications/index.ts

@@ -90,8 +90,6 @@ export type {
   NotificationsManagerInterface,
 } from './types.js';
 
-// UI Components
-export { NotificationsStatusWidget } from './NotificationsStatusWidget.js';
-export { NotificationsManagementPage } from './NotificationsManagementPage.js';
-export type { NotificationsStatusWidgetProps } from './NotificationsStatusWidget.js';
-export type { NotificationsManagementPageProps } from './NotificationsManagementPage.js';
+// UI Components are exported from main package index (@qwickapps/server)
+// Do NOT export here to avoid loading UI dependencies when importing plugins
+

package/src/plugins/notifications/notifications-plugin.ts

@@ -96,7 +96,10 @@ function validateId(id: string | undefined, paramName: string): { valid: boolean
 }
 
 /**
- * Create the Notifications plugin
+ * Create the Notifications plugin with smart defaults
+ *
+ * Config is optional - plugin will use defaults and get dependencies from registry.
+ * Gracefully handles missing dependencies with clear log messages.
  *
  * @param config Plugin configuration
  * @returns Plugin instance
@@ -112,11 +115,7 @@ function validateId(id: string | undefined, paramName: string): { valid: boolean
  * });
  * ```
  */
-export function createNotificationsPlugin(config: NotificationsPluginConfig): Plugin {
-  const apiPrefix = config.api?.prefix || '/'; // Framework adds /notifications prefix automatically
-  const streamEnabled = config.api?.stream !== false;
-  const statsEnabled = config.api?.stats !== false;
-
+export function createNotificationsPlugin(config: Partial<NotificationsPluginConfig> = {}): Plugin {
   let manager: NotificationsManager | null = null;
 
   return {
@@ -129,10 +128,19 @@ export function createNotificationsPlugin(config: NotificationsPluginConfig): Pl
 
       // Check for postgres plugin dependency
       if (!hasPostgres()) {
-        throw new Error(
-          'Notifications plugin requires postgres plugin. ' +
-          'Please add createPostgresPlugin() before createNotificationsPlugin().'
-        );
+        logger.warn('No Database! Notifications plugin disabled.');
+        registry.registerHealthCheck({
+          name: 'notifications',
+          type: 'custom',
+          check: async () => ({
+            healthy: false,
+            details: {
+              error: 'PostgreSQL not available',
+              state: 'disabled',
+            },
+          }),
+        });
+        return;
       }
 
       // Get database connection string from postgres plugin
@@ -150,22 +158,43 @@ export function createNotificationsPlugin(config: NotificationsPluginConfig): Pl
       }
 
       if (!connectionString) {
-        throw new Error(
-          'Could not determine PostgreSQL connection string. ' +
-          'Ensure DATABASE_URL is set or postgres plugin was configured with a URL.'
-        );
+        logger.warn('Could not determine PostgreSQL connection string. Notifications plugin disabled.');
+        registry.registerHealthCheck({
+          name: 'notifications',
+          type: 'custom',
+          check: async () => ({
+            healthy: false,
+            details: {
+              error: 'Connection string not available',
+              state: 'disabled',
+            },
+          }),
+        });
+        return;
       }
 
+      // Smart defaults
+      const channels = config.channels ?? [];
+      const apiPrefix = config.api?.prefix ?? '/'; // Framework adds /notifications prefix automatically
+      const streamEnabled = config.api?.stream ?? true;
+      const statsEnabled = config.api?.stats ?? true;
+
       logger.debug('Initializing notifications manager', {
-        channels: config.channels,
+        channels: channels,
         heartbeatInterval: config.heartbeat?.interval,
       });
 
+      // Create full config with defaults for required fields
+      const fullConfig: NotificationsPluginConfig = {
+        ...config,
+        channels, // Required field with default
+      };
+
       // Create and initialize manager
       manager = new NotificationsManager(
         connectionString,
-        config.channels,
-        config,
+        channels,
+        fullConfig,
         logger
       );
 
@@ -182,7 +211,7 @@ export function createNotificationsPlugin(config: NotificationsPluginConfig): Pl
             healthy: health?.isHealthy ?? false,
             details: {
               connected: health?.isConnected,
-              channels: config.channels,
+              channels: channels,
               activeClients: manager?.getStats().currentConnections ?? 0,
               lastEventAt: health?.lastEventAt?.toISOString(),
               isReconnecting: health?.isReconnecting,
@@ -273,7 +302,7 @@ export function createNotificationsPlugin(config: NotificationsPluginConfig): Pl
             const stats = manager.getStats();
             res.json({
               ...stats,
-              channels: config.channels,
+              channels: channels,
               lastEventAt: stats.connectionHealth.lastEventAt?.toISOString(),
               lastReconnectionAt: stats.lastReconnectionAt?.toISOString(),
             });
@@ -378,6 +407,7 @@ export function createNotificationsPlugin(config: NotificationsPluginConfig): Pl
           id: 'notifications-stats',
           title: 'Notifications',
           component: 'NotificationsStatsWidget',
+          type: 'status',
           priority: 25, // After ServiceHealthWidget (10) and AuthStatusWidget (20)
           showByDefault: true,
           pluginId: 'notifications',

package/src/plugins/parental/index.ts

@@ -54,8 +54,6 @@ export { postgresParentalStore } from './stores/index.js';
 export { kidsAdapter } from './adapters/index.js';
 export type { KidsAdapterConfig } from './adapters/index.js';
 
-// UI Components
-export { ParentalStatusWidget } from './ParentalStatusWidget.js';
-export type { ParentalStatusWidgetProps } from './ParentalStatusWidget.js';
-export { ParentalManagementPage } from './ParentalManagementPage.js';
-export type { ParentalManagementPageProps } from './ParentalManagementPage.js';
+// UI Components are exported from main package index (@qwickapps/server)
+// Do NOT export here to avoid loading UI dependencies when importing plugins
+