@qwickapps/server 1.6.1 → 1.7.1

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/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,
@@ -110,6 +111,24 @@ export type {
   StoredIdentifiers,
 } from './users/index.js';
 
+// Tenants plugin (multi-tenant data isolation, depends on Users)
+export { createTenantsPlugin, getTenantStore, postgresTenantStore, inMemoryTenantStore } from './tenants/index.js';
+export type {
+  TenantsPluginConfig,
+  TenantStore,
+  Tenant,
+  TenantType,
+  CreateTenantInput,
+  UpdateTenantInput,
+  TenantSearchParams,
+  TenantListResponse,
+  TenantMembership,
+  CreateTenantMembershipInput,
+  UpdateTenantMembershipInput,
+  TenantWithMembership,
+  PostgresTenantStoreConfig,
+} from './tenants/index.js';
+
 // Bans plugin (separate from Users, depends on Users)
 export {
   createBansPlugin,
@@ -121,6 +140,7 @@ export {
   unbanUser,
   listActiveBans,
   postgresBanStore,
+  inMemoryBanStore,
 } from './bans/index.js';
 export type {
   BansPluginConfig,
@@ -180,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/notifications-plugin.ts

@@ -378,6 +378,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/postgres-plugin.test.ts

@@ -118,12 +118,12 @@ describe('PostgreSQL Plugin', () => {
       expect(hasPostgres('test')).toBe(true);
     });
 
-    it('should log debug message on successful connection', async () => {
+    it('should log info message on successful connection', async () => {
       const plugin = createPostgresPlugin(mockConfig, 'test');
       await plugin.onStart({}, mockRegistry);
 
       const logger = mockRegistry.getLogger('postgres:test');
-      expect(logger.debug).toHaveBeenCalledWith(
+      expect(logger.info).toHaveBeenCalledWith(
         expect.stringContaining('connected')
       );
     });

package/src/plugins/postgres-plugin.ts

@@ -56,7 +56,10 @@ const { Pool } = pg;
  */
 export interface PostgresPluginConfig {
   /** Database connection URL (e.g., postgresql://user:pass@host:5432/db) */
-  url: string;
+  url?: string;
+
+  /** Pre-configured pg.Pool instance (alternative to url) */
+  pool?: pg.Pool;
 
   /** Maximum number of clients in the pool (default: 20) */
   maxConnections?: number;
@@ -193,14 +196,22 @@ export function createPostgresPlugin(
 
   const createInstance = (): PostgresInstance => {
     if (!pool) {
-      pool = new Pool({
-        connectionString: config.url,
-        max: config.maxConnections ?? 20,
-        min: config.minConnections ?? 2,
-        idleTimeoutMillis: config.idleTimeoutMs ?? 30000,
-        connectionTimeoutMillis: config.connectionTimeoutMs ?? 5000,
-        statement_timeout: config.statementTimeoutMs,
-      });
+      if (config.pool) {
+        // Use pre-configured pool (e.g., pg-mem for testing)
+        pool = config.pool;
+      } else if (config.url) {
+        // Create pool from URL
+        pool = new Pool({
+          connectionString: config.url,
+          max: config.maxConnections ?? 20,
+          min: config.minConnections ?? 2,
+          idleTimeoutMillis: config.idleTimeoutMs ?? 30000,
+          connectionTimeoutMillis: config.connectionTimeoutMs ?? 5000,
+          statement_timeout: config.statementTimeoutMs,
+        });
+      } else {
+        throw new Error('PostgresPluginConfig must have either url or pool');
+      }
 
       // Handle pool errors
       pool.on('error', (err) => {

package/src/plugins/tenants/index.ts

@@ -0,0 +1,31 @@
+/**
+ * Tenants Plugin
+ *
+ * Multi-tenant data isolation and organization management plugin.
+ * Provides CRUD operations for tenants and tenant memberships.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+// Plugin
+export { createTenantsPlugin, getTenantStore, autoCreateUserTenant } from './tenants-plugin.js';
+
+// Store implementations
+export { postgresTenantStore, inMemoryTenantStore } from './stores/index.js';
+
+// Types
+export type {
+  TenantType,
+  Tenant,
+  CreateTenantInput,
+  UpdateTenantInput,
+  TenantSearchParams,
+  TenantListResponse,
+  TenantMembership,
+  CreateTenantMembershipInput,
+  UpdateTenantMembershipInput,
+  TenantWithMembership,
+  TenantStore,
+  PostgresTenantStoreConfig,
+  TenantsPluginConfig,
+} from './types.js';