M4: Calendar plugin (builtin) + mail HTML/attachment fixes

Calendar plugin (webmail_plugin_calendar, non-removable core plugin):
- Local calendars/events CRUD with RLS isolation; recurrence expanded at
  query time (DST-correct), EXDATE + detached-override merge.
- Calendar app bundle: month/week/day/3-day views, mini-month, event form
  (color, show-as, timezone combobox, repeat, reminders, guests w/ recipient
  autocomplete, Jitsi video call), event popover with RSVP badges, resizable/
  collapsible left panel + theme toggle, overlap layout.
- iMIP invites: sdk.mail sends REQUEST from the organizer's mailbox (HTML +
  text/calendar + invite.ics); public /rsvp endpoint (vault-sealed token)
  records accepted/declined/tentative per attendee.
- "This and following" edit + scoped delete (this / this-and-following), with
  a delete confirmation dialog for recurring events.

Core:
- Settings: time_format (12/24h, default 24h) + jitsi_server; new Integrations
  section; date order follows time format (en-GB vs en-US) across Mail.
- Plugin SDK: mail (send from a user's account), vault (envelope encrypt),
  multi-method SSRF-guarded http; AppSwitcher product switcher; full-bleed
  PluginPage.

Mail HTML rendering:
- Sanitizer allows <style> blocks + class (CSS sanitized: drop script-like,
  strip @import/url() when remote images blocked); SANITIZER_VERSION 3 so
  already-indexed mail re-sanitizes on view.
- Attachments: a Content-Disposition: attachment part is a real attachment
  even when it also carries a Content-ID (fixes hidden invite.ics).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-28 16:33:34 +02:00
co-authored by Claude Opus 4.8
parent d46ad13b7b
commit 8c634f7967
56 changed files with 3308 additions and 37 deletions
+26
View File
@@ -126,6 +126,32 @@ def test_inline_image_nested_in_related_is_extracted() -> None:
assert parsed.has_attachments is False
def test_attachment_with_content_id_is_a_real_attachment() -> None:
# iMIP invites (e.g. Fastmail) send invite.ics as Content-Disposition: attachment
# yet also give it a Content-ID. It must show as a downloadable chip, not be
# hidden as an inline resource (regression: "no attachments" shown).
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
root = MIMEMultipart("mixed")
root["Subject"] = "invite"
root["From"] = "org@example.com"
root["To"] = "me@example.com"
root["Message-ID"] = "<inv@x.com>"
root.attach(MIMEText("body", "plain"))
ics = MIMEText("BEGIN:VCALENDAR\nEND:VCALENDAR", "calendar")
ics.add_header("Content-Disposition", "attachment", filename="invite.ics")
ics.add_header("Content-ID", "<cal123@x>")
root.attach(ics)
parsed = parse_message(root.as_bytes())
assert len(parsed.attachments) == 1
att = parsed.attachments[0]
assert att.filename == "invite.ics"
assert att.content_id is None # not treated as inline despite the Content-ID
assert parsed.has_attachments is True
def test_missing_message_id_returns_none() -> None:
msg = EmailMessage()
msg["Subject"] = "no id"
+32
View File
@@ -54,3 +54,35 @@ def test_javascript_uri_is_stripped() -> None:
def test_sanitizer_version_reported() -> None:
result = sanitize_html("<p>hi</p>", MID)
assert result.sanitizer_v >= 1
def test_style_block_and_classes_are_kept() -> None:
# Mailers (e.g. Fastmail invites) put layout in a <style> block + classes.
html = '<style>.banner{color:#333}</style><div class="banner">hi</div>'
result = sanitize_html(html, MID)
assert "<style" in result.html.lower()
assert ".banner" in result.html
assert 'class="banner"' in result.html
def test_style_block_script_css_is_dropped() -> None:
html = '<style>.x{width:expression(alert(1))}</style><p class="x">hi</p>'
result = sanitize_html(html, MID)
assert "expression(" not in result.html.lower()
# the block is nuked but the element/class survive
assert 'class="x"' in result.html
def test_style_block_import_and_url_stripped_when_remote_blocked() -> None:
html = "<style>@import url('http://evil/x.css'); .b{background:url(http://evil/p.gif)}</style>"
result = sanitize_html(html, MID)
assert "@import" not in result.html.lower()
assert "evil" not in result.html.lower()
assert result.has_remote_images
def test_script_content_still_stripped_with_style_allowed() -> None:
html = "<script>alert(1)</script><style>.a{color:red}</style>"
result = sanitize_html(html, MID)
assert "alert(1)" not in result.html
assert ".a{color:red}" in result.html
@@ -0,0 +1,170 @@
"""Calendar plugin A1 API: calendars/events CRUD + range expansion (SPEC §A).
Exercises the real HTTP surface: default-calendar bootstrap, event create/list with
recurrence expansion, edit, delete, read-only rejection, and per-user isolation.
Requires the calendar plugin installed + migrated.
"""
from __future__ import annotations
import uuid
from collections.abc import AsyncIterator
import httpx
import pytest_asyncio
from httpx import ASGITransport
from sqlalchemy import delete, text
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
from sqlalchemy.pool import NullPool
from app.config import get_settings
from app.identity.passwords import hash_password
from app.identity.sessions import create_session
from app.main import create_app
from app.models import User
CAL = "/api/plugins/calendar"
class _Ctx:
user_id: uuid.UUID
sm: async_sessionmaker # type: ignore[type-arg]
client: httpx.AsyncClient
client_b: httpx.AsyncClient
@pytest_asyncio.fixture
async def ctx() -> AsyncIterator[_Ctx]:
engine = create_async_engine(get_settings().database_url, poolclass=NullPool)
sm = async_sessionmaker(engine, expire_on_commit=False)
c = _Ctx()
c.sm = sm
ids: list[uuid.UUID] = []
async with sm() as s:
for _ in range(2):
handle = f"cal{uuid.uuid4().hex[:8]}@test.local"
u = User(handle=handle, password_hash=hash_password("pw"))
s.add(u)
await s.flush()
ids.append(u.id)
await s.commit()
c.user_id = ids[0]
transport = ASGITransport(app=create_app())
async def client(uid: uuid.UUID) -> httpx.AsyncClient:
token = await create_session(uid, "pytest")
return httpx.AsyncClient(
transport=transport,
base_url="http://testserver",
cookies={"session": token, "csrf": "csrf"},
headers={"X-CSRF": "csrf"},
)
c.client = await client(ids[0])
c.client_b = await client(ids[1])
try:
yield c
finally:
await c.client.aclose()
await c.client_b.aclose()
async with sm() as s: # cascade drops plg_calendar_* rows (user_id FK-less but scoped)
await s.execute(
text("DELETE FROM plg_calendar_calendars WHERE user_id = ANY(:ids)"),
{"ids": [str(i) for i in ids]},
)
await s.execute(delete(User).where(User.id.in_(ids)))
await s.commit()
await engine.dispose()
async def _events(
client: httpx.AsyncClient,
start: str = "2026-06-01T00:00:00Z",
end: str = "2026-06-02T00:00:00Z",
) -> list[dict[str, object]]:
r = await client.get(f"{CAL}/events", params={"start": start, "end": end})
return r.json()["events"]
async def test_default_calendar_and_event_crud(ctx: _Ctx) -> None:
# First calendars call bootstraps a default "Personal" calendar.
cals = (await ctx.client.get(f"{CAL}/calendars")).json()
assert [c["name"] for c in cals] == ["Personal"]
cal_id = cals[0]["id"]
# Create a timed event and read it back in a range.
r = await ctx.client.post(
f"{CAL}/events",
json={
"calendar_id": cal_id,
"summary": "Standup",
"dtstart": "2026-06-01T09:00:00Z",
"dtend": "2026-06-01T09:30:00Z",
},
)
assert r.status_code == 200
event_id = r.json()["id"]
listing = await _events(ctx.client)
assert len(listing) == 1
assert listing[0]["summary"] == "Standup"
assert listing[0]["color"] == "#3b82f6"
# Edit, then delete.
patched = await ctx.client.patch(f"{CAL}/events/{event_id}", json={"summary": "Daily standup"})
assert patched.status_code == 200
again = await _events(ctx.client)
assert again[0]["summary"] == "Daily standup"
assert (await ctx.client.delete(f"{CAL}/events/{event_id}")).status_code == 200
empty = await _events(ctx.client)
assert empty == []
async def test_recurring_event_expands_in_range(ctx: _Ctx) -> None:
cal_id = (await ctx.client.get(f"{CAL}/calendars")).json()[0]["id"]
await ctx.client.post(
f"{CAL}/events",
json={
"calendar_id": cal_id,
"summary": "Weekly sync",
"dtstart": "2026-06-01T14:00:00Z", # Monday
"dtend": "2026-06-01T15:00:00Z",
"rrule": "FREQ=WEEKLY;BYDAY=MO",
},
)
# A 3-week window contains 3 Monday occurrences of one recurring event.
listing = await _events(ctx.client, end="2026-06-22T00:00:00Z")
assert len(listing) == 3
assert all(i["recurring"] for i in listing)
assert [i["start"][:10] for i in listing] == ["2026-06-01", "2026-06-08", "2026-06-15"]
async def test_read_only_calendar_rejects_writes(ctx: _Ctx) -> None:
cal_id = (await ctx.client.get(f"{CAL}/calendars")).json()[0]["id"]
# Simulate an ICS subscription: flip the calendar read-only directly.
async with ctx.sm() as s:
await s.execute(
text("UPDATE plg_calendar_calendars SET read_only = true WHERE id = :id"),
{"id": cal_id},
)
await s.commit()
r = await ctx.client.post(
f"{CAL}/events",
json={"calendar_id": cal_id, "summary": "nope", "dtstart": "2026-06-01T09:00:00Z"},
)
assert r.status_code == 403
body = r.json()
detail = body.get("error", {}).get("message") or body.get("detail")
assert detail == "read_only_calendar"
async def test_events_are_per_user_isolated(ctx: _Ctx) -> None:
cal_id = (await ctx.client.get(f"{CAL}/calendars")).json()[0]["id"]
await ctx.client.post(
f"{CAL}/events",
json={"calendar_id": cal_id, "summary": "Private", "dtstart": "2026-06-05T10:00:00Z"},
)
# User B has their own default calendar and sees none of A's events.
b_events = await _events(ctx.client_b, end="2026-06-30T00:00:00Z")
assert b_events == []
@@ -0,0 +1,84 @@
"""Calendar recurrence expansion across a DST boundary (SPEC §A.3, acceptance A.7.2)."""
from __future__ import annotations
from datetime import UTC, datetime, timedelta
from zoneinfo import ZoneInfo
from webmail_plugin_calendar.recurrence import expand_occurrences # type: ignore[import-not-found]
WARSAW = ZoneInfo("Europe/Warsaw")
def _local(occ: list[tuple[datetime, datetime]]) -> dict[str, datetime]:
# Map "YYYY-MM-DD" (Warsaw date) -> the UTC start of that occurrence.
return {s.astimezone(WARSAW).date().isoformat(): s for s, _ in occ}
def test_weekly_recurrence_keeps_local_time_across_dst() -> None:
# Monday 2026-03-23 10:00 Europe/Warsaw == 09:00 UTC (UTC+1, before DST).
# DST starts 2026-03-29, so from 03-30 the offset is UTC+2.
dtstart = datetime(2026, 3, 23, 9, 0, tzinfo=UTC)
occ = expand_occurrences(
dtstart=dtstart,
duration=timedelta(hours=1),
rrule="FREQ=WEEKLY;BYDAY=MO",
exdates=[],
range_start=datetime(2026, 3, 1, tzinfo=UTC),
range_end=datetime(2026, 4, 30, tzinfo=UTC),
tz="Europe/Warsaw",
)
by_date = _local(occ)
# Every occurrence is at 10:00 local wall-clock, on both sides of the DST change.
for start, _ in occ:
assert start.astimezone(WARSAW).strftime("%H:%M") == "10:00"
# ...but the UTC offset moves across the boundary.
assert by_date["2026-03-23"].hour == 9 # UTC+1
assert by_date["2026-03-30"].hour == 8 # UTC+2 (DST)
assert by_date["2026-04-06"].hour == 8
def test_exdates_remove_instances() -> None:
dtstart = datetime(2026, 3, 23, 9, 0, tzinfo=UTC)
occ = expand_occurrences(
dtstart=dtstart,
duration=timedelta(hours=1),
rrule="FREQ=WEEKLY;BYDAY=MO",
# Exclude the 2026-03-30 occurrence (10:00 Warsaw == 08:00 UTC under DST).
exdates=[datetime(2026, 3, 30, 8, 0, tzinfo=UTC)],
range_start=datetime(2026, 3, 1, tzinfo=UTC),
range_end=datetime(2026, 4, 30, tzinfo=UTC),
tz="Europe/Warsaw",
)
dates = set(_local(occ))
assert "2026-03-23" in dates
assert "2026-03-30" not in dates # excluded
assert "2026-04-06" in dates
def test_single_event_no_rrule() -> None:
dtstart = datetime(2026, 6, 1, 12, 0, tzinfo=UTC)
occ = expand_occurrences(
dtstart=dtstart,
duration=timedelta(minutes=30),
rrule=None,
exdates=[],
range_start=datetime(2026, 6, 1, tzinfo=UTC),
range_end=datetime(2026, 6, 2, tzinfo=UTC),
tz="UTC",
)
assert occ == [(dtstart, dtstart + timedelta(minutes=30))]
# Outside the window -> nothing.
empty = expand_occurrences(
dtstart=dtstart,
duration=timedelta(minutes=30),
rrule=None,
exdates=[],
range_start=datetime(2026, 7, 1, tzinfo=UTC),
range_end=datetime(2026, 7, 2, tzinfo=UTC),
tz="UTC",
)
assert empty == []
@@ -0,0 +1,33 @@
"""SDK security surface for heavy plugins: vault + multi-method guarded HTTP."""
from __future__ import annotations
import pytest
from app.accounts.ssrf import SsrfError, guarded_request
from app.plugins.sdk import sdk
def test_vault_round_trips_secrets() -> None:
vault = sdk("calendar").vault
secret = b"caldav-app-password-123"
blob = vault.encrypt(secret)
assert blob != secret # encrypted at rest
assert vault.decrypt(blob) == secret
async def test_guarded_request_rejects_non_https() -> None:
with pytest.raises(SsrfError, match="https"):
await guarded_request("PROPFIND", "http://dav.example/cal/")
async def test_guarded_request_rejects_private_host() -> None:
# Resolves to a loopback/private address -> blocked before any connection.
with pytest.raises(SsrfError, match="non-public|resolve"):
await guarded_request("GET", "https://localhost/")
def test_http_facade_exposes_dav_verbs() -> None:
http = sdk("calendar").http
for verb in ("request", "get", "put", "delete", "propfind", "report"):
assert callable(getattr(http, verb))