Marks deprecated classes

This patch marks as deprecated classes we plan to remove in version
3.0.0.

src/Delegate/CallableDelegateDecorator.php

@@ -15,6 +15,10 @@
 /**
  * Decorate callable delegates as http-interop delegates in order to process
  * incoming requests.
+ *
+ * @deprecated since 2.2.0; to be removed in 3.0.0. This class is an internal
+ *     detail used to allow usage of Stratigility within double-pass middleware
+ *     frameworks; starting in 3.0.0, Stratigility will support PSR-15 only.
  */
 class CallableDelegateDecorator implements DelegateInterface
 {

src/Exception/InvalidMiddlewareException.php

@@ -9,6 +9,9 @@
 
 use InvalidArgumentException;
 
+/**
+ * @deprecated since 2.2.0; to be removed in 3.0.0.
+ */
 class InvalidMiddlewareException extends InvalidArgumentException
 {
     /**

src/Exception/InvalidRequestTypeException.php

@@ -12,6 +12,8 @@
 /**
  * Exception thrown when Dispatch::process() is called with a non-interop
  * handler provided, and the request is not a server request type.
+ *
+ * @deprecated since 2.2.0; to be removed in 3.0.0. No longer used internally.
  */
 class InvalidRequestTypeException extends RuntimeException
 {

src/Middleware/CallableInteropMiddlewareWrapper.php

@@ -11,6 +11,9 @@
 use Webimpress\HttpMiddlewareCompatibility\HandlerInterface as DelegateInterface;
 use Webimpress\HttpMiddlewareCompatibility\MiddlewareInterface as ServerMiddlewareInterface;
 
+/**
+ * @deprecated since 2.2.0; to be removed in 3.0.0. Use CallableMiddlewareDecorator instead.
+ */
 class CallableInteropMiddlewareWrapper implements ServerMiddlewareInterface
 {
     /**

src/Middleware/CallableMiddlewareWrapper.php

@@ -18,6 +18,8 @@
 /**
  * Decorate legacy callable middleware to make it dispatchable as server
  * middleware.
+ *
+ * @deprecated since 2.2.0; to be removed in 3.0.0. Use DoublePassMiddlewareDecorator instead.
  */
 class CallableMiddlewareWrapper implements ServerMiddlewareInterface
 {

src/Middleware/CallableMiddlewareWrapperFactory.php

@@ -9,6 +9,9 @@
 
 use Psr\Http\Message\ResponseInterface;
 
+/**
+ * @deprecated since 2.2.0; to be removed in 3.0.0.
+ */
 class CallableMiddlewareWrapperFactory
 {
     /**

src/NoopFinalHandler.php

@@ -10,6 +10,9 @@
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
 
+/**
+ * @deprecated since 2.2.0; to be removed in 3.0.0.
+ */
 class NoopFinalHandler
 {
     /**

src/Route.php

@@ -17,6 +17,8 @@
  * Details the subpath on which the middleware is active, and the
  * handler for the middleware itself.
  *
+ * @internal
+ * @deprecated since 2.2.0, to be removed in 3.0.0.
  * @property-read callable $handler Handler for this route
  * @property-read string $path Path for this route
  */