1 files changed, 55 insertions, 0 deletions

diff --git a/vendor/doctrine/orm/src/OptimisticLockException.php b/vendor/doctrine/orm/src/OptimisticLockException.php
new file mode 100644
index 0000000..f84e134
--- /dev/null
+++ b/vendor/doctrine/orm/src/OptimisticLockException.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM;
+
+use DateTimeInterface;
+use Doctrine\ORM\Exception\ORMException;
+use Exception;
+use Throwable;
+
+/**
+ * An OptimisticLockException is thrown when a version check on an object
+ * that uses optimistic locking through a version field fails.
+ */
+class OptimisticLockException extends Exception implements ORMException
+{
+    public function __construct(
+        string $msg,
+        private readonly object|string|null $entity,
+        Throwable|null $previous = null,
+    ) {
+        parent::__construct($msg, 0, $previous);
+    }
+
+    /**
+     * Gets the entity that caused the exception.
+     */
+    public function getEntity(): object|string|null
+    {
+        return $this->entity;
+    }
+
+    /** @param object|class-string $entity */
+    public static function lockFailed(object|string $entity): self
+    {
+        return new self('The optimistic lock on an entity failed.', $entity);
+    }
+
+    public static function lockFailedVersionMismatch(
+        object $entity,
+        int|string|DateTimeInterface $expectedLockVersion,
+        int|string|DateTimeInterface $actualLockVersion,
+    ): self {
+        $expectedLockVersion = $expectedLockVersion instanceof DateTimeInterface ? $expectedLockVersion->getTimestamp() : $expectedLockVersion;
+        $actualLockVersion   = $actualLockVersion instanceof DateTimeInterface ? $actualLockVersion->getTimestamp() : $actualLockVersion;
+
+        return new self('The optimistic lock failed, version ' . $expectedLockVersion . ' was expected, but is actually ' . $actualLockVersion, $entity);
+    }
+
+    public static function notVersioned(string $entityName): self
+    {
+        return new self('Cannot obtain optimistic lock on unversioned entity ' . $entityName, null);
+    }
+}