Recursive AI
onemailDocs

Changelog

OneMail 0.2.0-preview.2CHANGELOG.md at 4558e39 Markdown

All onemail docs

All notable changes are listed here. The format follows Keep a Changelog and the project follows Semantic Versioning.

[Unreleased]

[0.2.0-preview.2]

The first preview on nuget.org. It has everything in 0.2.0-preview.1 plus the changes below. What is checked, and the known gaps, are in docs/compatibility.md.

Added

  • jCal, jCard, xCal and xCard (RecursiveAI.OneMail.Calendar.Forms): read and write both directions from ICS and vCard trees with a loss report, typed defects and resource limits; MailFormatSniffer names the four forms.
  • Outlook Express 5/6 DBX reading (RecursiveAI.OneMail.Stores.Dbx): message databases, the folder tree from Folders.dbx, lazy message streams in constant memory, content sniffing, and Mail.Open on a .dbx file or a store folder.
  • MaildirStoreOptions.InfoSeparator: Maildir file names use ; before the info section on Windows (where : is not allowed in file names) and : elsewhere; both are read on every platform.

Fixed

  • IANA time-zone names now resolve on Windows when the runtime knows only Windows zone ids (for example with invariant globalization), through the CLDR Windows-zone map; Windows names resolve through the same map on every platform.
  • Maildir delivery no longer fails on Windows.

[0.2.0-preview.1]

Outlook formats on read: MSG and OFT, PST and OST, TNEF and compressed RTF, the MAPI property model, and conversion between MAPI and MIME. Calendar recurrence and time zones. What is checked, and the known gaps, are in docs/compatibility.md.

Fixed

  • Encoding to ISO-8859-1 and US-ASCII code pages (the runtime's own, not in the code page provider) no longer throws in MailEncoding.GetBytes.

Added

  • The MAPI property model (RecursiveAI.OneMail.Mapi): typed property bags with named properties, code-page handling and the MS-OXPROPS tag tables.

  • MSG and OFT reading (MS-OXMSG) over the compound file reader of OneArchive, with embedded messages and attachments.

  • The PST/OST lists, tables and properties layer (RecursiveAI.OneMail.Pst.Ltp: heap-on-node, BTH, property and table contexts) over the node database, reading through the random-access sources.

  • TNEF reading and writing (MS-OXTNEF): the attribute layer, MAPI messages and embedded messages.

  • Compressed RTF (MS-OXRTFCP) both ways and HTML and text de-encapsulation from RTF (MS-OXRTFEX), in a namespace with no dependencies on the rest of the library.

  • Conversion between MAPI messages and MIME per MS-OXCMAIL in both directions, with a loss report listing every value that did not carry over (RecursiveAI.OneMail.Conversion).

  • Calendar recurrence expansion (RRULE, RDATE, EXDATE, overrides) and time-zone resolution through VTIMEZONE, the IANA database and Windows zone names.

  • Benchmark rows for PST and OST enumeration and extraction, MSG read and TNEF read (docs/benchmarks.md).

  • Contacts: VCardView covers the rest of RFC 6350 (Gender, Geos, Impps, Related, Keys, Sounds, repeated properties, lazy VCardMedia); MapiContact and MapiDistributionList read Outlook contacts and lists (also as MapiMailItem.Contact / .DistributionList); ContactToVCardConverter and VCardToContactConverter convert both ways by MS-OXVCARD with loss reports (docs/contacts.md).

  • The PST/OST messaging layer (RecursiveAI.OneMail.Pst.Messaging): store, named properties, folders, messages, recipients, attachments and embedded messages as MAPI property bags, in ANSI, Unicode and 4 KiB files.

  • MAPI items (MSG, PST, OST) in the shared view; Mail.Open reads them and onemail inspect lists them.

  • TNEF parts inside MIME messages: MimeToMapiConverter merges them into the MAPI message by the rules of MS-OXCMAIL 2.2.3.8 (headers win, richer bodies kept, loss-report entries for every property set aside), the shared view shows their attachments and bodies in place of winmail.dat (MimeMailItem.TnefParts), and OxcMailExportOptions.Tnef writes a TNEF message.

  • The browser smoke app covers MSG, PST, TNEF, compressed RTF and de-encapsulation with legacy code pages, recurrence through a VTIMEZONE and the IANA database, and the MS-OXCMAIL conversions.

[0.1.0-preview.1]

First preview: the MIME core, mailbox stores and the one-line reading path. What is checked, and the known gaps, are in docs/compatibility.md.

Added

  • Random-access sources (memory, stream, file, ranged reads) under every file format.
  • MimeReader and MimeWriter (forward-only events with byte offsets, streaming writes) and the lossless entity tree: untouched messages write back byte for byte, every repair is a typed defect, and resource limits are on by default.
  • Charsets: the WHATWG encodings plus UTF-7, IMAP modified UTF-7 and the ISO-2022-JP variants; RFC 2047 encoded words and RFC 2231 parameters.
  • Structured headers: addresses and groups, dates, message identifiers, content type and disposition parameters.
  • multipart/report views (delivery status, disposition notification, feedback reports) with builders; MHTML resolution; Authentication-Results and Received-SPF parsing.
  • Mailbox stores: mbox (mboxo, mboxrd, mboxcl, mboxcl2, Gmail Takeout labels), Maildir with Courier and Dovecot keywords, EMLX and Apple Mail bundles, read and written; content-based store sniffing.
  • The shared read view (IMailItem), Mail.Open and Mail.Parse, and content-based format sniffing.
  • RecursiveAI.OneMail.Calendar: ICS and vCard content lines and lossless component trees with typed views.
  • The PST/OST node database layer (header, pages, B-trees, data and subnode trees, allocation maps, scan mode).
  • The onemail inspect command.
  • The ambiguity table (docs/ambiguities.md), the differential and round-trip tools, fuzz targets and the MIME benchmark rows.
  • Package skeleton: the RecursiveAI.OneMail, .Calendar, .Client, .Cryptography and .Render packages and the onemail tool as buildable placeholders, with tests, a benchmark shell, a fuzz shell and NativeAOT and browser WebAssembly smoke apps.