contextbase-plugin-imessage-local 0.2.9__py3-none-any.whl

contextbase_plugin_imessage_local-0.2.9.dist-info/METADATA

@@ -0,0 +1,14 @@
+Metadata-Version: 2.3
+Name: contextbase-plugin-imessage-local
+Version: 0.2.9
+Summary: iMessage local plugin for ContextBase
+Author: Alizain Feerasta
+Author-email: Alizain Feerasta <alizain.feerasta@gmail.com>
+Requires-Dist: contextbase-shared-plugins==0.2.9
+Requires-Dist: dagster==1.12.14
+Requires-Dist: dagster-dlt==0.28.14
+Requires-Dist: dlt>=1.26.0
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: pytypedstream>=0.1.0
+Requires-Python: >=3.14, <3.15

contextbase_plugin_imessage_local-0.2.9.dist-info/RECORD

@@ -0,0 +1,17 @@
+plugin_imessage_local/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_imessage_local/attributed_body.py,sha256=dqDGhacVNQBiItvJ4s-OESK6eI-P6oS6iHFIFly09XM,8690
+plugin_imessage_local/binding_config.py,sha256=27KQdL1jBL3EaNvETYbdW_mTAjBBNCapEVrdC8bgwME,346
+plugin_imessage_local/component.py,sha256=zM6l0XLl7Eb67HVzGk8XvvSthSbwt2A_B5pmBhMB_o0,4342
+plugin_imessage_local/defs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_imessage_local/defs/defs.yaml,sha256=3VPEop8FV-z3MzhwZ1At1E6LJ8nY0XZXmf_dgi3E74Y,65
+plugin_imessage_local/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_imessage_local/models/base.py,sha256=Fp7n4EfxQOxzqm34-D-rYyu60P88eZUIewCBNP_Iuc4,119
+plugin_imessage_local/models/ctx.py,sha256=ssFsqd13O7WFdmWp46sgaJmwIW3GIKC6dr7w0lOOams,6578
+plugin_imessage_local/models/ingress.py,sha256=k9RhevINbEB22-tc_nerw-nWM49q1BNpiKa7ojzun6s,15077
+plugin_imessage_local/models/translators.py,sha256=gpf8qZAdFX-5tP7xW8eCDLGn5xD05TJ2c38Ti7M03x0,14776
+plugin_imessage_local/plugin.json,sha256=Qb9qSVo9PHFxPb1KHKCgWqEL82ukL9wWlZZb37p0j8U,87
+plugin_imessage_local/sources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_imessage_local/sources/snapshot.py,sha256=dZFApIcC6Xrc-B0KQOu5WZSKdC4oPSak5d6C14Xx_os,8203
+contextbase_plugin_imessage_local-0.2.9.dist-info/WHEEL,sha256=i9aSRDivn5iP9LaR1BLQX2GNAuriQWPsFwbbWygTX2k,81
+contextbase_plugin_imessage_local-0.2.9.dist-info/METADATA,sha256=1SqkU6WzhTtb690xO_gQ-9kn9l1Q6NqcygxSuVQXshs,485
+contextbase_plugin_imessage_local-0.2.9.dist-info/RECORD,,

contextbase_plugin_imessage_local-0.2.9.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.15
+Root-Is-Purelib: true
+Tag: py3-none-any

plugin_imessage_local/attributed_body.py

@@ -0,0 +1,269 @@
+"""Decode iMessage ``message.attributedBody`` blobs into text + attribute runs.
+
+The ``attributedBody`` column stores an NeXTSTEP-typedstream-archived
+``NSAttributedString``. On modern macOS ~97% of messages populate this column
+rather than the plain ``text`` column, so extracting it is essential.
+
+Two tiers:
+
+1. **Primary** — ``pytypedstream`` reads the root ``NSMutableAttributedString``
+   object, then we walk its attribute-run structure to recover text plus the
+   per-run attribute dictionaries.
+2. **Fallback** — for blobs that raise ``InvalidTypedStreamError`` we attempt a
+   length-aware byte scan modeled on ``niftycode/imessage_reader`` which
+   recovers just the plain text.
+
+Returns ``None`` only when both tiers fail. The raw blob is still preserved
+upstream in the ingress model, so any future decoder can revisit it without
+re-ingesting.
+"""
+
+from __future__ import annotations
+
+import logging
+from collections.abc import Mapping
+from dataclasses import dataclass, field
+from typing import Any
+
+from typedstream import (
+    GenericArchivedObject,
+    InvalidTypedStreamError,
+    TypedGroup,
+    TypedValue,
+    unarchive_from_data,
+)
+from typedstream.types.foundation import (
+    NSArray,
+    NSData,
+    NSDate,
+    NSDictionary,
+    NSMutableArray,
+    NSMutableData,
+    NSMutableDictionary,
+    NSMutableSet,
+    NSMutableString,
+    NSNumber,
+    NSSet,
+    NSString,
+    NSURL,
+)
+
+LOGGER = logging.getLogger(__name__)
+
+_BYTESCAN_SENTINEL = b"NSString"
+_BYTESCAN_PREAMBLE = b"\x01\x94\x84\x01\x2b"  # '\x01' '\x94' '\x84' '\x01' '+'
+_BYTESCAN_LONG_LENGTH_MARKER = 0x81
+
+
+@dataclass(frozen=True)
+class TextRun:
+    """A contiguous attribute run within a decoded ``NSAttributedString``.
+
+    ``location`` and ``length`` are UTF-16 code-unit offsets to match Apple's
+    native string representation. Python ``str`` uses code points, so callers
+    that want to slice the text need to encode to UTF-16 first.
+    """
+
+    location: int
+    length: int
+    attributes: Mapping[str, Any]
+
+
+@dataclass(frozen=True)
+class DecodedBody:
+    """Result of decoding an ``attributedBody`` blob."""
+
+    text: str
+    runs: tuple[TextRun, ...] = field(default_factory=tuple)
+
+
+def decode_attributed_body(blob: bytes) -> DecodedBody | None:
+    """Decode a raw ``attributedBody`` blob.
+
+    Returns ``None`` iff both the typedstream decoder and the byte-scan
+    fallback fail to recover any text.
+    """
+    if not blob:
+        return None
+
+    try:
+        return _decode_via_typedstream(blob)
+    except InvalidTypedStreamError as exc:
+        LOGGER.debug(
+            "attributed_body.typedstream_failed falling back to byte-scan: %s", exc
+        )
+
+    return _decode_via_bytescan(blob)
+
+
+def _decode_via_typedstream(blob: bytes) -> DecodedBody:
+    obj = unarchive_from_data(blob)
+    if not isinstance(obj, GenericArchivedObject):
+        raise InvalidTypedStreamError(
+            f"attributedBody root is {type(obj).__name__}, expected "
+            "GenericArchivedObject"
+        )
+
+    class_name = obj.clazz.name.decode("ascii", errors="replace")
+    if "AttributedString" not in class_name:
+        raise InvalidTypedStreamError(
+            f"attributedBody root class is {class_name!r}, expected an "
+            "NSAttributedString subclass"
+        )
+
+    contents = obj.contents
+    if not contents:
+        raise InvalidTypedStreamError("attributedBody has no encoded contents")
+
+    text_item = contents[0]
+    if not isinstance(text_item, TypedValue):
+        raise InvalidTypedStreamError(
+            f"attributedBody[0] is {type(text_item).__name__}, expected TypedValue"
+        )
+    text = _as_python_string(text_item.value)
+
+    runs = tuple(_walk_attribute_runs(contents[1:]))
+    return DecodedBody(text=text, runs=runs)
+
+
+def _walk_attribute_runs(tail: list[Any]) -> list[TextRun]:
+    """Replay the NSAttributedString run sequence.
+
+    Layout is (TypedGroup[index, length] [, TypedValue(NSDictionary)])*.
+    ``index == 1 + len(seen_dicts)`` means "a new dictionary follows"; any
+    lower index is a back-reference into the stored dictionaries.
+    """
+    runs: list[TextRun] = []
+    stored: list[Mapping[str, Any]] = []
+    location = 0
+
+    cursor = 0
+    while cursor < len(tail):
+        group = tail[cursor]
+        if not isinstance(group, TypedGroup):
+            raise InvalidTypedStreamError(
+                f"attributedBody run entry is {type(group).__name__}, "
+                "expected TypedGroup"
+            )
+
+        try:
+            raw_index, raw_length = group.values
+        except (TypeError, ValueError) as exc:
+            raise InvalidTypedStreamError(
+                f"attributedBody run group has unexpected shape: {group!r}"
+            ) from exc
+
+        index = int(raw_index)
+        length = int(raw_length)
+
+        if index == len(stored) + 1:
+            cursor += 1
+            if cursor >= len(tail):
+                raise InvalidTypedStreamError(
+                    "attributedBody ended mid-run; expected NSDictionary after "
+                    f"new-dict marker index={index}"
+                )
+            dict_item = tail[cursor]
+            if not isinstance(dict_item, TypedValue):
+                raise InvalidTypedStreamError(
+                    f"attributedBody expected TypedValue(NSDictionary), got "
+                    f"{type(dict_item).__name__}"
+                )
+            attrs = _as_python(dict_item.value)
+            if not isinstance(attrs, Mapping):
+                raise InvalidTypedStreamError(
+                    f"attributedBody attribute dict is {type(attrs).__name__}, "
+                    "expected Mapping"
+                )
+            stored.append(attrs)
+        elif 1 <= index <= len(stored):
+            attrs = stored[index - 1]
+        else:
+            raise InvalidTypedStreamError(
+                f"attributedBody run references attribute index {index} with "
+                f"only {len(stored)} stored"
+            )
+
+        runs.append(TextRun(location=location, length=length, attributes=attrs))
+        location += length
+        cursor += 1
+
+    return runs
+
+
+def _decode_via_bytescan(blob: bytes) -> DecodedBody | None:
+    """Length-aware byte-scan fallback; recovers text only, no attributes."""
+    anchor = blob.find(_BYTESCAN_SENTINEL)
+    if anchor < 0:
+        return None
+
+    cursor = anchor + len(_BYTESCAN_SENTINEL)
+    if blob[cursor : cursor + len(_BYTESCAN_PREAMBLE)] != _BYTESCAN_PREAMBLE:
+        return None
+    cursor += len(_BYTESCAN_PREAMBLE)
+
+    if cursor >= len(blob):
+        return None
+
+    marker = blob[cursor]
+    cursor += 1
+    if marker == _BYTESCAN_LONG_LENGTH_MARKER:
+        if cursor + 2 > len(blob):
+            return None
+        length = int.from_bytes(blob[cursor : cursor + 2], "little")
+        cursor += 2
+    else:
+        length = marker
+
+    text_bytes = blob[cursor : cursor + length]
+    if len(text_bytes) != length:
+        return None
+
+    try:
+        text = text_bytes.decode("utf-8")
+    except UnicodeDecodeError:
+        return None
+
+    return DecodedBody(text=text, runs=())
+
+
+def _as_python_string(value: Any) -> str:
+    if isinstance(value, (NSString, NSMutableString)):
+        return str(value.value)
+    if isinstance(value, str):
+        return value
+    raise InvalidTypedStreamError(
+        f"expected NSString-compatible value, got {type(value).__name__}"
+    )
+
+
+def _as_python(value: Any) -> Any:
+    """Convert pytypedstream NS* types to native Python containers.
+
+    Unknown Foundation subclasses raise ``InvalidTypedStreamError`` so the
+    decoder falls through to the byte-scan tier rather than silently emitting
+    opaque sentinel values.
+    """
+    if value is None or isinstance(value, (str, int, float, bool, bytes)):
+        return value
+    if isinstance(value, (NSString, NSMutableString)):
+        return str(value.value)
+    if isinstance(value, NSNumber):
+        return value.value
+    if isinstance(value, (NSMutableData, NSData)):
+        return bytes(value.data)
+    if isinstance(value, NSURL):
+        return value.value
+    if isinstance(value, NSDate):
+        return value.value
+    if isinstance(value, (NSDictionary, NSMutableDictionary)):
+        return {_as_python(k): _as_python(v) for k, v in value.contents.items()}
+    if isinstance(value, (NSArray, NSMutableArray, NSSet, NSMutableSet)):
+        contents = getattr(value, "contents", None) or getattr(value, "elements", None)
+        if contents is None:
+            return []
+        return [_as_python(x) for x in contents]
+    raise InvalidTypedStreamError(
+        f"unhandled Foundation type in attribute value: "
+        f"{type(value).__name__} (repr={value!r})"
+    )

plugin_imessage_local/binding_config.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from pydantic import Field
+
+from shared_plugins.bindings import BaseBindingConfigModel, ResolvedPath
+
+
+class IMessageLocalBindingConfig(BaseBindingConfigModel):
+    chat_db: ResolvedPath = Field(
+        default_factory=lambda: Path.home() / "Library" / "Messages" / "chat.db",
+    )

plugin_imessage_local/component.py

@@ -0,0 +1,125 @@
+import dagster as dg
+from dagster import AssetExecutionContext
+from dagster_dlt import DagsterDltResource
+from shared_plugins.automation import non_overlapping_automation_condition
+from shared_plugins.bindings import parse_binding_config
+from shared_plugins.control_plane import ControlPlaneClient
+from shared_plugins.dlt import resolve_partition_binding, run_dlt_pipeline
+from shared_plugins.naming import (
+    dagster_asset_group_name,
+    dagster_asset_tags,
+    dagster_dlt_asset_key,
+    dagster_partition_def_name,
+    dagster_pool_name,
+    dlt_source_name,
+    plugin_id_from_module,
+)
+from shared_plugins.resources import DLT_RESOURCE
+
+from .binding_config import IMessageLocalBindingConfig
+from .sources.snapshot import imessage_local_snapshot_source
+
+PLUGIN_ID = plugin_id_from_module(__file__)
+SNAPSHOT_JOB = "snapshot"
+
+
+def _build_snapshot_specs(
+    partitions_def: dg.PartitionsDefinition,
+    automation_condition: dg.AutomationCondition,
+) -> list[dg.AssetSpec]:
+    snapshot_source_name = dlt_source_name(PLUGIN_ID, SNAPSHOT_JOB)
+    shared = dict(
+        group_name=dagster_asset_group_name(PLUGIN_ID),
+        tags=dagster_asset_tags(PLUGIN_ID),
+        automation_condition=automation_condition,
+        partitions_def=partitions_def,
+    )
+
+    return [
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(snapshot_source_name, "handle"),
+            **shared,
+        ),
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(snapshot_source_name, "chat"),
+            **shared,
+        ),
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(snapshot_source_name, "attachment"),
+            **shared,
+        ),
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(snapshot_source_name, "message"),
+            **shared,
+        ),
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(snapshot_source_name, "chat_handle_join"),
+            **shared,
+        ),
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(snapshot_source_name, "chat_message_join"),
+            **shared,
+        ),
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(snapshot_source_name, "message_attachment_join"),
+            **shared,
+        ),
+    ]
+
+
+class IMessageLocalSyncComponent(dg.Component):
+    def build_defs(self, context: dg.ComponentLoadContext) -> dg.Definitions:
+        partitions_def = dg.DynamicPartitionsDefinition(
+            name=dagster_partition_def_name(PLUGIN_ID)
+        )
+        snapshot_specs = _build_snapshot_specs(
+            partitions_def=partitions_def,
+            automation_condition=non_overlapping_automation_condition(
+                dg.AutomationCondition.on_missing()
+                | dg.AutomationCondition.on_cron("*/15 * * * *")
+            ),
+        )
+
+        @dg.multi_asset(
+            specs=snapshot_specs,
+            can_subset=True,
+            name="imessage_local_snapshot",
+            pool=dagster_pool_name(PLUGIN_ID),
+        )
+        def imessage_local_snapshot_assets(
+            context: AssetExecutionContext,
+            dlt_resource: DagsterDltResource,
+            control_plane: dg.ResourceParam[ControlPlaneClient],
+        ):
+            binding = resolve_partition_binding(
+                context=context,
+                control_plane=control_plane,
+                plugin_id=PLUGIN_ID,
+            )
+            binding_id = str(binding.binding_id)
+            cfg = parse_binding_config(binding, IMessageLocalBindingConfig)
+
+            source = imessage_local_snapshot_source(binding_id, cfg)
+            yield from run_dlt_pipeline(
+                context=context,
+                dlt_resource=dlt_resource,
+                source=source,
+                plugin_id=PLUGIN_ID,
+                binding_id=binding_id,
+                job_name=SNAPSHOT_JOB,
+            )
+
+        automation_sensor = dg.AutomationConditionSensorDefinition(
+            name="imessage_local_automation_sensor",
+            target=dg.AssetSelection.assets(imessage_local_snapshot_assets),
+            default_status=dg.DefaultSensorStatus.RUNNING,
+            minimum_interval_seconds=30,
+        )
+
+        return dg.Definitions(
+            assets=[imessage_local_snapshot_assets],
+            sensors=[automation_sensor],
+            resources={
+                "dlt_resource": DLT_RESOURCE,
+            },
+        )

plugin_imessage_local/defs/defs.yaml

@@ -0,0 +1 @@
+type: plugin_imessage_local.component.IMessageLocalSyncComponent

plugin_imessage_local/models/base.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from sqlalchemy.orm import DeclarativeBase
+
+
+class Base(DeclarativeBase):
+    pass

plugin_imessage_local/models/ctx.py

@@ -0,0 +1,193 @@
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import AwareDatetime
+from shared_plugins.models import CtxModel
+
+
+class HandleRow(CtxModel):
+    id: str
+    service: str
+    country: str | None = None
+    uncanonicalized_id: str | None = None
+    person_centric_id: str | None = None
+
+
+class ChatRow(CtxModel):
+    guid: str
+    style: int | None = None
+    state: int | None = None
+    account_id: str | None = None
+    properties: bytes | None = None
+    chat_identifier: str | None = None
+    service_name: str | None = None
+    room_name: str | None = None
+    account_login: str | None = None
+    is_archived: int | None = None
+    last_addressed_handle: str | None = None
+    display_name: str | None = None
+    group_id: str | None = None
+    is_filtered: int | None = None
+    successful_query: int | None = None
+    engram_id: str | None = None
+    server_change_token: str | None = None
+    ck_sync_state: int | None = None
+    original_group_id: str | None = None
+    last_read_message_timestamp: AwareDatetime | None = None
+    sr_server_change_token: str | None = None
+    sr_ck_sync_state: int | None = None
+    cloudkit_record_id: str | None = None
+    sr_cloudkit_record_id: str | None = None
+    last_addressed_sim_id: str | None = None
+    is_blackholed: int | None = None
+    syndication_date: AwareDatetime | None = None
+    syndication_type: int | None = None
+    is_recovered: int | None = None
+    is_deleting_incoming_messages: int | None = None
+
+
+class AttachmentRow(CtxModel):
+    guid: str
+    created_date: AwareDatetime | None = None
+    start_date: AwareDatetime | None = None
+    filename: str | None = None
+    uti: str | None = None
+    mime_type: str | None = None
+    transfer_state: int | None = None
+    is_outgoing: int | None = None
+    user_info: bytes | None = None
+    transfer_name: str | None = None
+    total_bytes: int | None = None
+    is_sticker: int | None = None
+    sticker_user_info: bytes | None = None
+    attribution_info: bytes | None = None
+    hide_attachment: int | None = None
+    ck_sync_state: int | None = None
+    ck_server_change_token_blob: bytes | None = None
+    ck_record_id: str | None = None
+    original_guid: str
+    sr_ck_sync_state: int | None = None
+    sr_ck_server_change_token_blob: bytes | None = None
+    sr_ck_record_id: str | None = None
+    is_commsafety_sensitive: int | None = None
+    emoji_image_content_identifier: str | None = None
+    emoji_image_short_description: str | None = None
+    preview_generation_state: int | None = None
+
+
+class MessageRow(CtxModel):
+    guid: str
+    text: str | None = None
+    replace: int | None = None
+    service_center: str | None = None
+    handle_id: int | None = None
+    handle_natural_id: str | None = None
+    handle_natural_service: str | None = None
+    subject: str | None = None
+    country: str | None = None
+    attributed_body: bytes | None = None
+    attribute_runs: list[dict[str, Any]] | None = None
+    version: int | None = None
+    type: int | None = None
+    service: str | None = None
+    account: str | None = None
+    account_guid: str | None = None
+    error: int | None = None
+    date: AwareDatetime | None = None
+    date_read: AwareDatetime | None = None
+    date_delivered: AwareDatetime | None = None
+    is_delivered: int | None = None
+    is_finished: int | None = None
+    is_emote: int | None = None
+    is_from_me: int | None = None
+    is_empty: int | None = None
+    is_delayed: int | None = None
+    is_auto_reply: int | None = None
+    is_prepared: int | None = None
+    is_read: int | None = None
+    is_system_message: int | None = None
+    is_sent: int | None = None
+    has_dd_results: int | None = None
+    is_service_message: int | None = None
+    is_forward: int | None = None
+    was_downgraded: int | None = None
+    is_archive: int | None = None
+    was_data_detected: int | None = None
+    was_deduplicated: int | None = None
+    is_audio_message: int | None = None
+    is_played: int | None = None
+    date_played: AwareDatetime | None = None
+    item_type: int | None = None
+    other_handle: int | None = None
+    other_handle_natural_id: str | None = None
+    other_handle_natural_service: str | None = None
+    group_title: str | None = None
+    group_action_type: int | None = None
+    share_status: int | None = None
+    share_direction: int | None = None
+    is_expirable: int | None = None
+    expire_state: int | None = None
+    message_action_type: int | None = None
+    message_source: int | None = None
+    associated_message_guid: str | None = None
+    associated_message_type: int | None = None
+    balloon_bundle_id: str | None = None
+    payload_data: bytes | None = None
+    expressive_send_style_id: str | None = None
+    associated_message_range_location: int | None = None
+    associated_message_range_length: int | None = None
+    time_expressive_send_played: AwareDatetime | None = None
+    message_summary_info: bytes | None = None
+    destination_caller_id: str | None = None
+    is_corrupt: int | None = None
+    reply_to_guid: str | None = None
+    sort_id: int | None = None
+    is_spam: int | None = None
+    has_unseen_mention: int | None = None
+    thread_originator_guid: str | None = None
+    thread_originator_part: str | None = None
+    syndication_ranges: str | None = None
+    was_delivered_quietly: int | None = None
+    did_notify_recipient: int | None = None
+    synced_syndication_ranges: str | None = None
+    date_retracted: AwareDatetime | None = None
+    date_edited: AwareDatetime | None = None
+    was_detonated: int | None = None
+    part_count: int | None = None
+    is_stewie: int | None = None
+    is_kt_verified: int | None = None
+    is_sos: int | None = None
+    is_critical: int | None = None
+    bia_reference_id: str | None = None
+    fallback_hash: str | None = None
+    associated_message_emoji: str | None = None
+    is_pending_satellite_send: int | None = None
+    needs_relay: int | None = None
+    schedule_type: int | None = None
+    schedule_state: int | None = None
+    sent_or_received_off_grid: int | None = None
+    date_recovered: AwareDatetime | None = None
+
+
+class ChatHandleJoinRow(CtxModel):
+    chat_id: int
+    chat_guid: str
+    handle_id: int
+    handle_natural_id: str
+    handle_natural_service: str
+
+
+class ChatMessageJoinRow(CtxModel):
+    chat_id: int
+    chat_guid: str
+    message_id: int
+    message_guid: str
+    message_date: AwareDatetime | None = None
+
+
+class MessageAttachmentJoinRow(CtxModel):
+    message_id: int
+    message_guid: str
+    attachment_id: int
+    attachment_guid: str