update

Author: tamedevelopers

README.md

@@ -0,0 +1,31 @@
+# Tamedevelopers Database CLI
+
+## Quick start
+
+1. Install dependencies
+```bash
+composer install
+```
+
+2. List commands
+```bash
+php database list
+# or via composer bin (after composer install)
+./vendor/bin/database list
+```
+
+3. Scaffold example table
+```bash
+php database scaffold --name=posts
+```
+
+## Adding new commands
+- Create a new class in `src/Console/Commands`, e.g. `MakeModelCommand.php` with a `handle(array $args): int` method.
+- Register it in `src/Console/Artisan.php` constructor:
+```php
+$this->register('make:model', [new MakeModelCommand(), 'handle']);
+```
+
+## Notes
+- Commands run in CLI, no manual browser reload needed.
+- Env and logger are booted automatically in the sample command.

README2.md

@@ -17,7 +17,16 @@
     ],
     "require": {
         "php": ">=8.0",
-        "tamedevelopers/support": "*"
+        "tamedevelopers/support": "^5.0",
+        "symfony/console": "^6.0"
+    },
+    "scripts": {
+        "post-install-cmd": [
+            "Tamedevelopers\\Database\\Installer::postInstall"
+        ],
+        "post-update-cmd": [
+            "Tamedevelopers\\Database\\Installer::postUpdate"
+        ]
     },
     "autoload": {
         "files": [

composer.json

@@ -8,6 +8,7 @@
 use Tamedevelopers\Support\Hash;
 use Tamedevelopers\Support\Capsule\Manager;
 use Tamedevelopers\Database\Traits\AuthTrait;
+use Tamedevelopers\Database\Traits\ExceptionTrait;
 
 /**
  * Class Auth Manager
@@ -22,7 +23,7 @@
  */
 class Auth
 {
-    use AuthTrait;
+    use AuthTrait, ExceptionTrait;
 
     /**
      * Instance of Database Object
@@ -44,14 +45,14 @@ class Auth
     /**
      * The table name associated with the current guard.
      *
-     * @var string|null $table
+     * @var string|null
      */
     protected $table;
 
     /**
      * Session key used to store authenticated user data.
      *
-     * @var string $session
+     * @var string
      */
     protected static $session = 'tame_auth_user';
 
@@ -63,6 +64,7 @@ class Auth
      */
     public function __construct($table = null, $connection = null)
     {
+        // Ensure environment variables are loaded before accessing them
         Manager::startEnvIFNotStarted();
 
         $this->table = $table;
@@ -139,6 +141,16 @@ public function login($userData = null, bool $persist = true): void
         }
     }
 
+    /**
+     * Determine if the current user is a guest.
+     *
+     * @return bool
+     */
+    public function guest()
+    {
+        return !$this->check();
+    }
+
     /**
      * Get the currently authenticated user (from memory or session).
      *
@@ -196,7 +208,13 @@ public function logout(): void
     public function __get(string $name)
     {
         if ($name === 'user') {
-            throw new \RuntimeException("Direct access to 'user' is restricted. Use user() method instead.");
+            $className = get_class($this);
+            try {
+                throw new \RuntimeException("
+                Cannot access protected property {$className}::$$name. Use user() method instead.");
+            } catch (\Throwable $th) {
+                $this->errorException($th);
+            }
         }
         return null;
     }

src/Auth.php

@@ -8,36 +8,60 @@
 use Tamedevelopers\Database\Traits\AutoLoaderTrait;
 use Tamedevelopers\Database\Schema\Pagination\PaginatorAsset;
 
-class AutoLoader{
-
+class AutoLoader
+{
     use AutoLoaderTrait;
 
     protected static $default;
+
+    /**
+     * Boot the AutoLoader::start.
+     * If the constant 'TAME_AUTOLOADER_BOOT' is not defined, 
+     * it defines it and starts the debugger automatically 
+     * 
+     * So that this is only called once in entire application life-cycle
+     * 
+     * @param string|null $path 
+     * @param bool $createDummy 
+     * @return void
+     */
+    public static function boot($path = null, $createDummy = true)
+    {
+        if(!defined('TAME_AUTOLOADER_BOOT')){
+            // start auto loader
+            self::start($path, $createDummy);
+
+            // Define boot logger as true
+            define('TAME_AUTOLOADER_BOOT', 1);
+        } 
+    }
 
     /**
      * Star env configuration
      * 
-     * @param string|null $custom_path 
+     * @param string|null $path 
      * path \Path to .env file
      * - [optional] path \By default we use project root path
      * 
+     * @param bool $createDummy 
+     * 
      * @return void
      */
-    public static function start($custom_path = null)
+    public static function start($path = null, $createDummy = true)
     {
         /*
         |--------------------------------------------------------------------------
         | Instance of class
         |--------------------------------------------------------------------------
         */
-        $Env = new Env($custom_path);
+        $env = new Env($path);
 
         /*
         |--------------------------------------------------------------------------
         | Create a sample .env file if not exist in project
         |--------------------------------------------------------------------------
         */
-        $Env::createOrIgnore();
+        $env::createOrIgnore();
 
         /*
         |--------------------------------------------------------------------------
@@ -47,25 +71,16 @@ public static function start($custom_path = null)
         | or exit with error status code 
         |
         */
-        $Env::loadOrFail();
-        
-        /*
-        |--------------------------------------------------------------------------
-        | Storing data into a Constant once everything is successful
-        |--------------------------------------------------------------------------
-        | We can now use on anywhere on our application 
-        | Mostly to get our defined .env root Path
-        */
-        if ( ! defined('TAME_SERVER_CONNECT') ) {
-            define('TAME_SERVER_CONNECT', $Env->getServers());
-        }
+        $env::loadOrFail();
 
         /*
         |--------------------------------------------------------------------------
         | Automatically create dummy files
         |--------------------------------------------------------------------------
         */
-        self::createDummy(realpath(__DIR__));
+        if($createDummy){
+            self::createDummy(realpath(__DIR__));
+        }
     }
 
     /**

src/AutoLoader.php

@@ -46,7 +46,7 @@ public static function bootLoader()
         | path => \storage\logs\orm.log
         |--------------------------------------------------------------------------
         */
-        Env::bootLogger();
+        Env::boot();
 
         /*
         |--------------------------------------------------------------------------
@@ -59,10 +59,10 @@ public static function bootLoader()
         /*
         |--------------------------------------------------------------------------
         | Start env configuration
-        | You can configura your pagination text data here if you like
+        | You can configure your pagination text data here if you like
         |--------------------------------------------------------------------------
         */
-        AutoLoader::start();
+        AutoLoader::boot();
     }
 
 }

src/Capsule/AppManager.php

@@ -11,15 +11,17 @@
 use Tamedevelopers\Support\Capsule\Manager;
 use Tamedevelopers\Database\DatabaseManager;
 use Tamedevelopers\Support\Capsule\FileCache;
+use Tamedevelopers\Database\Traits\ExceptionTrait;
 use Tamedevelopers\Database\Schema\Pagination\Paginator;
 use Tamedevelopers\Database\Connectors\ConnectionBuilder;
 use Tamedevelopers\Database\Schema\Traits\ExpressionTrait;
 use Tamedevelopers\Database\Connectors\Traits\ConnectorTrait;
 
 
-class Connector {
+class Connector extends DatabaseManager{
 
     use ConnectorTrait, 
+        ExceptionTrait,
         ExpressionTrait;
 
     /**
@@ -68,7 +70,7 @@ public function __construct($name = null, $connection = null, $data = [])
      */
     static public function addConnection($name = null, $connection = null, $data = [])
     {
-        $driver = DatabaseManager::driverValidator($name);
+        $driver = static::driverValidator($name);
 
         // driver name
         $driverName = $driver['name'];
@@ -92,7 +94,7 @@ static public function addConnection($name = null, $connection = null, $data = [
      */
     static public function removeFromConnection($name = null)
     {
-        $driver = DatabaseManager::driverValidator($name);
+        $driver = static::driverValidator($name);
 
         // driver name
         $driverName = $driver['name'];
@@ -212,7 +214,14 @@ private function buidTable($table = null)
 
         // There's no connecton instance set
         if(empty($instance)){
-            throw new Exception("There's no active connection! Unknown connection [{$this->name}].");
+            try {
+                throw new Exception("
+                    There's no active connection! Unknown connection [{$this->name}]. \n\n
+                    Use DB::connection(\$connName), to instatiate connection.
+                ");
+            } catch (\Throwable $th) {
+                $this->errorException($th);
+            }
         }
 
         // set connection
@@ -314,7 +323,7 @@ public function getConfig()
     private static function getConnectionFromDatabaseFile($name = null, $default = [])
     {
         $data = Server::config(
-            DatabaseManager::getConnectionKey($name), 
+            static::getConnectionKey($name), 
             []
         );
 
@@ -381,9 +390,9 @@ private function isModelDriverCreated()
     {
         if(self::isModelExtended()){
             $this->setConnectionName();
-            $key = DatabaseManager::getConnectionKey($this->name);
+            $key = static::getConnectionKey($this->name);
             if (!FileCache::exists($key)) {
-                DatabaseManager::connection($this->name);
+                static::connection($this->name);
             }
         } 
     }

src/Connectors/Connector.php

@@ -11,7 +11,7 @@
 use Tamedevelopers\Database\Connectors\PostgresConnector;
 
 trait ConnectorTrait{
-
+    
     /**
      * Check if config key is isset and not empty
      *