io-msgraph 0.5.0

Microsoft Graph API client library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [0.5.0] - 2026-10-09

### Added

- Added `MsgraphEvent::instance_update_from_ical` (`ical` feature): the update body of the Graph instance of one occurrence, from a document holding that occurrence alone (an override, or the series' component carried to it to revert an exception) against one holding it as Graph does, `None` when nothing differs. The recurrence and the stash stay on the master. `from_ical` still writes the master alone.
- Added `MsgraphEvent::is_online_meeting`. `from_ical` reads `X-PIMDIR-ONLINE-MEETING:TRUE` (pimdir STORAGE Annex B.1) as `isOnlineMeeting: true`, so Graph creates an online meeting with the calendar's default provider (Teams); `update_from_ical` sends it only when the base did not ask already. The property is never stashed.
- Added page size preference (`Prefer: odata.maxpagesize={n}`): `MsgraphSend::max_page_size` (and `MsgraphSend::header`), and a `max_page_size` builder on `MsgraphMessagesDelta`, `MsgraphContactsDelta`, `MsgraphEventsDelta`, `MsgraphMessagesList`, `MsgraphContactsList` and `MsgraphEventsList`. Graph forgets it across pages, so it is chained on every `from_link` too. Client: `messages_delta_with_params`, `{messages,contacts,events}_delta_from_link_with_page_size`, `contacts_delta_with_page_size`, `events_delta_with_page_size`.
- Added `MsgraphMessagesDeltaParams` (`$select`, `$filter` on `receivedDateTime`, page size) and `MsgraphMessagesDelta::with_params`.

### Changed

- Bumped ical-rs to 0.6, whose `IcalParseError` `MsgraphEventIcalError::Parse` carries. Lines built from Graph are folded at 75 octets. **Breaking.**
- `from_ical` consumes EXDATE instead of stashing it: Graph mints the EXDATEs from `cancelledOccurrences`, which only the deletion of an instance writes, so a stashed copy doubled them on read and outlived an occurrence Graph never removed.
- `to_ical` mints the join link of an online meeting as a standard `CONFERENCE;VALUE=URI;FEATURE=AUDIO,VIDEO` (RFC 7986 5.11) instead of `X-MICROSOFT-SKYPETEAMSMEETINGURL`. `from_ical` drops both, the server value staying authoritative.

## [0.4.7] - 2026-10-05

### Added

- Added `MsgraphEvent::recurrence_id_of` (`ical` feature): the RECURRENCE-ID value the projection gives the occurrence of a series master that originally started at an instance's `originalStart`, so a consumer told an occurrence by its RECURRENCE-ID finds its Graph instance.
- Added `MsgraphMessage::change_key`, the version of the message that every edit moves.

### Changed

- `to_ical` and `to_ical_series` project an invitation Exchange took in by mail under the organizer's UID: its `iCalUId` is a global object id that wraps that UID (the `vCal-Uid` form), which is now unwrapped (`ical::original_uid`). A global object id Exchange minted itself, with no UID inside, stays as it is. A store keyed on the UID sees such events change UID once.

## [0.4.6] - 2026-10-04

### Added

- Added `MsgraphEvent::online_meeting` (`onlineMeeting.joinUrl`, read-only), selected by `MSGRAPH_EVENT_ICAL_SELECT`. `to_ical` mints the join link of an online meeting as `X-MICROSOFT-SKYPETEAMSMEETINGURL`, the property Outlook writes, so a Teams link reaches the iCalendar document; `from_ical` drops it.

## [0.4.5] - 2026-10-03

### Added

- Added `MsgraphPatternedRecurrence::bounds` (`ical` feature): the dates a series spans, following its range type. Graph fills the `endDate` of a `numbered` or `noEnd` range with `0001-01-01`, so reading `endDate` alone gave an instances window ending before it starts.

### Changed

- Documented that Graph returns `cancelledOccurrences` only on a read of a series master by id, never in a listing.

## [0.4.4] - 2026-10-02

### Fixed

- Fixed `update_from_ical` patching an event's body to `null`, which Graph refuses (HTTP 400, "The body of the item is invalid"): Graph reads back an empty HTML body, so any edit of an event without DESCRIPTION, or one clearing it, failed. A missing DESCRIPTION is now an empty text body, and bodies compare by their text.

## [0.4.3] - 2026-10-02

### Fixed

- Fixed `to_ical` writing an event in UTC: Graph answers a read in UTC, so a series created in Europe/Paris read back anchored on UTC and drifted by an hour at each DST change once expanded. `MSGRAPH_EVENT_ICAL_SELECT` now selects `originalStartTimeZone` and `originalEndTimeZone`, and the projection tells a UTC start and end in that zone when the database knows it.

- Fixed `from_ical` dropping an edited DESCRIPTION: a document read from Graph carries Exchange's HTML body as `X-ALT-DESC` beside the text, and the HTML always won, so `update_from_ical` saw no change and left the edit out of the patch. The HTML now wins only while it says what the text says.

- Documented that `to_ical_series` needs its exceptions read with `MSGRAPH_EVENT_ICAL_SELECT`: Graph's default instance listing leaves out `originalStart`, and an exception without it gets no RECURRENCE-ID.

## [0.4.2] - 2026-10-01

### Added

- Added the `ical` feature: `MsgraphEvent::to_ical`, `to_ical_series`, `from_ical`, `create_from_ical` and `update_from_ical` project an event, or a series with its exceptions, onto an iCalendar document and back.

  The recurrence maps onto an RRULE both ways, a rule Graph cannot hold being refused; cancelled occurrences become EXDATEs and exceptions VEVENTs with a RECURRENCE-ID. Windows zone names read as their CLDR IANA counterpart and every zone gets a VTIMEZONE, through ical-rs's `tzdb` feature. The UID and every unmanaged line ride a stash extended property, read back with `MSGRAPH_EVENT_STASH_EXPAND`. Only the series master is written back.

- Added `MsgraphEvent::cancelled_occurrences`.

- Added calendars and events: `calendars` (list, get, create, update, delete) and `events` (list, get, create, update, delete, the instances of a series, the calendar view and its delta), with `MsgraphCalendar`, `MsgraphEvent` and the recurrence, attendee and time types, and a client method each.

  An event's times keep the zone Graph returns, a Windows or an IANA name; the calendar view and its delta expand series within a window, the events listing returns series masters.

- Added `MsgraphContact::stashed_uid`, the vCard UID a contact's stash carries, for a sync engine to check that a write kept it.

### Changed

- The vCard UID rides the stash, so a contact keeps the UID it was written with. **Behaviour change.**

  It used to be dropped on write and minted from the Graph id on read, which gave one person two identities across a sync. A contact with no stashed UID, created by Graph itself or by an earlier version, still reads back with one minted from its Graph id.

## [0.4.1] - 2026-10-01

### Added

- Added the `vcard` feature: `MsgraphContact::to_vcard`, `from_vcard`, `create_from_vcard` and `update_from_vcard` project a Graph contact onto a vCard 4.0 document and back.

  Graph-only fields ride as read-only `X-MSGRAPH-*` properties, every other line round-trips through a stash extended property read back with `MSGRAPH_CONTACT_STASH_EXPAND`. The projection moved here from Cardamum, stash id included, so contacts Cardamum already stashed still read back.

## [0.4.0] - 2026-09-29

### Added

- Added `MsgraphClientStdConnectOptions::proxy`, tunnelling the connection through a SOCKS5 or HTTP proxy.

## [0.3.1] - 2026-09-29

### Added

- Added JSON batching (`POST /$batch`) and the matching `batch` client method.

### Removed

- Removed the thiserror dependency. Error messages, sources and `From` conversions are unchanged.

## [0.3.0] - 2026-08-15

### Added

- Added `MsgraphContactsDelta::from_link` and the matching `contacts_delta_from_link` client method, resuming a contacts delta round from a saved link.

### Changed

- Bumped pimalaya-stream to 0.3. **Behaviour change.**

  The transport now retries a stream reporting it is not ready for up to a minute, then fails with `TimedOut`, and a read deadline stops a silent server from blocking forever. Consumers must move to the same `Tls` type.

- Bumped io-http to 0.5.
- Raised the MSRV from 1.87 to 1.88.

## [0.2.2] - 2026-08-06

### Added

- Added the messages delta operation (`v1::rest::users::messages::delta`) and the matching `messages_delta` and `messages_delta_from_link` client methods.

## [0.2.1] - 2026-07-25

### Added

- Added the `schemars` feature, deriving `JsonSchema` on the mail output types. It is off by default and stays `no_std`.

## [0.2.0] - 2026-07-16

### Changed

- Moved each resource type into its resource module, dropping the internal `types` submodules.

  Entity types keep their path. `MsgraphField` moved to `v1::field`, and operation companions (`Msgraph*ListResponse`, the contacts delta types) moved into their operation module.

## [0.1.0] - 2026-07-15

### Added

- Added the I/O-free coroutine core for Microsoft Graph v1.0: the `MsgraphCoroutine` contract, the `MsgraphSend` HTTP/JSON primitive and the OData query serializer.
- Added the mail surface: mail folders, messages, attachments and the sendMail action.
- Added the contacts surface: contact folders and contacts, with delta.
- Added `MsgraphClientStd` (`client` feature), a std blocking client with a `connect` constructor behind the TLS features.

[unreleased]: https://github.com/pimalaya/io-msgraph/compare/v0.5.0..HEAD
[0.5.0]: https://github.com/pimalaya/io-msgraph/compare/v0.4.7..v0.5.0
[0.4.7]: https://github.com/pimalaya/io-msgraph/compare/v0.4.6..v0.4.7
[0.4.6]: https://github.com/pimalaya/io-msgraph/compare/v0.4.5..v0.4.6
[0.4.5]: https://github.com/pimalaya/io-msgraph/compare/v0.4.4..v0.4.5
[0.4.4]: https://github.com/pimalaya/io-msgraph/compare/v0.4.3..v0.4.4
[0.4.3]: https://github.com/pimalaya/io-msgraph/compare/v0.4.2..v0.4.3
[0.4.2]: https://github.com/pimalaya/io-msgraph/compare/v0.4.1..v0.4.2
[0.4.1]: https://github.com/pimalaya/io-msgraph/compare/v0.4.0..v0.4.1
[0.4.0]: https://github.com/pimalaya/io-msgraph/compare/v0.3.1..v0.4.0
[0.3.1]: https://github.com/pimalaya/io-msgraph/compare/v0.3.0..v0.3.1
[0.3.0]: https://github.com/pimalaya/io-msgraph/compare/v0.2.2..v0.3.0
[0.2.2]: https://github.com/pimalaya/io-msgraph/compare/v0.2.1..v0.2.2
[0.2.1]: https://github.com/pimalaya/io-msgraph/compare/v0.2.0..v0.2.1
[0.2.0]: https://github.com/pimalaya/io-msgraph/compare/v0.1.0..v0.2.0
[0.1.0]: https://github.com/pimalaya/io-msgraph/compare/root..v0.1.0