bug: postgresql - clients types converting

- removed monolithic ArrayConverter in favor of type-specific
converters
  - added BoolArrayConverter for PostgreSQL BOOL[] type
  - added IntArrayConverter for PostgreSQL INT2[], INT4[], INT8[] types
  - added FloatArrayConverter for PostgreSQL FLOAT4[], FLOAT8[] types
  - added TextArrayConverter for PostgreSQL TEXT[], VARCHAR[] types
  - added UuidArrayConverter for PostgreSQL UUID[] type
  - added JsonArrayConverter for PostgreSQL JSON[], JSONB[] types
  - changed array converters to throw ValueConversionException for
invalid element types instead of silently converting
  - added unit tests for each new array converter
  - removed old ArrayConverterTest.php (unit and integration)
  - changed ValueConverters.php to register 6 type-specific array
converters
  - added "Array Types" section to
documentation/components/libs/postgresql.md
  - changed documentation/components/libs/postgresql/client-types.md to
document array converter validation behavior
  - fixed syntax highlighing on website
  - removed symfony/polyfill-83 dependency

Author: norberttech

composer.json

@@ -15,7 +15,6 @@
         "ext-dom": "*",
         "ext-hash": "*",
         "ext-json": "*",
-        "ext-mbstring": "*",
         "ext-xml": "*",
         "ext-xmlreader": "*",
         "ext-xmlwriter": "*",
@@ -42,7 +41,6 @@
         "psr/simple-cache": "^1.0 || ^2.0 || ^3.0",
         "symfony/console": "^6.4 || ^7.3 || ^8.0",
         "symfony/http-foundation": "^6.4 || ^7.3 || ^8.0",
-        "symfony/polyfill-php83": "^1.33",
         "symfony/string": "^6.4 || ^7.3 || ^8.0",
         "symfony/uid": "^6.4 || ^7.3 || ^8.0",
         "webmozart/glob": "^3.0 || ^4.0"

composer.lock

@@ -306,6 +306,32 @@ $result = $client->transaction(function ($client) {
 $client->close();
 ```
 
+### Array Types
+
+PostgreSQL arrays are supported through type-specific converters. Use `typed()` with the appropriate array type:
+
+```php
+<?php
+
+use function Flow\PostgreSql\DSL\{pgsql_client, pgsql_connection, typed, pgsql_type_int4_array, pgsql_type_text_array};
+
+$client = pgsql_client(pgsql_connection('host=localhost dbname=mydb'));
+
+// Integer array
+$client->execute(
+    'INSERT INTO scores (values) VALUES ($1)',
+    [typed([100, 200, 300], pgsql_type_int4_array())]
+);
+
+// Text array
+$client->execute(
+    'INSERT INTO tags (names) VALUES ($1)',
+    [typed(['php', 'postgresql'], pgsql_type_text_array())]
+);
+```
+
+See [Type System](/documentation/components/libs/postgresql/client-types.md) for all supported array types.
+
 ### Detailed Documentation
 
 - [Connection](/documentation/components/libs/postgresql/client-connection.md) - Connection parameters, DSN parsing,

documentation/components/libs/postgresql.md

@@ -131,7 +131,7 @@ $name = $client->fetchScalarString('SELECT name FROM users WHERE id = $1', [1]);
 // $name is guaranteed to be string
 ```
 
-These methods throw `InvalidTypeException` if the value cannot be converted to the expected type.
+These methods throw `QueryException` if the value cannot be converted to the expected type.
 
 ## execute() - Data Modification
 

documentation/components/libs/postgresql/client-fetching.md

@@ -11,7 +11,6 @@
     "require": {
         "php": "~8.3.0 || ~8.4.0 || ~8.5.0",
         "ext-json": "*",
-        "ext-mbstring": "*",
         "psr/clock": "^1.0",
         "brick/math": "^0.11 || ^0.12 || ^0.13 || ^0.14",
         "flow-php/types": "self.version",

documentation/components/libs/postgresql/client-types.md

@@ -12,7 +12,6 @@
     ],
     "require": {
         "php": "~8.3.0 || ~8.4.0 || ~8.5.0",
-        "flow-php/types": "self.version",
         "google/protobuf": "^4.0"
     },
     "require-dev": {

src/core/etl/composer.json

@@ -21,9 +21,7 @@ public function alias() : ?string
             return null;
         }
 
-        $aliasname = $alias->getAliasname();
-
-        return $aliasname !== '' ? $aliasname : null;
+        return $alias->getAliasname() ?: null;
     }
 
     public function name() : string
@@ -38,8 +36,6 @@ public function raw() : RangeVar
 
     public function schema() : ?string
     {
-        $schemaname = $this->rangeVar->getSchemaname();
-
-        return $schemaname !== '' ? $schemaname : null;
+        return $this->rangeVar->getSchemaname() ?: null;
     }
 }

src/lib/postgresql/composer.json

@@ -210,8 +210,6 @@ private function createIntegerNode(int $value) : Node
 
     private function hasOrderBy(SelectStmt $stmt) : bool
     {
-        $sortClause = $stmt->getSortClause();
-
-        return $sortClause !== null && \count($sortClause) > 0;
+        return \count($stmt->getSortClause() ?? []) > 0;
     }
 }

src/lib/postgresql/src/Flow/PostgreSql/AST/Nodes/Table.php

@@ -93,9 +93,7 @@ private function createIntegerNode(int $value) : Node
 
     private function hasOrderBy(SelectStmt $stmt) : bool
     {
-        $sortClause = $stmt->getSortClause();
-
-        return $sortClause !== null && \count($sortClause) > 0;
+        return \count($stmt->getSortClause() ?? []) > 0;
     }
 
     private function isSetOperation(SelectStmt $stmt) : bool