Claude
6a27c742d4
A REPORT multiget for a handful of resources previously listed the
whole calendar/address book (every row incl. ical_data/vcard) and
filtered by href in Rust with an O(N×M) substring scan. Large
collections paid full-table latency, RAM and DB CPU on every sync.
- Add find_events_by_ical_uids / get_contacts_by_uids through every
layer (domain repo trait → PG repo → storage port/adapter → use case
→ handler) using one indexed `= ANY($2)` query, mirroring the
existing single-UID lookups.
- Extract UIDs from multiget hrefs with a shared, tested
uid_from_multiget_href helper (percent-decoding, case-insensitive
extension strip, collection hrefs rejected). Exact UID matching also
removes the false positives the old substring filter allowed.
- CalDAV PROPFIND single-event path now uses the existing indexed
get_event_by_ical_uid instead of listing all events.
- Honour the already-documented limit/offset query params on
GET /api/address-books/{id}/contacts: optional ListQuery fields
thread through ContactUseCase::list_contacts to a paginated repo
query. Omitted params keep returning the full book (frontend and
DAV listing/sync paths unchanged).
https://claude.ai/code/session_0193Hff42gaA962wThxMGSd1
232 lines
7.6 KiB
Rust
232 lines
7.6 KiB
Rust
use crate::application::dtos::calendar_dto::{
|
|
CalendarDto, CalendarEventDto, CreateCalendarDto, CreateEventDto, CreateEventICalDto,
|
|
UpdateCalendarDto, UpdateEventDto,
|
|
};
|
|
use crate::common::errors::DomainError;
|
|
use chrono::{DateTime, Utc};
|
|
use uuid::Uuid;
|
|
|
|
/// Port for external calendar storage mechanisms
|
|
pub trait CalendarStoragePort: Send + Sync + 'static {
|
|
// Calendar operations
|
|
async fn create_calendar(
|
|
&self,
|
|
calendar: CreateCalendarDto,
|
|
owner_id: Uuid,
|
|
) -> Result<CalendarDto, DomainError>;
|
|
async fn update_calendar(
|
|
&self,
|
|
calendar_id: &str,
|
|
update: UpdateCalendarDto,
|
|
) -> Result<CalendarDto, DomainError>;
|
|
async fn delete_calendar(&self, calendar_id: &str) -> Result<(), DomainError>;
|
|
async fn get_calendar(&self, calendar_id: &str) -> Result<CalendarDto, DomainError>;
|
|
async fn list_calendars_by_owner(
|
|
&self,
|
|
owner_id: Uuid,
|
|
) -> Result<Vec<CalendarDto>, DomainError>;
|
|
async fn list_calendars_shared_with_user(
|
|
&self,
|
|
user_id: Uuid,
|
|
) -> Result<Vec<CalendarDto>, DomainError>;
|
|
async fn list_public_calendars(
|
|
&self,
|
|
limit: i64,
|
|
offset: i64,
|
|
) -> Result<Vec<CalendarDto>, DomainError>;
|
|
async fn check_calendar_access(
|
|
&self,
|
|
calendar_id: &str,
|
|
user_id: Uuid,
|
|
) -> Result<bool, DomainError>;
|
|
|
|
// Calendar sharing
|
|
async fn share_calendar(
|
|
&self,
|
|
calendar_id: &str,
|
|
user_id: Uuid,
|
|
access_level: &str,
|
|
) -> Result<(), DomainError>;
|
|
async fn remove_calendar_sharing(
|
|
&self,
|
|
calendar_id: &str,
|
|
user_id: Uuid,
|
|
) -> Result<(), DomainError>;
|
|
async fn get_calendar_shares(
|
|
&self,
|
|
calendar_id: &str,
|
|
) -> Result<Vec<(String, String)>, DomainError>;
|
|
|
|
// Calendar properties
|
|
async fn set_calendar_property(
|
|
&self,
|
|
calendar_id: &str,
|
|
property_name: &str,
|
|
property_value: &str,
|
|
) -> Result<(), DomainError>;
|
|
async fn get_calendar_property(
|
|
&self,
|
|
calendar_id: &str,
|
|
property_name: &str,
|
|
) -> Result<Option<String>, DomainError>;
|
|
async fn get_calendar_properties(
|
|
&self,
|
|
calendar_id: &str,
|
|
) -> Result<std::collections::HashMap<String, String>, DomainError>;
|
|
|
|
// Event operations
|
|
async fn create_event(&self, event: CreateEventDto) -> Result<CalendarEventDto, DomainError>;
|
|
async fn create_event_from_ical(
|
|
&self,
|
|
event: CreateEventICalDto,
|
|
) -> Result<CalendarEventDto, DomainError>;
|
|
async fn update_event(
|
|
&self,
|
|
event_id: &str,
|
|
update: UpdateEventDto,
|
|
) -> Result<CalendarEventDto, DomainError>;
|
|
async fn delete_event(&self, event_id: &str) -> Result<(), DomainError>;
|
|
async fn get_event(&self, event_id: &str) -> Result<CalendarEventDto, DomainError>;
|
|
/// Indexed single-row lookup by iCalendar UID — the CalDAV
|
|
/// object-resource paths must use this instead of listing the whole
|
|
/// calendar (every row + its `ical_data`) and filtering client-side.
|
|
async fn find_event_by_ical_uid(
|
|
&self,
|
|
calendar_id: &str,
|
|
ical_uid: &str,
|
|
) -> Result<Option<CalendarEventDto>, DomainError>;
|
|
/// Indexed batch lookup by iCalendar UID (`ical_uid = ANY(...)`) — the
|
|
/// CalDAV multiget REPORT must use this instead of listing the whole
|
|
/// calendar (every row + its `ical_data`) and filtering client-side.
|
|
async fn find_events_by_ical_uids(
|
|
&self,
|
|
calendar_id: &str,
|
|
ical_uids: &[String],
|
|
) -> Result<Vec<CalendarEventDto>, DomainError>;
|
|
async fn list_events_by_calendar(
|
|
&self,
|
|
calendar_id: &str,
|
|
) -> Result<Vec<CalendarEventDto>, DomainError>;
|
|
async fn list_events_by_calendar_paginated(
|
|
&self,
|
|
calendar_id: &str,
|
|
limit: i64,
|
|
offset: i64,
|
|
) -> Result<Vec<CalendarEventDto>, DomainError>;
|
|
async fn get_events_in_time_range(
|
|
&self,
|
|
calendar_id: &str,
|
|
start: &DateTime<Utc>,
|
|
end: &DateTime<Utc>,
|
|
) -> Result<Vec<CalendarEventDto>, DomainError>;
|
|
}
|
|
|
|
/// Port for calendar use cases.
|
|
///
|
|
/// All methods require an explicit `user_id` parameter for authorization.
|
|
/// The CalDAV protocol handler extracts the user identity from JWT claims
|
|
/// and passes it through.
|
|
pub trait CalendarUseCase: Send + Sync + 'static {
|
|
// Calendar operations
|
|
async fn create_calendar(
|
|
&self,
|
|
calendar: CreateCalendarDto,
|
|
user_id: Uuid,
|
|
) -> Result<CalendarDto, DomainError>;
|
|
async fn update_calendar(
|
|
&self,
|
|
calendar_id: &str,
|
|
update: UpdateCalendarDto,
|
|
user_id: Uuid,
|
|
) -> Result<CalendarDto, DomainError>;
|
|
async fn delete_calendar(&self, calendar_id: &str, user_id: Uuid) -> Result<(), DomainError>;
|
|
async fn get_calendar(
|
|
&self,
|
|
calendar_id: &str,
|
|
user_id: Uuid,
|
|
) -> Result<CalendarDto, DomainError>;
|
|
async fn list_my_calendars(&self, user_id: Uuid) -> Result<Vec<CalendarDto>, DomainError>;
|
|
async fn list_shared_calendars(&self, user_id: Uuid) -> Result<Vec<CalendarDto>, DomainError>;
|
|
async fn list_public_calendars(
|
|
&self,
|
|
limit: Option<i64>,
|
|
offset: Option<i64>,
|
|
) -> Result<Vec<CalendarDto>, DomainError>;
|
|
|
|
// Calendar sharing
|
|
async fn share_calendar(
|
|
&self,
|
|
calendar_id: &str,
|
|
target_user_id: Uuid,
|
|
access_level: &str,
|
|
caller_user_id: Uuid,
|
|
) -> Result<(), DomainError>;
|
|
async fn remove_calendar_sharing(
|
|
&self,
|
|
calendar_id: &str,
|
|
target_user_id: Uuid,
|
|
caller_user_id: Uuid,
|
|
) -> Result<(), DomainError>;
|
|
async fn get_calendar_shares(
|
|
&self,
|
|
calendar_id: &str,
|
|
user_id: Uuid,
|
|
) -> Result<Vec<(String, String)>, DomainError>;
|
|
|
|
// Event operations
|
|
async fn create_event(
|
|
&self,
|
|
event: CreateEventDto,
|
|
user_id: Uuid,
|
|
) -> Result<CalendarEventDto, DomainError>;
|
|
async fn create_event_from_ical(
|
|
&self,
|
|
event: CreateEventICalDto,
|
|
user_id: Uuid,
|
|
) -> Result<CalendarEventDto, DomainError>;
|
|
async fn update_event(
|
|
&self,
|
|
event_id: &str,
|
|
update: UpdateEventDto,
|
|
user_id: Uuid,
|
|
) -> Result<CalendarEventDto, DomainError>;
|
|
async fn delete_event(&self, event_id: &str, user_id: Uuid) -> Result<(), DomainError>;
|
|
async fn get_event(
|
|
&self,
|
|
event_id: &str,
|
|
user_id: Uuid,
|
|
) -> Result<CalendarEventDto, DomainError>;
|
|
/// Resolve one event by its iCalendar UID (the identifier CalDAV
|
|
/// object resources are addressed by). `Ok(None)` when no event with
|
|
/// that UID exists in the calendar.
|
|
async fn get_event_by_ical_uid(
|
|
&self,
|
|
calendar_id: &str,
|
|
ical_uid: &str,
|
|
user_id: Uuid,
|
|
) -> Result<Option<CalendarEventDto>, DomainError>;
|
|
/// Resolve a batch of events by their iCalendar UIDs with a single
|
|
/// indexed query. UIDs without a matching event are silently absent
|
|
/// from the result (CalDAV multiget semantics).
|
|
async fn get_events_by_ical_uids(
|
|
&self,
|
|
calendar_id: &str,
|
|
ical_uids: &[String],
|
|
user_id: Uuid,
|
|
) -> Result<Vec<CalendarEventDto>, DomainError>;
|
|
async fn list_events(
|
|
&self,
|
|
calendar_id: &str,
|
|
limit: Option<i64>,
|
|
offset: Option<i64>,
|
|
user_id: Uuid,
|
|
) -> Result<Vec<CalendarEventDto>, DomainError>;
|
|
async fn get_events_in_range(
|
|
&self,
|
|
calendar_id: &str,
|
|
start: DateTime<Utc>,
|
|
end: DateTime<Utc>,
|
|
user_id: Uuid,
|
|
) -> Result<Vec<CalendarEventDto>, DomainError>;
|
|
}
|