no issue - allow converter fromSql() method $type parameter to be a u…

…ser-given callback

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Next
 
+* [feature] ⭐️ Allow `Converter::fromSql()` `$type` parameter to be a user-given callback.
 * [fix] Cleanup PDO DSN options prior connecting in bridge factory.
 
 ## 1.6.1

src/Converter/Converter.php

@@ -126,11 +126,14 @@ public function toExpression(mixed $value, ?string $type = null): Expression
      * @throws ValueConversionError
      *   In case of value conversion error.
      */
-    public function fromSql(string $type, null|int|float|string $value): mixed
+    public function fromSql(callable|string $type, null|int|float|string $value): mixed
     {
         if (null === $value) {
             return null;
         }
+        if (\is_callable($type)) {
+            return $type($value);
+        }
 
         if (\str_ends_with($type, '[]')) {
             return $this->parseArrayRecursion(\substr($type, 0, -2), ArrayRowParser::parseArray($value));

tests/Converter/ConverterUnitTest.php

@@ -60,6 +60,15 @@ public function testToExpressionNullTypeFallback(): void
         self::assertNull($value->getType());
     }
 
+    public function testFromSqlCallback(): void
+    {
+        $converter = new Converter();
+
+        $callback = fn (mixed $value) => "13" === $value ? 7 : throw new \Exception();
+
+        self::assertSame(7, $converter->fromSql($callback, "13"));
+    }
+
     public function testFromSqlBool(): void
     {
         $converter = new Converter();