Add request, voice code, feedback, and HTTP modules

RequestManager (more time, day type change, ban lift with temp token flow),
VoiceCode (HMAC-SHA256 challenge-response for offline approval),
FeedbackManager (submit, load, reply) -- all ported from PHP reference.

Co-Authored-By: claude-flow <ruv@ruv.net>

Author: Allow2CEO

allow2_service/feedback.py

@@ -0,0 +1,158 @@
+"""Manages feedback submission and discussion threads via the Allow2 API.
+
+Feedback allows users to report issues, request features, or communicate
+with the Allow2 Parental Freedom support team.
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Any, Dict, List
+from urllib.parse import quote
+
+from allow2_service.exceptions.api_error import ApiError
+from allow2_service.exceptions.unpaired import UnpairedError
+from allow2_service.http_response import HttpResponse
+from allow2_service.models.feedback_category import FeedbackCategory
+
+
+class FeedbackManager:
+    """Manages feedback submission and discussion threads via the Allow2 API."""
+
+    def __init__(
+        self,
+        http_client: Any,
+        api_host: str,
+    ) -> None:
+        self._http_client = http_client
+        self._api_host = api_host
+
+    def submit(
+        self,
+        access_token: str,
+        user_id: str,
+        category: FeedbackCategory,
+        message: str,
+    ) -> str:
+        """Submit new feedback.
+
+        Args:
+            access_token: Valid OAuth2 access token.
+            user_id: The integrating application's user ID.
+            category: The feedback category.
+            message: The feedback message.
+
+        Returns:
+            The discussion ID for the created feedback thread.
+
+        Raises:
+            UnpairedError: If the API returns 401/403.
+            ApiError: On other API failures.
+        """
+        response: HttpResponse = self._http_client.post(
+            self._api_host + "/feedback/submit",
+            {
+                "access_token": access_token,
+                "category": category.value,
+                "message": message,
+            },
+        )
+
+        if response.is_unauthorized():
+            raise UnpairedError(user_id)
+
+        if not response.is_success():
+            body = None
+            try:
+                body = response.json()
+            except (json.JSONDecodeError, ValueError):
+                pass
+            raise ApiError(
+                message="Failed to submit feedback: HTTP %d" % response.status_code,
+                http_status_code=response.status_code,
+                response_body=body,
+            )
+
+        data = response.json()
+        return str(
+            data.get("discussionId", data.get("feedbackId", data.get("id", "")))
+        )
+
+    def load(self, access_token: str, user_id: str) -> List[Dict[str, Any]]:
+        """Load all feedback discussions for the authenticated user.
+
+        Args:
+            access_token: Valid OAuth2 access token.
+            user_id: The integrating application's user ID.
+
+        Returns:
+            List of feedback discussion threads.
+
+        Raises:
+            UnpairedError: If the API returns 401/403.
+            ApiError: On other API failures.
+        """
+        response: HttpResponse = self._http_client.get(
+            self._api_host + "/feedback/load",
+            headers={"Authorization": "Bearer " + access_token},
+        )
+
+        if response.is_unauthorized():
+            raise UnpairedError(user_id)
+
+        if not response.is_success():
+            body = None
+            try:
+                body = response.json()
+            except (json.JSONDecodeError, ValueError):
+                pass
+            raise ApiError(
+                message="Failed to load feedback: HTTP %d" % response.status_code,
+                http_status_code=response.status_code,
+                response_body=body,
+            )
+
+        data = response.json()
+        return data.get("discussions", data.get("feedback", []))
+
+    def reply(
+        self,
+        access_token: str,
+        user_id: str,
+        discussion_id: str,
+        message: str,
+    ) -> None:
+        """Reply to an existing feedback discussion thread.
+
+        Args:
+            access_token: Valid OAuth2 access token.
+            user_id: The integrating application's user ID.
+            discussion_id: The discussion thread ID to reply to.
+            message: The reply message.
+
+        Raises:
+            UnpairedError: If the API returns 401/403.
+            ApiError: On other API failures.
+        """
+        response: HttpResponse = self._http_client.post(
+            self._api_host + "/feedback/" + quote(discussion_id, safe="") + "/reply",
+            {
+                "access_token": access_token,
+                "message": message,
+            },
+        )
+
+        if response.is_unauthorized():
+            raise UnpairedError(user_id)
+
+        if not response.is_success():
+            body = None
+            try:
+                body = response.json()
+            except (json.JSONDecodeError, ValueError):
+                pass
+            raise ApiError(
+                message="Failed to reply to feedback: HTTP %d" % response.status_code,
+                http_status_code=response.status_code,
+                response_body=body,
+            )