Added some additional listener routing features based on dogfooding

Author: jeremeamia

src/App.php

@@ -468,6 +468,18 @@ public function viewSubmission(string $callbackId, $listener): self
         return $this;
     }
 
+    /**
+     * Configures an async listener for an incoming "view_submission" request.
+     *
+     * @param string $callbackId
+     * @param Listener|callable(Context): void|class-string $listener
+     * @return $this
+     */
+    public function viewSubmissionAsync(string $callbackId, $listener): self
+    {
+        return $this->router->viewSubmissionAsync($callbackId, $listener);
+    }
+
     /**
      * Configures a listener for an incoming "view_closed" request.
      *

src/Listeners/Dual.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SlackPhp\Framework\Listeners;
+
+use SlackPhp\Framework\{Context, Listener};
+
+/**
+ * Base class for listeners that have both sync and async logic.
+ *
+ * Note: Does not automatically call defer. This allows the flexibility to not defer if the sync logic represents a
+ *       complete handling of the request in some cases.
+ */
+abstract class Dual implements Listener
+{
+    public function handle(Context $context): void
+    {
+        if ($context->isAcknowledged()) {
+            $this->handleAfterAck($context);
+        } else {
+            $this->handleAck($context);
+        }
+    }
+
+    abstract protected function handleAck(Context $context): void;
+
+    abstract protected function handleAfterAck(Context $context): void;
+}

src/Router.php

@@ -234,6 +234,18 @@ public function viewSubmission(string $callbackId, $listener): self
         return $this->register(PayloadType::viewSubmission(), $callbackId, $listener);
     }
 
+    /**
+     * Configures an async listener for an incoming "view_submission" request.
+     *
+     * @param string $callbackId
+     * @param Listener|callable(Context): void|class-string $listener
+     * @return $this
+     */
+    public function viewSubmissionAsync(string $callbackId, $listener): self
+    {
+        return $this->viewSubmission($callbackId, Route::async($listener));
+    }
+
     /**
      * Configures a listener for an incoming "view_closed" request.
      *