Merge pull request #1 from panicdevs/develop

Add 'modules' alias for ModuleService and implement findOrFail method

Author: mohaphez

src/Providers/ModulesServiceProvider.php

@@ -32,6 +32,9 @@ public function register(): void
         $this->app->singleton(ModuleService::class, fn ($app): ModuleService
         => new ModuleService($app->make(ManifestBuilder::class)));
 
+        // Bind 'modules' alias for app('modules') access
+        $this->app->alias(ModuleService::class, 'modules');
+
         // Don't register autoloading here - defer to boot phase
     }
 

src/Services/ModuleService.php

@@ -51,6 +51,22 @@ public function find(string $name): ?array
         return $modules[$name] ?? null;
     }
 
+    /**
+     * Get a specific module by name or throw an exception if not found
+     *
+     * @throws \InvalidArgumentException
+     */
+    public function findOrFail(string $name): array
+    {
+        $module = $this->find($name);
+        
+        if (null === $module) {
+            throw new \InvalidArgumentException("Module '{$name}' not found.");
+        }
+        
+        return $module;
+    }
+
     /**
      * Check if a module exists and is enabled
      */