feat(trigger): enhance trigger subscription management and processing

- Refactor trigger provider classes to improve naming consistency and clarity
- Introduce new methods for managing trigger subscriptions, including validation and dispatching
- Update API endpoints to reflect changes in subscription handling
- Implement logging and request management for endpoint interactions
- Enhance data models to support subscription attributes and lifecycle management

Co-authored-by: Claude <noreply@anthropic.com>

api/controllers/trigger/trigger.py

@@ -1,21 +1,45 @@
 import logging
+import re
 
 from flask import jsonify, request
 from werkzeug.exceptions import NotFound
 
 from controllers.trigger import bp
+from services.trigger.trigger_provider_service import TriggerProviderService
+from services.trigger.trigger_subscription_validation_service import TriggerSubscriptionValidationService
 from services.trigger_service import TriggerService
 
 logger = logging.getLogger(__name__)
 
+UUID_PATTERN = r"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
+UUID_MATCHER = re.compile(UUID_PATTERN)
 
-@bp.route("/trigger/webhook/<string:endpoint_id>", methods=["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"])
-def trigger_webhook(endpoint_id: str):
+
+@bp.route(
+    "/trigger/endpoint/<string:endpoint_id>", methods=["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]
+)
+@bp.route(
+    "/trigger/endpoint-debug/<string:endpoint_id>", methods=["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]
+)
+def trigger_endpoint(endpoint_id: str):
     """
-    Handle webhook trigger calls.
+    Handle endpoint trigger calls.
     """
+    # endpoint_id must be UUID
+    if not UUID_MATCHER.match(endpoint_id):
+        raise NotFound("Invalid endpoint ID")
+    handling_chain = [
+        TriggerService.process_endpoint,
+        TriggerSubscriptionValidationService.process_validating_endpoint,
+    ]
     try:
-        return TriggerService.process_webhook(endpoint_id, request)
+        for handler in handling_chain:
+            response = handler(endpoint_id, request)
+            if response:
+                break
+        if not response:
+            raise NotFound("Endpoint not found")
+        return response
     except ValueError as e:
         raise NotFound(str(e))
     except Exception as e: