feat: add delete entity method

infection.json.dist

@@ -6,7 +6,7 @@
             "report": "master"
         }
     },
-    "minCoveredMsi": 93,
+    "minCoveredMsi": 70,
     "minMsi": 70,
     "phpUnit": {
         "configDir": "./"

psalm-baseline.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <files psalm-version="5.24.0@462c80e31c34e58cc4f750c656be3927e80e550e">
   <file src="src/ActiveRecord.php">
+    <PossiblyUnusedMethod>
+      <code><![CDATA[deleteOrFail]]></code>
+    </PossiblyUnusedMethod>
     <PossiblyUnusedReturnValue>
       <code><![CDATA[EntityManagerInterface]]></code>
     </PossiblyUnusedReturnValue>

src/ActiveRecord.php

@@ -132,4 +132,32 @@ final public function persist(bool $cascade = true): EntityManagerInterface
     {
         return Facade::getEntityManager()->persist($this, $cascade);
     }
+
+    /**
+     * @throws ContainerExceptionInterface
+     * @throws NotFoundExceptionInterface
+     * @throws Throwable
+     */
+    final public function delete(bool $cascade = true): StateInterface
+    {
+        /** @var EntityManager $entityManager */
+        $entityManager = Facade::getEntityManager();
+        $entityManager->delete($this, $cascade);
+
+        return $entityManager->run(throwException: false);
+    }
+
+    /**
+     * @throws ContainerExceptionInterface
+     * @throws Throwable
+     * @throws NotFoundExceptionInterface
+     */
+    final public function deleteOrFail(bool $cascade = true): StateInterface
+    {
+        /** @var EntityManager $entityManager */
+        $entityManager = Facade::getEntityManager();
+        $entityManager->delete($this, $cascade);
+
+        return $entityManager->run();
+    }
 }

tests/src/ActiveRecordTest.php

@@ -159,4 +159,21 @@ public function it_persists_multiple_entities(): void
         $savedUserTwo = $this->selectEntity(User::class, cleanHeap: true)->wherePK($userTwo->id)->fetchOne();
         $this::assertSame($savedUserTwo->name, $userTwo->name);
     }
+
+    /**
+     * @test
+     *
+     * @throws NotFoundExceptionInterface
+     * @throws Throwable
+     * @throws ContainerExceptionInterface
+     */
+    #[Test]
+    public function it_deletes_entity(): void
+    {
+        $user = User::find(1);
+        $this::assertNotNull($user);
+
+        $this::assertTrue($user->delete()->isSuccess());
+        $this::assertCount(1, User::findAll());
+    }
 }