@qwickapps/server 1.1.9 → 1.3.0

package/dist/plugins/users/users-plugin.js

@@ -0,0 +1,242 @@
+/**
+ * Users Plugin
+ *
+ * User identity management plugin for @qwickapps/server.
+ * Provides CRUD operations, search, and user lookup functionality.
+ *
+ * Note: Ban management is handled by the separate Bans Plugin.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+// Store instance for helper access
+let currentStore = null;
+/**
+ * Create the Users plugin
+ */
+export function createUsersPlugin(config) {
+    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 || '/users';
+    function log(message, data) {
+        if (debug) {
+            console.log(`[UsersPlugin] ${message}`, data || '');
+        }
+    }
+    return {
+        id: 'users',
+        name: 'Users',
+        version: '1.0.0',
+        async onStart(_pluginConfig, registry) {
+            log('Starting users plugin');
+            // Initialize the store (creates tables if needed)
+            await config.store.initialize();
+            log('Users plugin migrations complete');
+            // Store reference for helper access
+            currentStore = config.store;
+            // Register health check
+            registry.registerHealthCheck({
+                name: 'users-store',
+                type: 'custom',
+                check: async () => {
+                    try {
+                        // Simple health check - try to search with limit 1
+                        await config.store.search({ limit: 1 });
+                        return { healthy: true };
+                    }
+                    catch {
+                        return { healthy: false };
+                    }
+                },
+            });
+            // Add API routes if enabled
+            if (config.api?.crud !== false) {
+                // List/Search users
+                registry.addRoute({
+                    method: 'get',
+                    path: apiPrefix,
+                    pluginId: 'users',
+                    handler: async (req, res) => {
+                        try {
+                            const params = {
+                                query: req.query.q,
+                                provider: req.query.provider,
+                                page: parseInt(req.query.page) || 1,
+                                limit: Math.min(parseInt(req.query.limit) || 20, 100),
+                                sortBy: req.query.sortBy || 'created_at',
+                                sortOrder: req.query.sortOrder || 'desc',
+                            };
+                            const result = await config.store.search(params);
+                            res.json(result);
+                        }
+                        catch (error) {
+                            console.error('[UsersPlugin] Search error:', error);
+                            res.status(500).json({ error: 'Failed to search users' });
+                        }
+                    },
+                });
+                // Get user by ID
+                registry.addRoute({
+                    method: 'get',
+                    path: `${apiPrefix}/:id`,
+                    pluginId: 'users',
+                    handler: async (req, res) => {
+                        try {
+                            const user = await config.store.getById(req.params.id);
+                            if (!user) {
+                                return res.status(404).json({ error: 'User not found' });
+                            }
+                            res.json(user);
+                        }
+                        catch (error) {
+                            console.error('[UsersPlugin] Get user error:', error);
+                            res.status(500).json({ error: 'Failed to get user' });
+                        }
+                    },
+                });
+                // Create user
+                registry.addRoute({
+                    method: 'post',
+                    path: apiPrefix,
+                    pluginId: 'users',
+                    handler: async (req, res) => {
+                        try {
+                            const input = {
+                                email: req.body.email,
+                                name: req.body.name,
+                                external_id: req.body.external_id,
+                                provider: req.body.provider,
+                                picture: req.body.picture,
+                                metadata: req.body.metadata,
+                            };
+                            if (!input.email) {
+                                return res.status(400).json({ error: 'Email is required' });
+                            }
+                            // Check if user already exists
+                            const existing = await config.store.getByEmail(input.email);
+                            if (existing) {
+                                return res.status(409).json({ error: 'User with this email already exists' });
+                            }
+                            const user = await config.store.create(input);
+                            res.status(201).json(user);
+                        }
+                        catch (error) {
+                            console.error('[UsersPlugin] Create user error:', error);
+                            res.status(500).json({ error: 'Failed to create user' });
+                        }
+                    },
+                });
+                // Update user
+                registry.addRoute({
+                    method: 'put',
+                    path: `${apiPrefix}/:id`,
+                    pluginId: 'users',
+                    handler: async (req, res) => {
+                        try {
+                            const input = {
+                                name: req.body.name,
+                                picture: req.body.picture,
+                                metadata: req.body.metadata,
+                            };
+                            const user = await config.store.update(req.params.id, input);
+                            if (!user) {
+                                return res.status(404).json({ error: 'User not found' });
+                            }
+                            res.json(user);
+                        }
+                        catch (error) {
+                            console.error('[UsersPlugin] Update user error:', error);
+                            res.status(500).json({ error: 'Failed to update user' });
+                        }
+                    },
+                });
+                // Delete user
+                registry.addRoute({
+                    method: 'delete',
+                    path: `${apiPrefix}/:id`,
+                    pluginId: 'users',
+                    handler: async (req, res) => {
+                        try {
+                            const deleted = await config.store.delete(req.params.id);
+                            if (!deleted) {
+                                return res.status(404).json({ error: 'User not found' });
+                            }
+                            res.status(204).send();
+                        }
+                        catch (error) {
+                            console.error('[UsersPlugin] Delete user error:', error);
+                            res.status(500).json({ error: 'Failed to delete user' });
+                        }
+                    },
+                });
+            }
+            log('Users plugin started');
+        },
+        async onStop() {
+            log('Stopping users plugin');
+            await config.store.shutdown();
+            currentStore = null;
+            log('Users plugin stopped');
+        },
+    };
+}
+// ========================================
+// Helper Functions
+// ========================================
+/**
+ * Get the current user store instance
+ */
+export function getUserStore() {
+    return currentStore;
+}
+/**
+ * Get a user by ID
+ */
+export async function getUserById(id) {
+    if (!currentStore) {
+        throw new Error('Users plugin not initialized');
+    }
+    return currentStore.getById(id);
+}
+/**
+ * Get a user by email
+ */
+export async function getUserByEmail(email) {
+    if (!currentStore) {
+        throw new Error('Users plugin not initialized');
+    }
+    return currentStore.getByEmail(email);
+}
+/**
+ * Find or create a user from auth provider data
+ */
+export async function findOrCreateUser(data) {
+    if (!currentStore) {
+        throw new Error('Users plugin not initialized');
+    }
+    // Try to find by external ID first
+    let user = await currentStore.getByExternalId(data.external_id, data.provider);
+    if (user) {
+        await currentStore.updateLastLogin(user.id);
+        return user;
+    }
+    // Try to find by email
+    user = await currentStore.getByEmail(data.email);
+    if (user) {
+        // Update with external ID if not set
+        if (!user.external_id) {
+            await currentStore.update(user.id, {});
+        }
+        await currentStore.updateLastLogin(user.id);
+        return user;
+    }
+    // Create new user
+    user = await currentStore.create({
+        email: data.email,
+        name: data.name,
+        external_id: data.external_id,
+        provider: data.provider,
+        picture: data.picture,
+    });
+    return user;
+}
+//# sourceMappingURL=users-plugin.js.map

package/dist/plugins/users/users-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users-plugin.js","sourceRoot":"","sources":["../../../src/plugins/users/users-plugin.ts"],"names":[],"mappings":"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"}