Add getBounds() method to range values

src/Column/AbstractMultiRangeColumn.php

@@ -7,6 +7,7 @@
 use Yiisoft\Db\Exception\NotSupportedException;
 use Yiisoft\Db\Expression\ExpressionInterface;
 use Yiisoft\Db\Pgsql\Expression\MultiRangeValue;
+use Yiisoft\Db\Pgsql\Expression\RangeValueInterface;
 use Yiisoft\Db\Schema\Column\AbstractColumn;
 use Yiisoft\Db\Schema\Column\ColumnInterface;
 
@@ -15,7 +16,7 @@
 use function is_string;
 
 /**
- * @template T of ExpressionInterface
+ * @template T of RangeValueInterface
  */
 abstract class AbstractMultiRangeColumn extends AbstractColumn
 {
@@ -53,7 +54,7 @@ public function dbTypecast(mixed $value): mixed
     /**
      * @inheritDoc
      *
-     * @return ?ExpressionInterface[]
+     * @return ?RangeValueInterface[]
      *
      * @psalm-return ?T[]
      */

src/Column/AbstractRangeColumn.php

@@ -7,6 +7,7 @@
 use InvalidArgumentException;
 use Yiisoft\Db\Exception\NotSupportedException;
 use Yiisoft\Db\Expression\ExpressionInterface;
+use Yiisoft\Db\Pgsql\Expression\RangeValueInterface;
 use Yiisoft\Db\Schema\Column\AbstractColumn;
 use Yiisoft\Db\Schema\Column\ColumnInterface;
 
@@ -16,7 +17,7 @@
 use function sprintf;
 
 /**
- * @template T of ExpressionInterface
+ * @template T of RangeValueInterface
  */
 abstract class AbstractRangeColumn extends AbstractColumn
 {
@@ -56,7 +57,7 @@ public function dbTypecast(mixed $value): mixed
     /**
      * @inheritDoc
      *
-     * @return ?ExpressionInterface
+     * @return ?RangeValueInterface
      *
      * @psalm-return ?T
      */
@@ -88,6 +89,8 @@ abstract protected function getBoundColumn(): ColumnInterface;
     /**
      * @throws NotSupportedException
      *
+     * @return RangeValueInterface
+     *
      * @psalm-return T
      */
     abstract protected function createRangeValue(

src/Expression/DateRangeValue.php

@@ -5,14 +5,29 @@
 namespace Yiisoft\Db\Pgsql\Expression;
 
 use DateTimeImmutable;
-use Yiisoft\Db\Expression\ExpressionInterface;
 
-final class DateRangeValue implements ExpressionInterface
+/**
+ * @implements RangeValueInterface<DateTimeImmutable>
+ */
+final class DateRangeValue implements RangeValueInterface
 {
     public function __construct(
         public readonly ?DateTimeImmutable $lower = null,
         public readonly ?DateTimeImmutable $upper = null,
         public readonly bool $includeLower = true,
         public readonly bool $includeUpper = true,
     ) {}
+
+    public function getBounds(): array
+    {
+        $lower = $this->lower === null || $this->includeLower
+            ? $this->lower
+            : $this->lower->modify('+1 day');
+
+        $upper = $this->upper === null || $this->includeUpper
+            ? $this->upper
+            : $this->upper->modify('-1 day');
+
+        return [$lower, $upper];
+    }
 }

src/Expression/Int4RangeValue.php

@@ -4,14 +4,28 @@
 
 namespace Yiisoft\Db\Pgsql\Expression;
 
-use Yiisoft\Db\Expression\ExpressionInterface;
-
-final class Int4RangeValue implements ExpressionInterface
+/**
+ * @implements RangeValueInterface<int>
+ */
+final class Int4RangeValue implements RangeValueInterface
 {
     public function __construct(
         public readonly ?int $lower = null,
         public readonly ?int $upper = null,
         public readonly bool $includeLower = true,
         public readonly bool $includeUpper = true,
     ) {}
+
+    public function getBounds(): array
+    {
+        $lower = $this->lower === null || $this->includeLower
+            ? $this->lower
+            : $this->lower + 1;
+
+        $upper = $this->upper === null || $this->includeUpper
+            ? $this->upper
+            : $this->upper - 1;
+
+        return [$lower, $upper];
+    }
 }

src/Expression/Int8RangeValue.php

@@ -4,14 +4,45 @@
 
 namespace Yiisoft\Db\Pgsql\Expression;
 
-use Yiisoft\Db\Expression\ExpressionInterface;
+use RuntimeException;
 
-final class Int8RangeValue implements ExpressionInterface
+use const PHP_INT_MAX;
+use const PHP_INT_MIN;
+
+/**
+ * @implements RangeValueInterface<int|string>
+ */
+final class Int8RangeValue implements RangeValueInterface
 {
     public function __construct(
         public readonly int|string|null $lower = null,
         public readonly int|string|null $upper = null,
         public readonly bool $includeLower = true,
         public readonly bool $includeUpper = true,
     ) {}
+
+    public function getBounds(): array
+    {
+        $lower = $this->lower === null || $this->includeLower
+            ? $this->lower
+            : (
+                PHP_INT_MIN <= $this->lower && $this->lower < PHP_INT_MAX
+                ? (int) $this->lower + 1
+                : throw new RuntimeException(
+                    'Lower bound cannot be determined from the excluded value of a bigint range.',
+                )
+            );
+
+        $upper = $this->upper === null || $this->includeUpper
+            ? $this->upper
+            : (
+                PHP_INT_MIN < $this->upper && $this->upper <= PHP_INT_MAX
+                ? (int) $this->upper - 1
+                : throw new RuntimeException(
+                    'Upper bound cannot be determined from the excluded value of a bigint range.',
+                )
+            );
+
+        return [$lower, $upper];
+    }
 }

src/Expression/NumRangeValue.php

@@ -4,14 +4,34 @@
 
 namespace Yiisoft\Db\Pgsql\Expression;
 
-use Yiisoft\Db\Expression\ExpressionInterface;
+use RuntimeException;
 
-final class NumRangeValue implements ExpressionInterface
+/**
+ * @implements RangeValueInterface<int|float>
+ */
+final class NumRangeValue implements RangeValueInterface
 {
     public function __construct(
         public readonly int|float|null $lower = null,
         public readonly int|float|null $upper = null,
         public readonly bool $includeLower = true,
         public readonly bool $includeUpper = true,
     ) {}
+
+    public function getBounds(): array
+    {
+        $lower = $this->lower === null || $this->includeLower
+            ? $this->lower
+            : throw new RuntimeException(
+                'Lower bound cannot be determined from the excluded value of a numeric range.',
+            );
+
+        $upper = $this->upper === null || $this->includeUpper
+            ? $this->upper
+            : throw new RuntimeException(
+                'Upper bound cannot be determined from the excluded value of a numeric range.',
+            );
+
+        return [$lower, $upper];
+    }
 }

src/Expression/RangeValueInterface.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Db\Pgsql\Expression;
+
+use Yiisoft\Db\Expression\ExpressionInterface;
+use Yiisoft\Db\Pgsql\Column\AbstractMultiRangeColumn;
+use Yiisoft\Db\Pgsql\Column\AbstractRangeColumn;
+
+/**
+ * Represents a range value of {@see AbstractRangeColumn} and {@see AbstractMultiRangeColumn} column types.
+ *
+ * @template T
+ */
+interface RangeValueInterface extends ExpressionInterface
+{
+    /**
+     * Returns the lower and upper bounds of a range, inclusive.
+     *
+     * @psalm-return array{0: ?T, 1: ?T}
+     */
+    public function getBounds(): array;
+}

src/Expression/TsRangeValue.php

@@ -5,14 +5,29 @@
 namespace Yiisoft\Db\Pgsql\Expression;
 
 use DateTimeImmutable;
-use Yiisoft\Db\Expression\ExpressionInterface;
 
-final class TsRangeValue implements ExpressionInterface
+/**
+ * @implements RangeValueInterface<DateTimeImmutable>
+ */
+final class TsRangeValue implements RangeValueInterface
 {
     public function __construct(
         public readonly ?DateTimeImmutable $lower = null,
         public readonly ?DateTimeImmutable $upper = null,
         public readonly bool $includeLower = true,
         public readonly bool $includeUpper = true,
     ) {}
+
+    public function getBounds(): array
+    {
+        $lower = $this->lower === null || $this->includeLower
+            ? $this->lower
+            : $this->lower->modify('+1 second');
+
+        $upper = $this->upper === null || $this->includeUpper
+            ? $this->upper
+            : $this->upper->modify('-1 second');
+
+        return [$lower, $upper];
+    }
 }

src/Expression/TsTzRangeValue.php

@@ -5,14 +5,29 @@
 namespace Yiisoft\Db\Pgsql\Expression;
 
 use DateTimeImmutable;
-use Yiisoft\Db\Expression\ExpressionInterface;
 
-final class TsTzRangeValue implements ExpressionInterface
+/**
+ * @implements RangeValueInterface<DateTimeImmutable>
+ */
+final class TsTzRangeValue implements RangeValueInterface
 {
     public function __construct(
         public readonly ?DateTimeImmutable $lower = null,
         public readonly ?DateTimeImmutable $upper = null,
         public readonly bool $includeLower = true,
         public readonly bool $includeUpper = true,
     ) {}
+
+    public function getBounds(): array
+    {
+        $lower = $this->lower === null || $this->includeLower
+            ? $this->lower
+            : $this->lower->modify('+1 second');
+
+        $upper = $this->upper === null || $this->includeUpper
+            ? $this->upper
+            : $this->upper->modify('-1 second');
+
+        return [$lower, $upper];
+    }
 }