[doc] - better empty params handling

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "ilias/maestro",
     "type": "library",
-    "version": "1.2.5",
+    "version": "1.2.6",
     "description": "A PHP object-oriented postgres database manager",
     "keywords": [
         "postgres",

src/Abstract/Query.php

@@ -7,15 +7,14 @@
 use Ilias\Maestro\Database\Select;
 use Ilias\Maestro\Utils\Utils;
 use InvalidArgumentException, PDO, Exception, PDOStatement;
-use function PHPUnit\Framework\isEmpty;
 
 abstract class Query
 {
   public mixed $current = null;
   protected array $parameters = [];
   protected array $where = [];
   private ?PDOStatement $stmt = null;
-  private bool $isBinded = false;
+  private bool $isBound = false;
   protected string $query = '';
   public const AND = 'AND';
   public const OR = 'OR';
@@ -38,11 +37,10 @@ public function __construct(
   /**
    * Adds WHERE conditions to the SQL query.
    * This method accepts an associative array of conditions where the key is the column name and the value is the condition value.
-   *
-   * @param array $conditions An associative array of conditions for the WHERE clause.
+   * @param string|array $conditions An associative array of conditions for the WHERE clause. Use plain text if you don't need the array resolver.
    * @return $this Returns the current instance for method chaining.
    */
-  public function where(string|array $conditions, string $operation = Select::AND , string $compaction = Select::EQUALS, bool $group = false): static
+  public function where(string|array $conditions, string $operation = self::AND , string $compaction = self::EQUALS, bool $group = false): static
   {
     if (empty($conditions)) {
       return $this;
@@ -67,7 +65,7 @@ public function where(string|array $conditions, string $operation = Select::AND
     return $this;
   }
 
-  public function in(string|array $conditions, string $operation = Select::AND , bool $group = false): static
+  public function in(string|array $conditions, string $operation = self::AND , bool $group = false): static
   {
     if (empty($conditions)) {
       return $this;
@@ -108,7 +106,7 @@ protected function storeParameter(string $name, mixed $value): void
       $this->parameters[$name] = $value ? Expression::TRUE : Expression::FALSE;
     } elseif (is_object($value) && is_subclass_of($value, Query::class)) {
       $this->parameters[$name] = "({$value})";
-    } elseif (is_object($value) && $value instanceof Expression) {
+    } elseif ($value instanceof Expression) {
       $this->parameters[$name] = "{$value}";
     } else {
       $value = str_replace("'", "''", $value);
@@ -174,18 +172,21 @@ public function bindParameters(?PDO $pdo = null): Query
     }
     $this->query = $query;
     if (!empty($this->pdo) || !empty($pdo)) {
-      if (!$this->isBinded) {
+      if (!$this->isBound) {
         $stmt = $this->pdo->prepare($query);
-        $this->isBinded = true;
+        $this->isBound = true;
         $this->stmt = $stmt;
       }
     }
     return $this;
   }
 
+  /**
+   * @throws Exception
+   */
   public function execute(): array
   {
-    if (!$this->isBinded) {
+    if (!$this->isBound) {
       $this->bindParameters();
     }
     if (!empty($this->stmt)) {

src/Abstract/Table.php

@@ -149,7 +149,8 @@ public static function generateAlias(array $existingAlias = []): string
 
   /**
    * Fetches all rows from the table based on the given prediction, order, and limit.
- @param string|array|null $prediction The prediction criteria for the query. Can be a string or an array.
+   *
+   * @param string|array|null $prediction The prediction criteria for the query. Can be a string or an array.
    * @param string|array|null $orderBy The order by criteria for the query. Can be a string or an array.
    * @param int|string $limit The limit for the number of rows to fetch. Default is 100.
    * @return array The fetched rows as an array.
@@ -182,7 +183,8 @@ public static function fetchAll(string|array $prediction = null, string|array $o
 
   /**
    * Fetches a single row from the table based on the given prediction and order.
- @param string|array|null $prediction The prediction criteria for the query. Can be a string or an array.
+   *
+   * @param string|array|null $prediction The prediction criteria for the query. Can be a string or an array.
    * @param string|array|null $orderBy The order by criteria for the query. Can be a string or an array.
    * @return mixed The fetched row or null if no row is found.
    */

src/Core/Manager.php

@@ -17,12 +17,7 @@
 
 /**
  * Class Manager
- *
- * This class provides methods to create and manage a PostgreSQL database schema,
- * including creating schemas, tables, and foreign key constraints. It also provides
- * methods to insert, update, and select data from tables.
- *
- * @package Ilias\Maestro\Core
+ * This class provides methods to create and manage a PostgreSQL database schema, including creating schemas, tables, and foreign key constraints. It also provides methods to insert, update, and select data from tables.
  */
 class Manager
 {
@@ -39,7 +34,6 @@ public function __construct(
 
   /**
    * Create the database schema.
-   *
    * @param Database $database
    * @param bool $executeOnComplete
    * @return array
@@ -71,7 +65,6 @@ public function createDatabase(Database $database, bool $executeOnComplete = tru
 
   /**
    * Create a schema.
-   *
    * @param string|Schema $schema
    * @return string
    * @throws InvalidArgumentException
@@ -96,7 +89,6 @@ public function createSchema(string|Schema $schema): string
 
   /**
    * Create tables for a schema.
-   *
    * @param string|Schema $schema
    * @return array
    */
@@ -118,7 +110,6 @@ public function createSchemaTables(string|Schema $schema): array
 
   /**
    * Create a table.
-   *
    * @param string $table
    * @return string
    * @throws NotFinalExceptions
@@ -180,7 +171,6 @@ public function createTable(string $table): string
 
   /**
    * Create functions for a schema.
-   *
    * @param string|Schema $schema
    * @return array
    */

src/Database/Delete.php

@@ -8,7 +8,11 @@
 class Delete extends Query
 {
   private string $table;
-  /** Sets the table from which records will be deleted. @param string $table The name of the table. @return Delete Returns the current instance for method chaining./
+  /**
+   * Sets the table from which records will be deleted.
+   * @param string $table The name of the table.
+   * @return Delete Returns the current instance for method chaining.
+   */
   public function from(string $table): Delete
   {
     $this->table = $this->validateTableName($table);