core-framework 4.2.0__tar.gz → 4.2.1__tar.gz

{core_framework-4.2.0 → core_framework-4.2.1}/CHANGELOG.md

@@ -4,6 +4,12 @@ Notable changes to **core-framework** (import **`core_framework`**). Format foll
 
 ## [Unreleased]
 
+## [4.2.1] - 2026-10-10
+
+### Changed
+
+- **Entitlement grant list:** `GET /users/me/entitlements` returns **`identifier`** instead of **`label`**. **`register_entitlement_tier`** takes one **`identifier`**, which is that tier's RevenueCat lookup key. Registering tier **1** replaces **`plus`**. A host that passed **`label`** or **`lookup_keys`** must pass **`identifier`**.
+
 ## [4.2.0] - 2026-10-08
 
 ### Added
@@ -812,4 +818,5 @@ First **SemVer-stable** release per **`docs/library/package-api.md`**.
 [4.0.1]: https://github.com/NepNepFFXIV/core-framework/compare/v4.0.0...v4.0.1
 [4.1.0]: https://github.com/NepNepFFXIV/core-framework/compare/v4.0.1...v4.1.0
 [4.2.0]: https://github.com/NepNepFFXIV/core-framework/compare/v4.1.0...v4.2.0
-[unreleased]: https://github.com/NepNepFFXIV/core-framework/compare/v4.2.0...HEAD
+[4.2.1]: https://github.com/NepNepFFXIV/core-framework/compare/v4.2.0...v4.2.1
+[unreleased]: https://github.com/NepNepFFXIV/core-framework/compare/v4.2.1...HEAD

{core_framework-4.2.0 → core_framework-4.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: core-framework
-Version: 4.2.0
+Version: 4.2.1
 Summary: Core framework package (import as core_framework)
 Project-URL: Homepage, https://github.com/NepNepFFXIV/core-framework
 Project-URL: Repository, https://github.com/NepNepFFXIV/core-framework

core_framework-4.2.1/alembic/user/alembic/versions/089f4398f943_user_add_preference_switches.py

@@ -0,0 +1,40 @@
+"""add user_preferences inbox type switches
+
+Revision ID: 089f4398f943
+Revises: 24ba262c4ef2
+Create Date: 2026-10-09 15:57:00.000000
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+revision: str = "089f4398f943"
+down_revision: str | Sequence[str] | None = "24ba262c4ef2"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        alter table user_preferences
+            add column comments boolean not null default true,
+            add column replies boolean not null default true,
+            add column mentions boolean not null default true,
+            add column follows boolean not null default true,
+            add column friend_requests boolean not null default true,
+            add column group_invites boolean not null default true;
+    """)
+
+
+def downgrade() -> None:
+    op.execute("""
+        alter table user_preferences
+            drop column if exists comments,
+            drop column if exists replies,
+            drop column if exists mentions,
+            drop column if exists follows,
+            drop column if exists friend_requests,
+            drop column if exists group_invites;
+    """)

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/api/entitlements/router.py

@@ -27,7 +27,7 @@ async def get_my_entitlements(user_id: RequiredUserID) -> Any:
     items = await list_caller_entitlements(user_id=user_id)
     return EntitlementsResponse(
         items=[
-            EntitlementItemResponse(tier_id=item.tier_id, label=item.label, expires_at=item.expires_at)
+            EntitlementItemResponse(tier_id=item.tier_id, identifier=item.identifier, expires_at=item.expires_at)
             for item in items
         ]
     )

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/api/entitlements/schemas.py

@@ -5,7 +5,7 @@ from pydantic import BaseModel, Field
 
 class EntitlementItemResponse(BaseModel):
     tier_id: int = Field(ge=1)
-    label: str = Field(min_length=1)
+    identifier: str = Field(min_length=1)
     expires_at: datetime | None
 
 

core_framework-4.2.1/core_framework/api/users/authenticated/mappers.py

@@ -0,0 +1,42 @@
+from core_framework.api.users.authenticated.schemas import (
+    AccountUpdateRequest,
+    PreferencesResponse,
+    PreferencesUpdateRequest,
+)
+from core_framework.domains.user import AccountUpdate, Preferences, PreferencesUpdate
+
+
+def preferences_response(*, preferences: Preferences) -> PreferencesResponse:
+    return PreferencesResponse(
+        theme=preferences.theme,
+        language=preferences.language,
+        comments=preferences.comments,
+        replies=preferences.replies,
+        mentions=preferences.mentions,
+        follows=preferences.follows,
+        friend_requests=preferences.friend_requests,
+        group_invites=preferences.group_invites,
+    )
+
+
+def preferences_update_from_request(*, request: PreferencesUpdateRequest) -> PreferencesUpdate:
+    fields_set = frozenset(request.model_fields_set)
+    return PreferencesUpdate(
+        fields_set=fields_set,
+        theme=request.theme if "theme" in fields_set else None,
+        language=request.language if "language" in fields_set else None,
+        comments=request.comments if "comments" in fields_set else None,
+        replies=request.replies if "replies" in fields_set else None,
+        mentions=request.mentions if "mentions" in fields_set else None,
+        follows=request.follows if "follows" in fields_set else None,
+        friend_requests=request.friend_requests if "friend_requests" in fields_set else None,
+        group_invites=request.group_invites if "group_invites" in fields_set else None,
+    )
+
+
+def account_update_from_request(*, request: AccountUpdateRequest) -> AccountUpdate:
+    fields_set = frozenset(request.model_fields_set)
+    return AccountUpdate(
+        fields_set=fields_set,
+        username=request.username if "username" in fields_set else None,
+    )

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/api/users/authenticated/router.py

@@ -22,6 +22,7 @@ from core_framework.api.ratings.schemas import RatingItemResponse
 from core_framework.api.upload import iter_upload_chunks
 from core_framework.api.users.authenticated.mappers import (
     account_update_from_request,
+    preferences_response,
     preferences_update_from_request,
 )
 from core_framework.api.users.authenticated.schemas import (
@@ -338,7 +339,8 @@ async def get_my_ratings(
     dependencies=[Depends(check_caller_identity)],
 )
 async def get_my_preferences(user_id: RequiredUserID) -> Any:
-    return await retrieve_my_preferences(user_id=user_id)
+    preferences = await retrieve_my_preferences(user_id=user_id)
+    return preferences_response(preferences=preferences)
 
 
 @router.patch(
@@ -347,10 +349,11 @@ async def get_my_preferences(user_id: RequiredUserID) -> Any:
     dependencies=[Depends(check_caller_identity)],
 )
 async def patch_my_preferences(user_id: RequiredUserID, update_request: PreferencesUpdateRequest) -> Any:
-    return await change_my_preferences(
+    preferences = await change_my_preferences(
         user_id=user_id,
         update=preferences_update_from_request(request=update_request),
     )
+    return preferences_response(preferences=preferences)
 
 
 @router.get(

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/api/users/authenticated/schemas.py

@@ -1,7 +1,7 @@
 from datetime import datetime
-from typing import Annotated
+from typing import Annotated, Final
 
-from pydantic import BaseModel, EmailStr, Field
+from pydantic import BaseModel, EmailStr, Field, model_validator
 
 from core_framework.api.schemas import BasePatchRequest
 from core_framework.api.users.shared.schemas import (
@@ -103,8 +103,32 @@ class MyAppealsResponse(BaseModel):
 class PreferencesResponse(BaseModel):
     theme: Theme
     language: str
+    comments: bool = True
+    replies: bool = True
+    mentions: bool = True
+    follows: bool = True
+    friend_requests: bool = True
+    group_invites: bool = True
+
+
+_SWITCH_FIELDS: Final[frozenset[str]] = frozenset(
+    {"comments", "replies", "mentions", "follows", "friend_requests", "group_invites"}
+)
 
 
 class PreferencesUpdateRequest(BasePatchRequest):
     theme: Theme | None = None
     language: Annotated[str | None, Field(default=None, max_length=10)]
+    comments: bool | None = None
+    replies: bool | None = None
+    mentions: bool | None = None
+    follows: bool | None = None
+    friend_requests: bool | None = None
+    group_invites: bool | None = None
+
+    @model_validator(mode="after")
+    def reject_null_switches(self) -> PreferencesUpdateRequest:
+        for name in _SWITCH_FIELDS.intersection(self.model_fields_set):
+            if getattr(self, name) is None:
+                raise ValueError(f"{name} must not be null")
+        return self

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/application/entitlement/grant_service.py

@@ -4,7 +4,7 @@ from datetime import UTC, datetime
 import core_framework.domains.entitlement.dependencies as entitlement_deps
 import core_framework.domains.moderation.dependencies as moderation_deps
 import core_framework.domains.user.dependencies as user_deps
-from core_framework.application.entitlement.registry import entitlements_enabled, tier_is_registered, tier_label
+from core_framework.application.entitlement.registry import entitlements_enabled, tier_identifier, tier_is_registered
 from core_framework.application.shared.exceptions import (
     EntitlementRequiredException,
     UnprocessableEntityException,
@@ -17,19 +17,19 @@ from core_framework.domains.user import RESERVED_USER_IDS, UserIdentity
 @dataclass(frozen=True, slots=True, kw_only=True)
 class CallerEntitlement:
     tier_id: int
-    label: str
+    identifier: str
     expires_at: datetime | None
 
 
 async def list_caller_entitlements(*, user_id: str) -> list[CallerEntitlement]:
-    """Return this caller's active tiers with the host label."""
+    """Return this caller's active tiers with each tier's identifier."""
     tiers = await entitlement_deps.entitlement_service.list_active_tiers(user_id=user_id)
     items: list[CallerEntitlement] = []
     for tier in tiers:
-        label = tier_label(tier.tier_id)
-        if label is None:
+        identifier = tier_identifier(tier.tier_id)
+        if identifier is None:
             continue
-        items.append(CallerEntitlement(tier_id=tier.tier_id, label=label, expires_at=tier.expires_at))
+        items.append(CallerEntitlement(tier_id=tier.tier_id, identifier=identifier, expires_at=tier.expires_at))
     return items
 
 

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/application/entitlement/registry.py

@@ -14,8 +14,7 @@ _gate_tier_ids: set[int] = set()
 @dataclass(frozen=True, slots=True, kw_only=True)
 class TierRegistration:
     tier_id: int
-    label: str
-    lookup_keys: frozenset[str]
+    identifier: str
 
 
 def configure_entitlement(
@@ -35,7 +34,7 @@ def configure_entitlement(
     _tiers = {}
     _lookup_keys = {}
     _tier_one_registered_by_host = False
-    _install_tier(tier_id=1, label="Plus", lookup_keys=["plus"])
+    _install_tier(tier_id=1, identifier="plus")
 
 
 def entitlements_enabled() -> bool:
@@ -58,32 +57,29 @@ def email_sending_enabled() -> bool:
     return _email_enabled
 
 
-def register_entitlement_tier(*, tier_id: int, label: str, lookup_keys: list[str]) -> None:
-    """Register a host tier, or set tier 1's label and extra lookup keys.
+def register_entitlement_tier(*, tier_id: int, identifier: str) -> None:
+    """Register a host tier, or replace tier 1's identifier.
 
-    ``plus`` stays on tier 1. A second registration of the same tier id fails.
-    A lookup key listed on two tiers fails. The API lifespan checks recorded
+    The identifier is that tier's RevenueCat lookup key. Registering tier 1
+    replaces ``plus``. A second registration of the same tier id fails. An
+    identifier listed on two tiers fails. The API lifespan checks recorded
     gates after the host factory returns.
     """
     global _tier_one_registered_by_host
-    cleaned_label = label.strip()
+    cleaned_identifier = identifier.strip()
     if tier_id < 1:
         raise ValueError("tier id must be at least 1")
-    if not cleaned_label:
-        raise ValueError("tier label must be non-blank")
-    cleaned_keys = [key.strip() for key in lookup_keys]
-    if any(not key for key in cleaned_keys):
-        raise ValueError("lookup key must be non-blank")
+    if not cleaned_identifier:
+        raise ValueError("tier identifier must be non-blank")
     if tier_id == 1:
         if _tier_one_registered_by_host:
             raise ValueError("duplicate entitlement tier id: 1")
         _tier_one_registered_by_host = True
-        keys = ["plus", *[key for key in cleaned_keys if key != "plus"]]
-        _replace_tier(tier_id=1, label=cleaned_label, lookup_keys=keys)
+        _replace_tier(tier_id=1, identifier=cleaned_identifier)
         return
     if tier_id in _tiers:
         raise ValueError(f"duplicate entitlement tier id: {tier_id}")
-    _install_tier(tier_id=tier_id, label=cleaned_label, lookup_keys=cleaned_keys)
+    _install_tier(tier_id=tier_id, identifier=cleaned_identifier)
 
 
 def note_tier_gate(tier_id: int) -> None:
@@ -98,10 +94,10 @@ def validate_entitlement_tier_gates() -> None:
         raise RuntimeError(f"entitlement tier gate is not on the map: {missing}")
 
 
-def tier_label(tier_id: int) -> str | None:
-    """Return the label for a tier id, or None when the tier is not on the map."""
+def tier_identifier(tier_id: int) -> str | None:
+    """Return the identifier for a tier id, or None when the tier is not on the map."""
     tier = _tiers.get(tier_id)
-    return None if tier is None else tier.label
+    return None if tier is None else tier.identifier
 
 
 def tier_id_for_lookup_key(lookup_key: str) -> int | None:
@@ -114,27 +110,20 @@ def tier_is_registered(tier_id: int) -> bool:
     return tier_id in _tiers
 
 
-def _install_tier(*, tier_id: int, label: str, lookup_keys: list[str]) -> None:
-    unique_keys = list(dict.fromkeys(lookup_keys))
-    for key in unique_keys:
-        owner = _lookup_keys.get(key)
-        if owner is not None and owner != tier_id:
-            raise ValueError(f"lookup key {key} is already listed on tier {owner}")
-    for key in unique_keys:
-        _lookup_keys[key] = tier_id
-    _tiers[tier_id] = TierRegistration(tier_id=tier_id, label=label, lookup_keys=frozenset(unique_keys))
+def _install_tier(*, tier_id: int, identifier: str) -> None:
+    owner = _lookup_keys.get(identifier)
+    if owner is not None and owner != tier_id:
+        raise ValueError(f"identifier {identifier} is already listed on tier {owner}")
+    _lookup_keys[identifier] = tier_id
+    _tiers[tier_id] = TierRegistration(tier_id=tier_id, identifier=identifier)
 
 
-def _replace_tier(*, tier_id: int, label: str, lookup_keys: list[str]) -> None:
-    unique_keys = list(dict.fromkeys(lookup_keys))
-    for key in unique_keys:
-        owner = _lookup_keys.get(key)
-        if owner is not None and owner != tier_id:
-            raise ValueError(f"lookup key {key} is already listed on tier {owner}")
+def _replace_tier(*, tier_id: int, identifier: str) -> None:
+    owner = _lookup_keys.get(identifier)
+    if owner is not None and owner != tier_id:
+        raise ValueError(f"identifier {identifier} is already listed on tier {owner}")
     previous = _tiers.get(tier_id)
     if previous is not None:
-        for key in previous.lookup_keys:
-            _lookup_keys.pop(key, None)
-    for key in unique_keys:
-        _lookup_keys[key] = tier_id
-    _tiers[tier_id] = TierRegistration(tier_id=tier_id, label=label, lookup_keys=frozenset(unique_keys))
+        _lookup_keys.pop(previous.identifier, None)
+    _lookup_keys[identifier] = tier_id
+    _tiers[tier_id] = TierRegistration(tier_id=tier_id, identifier=identifier)

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/application/notifications/friendship_notification_service.py

@@ -3,6 +3,7 @@ from typing import Final
 from structlog import get_logger
 
 import core_framework.domains.notification.dependencies as notification_deps
+from core_framework.application.notifications.inbox_type_switch import recipient_ids_allowing_inbox_type
 from core_framework.domains.notification import NotificationSubjectKind, NotificationType
 
 logger = get_logger(__name__)
@@ -14,8 +15,12 @@ _PENDING_REQUEST_WIPE_LIMIT: Final[int] = 500
 async def notify_friend_request(*, requester_id: str, recipient_id: str) -> None:
     """Create the best-effort ``friend_request`` inbox row for the recipient."""
     try:
-        await notification_deps.notification_service.add_notification(
+        allowed_recipient_ids = await recipient_ids_allowing_inbox_type(
             recipient_ids={recipient_id},
+            notification_type=NotificationType.FRIEND_REQUEST,
+        )
+        await notification_deps.notification_service.add_notification(
+            recipient_ids=allowed_recipient_ids,
             actor_id=requester_id,
             notification_type=NotificationType.FRIEND_REQUEST,
             subject_id=requester_id,

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/application/notifications/group_invite_notification_service.py

@@ -3,6 +3,7 @@ from typing import Final
 from structlog import get_logger
 
 import core_framework.domains.notification.dependencies as notification_deps
+from core_framework.application.notifications.inbox_type_switch import recipient_ids_allowing_inbox_type
 from core_framework.domains.notification import NotificationSubjectKind, NotificationType
 
 logger = get_logger(__name__)
@@ -20,8 +21,12 @@ async def notify_group_invite(
 ) -> None:
     """Create the best-effort ``group_invite`` inbox row for the invitee."""
     try:
-        await notification_deps.notification_service.add_notification(
+        allowed_recipient_ids = await recipient_ids_allowing_inbox_type(
             recipient_ids={invitee_id},
+            notification_type=NotificationType.GROUP_INVITE,
+        )
+        await notification_deps.notification_service.add_notification(
+            recipient_ids=allowed_recipient_ids,
             actor_id=inviter_id,
             notification_type=NotificationType.GROUP_INVITE,
             subject_id=group_id,

core_framework-4.2.1/core_framework/application/notifications/inbox_type_switch.py

@@ -0,0 +1,54 @@
+from structlog import get_logger
+
+import core_framework.domains.user.dependencies as user_deps
+from core_framework.domains.notification import NotificationType
+from core_framework.domains.user import Preferences
+
+logger = get_logger(__name__)
+
+
+def _switch_is_on(*, preferences: Preferences, notification_type: NotificationType) -> bool:
+    match notification_type:
+        case NotificationType.COMMENT_ON_POST | NotificationType.COMMENT_ON_RATING:
+            return preferences.comments
+        case NotificationType.REPLY_TO_COMMENT:
+            return preferences.replies
+        case NotificationType.MENTION:
+            return preferences.mentions
+        case NotificationType.NEW_FOLLOWER:
+            return preferences.follows
+        case NotificationType.FRIEND_REQUEST:
+            return preferences.friend_requests
+        case NotificationType.GROUP_INVITE:
+            return preferences.group_invites
+        case _:
+            return True
+
+
+async def recipient_ids_allowing_inbox_type(
+    *,
+    recipient_ids: set[str],
+    notification_type: NotificationType,
+) -> set[str]:
+    """Return recipients whose switch is on. Empty when the preferences read fails."""
+    if not recipient_ids:
+        return set()
+    try:
+        preferences_by_user_id = await user_deps.user_service.retrieve_preferences_mapping_strong(
+            user_ids=recipient_ids,
+        )
+    except Exception:
+        logger.exception(
+            "Failed to read inbox type switches",
+            notification_type=notification_type.value,
+        )
+        return set()
+    return {
+        recipient_id
+        for recipient_id in recipient_ids
+        if recipient_id not in preferences_by_user_id
+        or _switch_is_on(
+            preferences=preferences_by_user_id[recipient_id],
+            notification_type=notification_type,
+        )
+    }

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/application/notifications/notification_service.py

@@ -9,6 +9,7 @@ import core_framework.domains.comment.dependencies as comment_deps
 import core_framework.domains.notification.dependencies as notification_deps
 import core_framework.domains.user.dependencies as user_deps
 from core_framework.application.comments.kind_registry import get_comment_kind_subject
+from core_framework.application.notifications.inbox_type_switch import recipient_ids_allowing_inbox_type
 from core_framework.application.notifications.preview import truncate_notification_preview
 from core_framework.domains.comment import POST_SUBJECT_KIND, RATING_SUBJECT_KIND
 from core_framework.domains.notification import NotificationSubjectKind, NotificationType
@@ -25,6 +26,32 @@ _OWNER_CUE_BY_COMMENT_KIND: Final[Mapping[str, tuple[NotificationType, Notificat
 )
 
 
+async def _add_notification(
+    *,
+    recipient_ids: set[str],
+    actor_id: str,
+    notification_type: NotificationType,
+    subject_id: str,
+    subject_kind: NotificationSubjectKind,
+    reference_id: str,
+    preview_text: str | None,
+) -> None:
+    """Insert an inbox row for recipients whose type switch is on."""
+    allowed_recipient_ids = await recipient_ids_allowing_inbox_type(
+        recipient_ids=recipient_ids,
+        notification_type=notification_type,
+    )
+    await notification_deps.notification_service.add_notification(
+        recipient_ids=allowed_recipient_ids,
+        actor_id=actor_id,
+        notification_type=notification_type,
+        subject_id=subject_id,
+        subject_kind=subject_kind,
+        reference_id=reference_id,
+        preview_text=preview_text,
+    )
+
+
 async def _existing_mention_recipient_ids(*, mention_user_ids: list[str], author_id: str) -> set[str]:
     """Return mention targets that exist as real users (not author or reserved sentinels)."""
     candidate_recipient_ids = set(mention_user_ids) - {author_id} - RESERVED_USER_IDS
@@ -73,7 +100,7 @@ async def _handle_new_post_notifications(
             followee_id=author_id,
         )
     preview_text = truncate_notification_preview(content=content)
-    await notification_deps.notification_service.add_notification(
+    await _add_notification(
         recipient_ids=existing_recipient_ids,
         actor_id=author_id,
         notification_type=NotificationType.MENTION,
@@ -122,7 +149,7 @@ async def _handle_new_root_comment_notifications(
         notification_type, notification_subject_kind = owner_cue
         owner_ids = set(recipients.owner_user_ids) - {author_id} - RESERVED_USER_IDS
         if owner_ids:
-            await notification_deps.notification_service.add_notification(
+            await _add_notification(
                 recipient_ids=owner_ids,
                 actor_id=author_id,
                 notification_type=notification_type,
@@ -131,7 +158,7 @@ async def _handle_new_root_comment_notifications(
                 reference_id=new_comment_id,
                 preview_text=preview_text,
             )
-    await notification_deps.notification_service.add_notification(
+    await _add_notification(
         recipient_ids=set(recipients.mention_user_ids) & existing_recipient_ids,
         actor_id=author_id,
         notification_type=NotificationType.MENTION,
@@ -157,7 +184,7 @@ async def _handle_new_reply_notifications(
         return
     preview_text = truncate_notification_preview(content=content)
     if parent.author_id != author_id and parent.author_id not in RESERVED_USER_IDS:
-        await notification_deps.notification_service.add_notification(
+        await _add_notification(
             recipient_ids={parent.author_id},
             actor_id=author_id,
             notification_type=NotificationType.REPLY_TO_COMMENT,
@@ -170,7 +197,7 @@ async def _handle_new_reply_notifications(
         mention_user_ids=mention_user_ids,
         author_id=author_id,
     )
-    await notification_deps.notification_service.add_notification(
+    await _add_notification(
         recipient_ids=existing_recipient_ids,
         actor_id=author_id,
         notification_type=NotificationType.MENTION,
@@ -182,7 +209,7 @@ async def _handle_new_reply_notifications(
 
 
 async def _handle_new_follower_notification(*, follower_id: str, followee_id: str) -> None:
-    await notification_deps.notification_service.add_notification(
+    await _add_notification(
         recipient_ids={followee_id},
         actor_id=follower_id,
         notification_type=NotificationType.NEW_FOLLOWER,

{core_framework-4.2.0 → core_framework-4.2.1}/core_framework/domains/user/models.py

@@ -128,6 +128,12 @@ UsernameSuggestion = UserCard
 class Preferences:
     theme: Theme
     language: str
+    comments: bool
+    replies: bool
+    mentions: bool
+    follows: bool
+    friend_requests: bool
+    group_invites: bool
 
     DEFAULT: ClassVar[Preferences]
 
@@ -135,6 +141,12 @@ class Preferences:
 Preferences.DEFAULT = Preferences(
     theme=Theme.LIGHT,
     language="en",
+    comments=True,
+    replies=True,
+    mentions=True,
+    follows=True,
+    friend_requests=True,
+    group_invites=True,
 )
 
 
@@ -144,6 +156,12 @@ class PreferencesUpdate:
         {
             "theme": "theme",
             "language": "language",
+            "comments": "comments",
+            "replies": "replies",
+            "mentions": "mentions",
+            "follows": "follows",
+            "friend_requests": "friend_requests",
+            "group_invites": "group_invites",
         }
     )
     UPDATE_FIELDS: ClassVar[frozenset[str]] = frozenset(UPDATE_COLUMNS.keys())
@@ -151,6 +169,12 @@ class PreferencesUpdate:
     fields_set: frozenset[str]
     theme: Theme | None = None
     language: str | None = None
+    comments: bool | None = None
+    replies: bool | None = None
+    mentions: bool | None = None
+    follows: bool | None = None
+    friend_requests: bool | None = None
+    group_invites: bool | None = None
 
     def require_has_updates(self) -> None:
         """