Added possibility to specify an array of composite type

(in `DefaultTypeConverterFactory::getConverterForTypeSpecification()`)

Author: sad-spirit

Changelog.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [Unreleased]
+
+### Added
+
+* `converters\DefaultTypeConverterFactory::getConverterForTypeSpecification()` accepts another specification
+  for an array type: `['' => type]` where `type` may be either a type name or another array for
+  an unnamed composite type. Empty string is used as a key here as column name / alias cannot legitimately
+  be an empty string in Postgres.
+  
+  There was no way previously to specify an "array of composite" other than creating all `TypeConverter` instances
+  manually.
+
 ## [3.1.0] - 2025-05-27
 
 ### Added
@@ -410,3 +422,4 @@ Initial release on GitHub
 [3.0.0-beta.2]: https://github.com/sad-spirit/pg-wrapper/compare/v3.0.0-beta...v3.0.0-beta.2
 [3.0.0]: https://github.com/sad-spirit/pg-wrapper/compare/v3.0.0-beta.2...v3.0.0
 [3.1.0]: https://github.com/sad-spirit/pg-wrapper/compare/v3.0.0...v3.1.0
+[Unreleased]: https://github.com/sad-spirit/pg-wrapper/compare/v3.1.0...HEAD

src/sad_spirit/pg_wrapper/converters/DefaultTypeConverterFactory.php

@@ -22,6 +22,7 @@
     exceptions\TypeConversionException,
     types
 };
+use sad_spirit\pg_wrapper\converters\containers\ArrayConverter;
 
 /**
  * Creates type converters for database type based on specific DB metadata
@@ -255,6 +256,8 @@ private function updateConnection(TypeConverter $converter): void
      *  - type name (string), either simple or schema-qualified,
      *    'foo[]' is treated as an array of base type 'foo'
      *  - ['field' => 'type', ...] for composite types
+     *  - ['' => type] is an alternate way to specify array of given type, which may be also
+     *    an array specifying composite type
      *  - TypeConverter instance. If it implements ConnectionAware, then
      *    it will receive current Connection
      *
@@ -276,6 +279,11 @@ public function getConverterForTypeSpecification(mixed $type): TypeConverter
             return $this->getConverterForTypeName($type);
 
         } elseif (\is_array($type)) {
+            // alternate type specification for arrays, added in 3.2
+            if (1 === \count($type) && [''] === \array_keys($type)) {
+                return new ArrayConverter($this->getConverterForTypeSpecification(\reset($type)));
+            }
+
             // type specification for composite type
             return new containers\CompositeConverter(\array_map(
                 $this->getConverterForTypeSpecification(...),

tests/DefaultTypeConverterFactoryTest.php

@@ -99,6 +99,13 @@ public function testGetConverterForSqlStandardTypeArray(string $typeName, TypeCo
             $this->factory->getConverterForTypeSpecification($typeName . '[]')
         );
     }
+    public function testGetConverterForArrayTypeAlternate(): void
+    {
+        $this->assertEquals(
+            new ArrayConverter(new IntegerConverter()),
+            $this->factory->getConverterForTypeSpecification(['' => 'integer'])
+        );
+    }
 
     #[DataProvider('getInvalidTypeNames')]
     public function testInvalidTypeNames(string $typeName, string $exceptionMessage): void
@@ -127,6 +134,26 @@ public function testGetConverterForCompositeTypeUsingArray(): void
         );
     }
 
+    public function testGetConverterForArrayOfCompositeType(): void
+    {
+        $this->assertEquals(
+            new ArrayConverter(new CompositeConverter([
+                'num'     => new IntegerConverter(),
+                'string'  => new StringConverter(),
+                'strings' => new ArrayConverter(new StringConverter()),
+                'coord'   => new PointConverter()
+            ])),
+            $this->factory->getConverterForTypeSpecification([
+                '' => [
+                    'num'     => 'integer',
+                    'string'  => '"varchar"',
+                    'strings' => 'text[]',
+                    'coord'   => 'pg_catalog.point'
+                ]
+            ])
+        );
+    }
+
     public function testMissingConverter(): void
     {
         $this::expectException(RuntimeException::class);