From 3dc0628807f151f5bb8e02949f2235aa3275a92f Mon Sep 17 00:00:00 2001
From: Jannik Zschiesche <j.zschiesche@21torr.com>
Date: Wed, 17 Jun 2026 10:41:42 +0200
Subject: [PATCH] Return task uuid from task manager

---
 CHANGELOG.md                      | 6 ++++++
 src/Manager/TaskManager.php       | 7 ++++---
 tests/Manager/TaskManagerTest.php | 4 ++--
 3 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3ab962d..7375335 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+3.4.1
+=====
+
+* (improvement) Return task uuid from task manager.
+
+
 3.4.0
 =====
 
diff --git a/src/Manager/TaskManager.php b/src/Manager/TaskManager.php
index 59e2023..c53414f 100644
--- a/src/Manager/TaskManager.php
+++ b/src/Manager/TaskManager.php
@@ -23,11 +23,11 @@ public function __construct (
 	 *
 	 * @param StampInterface[] $stamps
 	 *
-	 * @return bool whether the message was added. If this is false, an identical job is already queued.
+	 * @return string The uuid of the task
 	 *
 	 * @api
 	 */
-	public function enqueue (Task $task, array $stamps = []) : bool
+	public function enqueue (Task $task, array $stamps = []) : string
 	{
 		$uniqueTaskId = $task->getMetaData()->uniqueTaskId;
 
@@ -40,7 +40,8 @@ public function enqueue (Task $task, array $stamps = []) : bool
 			new Envelope($task, $stamps),
 		);
 
-		return true;
+		/** @phpstan-ignore-next-line property.deprecated (The uuid integration will be refactored in v4) */
+		return $task->ulid;
 	}
 
 	/**
diff --git a/tests/Manager/TaskManagerTest.php b/tests/Manager/TaskManagerTest.php
index b29c292..159bd8e 100644
--- a/tests/Manager/TaskManagerTest.php
+++ b/tests/Manager/TaskManagerTest.php
@@ -97,7 +97,7 @@ public function testEnqueueWithoutUniqueTaskIdAlwaysDispatches () : void
 		$manager = $this->createManager(["queue" => $this->createListableTransport()], $bus);
 		$task = $this->createTask(null);
 
-		self::assertTrue($manager->enqueue($task));
+		self::assertIsString($manager->enqueue($task));
 	}
 
 	public function testEnqueueReturnsTrueWhenNoConflict () : void
@@ -107,7 +107,7 @@ public function testEnqueueReturnsTrueWhenNoConflict () : void
 
 		$manager = $this->createManager(["queue" => $this->createListableTransport()], $bus);
 
-		self::assertTrue($manager->enqueue($this->createTask("test.task")));
+		self::assertIsString($manager->enqueue($this->createTask("test.task")));
 	}
 
 	public function testEnqueueReturnsFalseWhenDuplicateInQueue () : void