from flask_restx import Resource

from controllers.common.schema import register_response_schema_models
from controllers.web import web_ns
from services.feature_service import FeatureService, SystemFeatureModel

register_response_schema_models(web_ns, SystemFeatureModel)


@web_ns.route("/system-features")
class SystemFeatureApi(Resource):
    @web_ns.doc("get_system_features")
    @web_ns.doc(description="Get system feature flags and configuration")
    @web_ns.doc(responses={200: "System features retrieved successfully", 500: "Internal server error"})
    @web_ns.response(
        200,
        "System features retrieved successfully",
        web_ns.models[SystemFeatureModel.__name__],
    )
    def get(self):
        """Get system feature flags and configuration.

        Returns the current system feature flags and configuration
        that control various functionalities across the platform.

        Returns:
            dict: System feature configuration object

        This endpoint is akin to the `SystemFeatureApi` endpoint in api/controllers/console/feature.py,
        except it is intended for use by the web app, instead of the console dashboard.

        NOTE: This endpoint is unauthenticated by design, as it provides system features
        data required for webapp initialization.

        Authentication would create circular dependency (can't authenticate without webapp loading).

        Only non-sensitive configuration data should be returned by this endpoint.
        """
        return FeatureService.get_system_features().model_dump()
