From 911192a572913ed57104e21e60aac7753a61b778 Mon Sep 17 00:00:00 2001
From: roxblnfk <roxblnfk@ya.ru>
Date: Wed, 19 Mar 2025 14:52:19 +0400
Subject: [PATCH 1/5] Prepare test case template

---
 .scrutinizer.yml                              |  21 ---
 CHANGELOG.md                                  |  18 ---
 src/OptimisticLock.php                        |   2 +-
 .../Functional/Driver/Common/BaseTest.php     |   2 +-
 .../Driver/Common/Integration/BaseTest.php    | 110 +++++++++++++++
 .../Integration/CaseTemplate/CaseTest.php     | 130 ++++++++++++++++++
 .../CaseTemplate/Entity/Comment.php           |  51 +++++++
 .../Integration/CaseTemplate/Entity/Post.php  |  64 +++++++++
 .../CaseTemplate/Entity/PostTag.php           |  20 +++
 .../Integration/CaseTemplate/Entity/Tag.php   |  31 +++++
 .../Integration/CaseTemplate/Entity/User.php  |  41 ++++++
 tests/generate-case.php                       |   0
 12 files changed, 449 insertions(+), 41 deletions(-)
 delete mode 100644 CHANGELOG.md
 create mode 100644 tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php
 create mode 100644 tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/CaseTest.php
 create mode 100644 tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Comment.php
 create mode 100644 tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Post.php
 create mode 100644 tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/PostTag.php
 create mode 100644 tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Tag.php
 create mode 100644 tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/User.php
 create mode 100644 tests/generate-case.php

diff --git a/.scrutinizer.yml b/.scrutinizer.yml
index e629757..e69de29 100644
--- a/.scrutinizer.yml
+++ b/.scrutinizer.yml
@@ -1,21 +0,0 @@
-checks:
-  php: true
-
-filter:
-  paths:
-    - "src/*"
-
-tools:
-  external_code_coverage:
-    timeout: 600    # Timeout in seconds.
-    runs: 2         # How many code coverage submissions Scrutinizer will wait
-
-build:
-  nodes:
-    analysis:
-      environment:
-        php: 8.0
-
-      tests:
-        override:
-          - php-scrutinizer-run
diff --git a/CHANGELOG.md b/CHANGELOG.md
deleted file mode 100644
index 68a71b7..0000000
--- a/CHANGELOG.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# CHANGELOG
-
-v1.1.0 (20.01.2022)
--------------------
-- Add `SourceInterface $source` property to the `MapperEvent`by @msmakouz (#18)
-- Add nullable parameter to the updatedAt behavior by @msmakouz (#23)
-
-v1.0.0 (22.12.2021)
--------------------
-- Add behaviors:
-  - `CreatedAt`
-  - `OptimisticLock`
-  - `SoftDelete`
-  - `UpdatedAt`
-  - `EventListener`
-  - `Hook`
-- Add `EventDrivenCommandGenerator` with custom event dispatcher.
-- Supported events: `OnCreate`, `OnDelete` and `OnUpdate`
diff --git a/src/OptimisticLock.php b/src/OptimisticLock.php
index 1ed35b7..f9c181f 100644
--- a/src/OptimisticLock.php
+++ b/src/OptimisticLock.php
@@ -59,7 +59,7 @@ public function __construct(
         private string $field = 'version',
         ?string $column = null,
         /** @Enum({"microtime", "random-string", "increment", "datetime"}) */
-        #[ExpectedValues(valuesFromClass: Listener::class)]
+        #[ExpectedValues(valuesFromClass: self::class)]
         private ?string $rule = null,
     ) {
         $this->column = $column;
diff --git a/tests/Behavior/Functional/Driver/Common/BaseTest.php b/tests/Behavior/Functional/Driver/Common/BaseTest.php
index 087c08d..87de2cc 100644
--- a/tests/Behavior/Functional/Driver/Common/BaseTest.php
+++ b/tests/Behavior/Functional/Driver/Common/BaseTest.php
@@ -37,7 +37,7 @@ public function getDriver(): DriverInterface
         return static::$driverCache[static::DRIVER] = $this->driver;
     }
 
-    public function setUp(): void
+    protected function setUp(): void
     {
         $this->setUpLogger($this->getDriver());
         if (self::$config['debug'] ?? false) {
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php b/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php
new file mode 100644
index 0000000..66d8206
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php
@@ -0,0 +1,110 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration;
+
+use Cycle\Annotated\Embeddings;
+use Cycle\Annotated\Entities;
+use Cycle\Annotated\MergeColumns;
+use Cycle\Annotated\MergeIndexes;
+use Cycle\Annotated\TableInheritance;
+use Cycle\ORM\Collection\ArrayCollectionFactory;
+use Cycle\ORM\Config\RelationConfig;
+use Cycle\ORM\Entity\Behavior\EventDrivenCommandGenerator;
+use Cycle\ORM\Entity\Behavior\Tests\Utils\SimpleContainer;
+use Cycle\ORM\Factory;
+use Cycle\ORM\ORM;
+use Cycle\ORM\ORMInterface;
+use Cycle\ORM\Schema;
+use Cycle\ORM\SchemaInterface;
+use Cycle\ORM\Transaction;
+use Cycle\ORM\Transaction\UnitOfWork;
+use Cycle\Schema\Compiler;
+use Cycle\Schema\Generator\ForeignKeys;
+use Cycle\Schema\Generator\GenerateModifiers;
+use Cycle\Schema\Generator\GenerateRelations;
+use Cycle\Schema\Generator\GenerateTypecast;
+use Cycle\Schema\Generator\RenderModifiers;
+use Cycle\Schema\Generator\RenderRelations;
+use Cycle\Schema\Generator\RenderTables;
+use Cycle\Schema\Generator\ResetTables;
+use Cycle\Schema\Generator\SyncTables;
+use Cycle\Schema\Generator\ValidateEntities;
+use Cycle\Schema\Registry;
+use Spiral\Attributes\AttributeReader;
+use Spiral\Tokenizer\Config\TokenizerConfig;
+use Spiral\Tokenizer\Tokenizer;
+
+class BaseTest extends \Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\BaseTest
+{
+    protected SchemaInterface $schema;
+    protected ORMInterface $orm;
+
+    public function tearDown(): void
+    {
+        $this->disableProfiling();
+        unset($this->orm, $this->schema);
+        parent::tearDown();
+    }
+
+    /**
+     * @param non-empty-array<non-empty-string>|non-empty-string $entitiesPath
+     */
+    protected function prepareOrm(string|array $entitiesPath): void
+    {
+        $tokenizer = new Tokenizer(new TokenizerConfig([
+            'directories' => (array) $entitiesPath,
+            'exclude' => [],
+        ]));
+
+        $reader = new AttributeReader();
+
+        $classLocator = $tokenizer->classLocator();
+
+        $this->schema = new Schema((new Compiler())->compile($this->registry = new Registry($this->dbal), [
+            new ResetTables(),
+            new Embeddings($classLocator, $reader),
+            new Entities($classLocator, $reader),
+            new TableInheritance($reader),
+            new MergeColumns($reader),
+            new GenerateRelations(),
+            new GenerateModifiers(),
+            new ValidateEntities(),
+            new RenderTables(),
+            new RenderRelations(),
+            new RenderModifiers(),
+            new ForeignKeys(),
+            new MergeIndexes($reader),
+            new SyncTables(),
+            new GenerateTypecast(),
+        ]));
+
+        $this->orm = new ORM(
+            new Factory(
+                $this->dbal,
+                RelationConfig::getDefault(),
+                null,
+                new ArrayCollectionFactory(),
+            ),
+            $this->schema,
+            new EventDrivenCommandGenerator($this->schema, new SimpleContainer()),
+        );
+    }
+
+    protected function save(object ...$entities): void
+    {
+        $uow = new UnitOfWork($this->orm);
+
+        foreach ($entities as $entity) {
+            $uow->persistDeferred($entity);
+        }
+        $result = $uow->run();
+        $result->isSuccess() or throw $uow->getLastError();
+    }
+
+    protected function cleanHeap(): void
+    {
+        $this->orm->getHeap()->clean();
+    }
+}
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/CaseTest.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/CaseTest.php
new file mode 100644
index 0000000..e1ec1f7
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/CaseTest.php
@@ -0,0 +1,130 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate;
+
+use Cycle\ORM\Entity\Behavior\Tests\Traits\TableTrait;
+use Cycle\ORM\Select;
+use Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\BaseTest;
+
+abstract class CaseTest extends BaseTest
+{
+    use TableTrait;
+
+    public function testPreparedData(): void
+    {
+        // Get entity
+        $user = (new Select($this->orm, Entity\User::class))
+            ->load('posts')
+            ->wherePK(2)
+            ->fetchOne();
+        \assert($user instanceof Entity\User);
+
+        // Check results
+        self::assertNotNull($user->createdAt);
+        self::assertNotNull($user->updatedAt);
+        self::assertSame(0, $user->createdAt <=> $user->updatedAt);
+    }
+
+    public function testCreatedAt(): void
+    {
+        // Get entity
+        $user = $this->orm->make(Entity\User::class, ['login' => 'new-user', 'passwordHash' => '123456789']);
+
+        self::assertFalse(isset($user->createdAt));
+        $this->save($user);
+
+        self::assertNotNull($user->createdAt);
+
+        // Reload entity
+        $id = $user->id;
+        $this->cleanHeap();
+        $user = (new Select($this->orm, Entity\User::class))
+            ->wherePK($id)
+            ->fetchOne();
+        self::assertNotNull($user->createdAt);
+    }
+
+    public function testUpdatedAt(): void
+    {
+        // Get entity
+        $user = (new Select($this->orm, Entity\User::class))
+            ->wherePK(2)
+            ->fetchOne();
+        \assert($user instanceof Entity\User);
+        $updatedAt = $user->updatedAt;
+
+        // Change data
+        $user->passwordHash = 'new-password-hash';
+        $this->save($user);
+
+        // Check results
+        self::assertSame(1, $user->updatedAt <=> $updatedAt);
+    }
+
+    protected function setUp(): void
+    {
+        // Init DB
+        parent::setUp();
+        $this->prepareOrm(__DIR__ . '/Entity');
+        $this->save(...$this->fillData());
+        $this->orm->getHeap()->clean();
+    }
+
+    private function fillData(): iterable
+    {
+        /**
+         * @var callable(class-string, array): object $c
+         */
+        $c = \Closure::fromCallable([$this->orm, 'make']);
+
+        // Users
+        $u1 = $c(Entity\User::class, ['login' => 'user-1', 'passwordHash' => '123456789']);
+        $u2 = $c(Entity\User::class, ['login' => 'user-2', 'passwordHash' => '852741963']);
+        $u3 = $c(Entity\User::class, ['login' => 'user-3', 'passwordHash' => '321654987']);
+        $u4 = $c(Entity\User::class, ['login' => 'user-4', 'passwordHash' => '321456987']);
+
+        // Posts
+        $p1 = $c(Entity\Post::class, ['slug' => 'slug-string-1', 'title' => 'Title 1', 'public' => true, 'content' => 'Foo-bar-baz content 1']);
+        $p2 = $c(Entity\Post::class, ['slug' => 'slug-string-2', 'title' => 'Title 2', 'public' => true, 'content' => 'Foo-bar-baz content 2']);
+        $p3 = $c(Entity\Post::class, ['slug' => 'slug-string-3', 'title' => 'Title 3', 'public' => false, 'content' => 'Foo-bar-baz content 3']);
+        $p4 = $c(Entity\Post::class, ['slug' => 'slug-string-4', 'title' => 'Title 4', 'public' => true, 'content' => 'Foo-bar-baz content 4']);
+        $p5 = $c(Entity\Post::class, ['slug' => 'slug-string-5', 'title' => 'Title 5', 'public' => true, 'content' => 'Foo-bar-baz content 5']);
+        $p6 = $c(Entity\Post::class, ['slug' => 'slug-string-6', 'title' => 'Title 6', 'public' => true, 'content' => 'Foo-bar-baz content 6']);
+
+        // Link posts with users
+        $u1->posts = [$p1];
+        $u2->posts = [$p2, $p3];
+        $u3->posts = [$p4, $p5, $p6];
+
+        // Comments
+        $c1 = $c(Entity\Comment::class, ['post' => $p1, 'user' => $u2, 'content' => 'Foo-bar-baz comment 1', 'public' => true]);
+        $c2 = $c(Entity\Comment::class, ['post' => $p1, 'user' => $u1, 'content' => 'Reply to comment 1', 'public' => true]);
+        $c3 = $c(Entity\Comment::class, ['post' => $p2, 'user' => $u1, 'content' => 'Foo-bar-baz comment 2', 'public' => true]);
+        $c4 = $c(Entity\Comment::class, ['post' => $p2, 'user' => $u2, 'content' => 'Reply to comment 2', 'public' => true]);
+        $c5 = $c(Entity\Comment::class, ['post' => $p2, 'user' => $u3, 'content' => 'Foo-bar-baz comment 3', 'public' => true]);
+        $c6 = $c(Entity\Comment::class, ['post' => $p2, 'user' => $u4, 'content' => 'Hidden comment', 'public' => false]);
+        $c7 = $c(Entity\Comment::class, ['post' => $p2, 'user' => $u4, 'content' => 'Yet another comment', 'public' => true]);
+
+        // Tags
+        $t1 = $c(Entity\Tag::class, ['label' => 'tag-1']);
+        $t2 = $c(Entity\Tag::class, ['label' => 'tag-2']);
+        $t3 = $c(Entity\Tag::class, ['label' => 'tag-3']);
+        $t4 = $c(Entity\Tag::class, ['label' => 'tag-4']);
+        $t5 = $c(Entity\Tag::class, ['label' => 'tag-5']);
+
+        // Link tags with posts
+        $t1->posts = [$p1, $p2];
+        $t2->posts = [$p2, $p3];
+        $t3->posts = [$p3, $p4, $p5];
+        $t4->posts = [$p4, $p5];
+        $t5->posts = [$p5, $p6, $p1];
+
+        // yield all the entities
+        yield from [$u1, $u2, $u3, $u4];
+        yield from [$p1, $p2, $p3, $p4, $p5, $p6];
+        yield from [$c1, $c2, $c3, $c4, $c5, $c6, $c7];
+        yield from [$t1, $t2, $t3, $t4, $t5];
+    }
+}
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Comment.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Comment.php
new file mode 100644
index 0000000..f03db50
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Comment.php
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate\Entity;
+
+use Cycle\Annotated\Annotation\Column;
+use Cycle\Annotated\Annotation\Entity;
+use Cycle\Annotated\Annotation\Relation\BelongsTo;
+use Cycle\ORM\Entity\Behavior\CreatedAt;
+use Cycle\ORM\Entity\Behavior\SoftDelete;
+use Cycle\ORM\Entity\Behavior\UpdatedAt;
+
+#[Entity(role: Comment::ROLE, table: 'comment')]
+#[CreatedAt(field: 'createdAt', column: 'created_at')]
+#[UpdatedAt(field: 'updatedAt', column: 'updated_at')]
+#[SoftDelete(field: 'deletedAt', column: 'deleted_at')]
+class Comment
+{
+    public const ROLE = 'comment';
+
+    #[Column(type: 'bigPrimary')]
+    public ?int $id = null;
+
+    #[Column(type: 'boolean')]
+    public bool $public = false;
+
+    #[Column(type: 'text')]
+    public string $content;
+
+    #[Column(type: 'datetime', nullable: true)]
+    public ?\DateTimeImmutable $published_at = null;
+
+    public \DateTimeImmutable $createdAt;
+    public \DateTimeImmutable $updatedAt;
+    public ?\DateTimeImmutable $deletedAt = null;
+
+    #[BelongsTo(target: User::class, innerKey: 'userId', fkCreate: false)]
+    public User $user;
+
+    #[BelongsTo(target: Post::class, innerKey: 'postId', fkCreate: false)]
+    public ?Post $post = null;
+
+    #[Column(type: 'bigInteger', name: 'user_id')]
+    public ?int $userId = null;
+
+    #[Column(type: 'bigInteger', name: 'post_id')]
+    public ?int $postId = null;
+
+    private function __construct() {}
+}
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Post.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Post.php
new file mode 100644
index 0000000..e1f0673
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Post.php
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate\Entity;
+
+use Cycle\Annotated\Annotation\Column;
+use Cycle\Annotated\Annotation\Entity;
+use Cycle\Annotated\Annotation\Relation\BelongsTo;
+use Cycle\Annotated\Annotation\Relation\HasMany;
+use Cycle\Annotated\Annotation\Relation\ManyToMany;
+use Cycle\ORM\Entity\Behavior\CreatedAt;
+use Cycle\ORM\Entity\Behavior\OptimisticLock;
+use Cycle\ORM\Entity\Behavior\SoftDelete;
+use Cycle\ORM\Entity\Behavior\UpdatedAt;
+
+#[Entity(role: Post::ROLE, table: 'post')]
+#[CreatedAt(field: 'createdAt', column: 'created_at')]
+#[UpdatedAt(field: 'updatedAt', column: 'updated_at')]
+#[SoftDelete(field: 'deletedAt', column: 'deleted_at')]
+#[OptimisticLock(field: 'version', rule: OptimisticLock::RULE_INCREMENT)]
+class Post
+{
+    public const ROLE = 'post';
+
+    #[Column(type: 'bigPrimary')]
+    public ?int $id = null;
+
+    #[Column(type: 'string')]
+    public string $slug;
+
+    #[Column(type: 'string')]
+    public string $title = '';
+
+    #[Column(type: 'boolean')]
+    public bool $public = false;
+
+    #[Column(type: 'text')]
+    public string $content = '';
+
+    #[Column(type: 'datetime', nullable: true)]
+    public ?\DateTimeImmutable $published_at = null;
+
+    public int $version = 0;
+    public \DateTimeImmutable $created_at;
+    public \DateTimeImmutable $updated_at;
+    public ?\DateTimeImmutable $deleted_at = null;
+
+    #[BelongsTo(target: User::class, innerKey: 'userId', fkCreate: false)]
+    public User $user;
+
+    #[Column(type: 'bigInteger', name: 'user_id')]
+    public ?int $userId = null;
+
+    /** @var iterable<Tag> */
+    #[ManyToMany(target: Tag::class, innerKey: 'id', outerKey: 'id', throughInnerKey: 'postId', throughOuterKey: 'tagId', through: PostTag::class)]
+    public iterable $tags = [];
+
+    /** @var iterable<Comment> */
+    #[HasMany(target: Comment::class, innerKey: 'id', outerKey: 'postId')]
+    public iterable $comments = [];
+
+    private function __construct() {}
+}
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/PostTag.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/PostTag.php
new file mode 100644
index 0000000..f26ca38
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/PostTag.php
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate\Entity;
+
+use Cycle\Annotated\Annotation\Column;
+use Cycle\Annotated\Annotation\Entity;
+
+#[Entity(role: PostTag::ROLE, table: 'post_tag')]
+class PostTag
+{
+    public const ROLE = 'post_tag';
+
+    #[Column(type: 'bigInteger', name: 'post_id', primary: true)]
+    private ?int $postId = null;
+
+    #[Column(type: 'bigInteger', name: 'tag_id', primary: true)]
+    private ?int $tagId = null;
+}
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Tag.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Tag.php
new file mode 100644
index 0000000..2ee7cfb
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Tag.php
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate\Entity;
+
+use Cycle\Annotated\Annotation\Column;
+use Cycle\Annotated\Annotation\Entity;
+use Cycle\Annotated\Annotation\Relation\ManyToMany;
+use Cycle\ORM\Entity\Behavior\CreatedAt;
+
+#[Entity(role: Tag::ROLE, table: 'tag')]
+#[CreatedAt(field: 'createdAt', column: 'created_at')]
+class Tag
+{
+    public const ROLE = 'tag';
+
+    #[Column(type: 'bigPrimary', name: 'id')]
+    public ?int $id = null;
+
+    #[Column(type: 'string')]
+    public string $label;
+
+    public \DateTimeImmutable $createdAt;
+
+    /** @var iterable<Post> */
+    #[ManyToMany(target: Post::class, innerKey: 'id', outerKey: 'id', throughInnerKey: 'tagId', throughOuterKey: 'postId', through: PostTag::class, fkCreate: false)]
+    public iterable $posts = [];
+
+    private function __construct() {}
+}
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/User.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/User.php
new file mode 100644
index 0000000..45789d4
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/User.php
@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate\Entity;
+
+use Cycle\Annotated\Annotation\Column;
+use Cycle\Annotated\Annotation\Entity;
+use Cycle\Annotated\Annotation\Relation\HasMany;
+use Cycle\ORM\Entity\Behavior\CreatedAt;
+use Cycle\ORM\Entity\Behavior\UpdatedAt;
+
+#[Entity(role: User::ROLE, table: 'user')]
+#[CreatedAt(field: 'createdAt', column: 'created_at')]
+#[UpdatedAt(field: 'updatedAt', column: 'updated_at')]
+class User
+{
+    public const ROLE = 'user';
+
+    #[Column(type: 'bigPrimary')]
+    public ?int $id = null;
+
+    #[Column(type: 'string')]
+    public string $login;
+
+    #[Column(type: 'string')]
+    public string $passwordHash;
+
+    public \DateTimeImmutable $createdAt;
+    public \DateTimeImmutable $updatedAt;
+
+    /** @var iterable<Post> */
+    #[HasMany(target: Post::class, innerKey: 'id', outerKey: 'userId')]
+    public iterable $posts = [];
+
+    /** @var iterable<Comment> */
+    #[HasMany(target: Comment::class, innerKey: 'id', outerKey: 'userId')]
+    public iterable $comments = [];
+
+    private function __construct() {}
+}
diff --git a/tests/generate-case.php b/tests/generate-case.php
new file mode 100644
index 0000000..e69de29

From ad8dc4bf1fa4e6c3f1df3b3e44dcd1d5489ae45c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@users.noreply.github.com>
Date: Wed, 19 Mar 2025 10:52:52 +0000
Subject: [PATCH 2/5] style(php-cs-fixer): fix coding standards

---
 tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php b/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php
index 66d8206..a5271f5 100644
--- a/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php
+++ b/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php
@@ -18,7 +18,6 @@
 use Cycle\ORM\ORMInterface;
 use Cycle\ORM\Schema;
 use Cycle\ORM\SchemaInterface;
-use Cycle\ORM\Transaction;
 use Cycle\ORM\Transaction\UnitOfWork;
 use Cycle\Schema\Compiler;
 use Cycle\Schema\Generator\ForeignKeys;

From 95f7f5d36e1490ba2c95bf9bcb1f11cb169fa88d Mon Sep 17 00:00:00 2001
From: roxblnfk <roxblnfk@ya.ru>
Date: Wed, 19 Mar 2025 14:56:31 +0400
Subject: [PATCH 3/5] Add cases generator

---
 .scrutinizer.yml                              | 21 +++++
 .../Integration/CaseTemplate/CaseTest.php     | 17 ++++
 .../Integration/CaseTemplate/CaseTest.php     | 17 ++++
 .../Integration/CaseTemplate/CaseTest.php     | 17 ++++
 .../Integration/CaseTemplate/CaseTest.php     | 17 ++++
 tests/generate-case.php                       | 84 +++++++++++++++++++
 6 files changed, 173 insertions(+)
 create mode 100644 tests/Behavior/Functional/Driver/MySQL/Integration/CaseTemplate/CaseTest.php
 create mode 100644 tests/Behavior/Functional/Driver/Postgres/Integration/CaseTemplate/CaseTest.php
 create mode 100644 tests/Behavior/Functional/Driver/SQLServer/Integration/CaseTemplate/CaseTest.php
 create mode 100644 tests/Behavior/Functional/Driver/SQLite/Integration/CaseTemplate/CaseTest.php

diff --git a/.scrutinizer.yml b/.scrutinizer.yml
index e69de29..e629757 100644
--- a/.scrutinizer.yml
+++ b/.scrutinizer.yml
@@ -0,0 +1,21 @@
+checks:
+  php: true
+
+filter:
+  paths:
+    - "src/*"
+
+tools:
+  external_code_coverage:
+    timeout: 600    # Timeout in seconds.
+    runs: 2         # How many code coverage submissions Scrutinizer will wait
+
+build:
+  nodes:
+    analysis:
+      environment:
+        php: 8.0
+
+      tests:
+        override:
+          - php-scrutinizer-run
diff --git a/tests/Behavior/Functional/Driver/MySQL/Integration/CaseTemplate/CaseTest.php b/tests/Behavior/Functional/Driver/MySQL/Integration/CaseTemplate/CaseTest.php
new file mode 100644
index 0000000..2830edd
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/MySQL/Integration/CaseTemplate/CaseTest.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\MySQL\Integration\CaseTemplate;
+
+// phpcs:ignore
+use Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate\CaseTest as CommonClass;
+
+/**
+ * @group driver
+ * @group driver-mysql
+ */
+class CaseTest extends CommonClass
+{
+    public const DRIVER = 'mysql';
+}
diff --git a/tests/Behavior/Functional/Driver/Postgres/Integration/CaseTemplate/CaseTest.php b/tests/Behavior/Functional/Driver/Postgres/Integration/CaseTemplate/CaseTest.php
new file mode 100644
index 0000000..7bccaa0
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/Postgres/Integration/CaseTemplate/CaseTest.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Postgres\Integration\CaseTemplate;
+
+// phpcs:ignore
+use Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate\CaseTest as CommonClass;
+
+/**
+ * @group driver
+ * @group driver-postgres
+ */
+class CaseTest extends CommonClass
+{
+    public const DRIVER = 'postgres';
+}
diff --git a/tests/Behavior/Functional/Driver/SQLServer/Integration/CaseTemplate/CaseTest.php b/tests/Behavior/Functional/Driver/SQLServer/Integration/CaseTemplate/CaseTest.php
new file mode 100644
index 0000000..c1164b5
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/SQLServer/Integration/CaseTemplate/CaseTest.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\SQLServer\Integration\CaseTemplate;
+
+// phpcs:ignore
+use Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate\CaseTest as CommonClass;
+
+/**
+ * @group driver
+ * @group driver-sqlserver
+ */
+class CaseTest extends CommonClass
+{
+    public const DRIVER = 'sqlserver';
+}
diff --git a/tests/Behavior/Functional/Driver/SQLite/Integration/CaseTemplate/CaseTest.php b/tests/Behavior/Functional/Driver/SQLite/Integration/CaseTemplate/CaseTest.php
new file mode 100644
index 0000000..66cd7df
--- /dev/null
+++ b/tests/Behavior/Functional/Driver/SQLite/Integration/CaseTemplate/CaseTest.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\SQLite\Integration\CaseTemplate;
+
+// phpcs:ignore
+use Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\Integration\CaseTemplate\CaseTest as CommonClass;
+
+/**
+ * @group driver
+ * @group driver-sqlite
+ */
+class CaseTest extends CommonClass
+{
+    public const DRIVER = 'sqlite';
+}
diff --git a/tests/generate-case.php b/tests/generate-case.php
index e69de29..d7fb91c 100644
--- a/tests/generate-case.php
+++ b/tests/generate-case.php
@@ -0,0 +1,84 @@
+<?php
+
+/**
+ * Usage:
+ *  php tests/generate-case.php --case-name=Issue777
+ *  php tests/generate-case.php --case-name=Issue888 --template=Issue777
+ */
+
+declare(strict_types=1);
+
+\error_reporting(E_ALL | E_STRICT);
+\ini_set('display_errors', '1');
+
+//Composer
+require_once \dirname(__DIR__) . '/vendor/autoload.php';
+
+$integrationDir = __DIR__ . '/Behavior/Functional/Driver/Common/Integration';
+
+function defaultCaseName(string $integrationDir): string
+{
+    $cases = 0;
+
+    foreach (\scandir($integrationDir) as $dirName) {
+        if (\sscanf($dirName, 'Case%d', $last) === 1) {
+            $cases = \max($cases, $last);
+        }
+    }
+    ++$cases;
+
+    return $integrationDir . '/Case' . $cases;
+}
+
+function copyTemplateFiles(string $copyDir, string $caseTemplateDirName): void
+{
+    $caseTemplateDir = __DIR__ . '/Behavior/Functional/Driver/Common/Integration/' . $caseTemplateDirName;
+    if (!\file_exists($caseTemplateDir) || !\is_dir($caseTemplateDir)) {
+        echo "Error. template folder '$caseTemplateDir' does not exists\n";
+        exit(1);
+    }
+
+    echo \sprintf("Using template files from '%s'...\n", $caseTemplateDir);
+
+    $rii = new RecursiveIteratorIterator(
+        new RecursiveDirectoryIterator($caseTemplateDir, FilesystemIterator::SKIP_DOTS),
+    );
+    foreach ($rii as $file) {
+        $filePath = $file->getRealPath();
+        $target = \substr($filePath, \strlen($caseTemplateDir));
+
+        // creating directory...
+        $dirName = \dirname($copyDir . $target);
+        if (!\is_dir($dirName)) {
+            \mkdir($dirName, recursive: true);
+        }
+
+        $contents = \str_replace($caseTemplateDirName, \basename($copyDir), \file_get_contents($filePath));
+        \file_put_contents($copyDir . $target, $contents);
+    }
+}
+
+$options = \getopt('', [
+    'case-name:',
+    'template:',
+]);
+
+$copyDir = isset($options['case-name'])
+    ? $integrationDir . DIRECTORY_SEPARATOR . $options['case-name']
+    : defaultCaseName($integrationDir);
+
+if (\file_exists($copyDir)) {
+    echo "Error. Tests folder `$copyDir` already exists\n";
+    exit(1);
+}
+
+echo \sprintf("Generating new test case '%s'... \n", \basename($copyDir));
+
+\mkdir($copyDir);
+$copyDir = \realpath($copyDir);
+
+copyTemplateFiles($copyDir, $options['template'] ?? 'CaseTemplate');
+
+require 'generate.php';
+
+echo "Done. New test case is here:\n$copyDir\n";

From a6add98a0b05dd15cab1f74fdc0bc21a49ea9700 Mon Sep 17 00:00:00 2001
From: roxblnfk <roxblnfk@ya.ru>
Date: Wed, 19 Mar 2025 15:44:34 +0400
Subject: [PATCH 4/5] Simplify FK for MSSQL

---
 .../Driver/Common/Integration/CaseTemplate/Entity/Comment.php | 4 ++--
 .../Driver/Common/Integration/CaseTemplate/Entity/Post.php    | 4 ++--
 .../Driver/Common/Integration/CaseTemplate/Entity/Tag.php     | 2 +-
 .../Driver/Common/Integration/CaseTemplate/Entity/User.php    | 4 ++--
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Comment.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Comment.php
index f03db50..95e547b 100644
--- a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Comment.php
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Comment.php
@@ -35,10 +35,10 @@ class Comment
     public \DateTimeImmutable $updatedAt;
     public ?\DateTimeImmutable $deletedAt = null;
 
-    #[BelongsTo(target: User::class, innerKey: 'userId', fkCreate: false)]
+    #[BelongsTo(target: User::class, innerKey: 'userId')]
     public User $user;
 
-    #[BelongsTo(target: Post::class, innerKey: 'postId', fkCreate: false)]
+    #[BelongsTo(target: Post::class, innerKey: 'postId')]
     public ?Post $post = null;
 
     #[Column(type: 'bigInteger', name: 'user_id')]
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Post.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Post.php
index e1f0673..0652de4 100644
--- a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Post.php
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Post.php
@@ -46,7 +46,7 @@ class Post
     public \DateTimeImmutable $updated_at;
     public ?\DateTimeImmutable $deleted_at = null;
 
-    #[BelongsTo(target: User::class, innerKey: 'userId', fkCreate: false)]
+    #[BelongsTo(target: User::class, innerKey: 'userId', fkAction: 'NO ACTION')]
     public User $user;
 
     #[Column(type: 'bigInteger', name: 'user_id')]
@@ -57,7 +57,7 @@ class Post
     public iterable $tags = [];
 
     /** @var iterable<Comment> */
-    #[HasMany(target: Comment::class, innerKey: 'id', outerKey: 'postId')]
+    #[HasMany(target: Comment::class, innerKey: 'id', outerKey: 'postId', fkCreate: false)]
     public iterable $comments = [];
 
     private function __construct() {}
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Tag.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Tag.php
index 2ee7cfb..4c94c58 100644
--- a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Tag.php
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/Tag.php
@@ -24,7 +24,7 @@ class Tag
     public \DateTimeImmutable $createdAt;
 
     /** @var iterable<Post> */
-    #[ManyToMany(target: Post::class, innerKey: 'id', outerKey: 'id', throughInnerKey: 'tagId', throughOuterKey: 'postId', through: PostTag::class, fkCreate: false)]
+    #[ManyToMany(target: Post::class, innerKey: 'id', outerKey: 'id', throughInnerKey: 'tagId', throughOuterKey: 'postId', through: PostTag::class)]
     public iterable $posts = [];
 
     private function __construct() {}
diff --git a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/User.php b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/User.php
index 45789d4..736fc1d 100644
--- a/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/User.php
+++ b/tests/Behavior/Functional/Driver/Common/Integration/CaseTemplate/Entity/User.php
@@ -30,11 +30,11 @@ class User
     public \DateTimeImmutable $updatedAt;
 
     /** @var iterable<Post> */
-    #[HasMany(target: Post::class, innerKey: 'id', outerKey: 'userId')]
+    #[HasMany(target: Post::class, innerKey: 'id', outerKey: 'userId', fkCreate: false)]
     public iterable $posts = [];
 
     /** @var iterable<Comment> */
-    #[HasMany(target: Comment::class, innerKey: 'id', outerKey: 'userId')]
+    #[HasMany(target: Comment::class, innerKey: 'id', outerKey: 'userId', fkCreate: false)]
     public iterable $comments = [];
 
     private function __construct() {}

From 387e1f718bd95a96df1b184598f4134a21ab7abe Mon Sep 17 00:00:00 2001
From: roxblnfk <roxblnfk@ya.ru>
Date: Wed, 19 Mar 2025 15:47:25 +0400
Subject: [PATCH 5/5] Fix deprecations

---
 .../Functional/Driver/Common/Integration/BaseTest.php         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php b/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php
index a5271f5..b2c681a 100644
--- a/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php
+++ b/tests/Behavior/Functional/Driver/Common/Integration/BaseTest.php
@@ -35,7 +35,7 @@
 use Spiral\Tokenizer\Config\TokenizerConfig;
 use Spiral\Tokenizer\Tokenizer;
 
-class BaseTest extends \Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\BaseTest
+abstract class BaseTest extends \Cycle\ORM\Entity\Behavior\Tests\Functional\Driver\Common\BaseTest
 {
     protected SchemaInterface $schema;
     protected ORMInterface $orm;
@@ -61,7 +61,7 @@ protected function prepareOrm(string|array $entitiesPath): void
 
         $classLocator = $tokenizer->classLocator();
 
-        $this->schema = new Schema((new Compiler())->compile($this->registry = new Registry($this->dbal), [
+        $this->schema = new Schema((new Compiler())->compile(new Registry($this->dbal), [
             new ResetTables(),
             new Embeddings($classLocator, $reader),
             new Entities($classLocator, $reader),