endpoint_manager.py

Go to the documentation of this file.

r"""
# +==== BEGIN CatFeeder =================+
# LOGO:
# ..............(..../\
# ...............)..(.')
# ..............(../..)
# ...............\‍(__)|
# Inspired by Joan Stark
# source https://www.asciiart.eu/
# animals/cats
# /STOP
# PROJECT: CatFeeder
# FILE: endpoints_routes.py
# CREATION DATE: 11-10-2025
# LAST Modified: 18:52:11 31-01-2026
# DESCRIPTION:
# This is the backend server in charge of making the actual website work.
# /STOP
# COPYRIGHT: (c) Cat Feeder
# PURPOSE: This is the file in charge of storing the endpoints_initialised ready to be imported into the server class.
# // AR
# +==== END CatFeeder =================+
"""
from typing import Optional
from display_tty import Disp, initialise_logger
from . import endpoint_constants as ENDPOINT_CONST
from .endpoints import Bonus
from .endpoints import CatEndpoints
from .endpoints import UserEndpoints
from .endpoints import AdminEndpoints
from .endpoints import TokenEndpoints
from .endpoints import FrontEndManager
from .endpoints import TestingEndpoints
from ..path_manager import PathManager, decorators
from ..core import FinalClass
from ..utils.password_handling import PasswordHandling
from ..core.runtime_manager import RuntimeManager, RI
from ..utils.oauth_authentication import OAuthAuthentication
 
 
class EndpointManager(metaclass=FinalClass):
    """_summary_
    """
 
    disp: Disp = initialise_logger(__qualname__, False)
 
    def __init__(self, success: int = 0, error: int = 84, debug: bool = False) -> None:
        """_summary_
 
        Args:
            runtime_data (RuntimeData): _description_
            success (int, optional): _description_. Defaults to 0.
            error (int, optional): _description_. Defaults to 84.
            debug (bool, optional): _description_. Defaults to False.
        """
        # ------------------------ The logging function ------------------------
        self.disp.update_disp_debug(debug)
        self.disp.log_debug("Initialising...")
        # -------------------------- Inherited values --------------------------
        self.debug: bool = debug
        self.success: int = success
        self.error: int = error
        self.runtime_manager: RuntimeManager = RI
        self.password_handling_initialised: PasswordHandling = PasswordHandling(
            self.error,
            self.success,
            self.debug
        )
        self.paths_initialisedpaths_initialised: Optional[PathManager] = None
        self._retrieve_path_manager()
        self.oauth_authentication_initialisedoauth_authentication_initialised: Optional[OAuthAuthentication] = self.runtime_manager.get_if_exists(
            OAuthAuthentication,
            None
        )
        self.disp.update_disp_debug(self.debug)
        # ------------------- Initialize endpoints sub-classes ------------------
        self.user: UserEndpoints = UserEndpoints(
            success=self.success,
            error=self.error,
            debug=self.debug
        )
        self.bonus: Bonus = Bonus(
            success=success,
            error=error,
            debug=debug
        )
        self.cat_endpoints: CatEndpoints = CatEndpoints(
            success=success,
            error=error,
            debug=debug
        )
        self.admin: AdminEndpoints = AdminEndpoints(
            success=success,
            error=error,
            debug=debug
        )
        self.testing_endpoints: TestingEndpoints = TestingEndpoints(
            success=self.success,
            error=self.error,
            debug=self.debug
        )
        self.front_end_manager: FrontEndManager = FrontEndManager(
            success=self.success,
            error=self.error,
            debug=self.debug
        )
        self.token_endpoints: TokenEndpoints = TokenEndpoints(
            success=self.success,
            error=self.error,
            debug=self.debug
        )
        # ------------------------- Endpoint Prefixing -------------------------
        self.api_str: str = "/api"
        self.v1_str: str = f"{self.api_str}/v1"
        self.oauth_str: str = f"{self.v1_str}/oauth"
        self.test_endpoint: str = "/testing"
        self.sql_endpoint: str = f"{self.test_endpoint}/sql"
        self.bucket_endpoint: str = f"{self.test_endpoint}/bucket"
        self.favicon_endpoint: str = f"{self.v1_str}/favicons"
        self.user_favicon_endpoint: str = f"{self.v1_str}/user_favicon"
        self.token_endpoint: str = f"{self.v1_str}/token"
        self.disp.log_debug("Initialised")
 
    def _retrieve_path_manager(self) -> Optional[PathManager]:
        if self.paths_initialisedpaths_initialised is not None:
            return self.paths_initialisedpaths_initialised
        if self.runtime_manager.exists(PathManager):
            self.paths_initialisedpaths_initialised = self.runtime_manager.get(PathManager)
            return self.paths_initialisedpaths_initialised
        return None
 
    def inject_routes(self) -> None:
        """_summary_
        """
        self._retrieve_path_manager()
        if not self.paths_initialisedpaths_initialised:
            err_msg: str = "PathManager could not be found"
            self.disp.log_critical(err_msg)
            raise RuntimeError(err_msg)
 
        # User Endpoints
        # |- connection
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/register", self.user.post_register, ["POST"],
            decorators=[decorators.public_endpoint(), decorators.user_endpoint]
        )
 
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/login", self.user.post_login, ["POST"],
            decorators=[decorators.public_endpoint(), decorators.user_endpoint]
        )
 
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/logout", self.user.post_logout, ["POST"],
            decorators=[decorators.auth_endpoint(), decorators.user_endpoint]
        )
 
        # |- e-mail verification
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/send_email_verification", self.user.post_send_email_verification,
            ["POST"], decorators=[decorators.auth_endpoint(), decorators.user_endpoint]
        )
 
        # |- password reset
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/reset_password", self.user.put_reset_password,
            ["PUT"], decorators=[decorators.public_endpoint(), decorators.user_endpoint]
        )
 
        # |- user update
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/user", self.user.put_user, ["PUT"],
            decorators=[decorators.auth_endpoint(), decorators.user_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/user", self.user.patch_user, ["PATCH"],
            decorators=[decorators.auth_endpoint(), decorators.user_endpoint]
        )
 
        # |- info querying
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/user", self.user.get_user, ["GET"],
            decorators=[decorators.auth_endpoint(), decorators.user_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/user_id", self.user.get_user_id, ["GET"],
            decorators=[decorators.auth_endpoint(), decorators.user_endpoint]
        )
 
        # |- user removal
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/user", self.user.delete_user, ["DELETE"],
            decorators=[decorators.admin_endpoint(), decorators.user_endpoint]
        )
 
        # Cat Endpoints
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder", self.cat_endpoints.put_register_feeder, "PUT",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Register a new cat feeder with location and details",
                    example={
                        "latitude": 48.8566,
                        "longitude": 2.3522,
                        "city_locality": "Paris",
                        "country": "France",
                        "mac": "AA:BB:CC:DD:EE:FF",
                        "name": "My Feeder"
                    }
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder", self.cat_endpoints.patch_feeder, "PATCH",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Update feeder details - provide id or mac, and fields to update",
                    example={
                        "mac": "AA:BB:CC:DD:EE:FF",
                        "name": "Updated Feeder Name",
                        "latitude": 48.8566,
                        "longitude": 2.3522
                    }
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder", self.cat_endpoints.get_feeder, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Get feeder status by mac, name, or id",
                    example={"mac": "AA:BB:CC:DD:EE:FF"}
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/status", self.cat_endpoints.get_feeder_status, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Get feeder status by mac, name, or id",
                    example={"mac": "AA:BB:CC:DD:EE:FF"}
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder", self.cat_endpoints.delete_feeder, "DELETE",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Remove a feeder based on it's mac or id",
                    example={"mac": "AA:BB:CC:DD:EE:FF"}
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeders", self.cat_endpoints.get_feeders, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.set_operation_id("get_feeders"),
                decorators.set_summary("Get all feeders"),
                decorators.set_description(
                    "Retrieve a list of all feeders registered by the authenticated user")
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/fed", self.cat_endpoints.get_distribute_food, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Get food distribution status",
                    example={"beacon_mac": "AA:BB:CC:DD:EE:FF"}
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/fed", self.cat_endpoints.post_distribute_food, "POST",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Distribute food to feeder",
                    example={
                        "beacon_mac": "AA:BB:CC:DD:EE:FF",
                        "feeder_mac": "11:22:33:44:55:66",
                        "amount": 50
                    }
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/ip", self.cat_endpoints.put_feeder_ip, "PUT",
            decorators=[
                decorators.public_endpoint(),  # Changed: feeder calls this directly
                decorators.cat_endpoint,
                decorators.json_body(
                    "Feeder IP update - called by feeder itself after reboot",
                    example={
                        "mac": "AA:BB:CC:DD:EE:FF",
                        "ip": "192.168.1.100"
                    }
                ),
                decorators.set_operation_id("update_feeder_ip_address"),
                decorators.set_summary("Update feeder IP address"),
                decorators.set_description(
                    "Allows feeder to update its IP address after reboot")
            ]
        )
        # Beacon routes
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/beacon", self.cat_endpoints.put_register_beacon, "PUT",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Register a new beacon for a feeder",
                    example={
                        "mac": "AA:BB:CC:DD:EE:FF",
                        "name": "Beacon1"
                    }
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/beacon/status", self.cat_endpoints.get_beacon_status, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Get beacon status by mac, name, or id",
                    example={"mac": "AA:BB:CC:DD:EE:FF"}
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/beacon", self.cat_endpoints.patch_beacon, "PATCH",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Update beacon details - provide id or name, and fields to update",
                    example={
                        "id": 123,
                        "name": "Updated Beacon"
                    }
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/beacon", self.cat_endpoints.delete_beacon, "DELETE",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Remove a beacon based on it's id",
                    example={"id": 123}
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/beacons", self.cat_endpoints.get_beacons, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.set_operation_id("get_beacons"),
                decorators.set_summary("Get all beacons"),
                decorators.set_description(
                    "Retrieve a list of all beacons registered by the authenticated user")
            ]
        )
        # location endpoints
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/beacon/locations", self.cat_endpoints.get_beacon_locations, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Get beacon location history",
                    example={"mac": "AA:BB:CC:DD:EE:FF"}
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/beacon/location", self.cat_endpoints.post_beacon_location, "POST",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Post new beacon location",
                    example={
                        "beacon_mac": "AA:BB:CC:DD:EE:FF",
                        "feeder_mac": "11:22:33:44:55:66"
                    }
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/visits", self.cat_endpoints.get_feeder_visits, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Get feeder visit history",
                    example={"mac": "AA:BB:CC:DD:EE:FF"}
                )
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/feeder/visit", self.cat_endpoints.post_feeder_visit, "POST",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Record a feeder visit by a pet",
                    example={
                        "feeder_mac": "11:22:33:44:55:66",
                        "beacon_mac": "AA:BB:CC:DD:EE:FF"
                    }
                )
            ]
        )
 
        # Pet endpoints
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/pet", self.cat_endpoints.put_register_pet, "PUT",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Pet registration data with beacon_mac and name",
                    example={
                        "beacon_mac": "AA:BB:CC:DD:EE:FF",
                        "name": "Whiskers",
                        "food_max": 100,
                        "time_reset_hours": 24
                    }
                ),
                decorators.requires_bearer_auth()
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/pet", self.cat_endpoints.patch_pet, "PATCH",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "Pet update data with id and fields to update",
                    example={
                        "id": 123,
                        "name": "Whiskers Updated",
                        "food_max": 150
                    }
                ),
                decorators.requires_bearer_auth()
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/pet", self.cat_endpoints.get_pet, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "JSON body with pet ID to retrieve",
                    example={"id": 123}
                ),
                decorators.requires_bearer_auth()
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/pet", self.cat_endpoints.delete_pet, "DELETE",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.json_body(
                    "JSON body with pet ID to delete",
                    example={"id": 123}
                ),
                decorators.requires_bearer_auth()
            ]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.v1_str}/pets", self.cat_endpoints.get_pets, "GET",
            decorators=[
                decorators.auth_endpoint(),
                decorators.cat_endpoint,
                decorators.set_operation_id("get_pets"),
                decorators.set_summary("Get all pets"),
                decorators.set_description(
                    "Retrieve a list of all pets registered by the authenticated user")
            ]
        )
 
        # Front-end endpoints
        self.front_end_manager.inject_paths(self.paths_initialisedpaths_initialised)
 
        # Bonus routes - BEACON ENDPOINTS: Use individual functions to avoid Operation ID conflicts
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "", self.bonus.root_beacon_get, "GET",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "", self.bonus.root_beacon_post, "POST",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "", self.bonus.root_beacon_put, "PUT",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "", self.bonus.root_beacon_patch, "PATCH",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "", self.bonus.root_beacon_delete, "DELETE",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "", self.bonus.root_beacon_head, "HEAD",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "", self.bonus.root_beacon_options, "OPTIONS",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
 
        # Home beacon endpoints
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/", self.bonus.home_beacon_get, "GET",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/", self.bonus.home_beacon_post, "POST",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/", self.bonus.home_beacon_put, "PUT",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/", self.bonus.home_beacon_patch, "PATCH",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/", self.bonus.home_beacon_delete, "DELETE",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/", self.bonus.home_beacon_head, "HEAD",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/", self.bonus.home_beacon_options, "OPTIONS",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
 
        # API v1 beacon endpoints
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            f"{self.v1_str}/", self.bonus.api_v1_beacon_get, "GET",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            f"{self.v1_str}/", self.bonus.api_v1_beacon_post, "POST",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            f"{self.v1_str}/", self.bonus.api_v1_beacon_put, "PUT",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            f"{self.v1_str}/", self.bonus.api_v1_beacon_patch, "PATCH",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            f"{self.v1_str}/", self.bonus.api_v1_beacon_delete, "DELETE",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            f"{self.v1_str}/", self.bonus.api_v1_beacon_head, "HEAD",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            f"{self.v1_str}/", self.bonus.api_v1_beacon_options, "OPTIONS",
            decorators=[decorators.public_endpoint(),
                        decorators.system_endpoint]
        )
 
        # The endpoint to stop the server
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            f"{self.v1_str}/stop", self.bonus.post_stop_server, "PUT",
            decorators=[
                decorators.admin_endpoint(),
                decorators.system_endpoint
            ]
        )
 
        # Health check endpoint - use conditional registration
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/health", self.bonus.get_health, "GET",
            decorators=[
                decorators.public_endpoint(),
                decorators.system_endpoint
            ]
        )
 
        # favicon.ico support
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/favicon.ico", self.bonus.get_favicon, "GET",
            decorators=[
                decorators.public_endpoint(),
                decorators.system_endpoint
            ]
        )
 
        # /static/logo.png support
        self.paths_initialisedpaths_initialised.add_path_if_not_exists(
            "/static/logo.png", self.bonus.get_static_logo, "GET",
            decorators=[
                decorators.public_endpoint(),
                decorators.system_endpoint
            ]
        )
 
        # Oauth routes
        self.oauth_authentication_initialisedoauth_authentication_initialised = self.runtime_manager.get_if_exists(
            OAuthAuthentication,
            self.oauth_authentication_initialisedoauth_authentication_initialised
        )
        if not self.oauth_authentication_initialisedoauth_authentication_initialised:
            self.disp.log_error("OAuth Authentication is missing")
            raise RuntimeError("Token validation service unavailable")
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.oauth_str}/login", self.oauth_authentication_initialisedoauth_authentication_initialised.oauth_login, "POST",
            # No () for oauth_endpoint
            decorators=[decorators.public_endpoint(),
                        decorators.oauth_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.oauth_str}/callback", self.oauth_authentication_initialisedoauth_authentication_initialised.oauth_callback, "POST",
            # No () for oauth_endpoint
            decorators=[decorators.public_endpoint(),
                        decorators.oauth_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.oauth_str}/{'{provider}'}",
            self.oauth_authentication_initialisedoauth_authentication_initialised.add_oauth_provider, "POST",
            # No () for oauth_endpoint
            decorators=[decorators.admin_endpoint(), decorators.oauth_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.oauth_str}/{'{provider}'}",
            self.oauth_authentication_initialisedoauth_authentication_initialised.update_oauth_provider_data, "PUT",
            # No () for oauth_endpoint
            decorators=[decorators.admin_endpoint(), decorators.oauth_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.oauth_str}/{'{provider}'}",
            self.oauth_authentication_initialisedoauth_authentication_initialised.patch_oauth_provider_data, "PATCH",
            # No () for oauth_endpoint
            decorators=[decorators.admin_endpoint(), decorators.oauth_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.oauth_str}/{'{provider}'}",
            self.oauth_authentication_initialisedoauth_authentication_initialised.delete_oauth_provider, "DELETE",
            # No () for oauth_endpoint
            decorators=[decorators.admin_endpoint(), decorators.oauth_endpoint]
        )
 
        # Token route
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.token_endpoint}/valid", self.token_endpoints.get_token_valid, "GET",
            # No () for token_endpoint
            decorators=[decorators.auth_endpoint(), decorators.token_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.token_endpoint}/admin", self.token_endpoints.get_admin, "GET",
            # No () for token_endpoint
            decorators=[decorators.admin_endpoint(), decorators.token_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.token_endpoint}/ttl", self.token_endpoints.get_time_to_live, "GET",
            # No () for token_endpoint
            decorators=[decorators.auth_endpoint(), decorators.token_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.token_endpoint}/info", self.token_endpoints.get_token_info, "GET",
            # No () for token_endpoint
            decorators=[decorators.auth_endpoint(), decorators.token_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.token_endpoint}/refresh", self.token_endpoints.post_refresh_token, "POST",
            # No () for token_endpoint
            decorators=[decorators.auth_endpoint(), decorators.token_endpoint]
        )
        self.paths_initialisedpaths_initialised.add_path(
            f"{self.token_endpoint}/revoke_account_tokens", self.token_endpoints.delete_revoke_account_token, "DELETE",
            # No () for token_endpoint
            decorators=[decorators.admin_endpoint(), decorators.token_endpoint]
        )
 
        # Testing endpoints (only if enabled in configuration)
        if ENDPOINT_CONST.TEST_ENABLE_TESTING_ENDPOINTS:
            self.disp.log_debug("Testing endpoints enabled")
            # SQL testing endpoints
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/tables", self.testing_endpoints.get_tables, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/table/columns", self.testing_endpoints.get_table_columns, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/table/describe", self.testing_endpoints.describe_table, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/table/size", self.testing_endpoints.get_table_size, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/version", self.testing_endpoints.get_database_version, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/connected", self.testing_endpoints.test_sql_connection, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/triggers", self.testing_endpoints.get_triggers, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/triggers/names", self.testing_endpoints.get_trigger_names, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/datetime/now", self.testing_endpoints.get_current_datetime, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/datetime/today", self.testing_endpoints.get_current_date, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/datetime/to-string", self.testing_endpoints.convert_datetime_to_string, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.sql_endpoint}/datetime/from-string", self.testing_endpoints.convert_string_to_datetime, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            # Bucket testing endpoints
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.bucket_endpoint}/buckets", self.testing_endpoints.get_buckets, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.bucket_endpoint}/connected", self.testing_endpoints.test_bucket_connection, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.bucket_endpoint}/create", self.testing_endpoints.create_test_bucket, "POST",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.bucket_endpoint}/upload", self.testing_endpoints.upload_test_file_stream, "POST",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.bucket_endpoint}/files", self.testing_endpoints.get_bucket_files, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.bucket_endpoint}/files/info", self.testing_endpoints.get_bucket_file_info, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.bucket_endpoint}/download", self.testing_endpoints.download_test_file_stream, "GET",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.bucket_endpoint}/delete", self.testing_endpoints.delete_test_bucket, "DELETE",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
            self.paths_initialisedpaths_initialised.add_path(
                f"{self.bucket_endpoint}/delete-file", self.testing_endpoints.delete_test_file, "DELETE",
                decorators=[decorators.test_endpoint(
                ), decorators.admin_endpoint()]
            )
        else:
            self.disp.log_debug("Testing endpoints disabled")