@qwickapps/server 1.7.1 → 1.8.0

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

@@ -16,8 +16,9 @@ import type {
   PreferencesStore,
 } from './types.js';
 import type { AuthenticatedRequest } from '../auth/types.js';
-import { deepMerge } from './stores/postgres-store.js';
+import { deepMerge, postgresPreferencesStore } from './stores/postgres-store.js';
 import { MAX_PREFERENCES_SIZE, MAX_NESTING_DEPTH } from './types.js';
+import { hasPostgres, getPostgres } from '../postgres-plugin.js';
 
 /**
  * Check if an object exceeds maximum nesting depth
@@ -38,17 +39,18 @@ let currentStore: PreferencesStore | null = null;
 let pluginDefaults: Record<string, unknown> = {};
 
 /**
- * Create the Preferences plugin
+ * Create the Preferences 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 createPreferencesPlugin(config: PreferencesPluginConfig): 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 /preferences prefix automatically
-  const apiEnabled = config.api?.enabled !== false;
-
-  function log(message: string, data?: Record<string, unknown>) {
-    if (debug) {
-      console.log(`[PreferencesPlugin] ${message}`, data || '');
+export function createPreferencesPlugin(config: Partial<PreferencesPluginConfig> = {}): Plugin {
+  function log(message: string, data?: Record<string, unknown>, isError = false) {
+    const prefix = '[PreferencesPlugin]';
+    if (isError) {
+      console.error(`${prefix} ${message}`, data || '');
+    } else if (config.debug) {
+      console.log(`${prefix} ${message}`, data || '');
     }
   }
 
@@ -58,20 +60,62 @@ export function createPreferencesPlugin(config: PreferencesPluginConfig): Plugin
     version: '1.0.0',
 
     async onStart(_pluginConfig: PluginConfig, registry: PluginRegistry): Promise<void> {
-      log('Starting preferences plugin');
+      const logger = registry.getLogger('preferences');
 
       // Check for users plugin dependency
       if (!registry.hasPlugin('users')) {
-        throw new Error('Preferences plugin requires Users plugin to be loaded first');
+        logger.warn('Users plugin not loaded! Preferences plugin disabled.');
+        registry.registerHealthCheck({
+          name: 'preferences-store',
+          type: 'custom',
+          check: async () => ({
+            healthy: false,
+            details: {
+              error: 'Users plugin not available',
+              state: 'disabled',
+            },
+          }),
+        });
+        return;
+      }
+
+      // Check for postgres in registry
+      if (!hasPostgres()) {
+        logger.warn('No Database! Preferences plugin disabled.');
+        registry.registerHealthCheck({
+          name: 'preferences-store',
+          type: 'custom',
+          check: async () => ({
+            healthy: false,
+            details: {
+              error: 'PostgreSQL not available',
+              state: 'disabled',
+            },
+          }),
+        });
+        return;
       }
 
+      // Smart defaults - get dependencies from registry
+      const store = config.store ?? postgresPreferencesStore({
+        pool: () => getPostgres().getPool(),
+        autoCreateTables: true,
+      });
+
+      const debug = config.debug ?? false;
+      const apiPrefix = config.api?.prefix ?? '/'; // Framework adds /preferences prefix automatically
+      const apiEnabled = config.api?.enabled ?? true;
+      const defaults = config.defaults ?? {};
+
+      log('Starting preferences plugin');
+
       // Initialize the store (creates tables and RLS policies if needed)
-      await config.store.initialize();
+      await store.initialize();
       log('Preferences plugin migrations complete');
 
       // Store references for helper access
-      currentStore = config.store;
-      pluginDefaults = config.defaults || {};
+      currentStore = store;
+      pluginDefaults = defaults;
 
       // Register health check
       registry.registerHealthCheck({
@@ -105,7 +149,7 @@ export function createPreferencesPlugin(config: PreferencesPluginConfig): Plugin
                 return res.status(401).json({ error: 'Authentication required' });
               }
 
-              const stored = await config.store.get(userId);
+              const stored = await store.get(userId);
 
               // Merge with defaults (defaults as base, stored values override)
               const preferences = stored
@@ -153,7 +197,7 @@ export function createPreferencesPlugin(config: PreferencesPluginConfig): Plugin
                 return res.status(400).json({ error: 'Preferences object too deeply nested (max 10 levels)' });
               }
 
-              const updated = await config.store.update(userId, newPreferences);
+              const updated = await store.update(userId, newPreferences);
 
               // Merge with defaults for response
               const preferences = deepMerge(pluginDefaults, updated);
@@ -183,7 +227,7 @@ export function createPreferencesPlugin(config: PreferencesPluginConfig): Plugin
                 return res.status(401).json({ error: 'Authentication required' });
               }
 
-              await config.store.delete(userId);
+              await store.delete(userId);
 
               // Return 204 No Content (idempotent - success even if no row existed)
               res.status(204).send();
@@ -208,7 +252,9 @@ export function createPreferencesPlugin(config: PreferencesPluginConfig): Plugin
 
     async onStop(): Promise<void> {
       log('Stopping preferences plugin');
-      await config.store.shutdown();
+      if (currentStore) {
+        await currentStore.shutdown();
+      }
       currentStore = null;
       pluginDefaults = {};
       log('Preferences plugin stopped');

package/src/plugins/profiles/index.ts

@@ -48,8 +48,6 @@ export type {
 // Stores
 export { postgresProfileStore } from './stores/index.js';
 
-// UI Components
-export { ProfilesStatusWidget } from './ProfilesStatusWidget.js';
-export type { ProfilesStatusWidgetProps } from './ProfilesStatusWidget.js';
-export { ProfilesManagementPage } from './ProfilesManagementPage.js';
-export type { ProfilesManagementPageProps } from './ProfilesManagementPage.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/profiles/profiles-plugin.ts

@@ -20,6 +20,8 @@ import type {
   ContentFilterLevel,
   TimeRestrictionResult,
 } from './types.js';
+import { hasPostgres, getPostgres } from '../postgres-plugin.js';
+import { postgresProfileStore } from './stores/index.js';
 
 // Store instance for helper access
 let currentStore: ProfileStore | null = null;
@@ -66,17 +68,18 @@ function isWithinAllowedHours(start?: string, end?: string): boolean {
 }
 
 /**
- * Create the Profiles plugin
+ * Create the Profiles 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 createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
-  const debug = config.debug || false;
-  const maxProfilesPerUser = config.maxProfilesPerUser || 10;
-  const defaultFilterLevel = config.defaultFilterLevel || 'moderate';
-  const apiPrefix = config.api?.prefix || '/'; // Framework adds /profiles prefix automatically
-
-  function log(message: string, data?: Record<string, unknown>) {
-    if (debug) {
-      console.log(`[ProfilesPlugin] ${message}`, data || '');
+export function createProfilesPlugin(config: Partial<ProfilesPluginConfig> = {}): Plugin {
+  function log(message: string, data?: Record<string, unknown>, isError = false) {
+    const prefix = '[ProfilesPlugin]';
+    if (isError) {
+      console.error(`${prefix} ${message}`, data || '');
+    } else if (config.debug) {
+      console.log(`${prefix} ${message}`, data || '');
     }
   }
 
@@ -86,15 +89,45 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
     version: '1.0.0',
 
     async onStart(_pluginConfig: PluginConfig, registry: PluginRegistry): Promise<void> {
+      const logger = registry.getLogger('profiles');
+
+      // Check for postgres in registry
+      if (!hasPostgres()) {
+        logger.warn('No Database! Profiles plugin disabled.');
+        registry.registerHealthCheck({
+          name: 'profiles-store',
+          type: 'custom',
+          check: async () => ({
+            healthy: false,
+            details: {
+              error: 'PostgreSQL not available',
+              state: 'disabled',
+            },
+          }),
+        });
+        return;
+      }
+
+      // Smart defaults - get dependencies from registry
+      const store = config.store ?? postgresProfileStore({
+        pool: () => getPostgres().getPool(),
+        autoCreateTables: true,
+      });
+
+      const debug = config.debug ?? false;
+      const maxProfilesPerUser = config.maxProfilesPerUser ?? 10;
+      const defaultFilterLevel = config.defaultFilterLevel ?? 'moderate';
+      const apiPrefix = config.api?.prefix ?? '/profiles';
+
       log('Starting profiles plugin');
 
       // Initialize the store (creates tables if needed)
-      await config.store.initialize();
+      await store.initialize();
       log('Profiles plugin migrations complete');
 
       // Store references for helper access
-      currentStore = config.store;
-      currentConfig = config;
+      currentStore = store;
+      currentConfig = { ...config, store, debug, maxProfilesPerUser, defaultFilterLevel };
 
       // Register health check
       registry.registerHealthCheck({
@@ -102,7 +135,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
         type: 'custom',
         check: async () => {
           try {
-            await config.store.search({ limit: 1 });
+            await store.search({ limit: 1 });
             return {
               healthy: true,
               details: {
@@ -137,7 +170,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
                 sortOrder: (req.query.sortOrder as ProfileSearchParams['sortOrder']) || 'desc',
               };
 
-              const result = await config.store.search(params);
+              const result = await store.search(params);
               res.json(result);
             } catch (error) {
               console.error('[ProfilesPlugin] Search error:', error);
@@ -153,7 +186,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
           pluginId: 'profiles',
           handler: async (req: Request, res: Response) => {
             try {
-              const profile = await config.store.getById(req.params.id);
+              const profile = await store.getById(req.params.id);
               if (!profile) {
                 return res.status(404).json({ error: 'Profile not found' });
               }
@@ -196,14 +229,14 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
               }
 
               // Check profile limit
-              const currentCount = await config.store.getProfileCount(input.user_id);
+              const currentCount = await store.getProfileCount(input.user_id);
               if (currentCount >= maxProfilesPerUser) {
                 return res.status(400).json({
                   error: `Maximum profiles (${maxProfilesPerUser}) reached for this user`,
                 });
               }
 
-              const profile = await config.store.create(input);
+              const profile = await store.create(input);
               res.status(201).json(profile);
             } catch (error) {
               console.error('[ProfilesPlugin] Create profile error:', error);
@@ -235,7 +268,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
                 metadata: req.body.metadata,
               };
 
-              const profile = await config.store.update(req.params.id, input);
+              const profile = await store.update(req.params.id, input);
               if (!profile) {
                 return res.status(404).json({ error: 'Profile not found' });
               }
@@ -254,7 +287,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
           pluginId: 'profiles',
           handler: async (req: Request, res: Response) => {
             try {
-              const deleted = await config.store.delete(req.params.id);
+              const deleted = await store.delete(req.params.id);
               if (!deleted) {
                 return res.status(404).json({ error: 'Profile not found' });
               }
@@ -273,7 +306,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
           pluginId: 'profiles',
           handler: async (req: Request, res: Response) => {
             try {
-              const profiles = await config.store.listByUser(req.params.userId);
+              const profiles = await store.listByUser(req.params.userId);
               res.json({ profiles });
             } catch (error) {
               console.error('[ProfilesPlugin] List user profiles error:', error);
@@ -289,7 +322,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
           pluginId: 'profiles',
           handler: async (req: Request, res: Response) => {
             try {
-              const profile = await config.store.getDefaultProfile(req.params.userId);
+              const profile = await store.getDefaultProfile(req.params.userId);
               if (!profile) {
                 return res.status(404).json({ error: 'No default profile found' });
               }
@@ -308,17 +341,17 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
           pluginId: 'profiles',
           handler: async (req: Request, res: Response) => {
             try {
-              const profile = await config.store.getById(req.params.id);
+              const profile = await store.getById(req.params.id);
               if (!profile) {
                 return res.status(404).json({ error: 'Profile not found' });
               }
 
-              const success = await config.store.setDefaultProfile(req.params.id, profile.user_id);
+              const success = await store.setDefaultProfile(req.params.id, profile.user_id);
               if (!success) {
                 return res.status(500).json({ error: 'Failed to set default profile' });
               }
 
-              const updated = await config.store.getById(req.params.id);
+              const updated = await store.getById(req.params.id);
               res.json(updated);
             } catch (error) {
               console.error('[ProfilesPlugin] Set default profile error:', error);
@@ -334,7 +367,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
           pluginId: 'profiles',
           handler: async (req: Request, res: Response) => {
             try {
-              const profile = await config.store.getById(req.params.id);
+              const profile = await store.getById(req.params.id);
               if (!profile) {
                 return res.status(404).json({ error: 'Profile not found' });
               }
@@ -354,7 +387,7 @@ export function createProfilesPlugin(config: ProfilesPluginConfig): Plugin {
 
     async onStop(): Promise<void> {
       log('Stopping profiles plugin');
-      await config.store.shutdown();
+      if (currentStore) { await currentStore.shutdown(); };
       currentStore = null;
       currentConfig = null;
       log('Profiles plugin stopped');

package/src/plugins/profiles/types.ts

@@ -289,10 +289,17 @@ export interface ProfilesApiConfig {
 
 /**
  * Profiles plugin configuration
+ *
+ * All properties are optional - plugin will use smart defaults:
+ * - store: Postgres profile store using registry's postgres instance
+ * - maxProfilesPerUser: 10
+ * - defaultFilterLevel: 'moderate'
+ * - api.prefix: '/profiles'
+ * - debug: false
  */
 export interface ProfilesPluginConfig {
-  /** Profile storage backend */
-  store: ProfileStore;
+  /** Profile storage backend (default: postgres profile store from registry) */
+  store?: ProfileStore;
   /** Maximum profiles per user (default: 10) */
   maxProfilesPerUser?: number;
   /** Default content filter level (default: 'moderate') */

package/src/plugins/qwickbrain/index.ts

@@ -32,8 +32,6 @@ export type {
   MCPRateLimitConfig,
 } from './types.js';
 
-// UI Components
-export { QwickbrainStatusWidget } from './QwickbrainStatusWidget.js';
-export { QwickbrainManagementPage } from './QwickbrainManagementPage.js';
-export type { QwickbrainStatusWidgetProps } from './QwickbrainStatusWidget.js';
-export type { QwickbrainManagementPageProps } from './QwickbrainManagementPage.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/qwickbrain/qwickbrain-plugin.ts

@@ -530,6 +530,141 @@ export function createQwickBrainPlugin(config: QwickBrainPluginConfig): Plugin {
           },
         });
 
+        // POST /mcp/query - LLM Query endpoint (auth required, supports streaming)
+        registry.addRoute({
+          method: 'post',
+          path: `${apiPrefix}/query`,
+          pluginId: 'qwickbrain',
+          handler: async (req: Request, res: ExpressResponse) => {
+            // Check authentication
+            const authError = checkAuth(req);
+            if (authError) {
+              res.status(authError.status).json(authError.body);
+              return;
+            }
+
+            const user = getAuthenticatedUser(req);
+
+            // Check rate limits
+            const rateLimitError = checkRateLimits(user?.id);
+            if (rateLimitError) {
+              Object.entries(rateLimitError.headers).forEach(([key, value]) => {
+                res.setHeader(key, value);
+              });
+              res.status(rateLimitError.status).json(rateLimitError.body);
+              return;
+            }
+
+            try {
+              if (!connectionStatus.connected) {
+                res.status(503).json({
+                  error: 'QwickBrain not connected',
+                  details: connectionStatus.error,
+                });
+                return;
+              }
+
+              // Check if streaming is requested
+              const stream = req.query.stream === 'true';
+
+              // Build query string
+              const queryParams = new URLSearchParams();
+              if (stream) {
+                queryParams.set('stream', 'true');
+              }
+              const queryString = queryParams.toString();
+              const path = `/api/v1/query${queryString ? `?${queryString}` : ''}`;
+
+              log('LLM query', { userId: user?.id, streaming: stream, query: req.body.query });
+
+              if (stream) {
+                // Streaming mode: pipe SSE stream from QwickBrain to client
+                const url = `${config.qwickbrainUrl}${path}`;
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeout);
+
+                try {
+                  const fetchResponse = await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                      'Content-Type': 'application/json',
+                      'Accept': 'text/event-stream',
+                    },
+                    body: JSON.stringify(req.body),
+                    signal: controller.signal,
+                  });
+
+                  clearTimeout(timeoutId);
+
+                  if (!fetchResponse.ok) {
+                    res.status(fetchResponse.status).json({
+                      error: 'Query failed',
+                      status: fetchResponse.status,
+                    });
+                    return;
+                  }
+
+                  // Set SSE headers
+                  res.setHeader('Content-Type', 'text/event-stream');
+                  res.setHeader('Cache-Control', 'no-cache');
+                  res.setHeader('Connection', 'keep-alive');
+                  res.setHeader('X-Accel-Buffering', 'no');
+
+                  // Pipe the stream
+                  const reader = fetchResponse.body?.getReader();
+                  if (!reader) {
+                    res.status(500).json({ error: 'No response body' });
+                    return;
+                  }
+
+                  const decoder = new TextDecoder();
+
+                  while (true) {
+                    const { done, value } = await reader.read();
+                    if (done) break;
+                    const text = decoder.decode(value, { stream: true });
+                    res.write(text);
+                  }
+
+                  res.end();
+                } catch (error) {
+                  clearTimeout(timeoutId);
+                  throw error;
+                }
+              } else {
+                // Non-streaming mode: proxy JSON response
+                const response = await proxyToQwickBrain(
+                  config.qwickbrainUrl,
+                  path,
+                  {
+                    method: 'POST',
+                    body: req.body,
+                    timeout,
+                  }
+                );
+
+                if (!response.ok) {
+                  const errorText = await response.text();
+                  res.status(response.status).json({
+                    error: 'Query failed',
+                    details: errorText,
+                  });
+                  return;
+                }
+
+                const result = await response.json();
+                res.json(result);
+              }
+            } catch (error) {
+              log('Error executing query', { error: String(error) });
+              res.status(500).json({
+                error: 'Query execution failed',
+                details: error instanceof Error ? error.message : 'Unknown error',
+              });
+            }
+          },
+        });
+
         // GET /mcp/sse - Server-Sent Events endpoint for streaming (auth required)
         registry.addRoute({
           method: 'get',

package/src/plugins/rate-limit/index.ts

@@ -127,8 +127,6 @@ export type {
   CheckLimitOptions,
 } from './types.js';
 
-// UI Components
-export { RateLimitStatusWidget } from './RateLimitStatusWidget.js';
-export { RateLimitManagementPage } from './RateLimitManagementPage.js';
-export type { RateLimitStatusWidgetProps } from './RateLimitStatusWidget.js';
-export type { RateLimitManagementPageProps } from './RateLimitManagementPage.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/subscriptions/index.ts

@@ -50,8 +50,6 @@ export type {
 // Stores
 export { postgresSubscriptionsStore } from './stores/index.js';
 
-// UI Components
-export { SubscriptionsStatusWidget } from './SubscriptionsStatusWidget.js';
-export type { SubscriptionsStatusWidgetProps } from './SubscriptionsStatusWidget.js';
-export { SubscriptionsManagementPage } from './SubscriptionsManagementPage.js';
-export type { SubscriptionsManagementPageProps } from './SubscriptionsManagementPage.js';
+// UI Components are exported from main package index (@qwickapps/server)
+// Do NOT export here to avoid loading UI dependencies when importing plugins
+