amsdal 0.4.13__cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

amsdal/contrib/auth/lifecycle/consumer.pyi

@@ -0,0 +1,108 @@
+from _typeshed import Incomplete
+from amsdal.contrib.auth.errors import AuthenticationError as AuthenticationError
+from amsdal_data.transactions.decorators import async_transaction, transaction
+from amsdal_models.classes.model import Model
+from amsdal_utils.lifecycle.consumer import LifecycleConsumer
+from typing import Any
+
+logger: Incomplete
+
+class CheckAndCreateSuperUserConsumer(LifecycleConsumer):
+    """
+    Ensures the existence of a super user in the system.
+
+    This consumer checks if a super user exists based on the provided email and password
+    in the authentication settings. If the super user does not exist, it creates one.
+    """
+    @transaction
+    def on_event(self) -> None:
+        """
+        Checks for the existence of a super user and creates one if necessary.
+
+        This method ensures that a super user exists by checking the email and password
+        in the authentication settings. If the super user does not exist, it creates one
+        with the necessary permissions.
+        """
+    @async_transaction
+    async def on_event_async(self) -> None:
+        """
+        Checks for the existence of a super user and creates one if necessary.
+
+        This method ensures that a super user exists by checking the email and password
+        in the authentication settings. If the super user does not exist, it creates one
+        with the necessary permissions.
+        """
+
+class AuthenticateUserConsumer(LifecycleConsumer):
+    """
+    Authenticates a user based on a provided JWT token.
+
+    This consumer decodes the JWT token from the authorization header and retrieves
+    the corresponding user from the database. If the token is invalid or expired,
+    it raises an `AuthenticationError`.
+    """
+    def on_event(self, auth_header: str, authentication_info: Any) -> None:
+        """
+        Authenticates the user using the provided JWT token.
+
+        This method decodes the JWT token from the authorization header and retrieves
+        the corresponding user from the database. If the token is invalid or expired,
+        it raises an `AuthenticationError`.
+
+        Args:
+            auth_header (str): The JWT token from the authorization header.
+            authentication_info (Any): The authentication information object to update with the user.
+        """
+    async def on_event_async(self, auth_header: str, authentication_info: Any) -> None:
+        """
+        Authenticates the user using the provided JWT token.
+
+        This method decodes the JWT token from the authorization header and retrieves
+        the corresponding user from the database. If the token is invalid or expired,
+        it raises an `AuthenticationError`.
+
+        Args:
+            auth_header (str): The JWT token from the authorization header.
+            authentication_info (Any): The authentication information object to update with the user.
+        """
+
+class CheckPermissionConsumer(LifecycleConsumer):
+    """
+    Checks and manages permissions for a given user and object.
+
+    This consumer prepopulates default permissions, checks class-level permissions,
+    and object-level permissions for a given user and object.
+    """
+    def _prepopulate_default_permissions(self, object_class: type[Model], permissions_info: Any) -> None: ...
+    async def _async_prepopulate_default_permissions(self, object_class: type[Model], permissions_info: Any) -> None: ...
+    def _check_class_permissions(self, object_class: type[Model], user: Any, permissions_info: Any) -> None: ...
+    async def _async_check_class_permissions(self, object_class: type[Model], user: Any, permissions_info: Any) -> None: ...
+    def _check_object_permissions(self, obj: Model, user: Any, permissions_info: Any) -> None: ...
+    def on_event(self, object_class: type[Model], user: Any, access_types: list[Any], permissions_info: Any, obj: Model | None = None) -> None:
+        """
+        Main method to check permissions for a given user and object.
+
+        This method prepopulates default permissions, checks class-level permissions,
+        and object-level permissions for the given user and object.
+
+        Args:
+            object_class (type[Model]): The class of the object to check permissions for.
+            user (Any): The user to check permissions for.
+            access_types (list[Any]): The list of access types to check.
+            permissions_info (Any): The permissions information object to update.
+            obj (Model | None): The object to check permissions for, if any.
+        """
+    async def on_event_async(self, object_class: type[Model], user: Any, access_types: list[Any], permissions_info: Any, obj: Model | None = None) -> None:
+        """
+        Main method to check permissions for a given user and object.
+
+        This method prepopulates default permissions, checks class-level permissions,
+        and object-level permissions for the given user and object.
+
+        Args:
+            object_class (type[Model]): The class of the object to check permissions for.
+            user (Any): The user to check permissions for.
+            access_types (list[Any]): The list of access types to check.
+            permissions_info (Any): The permissions information object to update.
+            obj (Model | None): The object to check permissions for, if any.
+        """

amsdal/contrib/auth/migrations/0000_initial.py

@@ -0,0 +1,84 @@
+from amsdal_models.migration import migrations
+from amsdal_utils.models.enums import ModuleType
+
+
+class Migration(migrations.Migration):
+    operations: list[migrations.Operation] = [
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name='Permission',
+            new_schema={
+                'title': 'Permission',
+                'required': ['model', 'action'],
+                'properties': {
+                    'model': {'type': 'string', 'title': 'Model'},
+                    'action': {'type': 'string', 'title': 'Action'},
+                },
+                "primary_key": ["partition_key"],
+                "table_name": "Permission",
+                'custom_code': "@property  # type: ignore[misc]\ndef display_name(self) -> str:  # type: ignore[no-untyped-def]\n    return f'{self.model}:{self.action}'",
+            },
+        ),
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name='User',
+            new_schema={
+                'title': 'User',
+                'required': ['email', 'password'],
+                'properties': {
+                    'email': {'type': 'string', 'title': 'Email'},
+                    'password': {'type': 'binary', 'title': 'Password (hash)'},
+                    'permissions': {'type': 'array', 'items': {'type': 'Permission'}, 'title': 'Permissions'},
+                },
+                "primary_key": ["partition_key"],
+                "table_name": "User",
+                'custom_code': "from typing import Any\n\n\ndef pre_init(self, *, is_new_object: bool, kwargs: dict[str, Any]) -> None:  # type: ignore[no-untyped-def]  # noqa: ARG001\n    import bcrypt\n\n    from amsdal.contrib.auth.errors import UserCreationError\n\n    email = kwargs.get('email', None)\n    password = kwargs.get('password', None)\n\n    if email is None or email == '':\n        msg = \"Email can't be empty\"\n        raise UserCreationError(msg)\n\n    if password is None or password == '':\n        msg = \"Password can't be empty\"\n        raise UserCreationError(msg)\n\n    kwargs['email'] = email.lower()\n\n    if is_new_object and '_metadata' not in kwargs:\n        hashed_password = bcrypt.hashpw(password.encode('utf-8'), bcrypt.gensalt())\n        kwargs['password'] = hashed_password\n        kwargs['_object_id'] = email.lower()\n\ndef pre_create(self) -> None:  # type: ignore[no-untyped-def]  # noqa: ARG001\n    pass\n\n@property  # type: ignore[misc]\ndef display_name(self) -> str:  # type: ignore[no-untyped-def]\n    return self.email",
+            },
+        ),
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name='UserPermission',
+            new_schema={
+                'title': 'UserPermission',
+                'required': ['user', 'permission'],
+                'properties': {
+                    'user': {'type': 'User', 'title': 'User', 'db_field': ['user_partition_key']},
+                    'permission': {
+                        'type': 'Permission',
+                        'title': 'Permission',
+                        'db_field': ['permission_partition_key'],
+                    },
+                },
+                "primary_key": ["user", "permission"],
+                "foreign_keys": {
+                    "user": [
+                        {"user_partition_key": "string"},
+                        "User",
+                        ["partition_key"],
+                    ],
+                    "permission": [
+                        {"permission_partition_key": "string"},
+                        "Permission",
+                        ["partition_key"],
+                    ],
+                },
+                "table_name": "UserPermission",
+            },
+        ),
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name='LoginSession',
+            new_schema={
+                'title': 'LoginSession',
+                'required': ['email', 'password'],
+                'properties': {
+                    'email': {'type': 'string', 'title': 'Email'},
+                    'password': {'type': 'string', 'title': 'Password (hash)'},
+                    'token': {'type': 'string', 'title': 'Token', 'mark_as_read_only': True},
+                },
+                "primary_key": ["partition_key"],
+                "table_name": "LoginSession",
+                'custom_code': "from datetime import datetime\nfrom datetime import timedelta\nfrom datetime import timezone\nfrom typing import Any\n\nimport bcrypt\nimport jwt\nfrom amsdal_utils.models.enums import Versions\n\n\ndef pre_init(self, *, is_new_object: bool, kwargs: dict[str, Any]) -> None:  # type: ignore[no-untyped-def]  # noqa: ARG001\n    if not is_new_object or '_metadata' in kwargs:\n        return\n\n    from amsdal.contrib.auth.errors import AuthenticationError\n    from amsdal.contrib.auth.settings import auth_settings\n\n    email = kwargs.get('email', None)\n    password = kwargs.get('password', None)\n\n    if not email:\n        msg = \"Email can't be empty\"\n        raise AuthenticationError(msg)\n\n    if not password:\n        msg = \"Password can't be empty\"\n        raise AuthenticationError(msg)\n\n    lowercased_email = email.lower()\n\n    from amsdal.contrib.auth.models.user import User  # type: ignore[import-not-found]\n\n    user = User.objects.filter(email=lowercased_email, _address__object_version=Versions.LATEST).get_or_none().execute()\n\n    if not user:\n        msg = 'Invalid email / password'\n        raise AuthenticationError(msg)\n\n    if not bcrypt.checkpw(password.encode('utf-8') if isinstance(password, str) else password, user.password):\n        msg = 'Invalid email / password'\n        raise AuthenticationError(msg)\n\n    kwargs['password'] = 'validated'\n    expiration_time = datetime.now(tz=timezone.utc) + timedelta(seconds=1200)\n    token = jwt.encode(\n        {'email': lowercased_email, 'exp': expiration_time},\n        key=auth_settings.AUTH_JWT_KEY,  # type: ignore[arg-type]\n        algorithm='HS256',\n    )\n\n    kwargs['token'] = token\n\n@property  # type: ignore[misc]\ndef display_name(self) -> str:  # type: ignore[no-untyped-def]\n    return self.email",
+            },
+        ),
+    ]

amsdal/contrib/auth/models/login_session.py

@@ -0,0 +1,118 @@
+from datetime import UTC
+from datetime import datetime
+from datetime import timedelta
+from typing import Any
+from typing import ClassVar
+
+import jwt
+from amsdal_models.classes.model import Model
+from amsdal_utils.models.enums import ModuleType
+from pydantic.fields import Field
+
+
+class LoginSession(Model):
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    email: str = Field(title='Email')
+    password: str = Field(title='Password (hash)')
+    token: str | None = Field(None, title='Token')
+
+    @property
+    def display_name(self) -> str:
+        """
+        Returns the display name of the user.
+
+        This method returns the email of the user as their display name.
+
+        Returns:
+            str: The email of the user.
+        """
+        return self.email
+
+    def pre_init(self, *, is_new_object: bool, kwargs: dict[str, Any]) -> None:
+        """
+        Pre-initializes a user object by validating email and password, and generating a JWT token.
+
+        This method checks if the object is new and validates the provided email and password.
+        If the email and password are valid, it generates a JWT token and adds it to the kwargs.
+
+        Args:
+            is_new_object (bool): Indicates if the object is new.
+            kwargs (dict[str, Any]): The keyword arguments containing user details.
+
+        Raises:
+            AuthenticationError: If the email or password is invalid.
+        """
+        if not is_new_object or '_metadata' in kwargs:
+            return
+        from amsdal.contrib.auth.errors import AuthenticationError
+        from amsdal.contrib.auth.settings import auth_settings
+
+        email = kwargs.get('email', None)
+        password = kwargs.get('password', None)
+        if not email:
+            msg = "Email can't be empty"
+            raise AuthenticationError(msg)
+        if not password:
+            msg = "Password can't be empty"
+            raise AuthenticationError(msg)
+        lowercased_email = email.lower()
+
+        if not auth_settings.AUTH_JWT_KEY:
+            msg = 'JWT key is not set'
+            raise AuthenticationError(msg)
+
+        expiration_time = datetime.now(tz=UTC) + timedelta(seconds=auth_settings.AUTH_TOKEN_EXPIRATION)
+        token = jwt.encode(
+            {'email': lowercased_email, 'exp': expiration_time},
+            key=auth_settings.AUTH_JWT_KEY,  # type: ignore[arg-type]
+            algorithm='HS256',
+        )
+        kwargs['token'] = token
+
+    def pre_create(self) -> None:
+        import bcrypt
+
+        from amsdal.contrib.auth.errors import AuthenticationError
+        from amsdal.contrib.auth.models.user import User
+
+        user = User.objects.filter(email=self.email).latest().first().execute()
+
+        if not user:
+            msg = 'User not found'
+            raise AuthenticationError(msg)
+
+        if not bcrypt.checkpw(self.password.encode(), user.password):
+            msg = 'Invalid password'
+            raise AuthenticationError(msg)
+
+        self.password = 'validated'
+
+    def pre_update(self) -> None:
+        from amsdal.contrib.auth.errors import AuthenticationError
+
+        msg = 'Update not allowed'
+        raise AuthenticationError(msg)
+
+    async def apre_create(self) -> None:
+        import bcrypt
+
+        from amsdal.contrib.auth.errors import AuthenticationError
+        from amsdal.contrib.auth.models.user import User
+
+        user = await User.objects.filter(email=self.email).latest().first().aexecute()
+
+        if not user:
+            msg = 'User not found'
+            raise AuthenticationError(msg)
+
+        if not bcrypt.checkpw(self.password.encode(), user.password):
+            msg = 'Invalid password'
+            raise AuthenticationError(msg)
+
+        self.password = 'validated'
+
+    async def apre_update(self) -> None:
+        from amsdal.contrib.auth.errors import AuthenticationError
+
+        msg = 'Update not allowed'
+        raise AuthenticationError(msg)

amsdal/contrib/auth/models/login_session.pyi

@@ -0,0 +1,37 @@
+from amsdal_models.classes.model import Model
+from amsdal_utils.models.enums import ModuleType
+from typing import Any, ClassVar
+
+class LoginSession(Model):
+    __module_type__: ClassVar[ModuleType] = ...
+    email: str = ...
+    password: str = ...
+    token: str | None = ...
+    @property
+    def display_name(self) -> str:
+        """
+        Returns the display name of the user.
+
+        This method returns the email of the user as their display name.
+
+        Returns:
+            str: The email of the user.
+        """
+    def pre_init(self, *, is_new_object: bool, kwargs: dict[str, Any]) -> None:
+        """
+        Pre-initializes a user object by validating email and password, and generating a JWT token.
+
+        This method checks if the object is new and validates the provided email and password.
+        If the email and password are valid, it generates a JWT token and adds it to the kwargs.
+
+        Args:
+            is_new_object (bool): Indicates if the object is new.
+            kwargs (dict[str, Any]): The keyword arguments containing user details.
+
+        Raises:
+            AuthenticationError: If the email or password is invalid.
+        """
+    def pre_create(self) -> None: ...
+    def pre_update(self) -> None: ...
+    async def apre_create(self) -> None: ...
+    async def apre_update(self) -> None: ...

amsdal/contrib/auth/models/permission.py

@@ -0,0 +1,23 @@
+from typing import ClassVar
+
+from amsdal_models.classes.model import Model
+from amsdal_utils.models.enums import ModuleType
+from pydantic.fields import Field
+
+
+class Permission(Model):
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    model: str = Field(title='Model')
+    action: str = Field(title='Action')
+
+    @property
+    def display_name(self) -> str:
+        """
+        Returns the display name of the user.
+
+        This method returns a formatted string combining the model and action of the user.
+
+        Returns:
+            str: The formatted display name in the format 'model:action'.
+        """
+        return f'{self.model}:{self.action}'

amsdal/contrib/auth/models/permission.pyi

@@ -0,0 +1,18 @@
+from amsdal_models.classes.model import Model
+from amsdal_utils.models.enums import ModuleType
+from typing import ClassVar
+
+class Permission(Model):
+    __module_type__: ClassVar[ModuleType] = ...
+    model: str = ...
+    action: str = ...
+    @property
+    def display_name(self) -> str:
+        """
+        Returns the display name of the user.
+
+        This method returns a formatted string combining the model and action of the user.
+
+        Returns:
+            str: The formatted display name in the format 'model:action'.
+        """

amsdal/contrib/auth/models/user.py

@@ -0,0 +1,106 @@
+from typing import Any
+from typing import ClassVar
+
+from amsdal_models.classes.model import Model
+from amsdal_utils.models.enums import ModuleType
+from pydantic.fields import Field
+
+from amsdal.contrib.auth.models.permission import *  # noqa: F403
+
+
+class User(Model):
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    email: str = Field(title='Email')
+    password: bytes = Field(title='Password (hash)')
+    permissions: list['Permission'] | None = Field(None, title='Permissions')  # noqa: F405
+
+    def __repr__(self) -> str:
+        return str(self)
+
+    def __str__(self) -> str:
+        return f'User(email={self.email})'
+
+    async def apre_update(self) -> None:
+        import bcrypt
+
+        original_object = await self.arefetch_from_db()
+        password = self.password
+        if original_object.password and password is not None:
+            if isinstance(password, str):
+                password = password.encode('utf-8')
+            try:
+                if not bcrypt.checkpw(password, original_object.password):
+                    self.password = password
+            except ValueError:
+                hashed_password = bcrypt.hashpw(password, bcrypt.gensalt())
+                self.password = hashed_password
+
+    @property
+    def display_name(self) -> str:
+        """
+        Returns the display name of the user.
+
+        This method returns the email of the user as their display name.
+
+        Returns:
+            str: The email of the user.
+        """
+        return self.email
+
+    def post_init(self, *, is_new_object: bool, kwargs: dict[str, Any]) -> None:
+        """
+        Post-initializes a user object by validating email and password, and hashing the password.
+
+        This method checks if the email and password are provided and valid. If the object is new,
+        it hashes the password and sets the object ID to the lowercased email.
+
+        Args:
+            is_new_object (bool): Indicates if the object is new.
+            kwargs (dict[str, Any]): The keyword arguments containing user details.
+
+        Raises:
+            UserCreationError: If the email or password is invalid.
+        """
+        import bcrypt
+
+        from amsdal.contrib.auth.errors import UserCreationError
+
+        email = kwargs.get('email', None)
+        password = kwargs.get('password', None)
+        if email is None or email == '':
+            msg = "Email can't be empty"
+            raise UserCreationError(msg)
+        if password is None or password == '':
+            msg = "Password can't be empty"
+            raise UserCreationError(msg)
+        kwargs['email'] = email.lower()
+        if is_new_object and '_metadata' not in kwargs:
+            if isinstance(password, str):
+                password = password.encode('utf-8')
+            hashed_password = bcrypt.hashpw(password, bcrypt.gensalt())
+            self.password = hashed_password
+            self._object_id = email.lower()
+
+    def pre_create(self) -> None:
+        """
+        Pre-creates a user object.
+
+        This method is a placeholder for any pre-creation logic that needs to be executed
+        before a user object is created.
+        """
+        pass
+
+    def pre_update(self) -> None:
+        import bcrypt
+
+        original_object = self.refetch_from_db()
+        password = self.password
+        if original_object.password and password is not None:
+            if isinstance(password, str):
+                password = password.encode('utf-8')
+            try:
+                if not bcrypt.checkpw(password, original_object.password):
+                    self.password = password
+            except ValueError:
+                hashed_password = bcrypt.hashpw(password, bcrypt.gensalt())
+                self.password = hashed_password

amsdal/contrib/auth/models/user.pyi

@@ -0,0 +1,46 @@
+from amsdal.contrib.auth.models.permission import *
+from amsdal_models.classes.model import Model
+from amsdal_utils.models.enums import ModuleType
+from typing import Any, ClassVar
+
+class User(Model):
+    __module_type__: ClassVar[ModuleType] = ...
+    email: str = ...
+    password: bytes = ...
+    permissions: list['Permission'] | None = ...
+    def __repr__(self) -> str: ...
+    def __str__(self) -> str: ...
+    async def apre_update(self) -> None: ...
+    @property
+    def display_name(self) -> str:
+        """
+        Returns the display name of the user.
+
+        This method returns the email of the user as their display name.
+
+        Returns:
+            str: The email of the user.
+        """
+    _object_id = ...
+    def post_init(self, *, is_new_object: bool, kwargs: dict[str, Any]) -> None:
+        """
+        Post-initializes a user object by validating email and password, and hashing the password.
+
+        This method checks if the email and password are provided and valid. If the object is new,
+        it hashes the password and sets the object ID to the lowercased email.
+
+        Args:
+            is_new_object (bool): Indicates if the object is new.
+            kwargs (dict[str, Any]): The keyword arguments containing user details.
+
+        Raises:
+            UserCreationError: If the email or password is invalid.
+        """
+    def pre_create(self) -> None:
+        """
+        Pre-creates a user object.
+
+        This method is a placeholder for any pre-creation logic that needs to be executed
+        before a user object is created.
+        """
+    def pre_update(self) -> None: ...

amsdal/contrib/auth/settings.py

@@ -0,0 +1,36 @@
+from pydantic_settings import BaseSettings
+from pydantic_settings import SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    """
+    Settings configuration for the application.
+
+    This class uses Pydantic's BaseSettings to manage application settings
+    from environment variables and a .env file.
+
+    Attributes:
+        model_config (SettingsConfigDict): Configuration for Pydantic settings.
+        ADMIN_USER_EMAIL (str | None): The email of the admin user.
+        ADMIN_USER_PASSWORD (str | None): The password of the admin user.
+        AUTH_JWT_KEY (str | None): The key used for JWT authentication.
+        AUTH_TOKEN_EXPIRATION (int): The expiration time for authentication tokens in seconds.
+        REQUIRE_DEFAULT_AUTHORIZATION (bool): Flag to require default authorization.
+    """
+
+    model_config = SettingsConfigDict(
+        case_sensitive=True,
+        env_prefix='AMSDAL_',
+        env_file='.env',
+        env_file_encoding='utf-8',
+        extra='ignore',
+    )
+
+    ADMIN_USER_EMAIL: str | None = None
+    ADMIN_USER_PASSWORD: str | None = None
+    AUTH_JWT_KEY: str | None = None
+    AUTH_TOKEN_EXPIRATION: int = 86400
+    REQUIRE_DEFAULT_AUTHORIZATION: bool = True
+
+
+auth_settings = Settings()

amsdal/contrib/auth/settings.pyi

@@ -0,0 +1,26 @@
+from _typeshed import Incomplete
+from pydantic_settings import BaseSettings
+
+class Settings(BaseSettings):
+    """
+    Settings configuration for the application.
+
+    This class uses Pydantic's BaseSettings to manage application settings
+    from environment variables and a .env file.
+
+    Attributes:
+        model_config (SettingsConfigDict): Configuration for Pydantic settings.
+        ADMIN_USER_EMAIL (str | None): The email of the admin user.
+        ADMIN_USER_PASSWORD (str | None): The password of the admin user.
+        AUTH_JWT_KEY (str | None): The key used for JWT authentication.
+        AUTH_TOKEN_EXPIRATION (int): The expiration time for authentication tokens in seconds.
+        REQUIRE_DEFAULT_AUTHORIZATION (bool): Flag to require default authorization.
+    """
+    model_config: Incomplete
+    ADMIN_USER_EMAIL: str | None
+    ADMIN_USER_PASSWORD: str | None
+    AUTH_JWT_KEY: str | None
+    AUTH_TOKEN_EXPIRATION: int
+    REQUIRE_DEFAULT_AUTHORIZATION: bool
+
+auth_settings: Incomplete

amsdal/contrib/frontend_configs/app.py

@@ -0,0 +1,24 @@
+from amsdal_utils.lifecycle.producer import LifecycleProducer
+
+from amsdal.contrib.app_config import AppConfig
+from amsdal.contrib.frontend_configs.constants import ON_RESPONSE_EVENT
+from amsdal.contrib.frontend_configs.lifecycle.consumer import ProcessResponseConsumer
+
+
+class FrontendConfigAppConfig(AppConfig):
+    """
+    Application configuration class for frontend configurations.
+
+    This class extends the AppConfig and sets up listeners for lifecycle events
+    to process frontend configurations.
+    """
+
+    def on_ready(self) -> None:
+        """
+        Registers a listener for the ON_RESPONSE_EVENT to process responses
+        using the ProcessResponseConsumer.
+
+        Returns:
+            None
+        """
+        LifecycleProducer.add_listener(ON_RESPONSE_EVENT, ProcessResponseConsumer)  # type: ignore[arg-type]

amsdal/contrib/frontend_configs/app.pyi

@@ -0,0 +1,19 @@
+from amsdal.contrib.app_config import AppConfig as AppConfig
+from amsdal.contrib.frontend_configs.constants import ON_RESPONSE_EVENT as ON_RESPONSE_EVENT
+from amsdal.contrib.frontend_configs.lifecycle.consumer import ProcessResponseConsumer as ProcessResponseConsumer
+
+class FrontendConfigAppConfig(AppConfig):
+    """
+    Application configuration class for frontend configurations.
+
+    This class extends the AppConfig and sets up listeners for lifecycle events
+    to process frontend configurations.
+    """
+    def on_ready(self) -> None:
+        """
+        Registers a listener for the ON_RESPONSE_EVENT to process responses
+        using the ProcessResponseConsumer.
+
+        Returns:
+            None
+        """

amsdal/contrib/frontend_configs/constants.py

@@ -0,0 +1 @@
+ON_RESPONSE_EVENT = 'on_response'