exguard-backend 1.0.16 → 1.0.17

package/README.md

@@ -34,19 +34,21 @@ pnpm add exguard-backend
 npm install exguard-backend@1.0.10
 
 # Run automatic setup
-npx exguard-backend
+npx exguard-backend@1.0.16
 # OR
 npm run setup-nestjs
 ```
 
-**What the automatic setup creates:**
-
-✅ **ExGuard Module** - Global module with Guard provider  
-✅ **Custom Guards** - ExGuardNestGuard, PermissionGuard, RoleGuard  
-✅ **Decorators** - @RequirePermissions, @RequireRoles, @RequireModules  
-✅ **Example Controller** - Complete usage examples  
-✅ **Environment Variables** - .env configuration  
-✅ **Package Scripts** - Helper scripts for development  
+**The setup script (v1.0.16) includes:**
+✅ **Automatic package installation** - Installs exguard-backend if missing  
+✅ **File overwriting** - Overwrites existing files to ensure latest fixes  
+✅ **Better import handling** - Fixed app.module.ts import issues  
+✅ **Robust error handling** - Better error messages and recovery  
+✅ **Improved module detection** - More reliable NestJS project detection  
+✅ **Enhanced file creation** - Better file path handling  
+✅ **TypeScript error fixes** - All generated code is type-safe  
+✅ **Complete imports** - All factory functions properly imported  
+✅ **Working permission checks** - Guards actually enforce permissions
 
 ### 📋 Option 2: Manual Setup
 
@@ -446,6 +448,53 @@ describe('AppController (e2e)', () => {
 });
 ```
 
+## 🚀 Quick Implementation Guide
+
+### **Step 1: Install and Setup**
+```bash
+# Install latest version
+npm install exguard-backend@1.0.16
+
+# Run automatic setup (overwrites existing files)
+npx exguard-backend@1.0.16
+```
+
+### **Step 2: Controller Implementation**
+```typescript
+import { Controller, Get, Post, UseGuards, Request, Body } from '@nestjs/common';
+import { createPermissionGuard, createRoleGuard, createModuleGuard } from '../exguard/exguard.guard';
+
+@Controller('your-controller')
+export class YourController {
+  @Get()
+  @UseGuards(createPermissionGuard(['your-resource:read']))
+  async getAll(@Request() req) {
+    return { success: true, data: [] };
+  }
+
+  @Post()
+  @UseGuards(createPermissionGuard(['your-resource:create']))
+  async create(@Body() createDto: any, @Request() req) {
+    return { success: true, data: createDto };
+  }
+}
+```
+
+### **Step 3: Test Your Implementation**
+```bash
+# Test with valid permissions
+curl http://localhost:3000/your-controller -H "Authorization: Bearer YOUR_TOKEN"
+
+# Test with invalid permissions (should return 403)
+curl http://localhost:3000/your-controller -H "Authorization: Bearer TOKEN_WITHOUT_PERMISSIONS"
+```
+
+### **Important Notes:**
+- ✅ **File Overwriting**: The setup script now overwrites existing files to ensure you get the latest fixes
+- ✅ **Permission Checking**: Guards now actually check and enforce permissions
+- ✅ **TypeScript Safe**: All generated code is TypeScript compliant
+- ✅ **Working Examples**: The generated controller demonstrates all protection patterns
+
 ## 🎯 Controller Implementation Examples
 
 ### **Basic Permission Protection**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exguard-backend",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "private": false,
   "publishConfig": {
     "access": "public"

package/scripts/setup-nestjs.cjs

@@ -143,8 +143,7 @@ export class ExGuardModule {}
   const modulePath = path.join(process.cwd(), 'src/exguard/exguard.module.ts');
   
   if (fs.existsSync(modulePath)) {
-    logWarning('ExGuardModule already exists. Skipping creation.');
-    return;
+    logWarning('ExGuard module already exists. Overwriting...');
   }
 
   fs.writeFileSync(modulePath, moduleContent);
@@ -236,7 +235,10 @@ export function createPermissionGuard(permissions: string[], requireAll = false)
       
       // Then check specific permissions
       // Extract permissions from modules array
-      const userPermissions = authResult.modules?.flatMap(module => module.permissions) || [];
+      if (!authResult.user) {
+        return { allowed: false, error: 'User not found in authentication result' };
+      }
+      const userPermissions = authResult.user.modules?.flatMap(module => module.permissions) || [];
       
       if (requireAll) {
         // User must have ALL permissions
@@ -260,13 +262,7 @@ export function createPermissionGuard(permissions: string[], requireAll = false)
       
       return { 
         allowed: true, 
-        user: {
-          ...authResult.user,
-          permissions: authResult.modules?.flatMap(module => module.permissions) || [],
-          roles: authResult.roles || [],
-          modules: authResult.modules || [],
-          fieldOffices: authResult.fieldOffices || []
-        }
+        user: authResult.user
       };
     }
   };
@@ -292,8 +288,7 @@ export function createModuleGuard(modules: string[], requireAll = false) {
   const guardPath = path.join(process.cwd(), 'src/exguard/exguard.guard.ts');
   
   if (fs.existsSync(guardPath)) {
-    logWarning('ExGuard guards already exist. Skipping creation.');
-    return;
+    logWarning('ExGuard guards already exist. Overwriting...');
   }
 
   fs.writeFileSync(guardPath, guardContent);
@@ -376,8 +371,7 @@ export const Require = (requirements: {
   const decoratorPath = path.join(process.cwd(), 'src/exguard/exguard.decorators.ts');
   
   if (fs.existsSync(decoratorPath)) {
-    logWarning('ExGuard decorators already exist. Skipping creation.');
-    return;
+    logWarning('ExGuard decorators already exist. Overwriting...');
   }
 
   fs.writeFileSync(decoratorPath, decoratorContent);
@@ -468,16 +462,8 @@ export class EventsController {
 
   const controllerPath = path.join(process.cwd(), 'src/events/events.controller.ts');
   
-  // Check if events directory exists
-  const eventsDir = path.join(process.cwd(), 'src/events');
-  if (!fs.existsSync(eventsDir)) {
-    fs.mkdirSync(eventsDir, { recursive: true });
-    logSuccess('Created events directory');
-  }
-
   if (fs.existsSync(controllerPath)) {
-    logWarning('Example controller already exists. Skipping creation.');
-    return;
+    logWarning('Example controller already exists. Overwriting...');
   }
 
   fs.writeFileSync(controllerPath, controllerContent);