contextbase-plugin-microsoft-mail 0.2.6__py3-none-any.whl

contextbase_plugin_microsoft_mail-0.2.6.dist-info/METADATA

@@ -0,0 +1,14 @@
+Metadata-Version: 2.3
+Name: contextbase-plugin-microsoft-mail
+Version: 0.2.6
+Summary: Microsoft Mail plugin for ContextBase
+Author: Alizain Feerasta
+Author-email: Alizain Feerasta <alizain.feerasta@gmail.com>
+Requires-Dist: azure-identity>=1.25.1
+Requires-Dist: dagster==1.12.14
+Requires-Dist: dagster-dlt==0.28.14
+Requires-Dist: dlt[duckdb]>=1.26.0
+Requires-Dist: msgraph-sdk>=1.56.0
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: contextbase-shared-plugins==0.2.6
+Requires-Python: >=3.14, <3.15

contextbase_plugin_microsoft_mail-0.2.6.dist-info/RECORD

@@ -0,0 +1,18 @@
+plugin_microsoft_mail/__init__.py,sha256=ElTC8h64p4DKoEbGEjimkj2CIjmT8l_aw0me_JGZfMM,37
+plugin_microsoft_mail/binding_config.py,sha256=NWHO20z3EPLSZwfJS5ckQqq91A05epw8xA-TN9L3zqk,401
+plugin_microsoft_mail/component.py,sha256=_SV5rAICmhtw_M1KeVJVtnOObqo0P3toBv9_Pyev8FM,6754
+plugin_microsoft_mail/defs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_microsoft_mail/defs/defs.yaml,sha256=QazgvJAFnOXMfZQnZixhJ9vEOKlLJLW2E5lbJ0o4Etw,61
+plugin_microsoft_mail/models/__init__.py,sha256=uzhFJ0GZsyzEbh9e2aDXued2szRLOdK0y4Edu9Au-tg,45
+plugin_microsoft_mail/models/ctx.py,sha256=mjZWlQ9JTUP9kcPryEK3qWCDqUcA5ILAa9ocUWv884I,16193
+plugin_microsoft_mail/models/translators.py,sha256=HKVuE9MZSYWvL4OEJ_OzFLWAiedWYyNrixVoBY8t3RY,7577
+plugin_microsoft_mail/plugin.json,sha256=qmr0yO23xgAmk3fFEEamGsjvtaIpByrCf5Ei-KMA43c,101
+plugin_microsoft_mail/sources/__init__.py,sha256=amRjajxNvz162fVQ7qBKav8u_5B3RlynZovTc_cOdI8,38
+plugin_microsoft_mail/sources/attachments.py,sha256=x5IDgTXxUO1ZRh-dl8F9Ir4d5zVSgZIqOGQH-JceHto,14152
+plugin_microsoft_mail/sources/sync.py,sha256=Mp7wKcz-TWy8WBBC11Mc-BvWhVi_xzvVMcr9vnFpJro,12485
+plugin_microsoft_mail/utils/__init__.py,sha256=6rzVtzFRsQ3u0YcpE-Ehb2Amr0I6nasQ01xRTy3rc2U,57
+plugin_microsoft_mail/utils/attachments.py,sha256=VGMs105v2vaHro0dIstTQ5VXe-EY28khAmWtaKNM4EE,3673
+plugin_microsoft_mail/utils/client.py,sha256=JjR6DSQYeFm-f74i4uhEN4m7lyRjpC2Pu1msX_4N678,8552
+contextbase_plugin_microsoft_mail-0.2.6.dist-info/WHEEL,sha256=i9aSRDivn5iP9LaR1BLQX2GNAuriQWPsFwbbWygTX2k,81
+contextbase_plugin_microsoft_mail-0.2.6.dist-info/METADATA,sha256=dd0tfO1J64U2EVACxLUkiZQ50KOj1MAcqsVl5-6w5JQ,497
+contextbase_plugin_microsoft_mail-0.2.6.dist-info/RECORD,,

contextbase_plugin_microsoft_mail-0.2.6.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_microsoft_mail/__init__.py

@@ -0,0 +1 @@
+"""Microsoft Mail plugin package."""

plugin_microsoft_mail/binding_config.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from typing import Annotated
+
+from pydantic import Field
+from shared_plugins.bindings import BaseBindingConfigModel, NonEmptyText
+
+PositiveInt = Annotated[int, Field(strict=True, ge=1)]
+
+
+class MicrosoftMailBindingConfig(BaseBindingConfigModel):
+    tenant_id: NonEmptyText
+    mailbox_user_id: NonEmptyText
+    initial_message_delta_top: PositiveInt | None = 1000

plugin_microsoft_mail/component.py

@@ -0,0 +1,189 @@
+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, require_client_credentials
+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 MicrosoftMailBindingConfig
+from .sources.attachments import microsoft_mail_attachment_source
+from .sources.sync import microsoft_mail_source
+from .utils.client import SyncGraphMailClient
+
+PLUGIN_ID = plugin_id_from_module(__file__)
+SYNC_JOB = "sync"
+ATTACHMENT_CONTENT_JOB = "attachment_content"
+
+SYNC_SOURCE_NAME = dlt_source_name(PLUGIN_ID, SYNC_JOB)
+ATTACHMENT_CONTENT_SOURCE_NAME = dlt_source_name(
+    PLUGIN_ID,
+    ATTACHMENT_CONTENT_JOB,
+)
+
+MAIL_FOLDERS_ASSET_KEY = dagster_dlt_asset_key(SYNC_SOURCE_NAME, "mail_folders")
+MESSAGES_ASSET_KEY = dagster_dlt_asset_key(SYNC_SOURCE_NAME, "messages")
+ATTACHMENT_CONTENT_ASSET_KEY = dagster_dlt_asset_key(
+    ATTACHMENT_CONTENT_SOURCE_NAME,
+    "attachment_content",
+)
+
+
+def _build_sync_specs(
+    partitions_def: dg.PartitionsDefinition,
+    automation_condition: dg.AutomationCondition,
+) -> list[dg.AssetSpec]:
+    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=MAIL_FOLDERS_ASSET_KEY, **shared),
+        dg.AssetSpec(key=MESSAGES_ASSET_KEY, deps=[MAIL_FOLDERS_ASSET_KEY], **shared),
+    ]
+
+
+def _build_attachment_content_specs(
+    partitions_def: dg.PartitionsDefinition,
+    automation_condition: dg.AutomationCondition,
+) -> list[dg.AssetSpec]:
+    return [
+        dg.AssetSpec(
+            key=ATTACHMENT_CONTENT_ASSET_KEY,
+            group_name=dagster_asset_group_name(PLUGIN_ID),
+            tags=dagster_asset_tags(PLUGIN_ID),
+            automation_condition=automation_condition,
+            partitions_def=partitions_def,
+            deps=[MESSAGES_ASSET_KEY],
+        )
+    ]
+
+
+class MicrosoftMailComponent(dg.Component):
+    def build_defs(self, context: dg.ComponentLoadContext) -> dg.Definitions:
+        partitions_def = dg.DynamicPartitionsDefinition(
+            name=dagster_partition_def_name(PLUGIN_ID)
+        )
+
+        sync_specs = _build_sync_specs(
+            partitions_def,
+            non_overlapping_automation_condition(
+                dg.AutomationCondition.on_missing()
+                | dg.AutomationCondition.on_cron("*/15 * * * *")
+            ),
+        )
+        attachment_content_specs = _build_attachment_content_specs(
+            partitions_def,
+            non_overlapping_automation_condition(
+                dg.AutomationCondition.cron_tick_passed("*/10 * * * *")
+            ),
+        )
+
+        @dg.multi_asset(
+            specs=sync_specs,
+            can_subset=False,
+            name="microsoft_mail_sync",
+            pool=dagster_pool_name(PLUGIN_ID),
+        )
+        def microsoft_mail_sync_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, MicrosoftMailBindingConfig)
+            auth = require_client_credentials(binding)
+
+            with SyncGraphMailClient(
+                auth=auth,
+                tenant_id=cfg.tenant_id,
+                mailbox_user_id=cfg.mailbox_user_id,
+            ) as client:
+                source = microsoft_mail_source(
+                    binding_id,
+                    client=client,
+                    initial_message_delta_top=cfg.initial_message_delta_top,
+                )
+                yield from run_dlt_pipeline(
+                    context=context,
+                    dlt_resource=dlt_resource,
+                    source=source,
+                    plugin_id=PLUGIN_ID,
+                    binding_id=binding_id,
+                    job_name=SYNC_JOB,
+                )
+
+        @dg.multi_asset(
+            specs=attachment_content_specs,
+            name="microsoft_mail_attachment_content",
+            pool=dagster_pool_name(PLUGIN_ID),
+        )
+        def microsoft_mail_attachment_content_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, MicrosoftMailBindingConfig)
+            auth = require_client_credentials(binding)
+
+            with SyncGraphMailClient(
+                auth=auth,
+                tenant_id=cfg.tenant_id,
+                mailbox_user_id=cfg.mailbox_user_id,
+            ) as client:
+                source = microsoft_mail_attachment_source(
+                    binding_id,
+                    client=client,
+                )
+                yield from run_dlt_pipeline(
+                    context=context,
+                    dlt_resource=dlt_resource,
+                    source=source,
+                    plugin_id=PLUGIN_ID,
+                    binding_id=binding_id,
+                    job_name=ATTACHMENT_CONTENT_JOB,
+                )
+
+        automation_sensor = dg.AutomationConditionSensorDefinition(
+            name="microsoft_mail_automation_sensor",
+            target=dg.AssetSelection.assets(
+                microsoft_mail_sync_assets,
+                microsoft_mail_attachment_content_assets,
+            ),
+            default_status=dg.DefaultSensorStatus.RUNNING,
+            minimum_interval_seconds=30,
+        )
+
+        return dg.Definitions(
+            assets=[
+                microsoft_mail_sync_assets,
+                microsoft_mail_attachment_content_assets,
+            ],
+            sensors=[automation_sensor],
+            resources={
+                "dlt_resource": DLT_RESOURCE,
+            },
+        )

plugin_microsoft_mail/defs/defs.yaml

@@ -0,0 +1 @@
+type: plugin_microsoft_mail.component.MicrosoftMailComponent

plugin_microsoft_mail/models/__init__.py

@@ -0,0 +1 @@
+"""Microsoft Mail ContextBase row models."""

plugin_microsoft_mail/models/ctx.py

@@ -0,0 +1,378 @@
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import AwareDatetime, Field, model_validator
+from shared_plugins.models import CtxModel, IdStr, NonNegativeInt
+
+
+class MailFolderRow(CtxModel):
+    ctx_deleted: bool = Field(default=False, alias="_ctx_deleted")
+    id: IdStr
+    odata_type: str | None = None
+    additional_data: dict[str, Any] = Field(default_factory=dict)
+    child_folder_count: NonNegativeInt | None = None
+    child_folders: list[dict[str, Any]] = Field(default_factory=list)
+    display_name: str | None = None
+    is_hidden: bool | None = None
+    message_rules: list[dict[str, Any]] = Field(default_factory=list)
+    messages: list[dict[str, Any]] = Field(default_factory=list)
+    multi_value_extended_properties: list[dict[str, Any]] = Field(default_factory=list)
+    parent_folder_id: str | None = None
+    single_value_extended_properties: list[dict[str, Any]] = Field(default_factory=list)
+    total_item_count: NonNegativeInt | None = None
+    unread_item_count: NonNegativeInt | None = None
+
+
+class MessageRow(CtxModel):
+    ctx_deleted: bool = Field(default=False, alias="_ctx_deleted")
+    id: IdStr
+    odata_type: str | None = None
+    etag: str | None = None
+    additional_data: dict[str, Any] = Field(default_factory=dict)
+    attachments: list[dict[str, Any]] = Field(default_factory=list)
+    bcc_recipients: list[dict[str, Any]] = Field(default_factory=list)
+    body: dict[str, Any] | None = None
+    body_preview: str | None = None
+    categories: list[str] = Field(default_factory=list)
+    cc_recipients: list[dict[str, Any]] = Field(default_factory=list)
+    change_key: str | None = None
+    conversation_id: str | None = None
+    conversation_index: str | None = None
+    created_date_time: AwareDatetime | None = None
+    extensions: list[dict[str, Any]] = Field(default_factory=list)
+    flag: dict[str, Any] | None = None
+    from_: dict[str, Any] | None = None
+    has_attachments: bool | None = None
+    importance: str | None = None
+    inference_classification: str | None = None
+    internet_message_headers: list[dict[str, Any]] = Field(default_factory=list)
+    internet_message_id: str | None = None
+    is_delivery_receipt_requested: bool | None = None
+    is_draft: bool | None = None
+    is_read: bool | None = None
+    is_read_receipt_requested: bool | None = None
+    last_modified_date_time: AwareDatetime | None = None
+    multi_value_extended_properties: list[dict[str, Any]] = Field(default_factory=list)
+    parent_folder_id: IdStr
+    received_date_time: AwareDatetime | None = None
+    reply_to: list[dict[str, Any]] = Field(default_factory=list)
+    sender: dict[str, Any] | None = None
+    sent_date_time: AwareDatetime | None = None
+    single_value_extended_properties: list[dict[str, Any]] = Field(default_factory=list)
+    subject: str | None = None
+    to_recipients: list[dict[str, Any]] = Field(default_factory=list)
+    unique_body: dict[str, Any] | None = None
+    web_link: str | None = None
+
+
+class AttachmentContentRow(CtxModel):
+    """Row in the `attachment_content` table.
+
+    Carries either materialized-attachment data (live row) or a deletion
+    signal (tombstone) emitted by the orphan-cleanup arm of the content
+    job's candidate query.
+
+    - Live row: `ctx_deleted=False`, `attachment_id` and `file_path` populated.
+    - Tombstone: `ctx_deleted=True`, only the merge-key columns
+      (`_ctx_binding_id`, `message_id`) populated; dlt deletes every
+      `attachment_content` row matching that merge_key regardless of
+      `attachment_id`.
+
+    `attachment_id` and `file_path` are nullable on the type because
+    tombstones don't carry them. The validator enforces that live rows
+    (`ctx_deleted=False`) populate both.
+    """
+
+    message_id: IdStr
+    attachment_id: IdStr | None = None
+    odata_type: str | None = None
+    media_content_type: str | None = None
+    name: str | None = None
+    content_type: str | None = None
+    size: NonNegativeInt | None = None
+    is_inline: bool | None = None
+    content_id: str | None = None
+    content_location: str | None = None
+    last_modified_date_time: AwareDatetime | None = None
+    file_path: str | None = None
+    ctx_deleted: bool = Field(default=False, alias="_ctx_deleted")
+
+    @model_validator(mode="after")
+    def _enforce_live_row_invariant(self) -> "AttachmentContentRow":
+        if not self.ctx_deleted:
+            if self.attachment_id is None or self.file_path is None:
+                raise ValueError(
+                    "Live AttachmentContentRow (ctx_deleted=False) must have "
+                    "attachment_id and file_path; got "
+                    f"attachment_id={self.attachment_id!r}, file_path={self.file_path!r}."
+                )
+        return self
+
+
+MAIL_FOLDER_COLUMN_DESCRIPTIONS = {
+    "child_folder_count": {
+        "description": "The number of immediate child mailFolders in the current mailFolder."
+    },
+    "child_folders": {
+        "description": "The collection of child folders in the mailFolder."
+    },
+    "display_name": {"description": "The mailFolder's display name."},
+    "id": {"description": "The mailFolder's unique identifier."},
+    "is_hidden": {
+        "description": (
+            "Indicates whether the mailFolder is hidden. This property can be set "
+            "only when creating the folder. Find more information in Hidden mail "
+            "folders."
+        )
+    },
+    "message_rules": {
+        "description": "The collection of rules that apply to the user's Inbox folder."
+    },
+    "messages": {"description": "The collection of messages in the mailFolder."},
+    "multi_value_extended_properties": {
+        "description": (
+            "The collection of multi-value extended properties defined for the "
+            "mailFolder. Read-only. Nullable."
+        )
+    },
+    "parent_folder_id": {
+        "description": "The unique identifier for the mailFolder's parent mailFolder."
+    },
+    "single_value_extended_properties": {
+        "description": (
+            "The collection of single-value extended properties defined for the "
+            "mailFolder. Read-only. Nullable."
+        )
+    },
+    "total_item_count": {"description": "The number of items in the mailFolder."},
+    "unread_item_count": {
+        "description": "The number of items in the mailFolder marked as unread."
+    },
+}
+
+MESSAGE_COLUMN_DESCRIPTIONS = {
+    "attachments": {
+        "description": (
+            "Microsoft Graph attachments expanded inline with the message delta. "
+            "Each element is a Graph attachment record (file/reference/item). "
+            "Includes inline attachments (e.g. signature images, embedded "
+            "screenshots), distinguished by `isInline`. To exclude inline "
+            "attachments in a query: `WHERE NOT (a->>'isInline')::bool` over "
+            "`jsonb_array_elements(attachments) AS a`."
+        )
+    },
+    "bcc_recipients": {"description": "The Bcc: recipients for the message."},
+    "body": {
+        "description": (
+            "The body of the message. It can be in HTML or text format. Find out "
+            "about safe HTML in a message body."
+        )
+    },
+    "body_preview": {
+        "description": (
+            "The first 255 characters of the message body. It is in text format."
+        )
+    },
+    "cc_recipients": {"description": "The Cc: recipients for the message."},
+    "change_key": {"description": "The version of the message."},
+    "conversation_id": {
+        "description": "The ID of the conversation the email belongs to."
+    },
+    "conversation_index": {
+        "description": "Indicates the position of the message within the conversation."
+    },
+    "created_date_time": {
+        "description": (
+            "The date and time the message was created. The date and time "
+            "information uses ISO 8601 format and is always in UTC time. For "
+            "example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`."
+        )
+    },
+    "extensions": {
+        "description": (
+            "The collection of open extensions defined for the message. Nullable."
+        )
+    },
+    "flag": {
+        "description": (
+            "Indicates the status, start date, due date, or completion date for "
+            "the message."
+        )
+    },
+    "from_": {
+        "description": (
+            "The owner of the mailbox from which the message is sent. In most "
+            "cases, this value is the same as the sender property, except for "
+            "sharing or delegation scenarios. The value must correspond to the "
+            "actual mailbox used. Find out more about setting the from and sender "
+            "properties of a message."
+        )
+    },
+    "has_attachments": {
+        "description": (
+            "Indicates whether the message has attachments. This property doesn't "
+            "include inline attachments, so if a message contains only inline "
+            "attachments, this property is false. To verify the existence of inline "
+            "attachments, parse the body property to look for a `src` attribute, "
+            'such as `<IMG src="cid:image001.jpg@01D26CD8.6C05F070">`.'
+        )
+    },
+    "id": {
+        "description": (
+            "Unique identifier for the message. By default, this value changes "
+            "when the item is moved from one container (such as a folder or "
+            "calendar) to another. To change this behavior, use the `Prefer: "
+            'IdType="ImmutableId"` header. See Get immutable identifiers for '
+            "Outlook resources for more information. Read-only."
+        )
+    },
+    "importance": {
+        "description": (
+            "The importance of the message. The possible values are: `low`, "
+            "`normal`, and `high`."
+        )
+    },
+    "inference_classification": {
+        "description": (
+            "The classification of the message for the user, based on inferred "
+            "relevance or importance, or on an explicit override. The possible "
+            "values are: `focused` or `other`."
+        )
+    },
+    "internet_message_headers": {
+        "description": (
+            "A collection of message headers defined by RFC5322. The set includes "
+            "message headers indicating the network path taken by a message from "
+            "the sender to the recipient. It can also contain custom message "
+            "headers that hold app data for the message. Requires `$select` to "
+            "retrieve. Read-only."
+        )
+    },
+    "internet_message_id": {
+        "description": "The message ID in the format specified by RFC2822."
+    },
+    "is_delivery_receipt_requested": {
+        "description": "Indicates whether a read receipt is requested for the message."
+    },
+    "is_draft": {
+        "description": (
+            "Indicates whether the message is a draft. A message is a draft if it "
+            "hasn't been sent yet."
+        )
+    },
+    "is_read": {"description": "Indicates whether the message has been read."},
+    "is_read_receipt_requested": {
+        "description": "Indicates whether a read receipt is requested for the message."
+    },
+    "last_modified_date_time": {
+        "description": (
+            "The date and time the message was last changed. The date and time "
+            "information uses ISO 8601 format and is always in UTC time. For "
+            "example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`."
+        )
+    },
+    "multi_value_extended_properties": {
+        "description": (
+            "The collection of multi-value extended properties defined for the "
+            "message. Nullable."
+        )
+    },
+    "parent_folder_id": {
+        "description": "The unique identifier for the message's parent mailFolder."
+    },
+    "received_date_time": {
+        "description": (
+            "The date and time the message was received. The date and time "
+            "information uses ISO 8601 format and is always in UTC time. For "
+            "example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`."
+        )
+    },
+    "reply_to": {"description": "The email addresses to use when replying."},
+    "sender": {
+        "description": (
+            "The account that is used to generate the message. In most cases, this "
+            "value is the same as the from property. You can set this property to "
+            "a different value when sending a message from a shared mailbox, for a "
+            "shared calendar, or as a delegate. In any case, the value must "
+            "correspond to the actual mailbox used. Find out more about setting "
+            "the from and sender properties of a message."
+        )
+    },
+    "sent_date_time": {
+        "description": (
+            "The date and time the message was sent. The date and time information "
+            "uses ISO 8601 format and is always in UTC time. For example, midnight "
+            "UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`."
+        )
+    },
+    "single_value_extended_properties": {
+        "description": (
+            "The collection of single-value extended properties defined for the "
+            "message. Nullable."
+        )
+    },
+    "subject": {"description": "The subject of the message."},
+    "to_recipients": {"description": "The To: recipients for the message."},
+    "unique_body": {
+        "description": (
+            "The part of the body of the message that is unique to the current "
+            "message. uniqueBody is not returned by default but can be retrieved "
+            "for a given message by use of the `?$select=uniqueBody` query. It can "
+            "be in HTML or text format."
+        )
+    },
+    "web_link": {
+        "description": (
+            "The URL to open the message in Outlook on the web. You can append an "
+            "`ispopout` argument to the end of the URL to change how the message "
+            "is displayed. If `ispopout` is not present or if it is set to `1`, "
+            "then the message is shown in a popout window. If `ispopout` is set to "
+            "`0`, the browser shows the message in the Outlook on the web review "
+            "pane. The message opens in the browser if you are signed in to your "
+            "mailbox via Outlook on the web. You are prompted to sign in if you "
+            "are not already signed in with the browser. This URL cannot be "
+            "accessed from within an iFrame. NOTE: When using this URL to access a "
+            "message from a mailbox with delegate permissions, both the signed-in "
+            "user and the target mailbox must be in the same database region. For "
+            "example, an error is returned when a user with a mailbox in the EUR "
+            "(Europe) region attempts to access messages from a mailbox in the NAM "
+            "(North America) region."
+        )
+    },
+}
+
+ATTACHMENT_CONTENT_COLUMN_DESCRIPTIONS = {
+    "attachment_id": {
+        "description": "Microsoft Graph attachment id (per-message stable identifier)."
+    },
+    "name": {"description": "The attachment's file name."},
+    "content_type": {"description": "The MIME type."},
+    "size": {"description": "The length of the attachment in bytes."},
+    "is_inline": {
+        "description": (
+            "`true` if the attachment is referenced inline from the message body "
+            "(e.g. a `cid:`-referenced image)."
+        )
+    },
+    "content_id": {
+        "description": (
+            'Microsoft Graph contentId, used to match `<img src="cid:{contentId}">` '
+            "tags in the message body. Only set for fileAttachment subtypes."
+        )
+    },
+    "content_location": {"description": "Microsoft Graph contentLocation. Often NULL."},
+    "last_modified_date_time": {
+        "description": (
+            "Per-attachment last-modified timestamp from Graph. Same source as "
+            "_ctx_source_updated_at."
+        )
+    },
+    "file_path": {
+        "description": (
+            "Local on-disk path written by the content materialization job. "
+            "Always set — this table only contains rows for attachments with "
+            "materialized bytes."
+        )
+    },
+}