From ec42ef9969645fc81f56404c4d00051464dd1e08 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Munsch?= <github@jeremydev.ovh>
Date: Sun, 20 Sep 2026 17:16:44 +0200
Subject: [PATCH] feat(shared): add DDD use case contracts

---
 src/Shared/DDD/UseCases/Executor.php      | 10 ++++++++++
 src/Shared/DDD/UseCases/Presenter.php     | 19 +++++++++++++++++++
 src/Shared/DDD/UseCases/Transactional.php | 13 +++++++++++++
 3 files changed, 42 insertions(+)
 create mode 100644 src/Shared/DDD/UseCases/Executor.php
 create mode 100644 src/Shared/DDD/UseCases/Presenter.php
 create mode 100644 src/Shared/DDD/UseCases/Transactional.php

diff --git a/src/Shared/DDD/UseCases/Executor.php b/src/Shared/DDD/UseCases/Executor.php
new file mode 100644
index 0000000..11212bd
--- /dev/null
+++ b/src/Shared/DDD/UseCases/Executor.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Shared\DDD\UseCases;
+
+interface Executor
+{
+    public function execute(): object;
+}
diff --git a/src/Shared/DDD/UseCases/Presenter.php b/src/Shared/DDD/UseCases/Presenter.php
new file mode 100644
index 0000000..3ac29e1
--- /dev/null
+++ b/src/Shared/DDD/UseCases/Presenter.php
@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Shared\DDD\UseCases;
+
+/**
+ * @template TOutput of Output
+ *
+ * @template-covariant T of object
+ */
+interface Presenter
+{
+    /**
+     * @param  TOutput  $output
+     * @return T
+     */
+    public function present(Output $output): object;
+}
diff --git a/src/Shared/DDD/UseCases/Transactional.php b/src/Shared/DDD/UseCases/Transactional.php
new file mode 100644
index 0000000..11878f5
--- /dev/null
+++ b/src/Shared/DDD/UseCases/Transactional.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Shared\DDD\UseCases;
+
+/**
+ * Marker interface for use cases that perform database mutations
+ * requiring an atomic database transaction.
+ */
+interface Transactional
+{
+}