lateral join

application/Espo/ORM/Query/Part/Join.php

@@ -47,6 +47,7 @@ class Join
 
     private ?WhereItem $conditions = null;
     private bool $onlyMiddle = false;
+    private bool $isLateral = false;
 
     private function __construct(
         private string|Select $target,
@@ -132,6 +133,16 @@ class Join
         return $this->onlyMiddle;
     }
 
+    /**
+     * Is LATERAL.
+     *
+     * @since 9.1.6
+     */
+    public function isLateral(): bool
+    {
+        return $this->isLateral;
+    }
+
     /**
      * Create.
      *
@@ -216,4 +227,21 @@ class Join
 
         return $obj;
     }
+
+    /**
+     * With LATERAL. Only for a sub-query join.
+     *
+     * @since 9.1.6
+     */
+    public function withLateral(bool $isLateral = true): self
+    {
+        if (!$this->isSubQuery()) {
+            throw new LogicException("Lateral can be used only with sub-query joins.");
+        }
+
+        $obj = clone $this;
+        $obj->isLateral = $isLateral;
+
+        return $obj;
+    }
 }

application/Espo/ORM/Query/SelectingBuilderTrait.php

@@ -201,6 +201,7 @@ trait SelectingBuilderTrait
     ): self {
 
         $onlyMiddle = false;
+        $isLateral = false;
 
         /** @var string|Join|array<int, mixed> $target */
 
@@ -208,6 +209,8 @@ trait SelectingBuilderTrait
             $alias = $alias ?? $target->getAlias();
             $conditions = $conditions ?? $target->getConditions();
             $onlyMiddle = $target->isOnlyMiddle();
+            $isLateral = $target->isLateral();
+
             $target = $target->getTarget();
         }
 
@@ -256,6 +259,10 @@ trait SelectingBuilderTrait
             $params['onlyMiddle'] = true;
         }
 
+        if ($isLateral) {
+            $params['isLateral'] = true;
+        }
+
         if ($params !== []) {
             $this->params[$type][] = [$target, $alias, $conditions, $params];