feat: Add category unto ApplicationFailure;

Configure mapping

Author: roxblnfk

src/Exception/Failure/ApplicationErrorCategory.php

@@ -11,17 +11,19 @@
 
 namespace Temporal\Exception\Failure;
 
+use Temporal\Api\Enums\V1\ApplicationErrorCategory as ProtoCategory;
+
 /**
  * Used to categorize application failures, for example, to distinguish benign errors from others.
  *
  * @see \Temporal\Api\Enums\V1\ApplicationErrorCategory
  */
-enum ApplicationErrorCategory
+enum ApplicationErrorCategory: int
 {
-    case Unspecified;
+    case Unspecified = ProtoCategory::APPLICATION_ERROR_CATEGORY_UNSPECIFIED;
 
     /**
      * Expected application error with little/no severity.
      */
-    case Benign;
+    case Benign = ProtoCategory::APPLICATION_ERROR_CATEGORY_BENIGN;
 }

src/Exception/Failure/ApplicationFailure.php

@@ -49,6 +49,7 @@ class ApplicationFailure extends TemporalFailure
     /**
      * @param ValuesInterface|null $details Optional details about the failure.
      * @param \DateInterval|null $nextRetryDelay Delay before the next retry attempt.
+     * @param ApplicationErrorCategory $category The category of the application failure.
      */
     public function __construct(
         string $message,
@@ -57,6 +58,7 @@ public function __construct(
         ?ValuesInterface $details = null,
         ?\Throwable $previous = null,
         private ?\DateInterval $nextRetryDelay = null,
+        private readonly ApplicationErrorCategory $category = ApplicationErrorCategory::Unspecified,
     ) {
         parent::__construct(
             self::buildMessage(\compact('message', 'type', 'nonRetryable')),
@@ -103,4 +105,9 @@ public function setNextRetryDelay(?\DateInterval $nextRetryDelay): void
     {
         $this->nextRetryDelay = $nextRetryDelay;
     }
+
+    public function getApplicationErrorCategory(): ApplicationErrorCategory
+    {
+        return $this->category;
+    }
 }

src/Exception/Failure/FailureConverter.php

@@ -70,6 +70,7 @@ public static function mapExceptionToFailure(\Throwable $e, DataConverterInterfa
                 $info = new ApplicationFailureInfo();
                 $info->setType($e->getType());
                 $info->setNonRetryable($e->isNonRetryable());
+                $info->setCategory($e->getApplicationErrorCategory()->value);
 
                 // Set Next Retry Delay
                 $nextRetry = DateInterval::toDuration($e->getNextRetryDelay());
@@ -181,6 +182,7 @@ private static function createFailureException(Failure $failure, DataConverterIn
                     $details,
                     $previous,
                     DateInterval::parseOrNull($info->getNextRetryDelay()),
+                    ApplicationErrorCategory::tryFrom($info->getCategory()) ?? ApplicationErrorCategory::Unspecified,
                 );
 
             case $failure->hasTimeoutFailureInfo():