@rapidmx/mapi-plugin 1.0.0-beta.10

package/dist/lib/RopDispatcher.js

@@ -0,0 +1,145 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { BufferReader, BufferWriter, DecodeError } from "./codec/BufferCursor.js";
+import { ExecuteBudget, WorkBudgetExceededError } from "./rop/ExecuteBudget.js";
+/** The most ROPs processed from one `Execute` request. A real client batches far fewer; anything past this is
+ * left unprocessed. */
+export const MAX_ROPS_PER_EXECUTE = 1024;
+/** The largest `RopsList` a response can carry: `RopSize` is a 16-bit count that includes its own 2 bytes. */
+export const MAX_ROPS_LIST_BYTES = 0xffff - 2;
+/** `RopBufferTooSmall`'s `RopId` (`[MS-OXCROPS]` §2.2.15.1). */
+export const ROP_ID_BUFFER_TOO_SMALL = 0xff;
+/** `MAPI_E_CALL_FAILED`: a ROP failed while running (a database error, undecodable stored data, ...). */
+export const ERROR_CALL_FAILED = 0x80004005;
+/** `MAPI_E_TOO_COMPLEX`: the ROP would have gone past this request's `ExecuteBudget`. */
+export const ERROR_TOO_COMPLEX = 0x80040117;
+/** `RopBufferTooSmall`'s fixed fields: `RopId` and `SizeNeeded`. */
+const BUFFER_TOO_SMALL_HEADER_BYTES = 3;
+/** Thrown by `dispatchRops`, before any ROP runs, when the room for responses can't even hold a `RopBufferTooSmall`
+ * carrying the whole request. The route answers the `Execute` with `ecBufferTooSmall` ([MS-OXCRPC]). No ROP has run. */
+export class ExecuteBufferTooSmallError extends Error {
+    constructor() {
+        super("Execute: MaxRopOut is too small for even a RopBufferTooSmall response.");
+        this.name = "ExecuteBufferTooSmallError";
+    }
+}
+/** Wraps `reader` so that running out of request bytes raises a `DecodeError` (a malformed request) rather than a
+ * plain `RangeError`, which a handler may also raise while working on data it read from somewhere else. */
+function decodingReader(reader) {
+    return new Proxy(reader, {
+        get(target, property) {
+            const value = Reflect.get(target, property, target);
+            if (typeof value !== "function") {
+                return value;
+            }
+            return (...args) => {
+                try {
+                    return value.apply(target, args);
+                }
+                catch (err) {
+                    throw err instanceof RangeError && !(err instanceof DecodeError) ? new DecodeError(err.message) : err;
+                }
+            };
+        },
+    });
+}
+/**
+ * Walks a decoded `RopBuffer`'s `ropsList` blob, dispatching each contained ROP - identified by its own leading
+ * `RopId` byte - to the matching registered handler in turn, collecting every response into one output buffer.
+ * Deliberately ROP-agnostic: it knows nothing about any specific ROP's own fields, only how to find the *next* one,
+ * via the handler's own advanced `reader` position once `handle()` returns - see `RopBuffer.ts`'s doc comment for
+ * why a fully generic split isn't possible for this wire format.
+ *
+ * - **Malformed requests.** An unrecognized `RopId`, or a ROP whose bytes run out or can't be sized (a
+ * `DecodeError`), throws a `DecodeError`: nothing after it can be located, so the route answers 400.
+ * - **A failing ROP.** Any other error thrown by a handler fails just that ROP: its partial output is dropped, a
+ * failure response (`RopId`, the handle index it echoes, `ReturnValue` `MAPI_E_CALL_FAILED` or, past the
+ * `ExecuteBudget`, `MAPI_E_TOO_COMPLEX`) takes its place, and the following ROPs still run. The handler has
+ * already read its whole request by the time it does work that can fail, so the next ROP is still where the
+ * reader points.
+ * - **Output space.** Room for a `RopBufferTooSmall` covering the next ROP and everything after it (3 bytes plus
+ * those request bytes) is always kept free. `context.ropOutputRemaining` tells each handler the room left *after*
+ * that reserve (computed from where the reader stands, so once a handler has read its request it excludes the
+ * handler's own bytes). A response that doesn't leave the reserve is replaced by `RopBufferTooSmall` (`SizeNeeded`
+ * plus the unprocessed request bytes, from this ROP on, for the client to resend) and processing stops; that always
+ * fits, because the reserve for this ROP was kept by the one before it. Handlers that change state by how much they
+ * return (`RopQueryRows`, `RopReadStream`, `RopFastTransferSourceGetBuffer`) size their response to the room, so they
+ * are never replaced after moving a cursor. Only when the request as a whole can't be covered by a
+ * `RopBufferTooSmall` is `ExecuteBufferTooSmallError` thrown, before anything runs, and the route answers the
+ * `Execute` with `ecBufferTooSmall` ([MS-OXCRPC]). So a failed `Execute` never follows state already changed and
+ * saved, which a retry would skip past.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export async function dispatchRops(ropsList, handlers, context, options = {}) {
+    const maxRops = options.maxRops ?? MAX_ROPS_PER_EXECUTE;
+    const maxOutputBytes = Math.min(options.maxOutputBytes ?? MAX_ROPS_LIST_BYTES, MAX_ROPS_LIST_BYTES);
+    const reader = decodingReader(new BufferReader(ropsList));
+    const writer = new BufferWriter();
+    context.budget ?? (context.budget = new ExecuteBudget());
+    /** Room for a RopBufferTooSmall resending the request from `offset` on (nothing when there is nothing left). */
+    const reserveFrom = (offset) => (offset < ropsList.length ? BUFFER_TOO_SMALL_HEADER_BYTES + ropsList.length - offset : 0);
+    if (reserveFrom(0) > maxOutputBytes) {
+        throw new ExecuteBufferTooSmallError();
+    }
+    let remaining = maxOutputBytes;
+    Object.defineProperty(context, "ropOutputRemaining", {
+        configurable: true,
+        enumerable: true,
+        get: () => Math.max(0, remaining - reserveFrom(reader.position)),
+    });
+    let processed = 0;
+    try {
+        // Stops after `maxRops`, so one Execute can't queue unbounded work.
+        while (reader.hasMore() && processed++ < maxRops) {
+            const start = reader.position;
+            const ropId = reader.readUInt8();
+            const handler = handlers.get(ropId);
+            if (!handler) {
+                throw new DecodeError(`RopDispatcher: unsupported RopId 0x${ropId.toString(16)}.`);
+            }
+            remaining = maxOutputBytes - writer.length;
+            let response;
+            try {
+                const ropWriter = new BufferWriter();
+                await handler.handle(reader, ropWriter, context);
+                response = ropWriter.toBuffer();
+            }
+            catch (err) {
+                if (err instanceof DecodeError) {
+                    throw err;
+                }
+                response = failureResponse(handler, ropsList, start, err instanceof WorkBudgetExceededError ? ERROR_TOO_COMPLEX : ERROR_CALL_FAILED);
+            }
+            if (response.length + reserveFrom(reader.position) > remaining) {
+                // The reserve kept for this ROP guarantees this fits.
+                writer
+                    .writeUInt8(ROP_ID_BUFFER_TOO_SMALL)
+                    .writeUInt16LE(Math.min(response.length, 0xffff)) // SizeNeeded
+                    .writeBytes(ropsList.subarray(start)); // RequestBuffers
+                break;
+            }
+            writer.writeBytes(response);
+        }
+    }
+    finally {
+        delete context.ropOutputRemaining;
+    }
+    return writer.toBuffer();
+}
+/** The response a ROP gets when its handler throws: `RopId`, the handle index its responses echo, `ReturnValue`,
+ * then any always-present fields zeroed. Nothing at all for a ROP that never responds. */
+function failureResponse(handler, ropsList, start, returnValue) {
+    if (handler.hasNoResponse) {
+        return Buffer.alloc(0);
+    }
+    return new BufferWriter()
+        .writeUInt8(handler.ropId)
+        .writeUInt8(ropsList[start + (handler.responseHandleIndexOffset ?? 2)] ?? 0)
+        .writeUInt32LE(returnValue)
+        .writeBytes(Buffer.alloc(handler.failureTailBytes ?? 0))
+        .toBuffer();
+}
+//# sourceMappingURL=RopDispatcher.js.map

package/dist/lib/RopDispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RopDispatcher.js","sourceRoot":"","sources":["../../src/RopDispatcher.ts"],"names":[],"mappings":"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"}

package/dist/lib/codec/AppointmentRecurrence.js

@@ -0,0 +1,315 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { BufferWriter } from "./BufferCursor.js";
+import { RecurrenceFrequency } from "@rapidmx/restapi";
+/**
+ * Encodes/decodes `CalendarEvent.recurrenceRule` to/from the binary blob carried by `PidLidAppointmentRecur`
+ * (`[MS-OXOCAL]` §2.2.1.44: the outer `AppointmentRecurrencePattern` structure, §2.2.1.44.5, wrapping an inner
+ * `RecurrencePattern`, §2.2.1.44.1). Every field layout/size below was confirmed against those spec pages
+ * directly, not assumed.
+ *
+ * **Pragmatic scope, matching the same limits `CalendarSyncAdapter` (EAS) already carries**:
+ * - Only `RecurFrequency` Daily/Weekly/Monthly/Yearly and `PatternType` Day/Week/Month are produced or
+ * accepted - `MonthNth`/`MonthEnd`/Hijri patterns have no representation in `RecurrenceRule` (no ordinal-
+ * weekday field) and decoding one throws a clear, documented error rather than silently guessing.
+ * - `DeletedInstanceCount`/`ModifiedInstanceCount` (recurrence exceptions) and the outer structure's
+ * `ExceptionCount` are always written as `0`. Decoding reads the deleted occurrences into `RecurrenceRule.exceptions`
+ * and ignores the details of modified ones (`ExceptionInfo`), which `RecurrenceRule` can't hold, instead of failing
+ * the whole save.
+ * - A `YEARLY` rule with `interval > 1` ("every N years", N>1) is encoded as `RecurFrequency=Monthly` with
+ * `Period=12*N`, per the spec's own stated rule that "a yearly recurrence pattern is just a monthly pattern
+ * that occurs every 12 months" (a plain `RecurFrequency=Yearly` value's `Period` MUST be exactly 12).
+ * **This is a one-way, documented round-trip asymmetry**: decoding that same blob back yields
+ * `{freq: MONTHLY, interval: 12*N}`, not the original `{freq: YEARLY, interval: N}` - the two are
+ * indistinguishable on the wire once encoded, the same ambiguity a real Exchange server itself has no way
+ * around either.
+ * - `StartTimeOffset`/`EndTimeOffset` (the outer structure) are derived from `startDate`/`endDate`'s own
+ * time-of-day only (`hours*60+minutes`), not carried through decode - the real start/end instant of any
+ * given occurrence comes from `PidLidAppointmentStartWhole`/`EndWhole`, not from this blob.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+/** `RecurFrequency` (`[MS-OXOCAL]` §2.2.1.44.1). */
+var RecurFrequencyWire;
+(function (RecurFrequencyWire) {
+    RecurFrequencyWire[RecurFrequencyWire["Daily"] = 8202] = "Daily";
+    RecurFrequencyWire[RecurFrequencyWire["Weekly"] = 8203] = "Weekly";
+    RecurFrequencyWire[RecurFrequencyWire["Monthly"] = 8204] = "Monthly";
+    RecurFrequencyWire[RecurFrequencyWire["Yearly"] = 8205] = "Yearly";
+})(RecurFrequencyWire || (RecurFrequencyWire = {}));
+/** `PatternType` (`[MS-OXOCAL]` §2.2.1.44.1) - only the 3 values this codec produces/accepts. */
+var PatternTypeWire;
+(function (PatternTypeWire) {
+    PatternTypeWire[PatternTypeWire["Day"] = 0] = "Day";
+    PatternTypeWire[PatternTypeWire["Week"] = 1] = "Week";
+    PatternTypeWire[PatternTypeWire["Month"] = 2] = "Month";
+})(PatternTypeWire || (PatternTypeWire = {}));
+/** `EndType` (`[MS-OXOCAL]` §2.2.1.44.1). */
+var EndTypeWire;
+(function (EndTypeWire) {
+    EndTypeWire[EndTypeWire["AfterDate"] = 8225] = "AfterDate";
+    EndTypeWire[EndTypeWire["AfterN"] = 8226] = "AfterN";
+    EndTypeWire[EndTypeWire["Never"] = 8227] = "Never";
+})(EndTypeWire || (EndTypeWire = {}));
+/** Sentinel `EndDate` value (`[MS-OXOCAL]` §2.2.1.44.1) meaning "never-ending". */
+const NEVER_END_DATE = 0x5ae980df;
+const MINUTES_PER_DAY = 1440;
+const MINUTES_PER_WEEK = 10080;
+/** `RecurrencePattern.CalendarType` `Default` value (Gregorian) - the only calendar type this codec supports. */
+const CALENDAR_TYPE_DEFAULT = 0x0000;
+/** `RecurrencePattern.FirstDOW` `Sunday` value - this codec always encodes with a Sunday week start, since
+ * `RecurrenceRule` has no field of its own to source a different one from. */
+const FIRST_DOW_SUNDAY = 0x00000000;
+/** `RecurrencePattern`'s `DayOfWeekMask` bits (`[MS-OXOCAL]` §2.2.1.44.1) - confirmed identical to
+ * `CalendarSyncAdapter`'s own `DAY_OF_WEEK_BITS` table for MS-ASCAL's `DayOfWeek` field, reused here under the
+ * same RFC 5545 two-letter day codes `RecurrenceRule.byDay` uses. */
+const DAY_OF_WEEK_BITS = { SU: 1, MO: 2, TU: 4, WE: 8, TH: 16, FR: 32, SA: 64 };
+const DAY_OF_WEEK_CODE_BY_BIT = [
+    ["SU", 1],
+    ["MO", 2],
+    ["TU", 4],
+    ["WE", 8],
+    ["TH", 16],
+    ["FR", 32],
+    ["SA", 64],
+];
+/** Minutes-since-1601-01-01T00:00:00Z epoch, as a JS `Date`-compatible millisecond timestamp - every date field
+ * in `RecurrencePattern` uses this epoch/unit, distinct from `PropertyValue.ts`'s `FILETIME` epoch (which is
+ * also 1601-based, but in 100-ns units, not minutes). */
+const EPOCH_1601_MS = Date.UTC(1601, 0, 1);
+function dateToMinutesSince1601(date) {
+    return Math.round((date.getTime() - EPOCH_1601_MS) / 60000);
+}
+function minutesSince1601ToDate(minutes) {
+    return new Date(EPOCH_1601_MS + minutes * 60000);
+}
+function utcMidnight(date) {
+    return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+}
+/** Calendar months elapsed between 1601-01-01 and the first day of the month containing `date`. */
+function monthsElapsedSince1601(date) {
+    return (date.getUTCFullYear() - 1601) * 12 + date.getUTCMonth();
+}
+function dayOfWeekMaskFromByDay(byDay, fallbackDate) {
+    if (byDay && byDay.length > 0) {
+        return byDay.reduce((mask, day) => mask | (DAY_OF_WEEK_BITS[day] ?? 0), 0);
+    }
+    return DAY_OF_WEEK_CODE_BY_BIT[fallbackDate.getUTCDay()][1];
+}
+function byDayFromMask(mask) {
+    return DAY_OF_WEEK_CODE_BY_BIT.filter(([, bit]) => (mask & bit) !== 0).map(([code]) => code);
+}
+/**
+ * Encodes `rule` (plus the occurrence's own `startDate`/`endDate`, needed for phase/time-of-day derivation)
+ * into an `AppointmentRecurrencePattern` blob, ready to be written as the raw content of a `PtypBinary`
+ * `PidLidAppointmentRecur` property value.
+ */
+export function encodeAppointmentRecurrence(rule, startDate, endDate) {
+    let recurFrequency;
+    let patternType;
+    let period;
+    let patternSpecific;
+    let firstDateTime;
+    switch (rule.freq) {
+        case RecurrenceFrequency.DAILY: {
+            recurFrequency = RecurFrequencyWire.Daily;
+            patternType = PatternTypeWire.Day;
+            period = rule.interval * MINUTES_PER_DAY;
+            patternSpecific = Buffer.alloc(0);
+            firstDateTime = dateToMinutesSince1601(utcMidnight(startDate)) % period;
+            break;
+        }
+        case RecurrenceFrequency.WEEKLY: {
+            recurFrequency = RecurFrequencyWire.Weekly;
+            patternType = PatternTypeWire.Week;
+            period = rule.interval;
+            const mask = dayOfWeekMaskFromByDay(rule.byDay, startDate);
+            patternSpecific = new BufferWriter().writeUInt32LE(mask).toBuffer();
+            const midnight = utcMidnight(startDate);
+            const weekStart = new Date(midnight.getTime() - midnight.getUTCDay() * MINUTES_PER_DAY * 60000);
+            firstDateTime = dateToMinutesSince1601(weekStart) % (period * MINUTES_PER_WEEK);
+            break;
+        }
+        case RecurrenceFrequency.MONTHLY: {
+            recurFrequency = RecurFrequencyWire.Monthly;
+            patternType = PatternTypeWire.Month;
+            period = rule.interval;
+            const day = rule.byMonthDay?.[0] ?? startDate.getUTCDate();
+            patternSpecific = new BufferWriter().writeUInt32LE(day).toBuffer();
+            const monthsElapsed = monthsElapsedSince1601(startDate);
+            const refMonthIndex = monthsElapsed % period;
+            firstDateTime = dateToMinutesSince1601(new Date(Date.UTC(1601, refMonthIndex, 1)));
+            break;
+        }
+        case RecurrenceFrequency.YEARLY: {
+            patternType = PatternTypeWire.Month;
+            if (rule.interval <= 1) {
+                recurFrequency = RecurFrequencyWire.Yearly;
+                period = 12;
+            }
+            else {
+                recurFrequency = RecurFrequencyWire.Monthly;
+                period = 12 * rule.interval;
+            }
+            const day = rule.byMonthDay?.[0] ?? startDate.getUTCDate();
+            patternSpecific = new BufferWriter().writeUInt32LE(day).toBuffer();
+            const monthsElapsed = monthsElapsedSince1601(startDate);
+            const refMonthIndex = monthsElapsed % period;
+            firstDateTime = dateToMinutesSince1601(new Date(Date.UTC(1601, refMonthIndex, 1)));
+            break;
+        }
+        default:
+            throw new Error(`AppointmentRecurrence: unsupported RecurrenceFrequency ${rule.freq}`);
+    }
+    let endType;
+    let occurrenceCount = 0;
+    let endDateMinutes;
+    if (rule.until) {
+        endType = EndTypeWire.AfterDate;
+        endDateMinutes = dateToMinutesSince1601(utcMidnight(rule.until));
+    }
+    else if (rule.count != null) {
+        endType = EndTypeWire.AfterN;
+        occurrenceCount = rule.count;
+        endDateMinutes = NEVER_END_DATE;
+    }
+    else {
+        endType = EndTypeWire.Never;
+        endDateMinutes = NEVER_END_DATE;
+    }
+    const writer = new BufferWriter();
+    // RecurrencePattern (MS-OXOCAL §2.2.1.44.1)
+    writer.writeUInt16LE(0x3004); // ReaderVersion
+    writer.writeUInt16LE(0x3004); // WriterVersion
+    writer.writeUInt16LE(recurFrequency);
+    writer.writeUInt16LE(patternType);
+    writer.writeUInt16LE(CALENDAR_TYPE_DEFAULT);
+    writer.writeUInt32LE(firstDateTime);
+    writer.writeUInt32LE(period);
+    writer.writeUInt32LE(0); // SlidingFlag
+    writer.writeBytes(patternSpecific);
+    writer.writeUInt32LE(endType);
+    writer.writeUInt32LE(occurrenceCount);
+    writer.writeUInt32LE(FIRST_DOW_SUNDAY);
+    writer.writeUInt32LE(0); // DeletedInstanceCount
+    writer.writeUInt32LE(0); // ModifiedInstanceCount
+    writer.writeUInt32LE(dateToMinutesSince1601(utcMidnight(startDate))); // StartDate
+    writer.writeUInt32LE(endDateMinutes); // EndDate
+    // AppointmentRecurrencePattern's own wrapper fields (MS-OXOCAL §2.2.1.44.5)
+    writer.writeUInt32LE(0x00003006); // ReaderVersion2
+    writer.writeUInt32LE(0x00003009); // WriterVersion2
+    writer.writeUInt32LE(startDate.getUTCHours() * 60 + startDate.getUTCMinutes()); // StartTimeOffset
+    writer.writeUInt32LE(endDate.getUTCHours() * 60 + endDate.getUTCMinutes()); // EndTimeOffset
+    writer.writeUInt16LE(0); // ExceptionCount
+    writer.writeUInt32LE(0); // ReservedBlock1Size
+    writer.writeUInt32LE(0); // ReservedBlock2Size
+    return writer.toBuffer();
+}
+/** Reads a `DeletedInstanceCount`/`ModifiedInstanceCount`-style count followed by that many 4-byte dates. */
+function readDateList(reader) {
+    const count = reader.readUInt32LE();
+    if (count * 4 > reader.remaining) {
+        throw new RangeError(`AppointmentRecurrence: an instance date count of ${count} is larger than the pattern.`);
+    }
+    return Array.from({ length: count }, () => reader.readUInt32LE());
+}
+/**
+ * Decodes an `AppointmentRecurrencePattern` blob (read from `reader`'s current position) back into a
+ * `RecurrenceRule`. Throws a clear error for any pattern this pragmatic subset can't represent (see this
+ * file's own doc comment) rather than silently dropping data.
+ */
+export function decodeAppointmentRecurrence(reader) {
+    reader.readUInt16LE(); // ReaderVersion
+    reader.readUInt16LE(); // WriterVersion
+    const recurFrequency = reader.readUInt16LE();
+    const patternType = reader.readUInt16LE();
+    reader.readUInt16LE(); // CalendarType
+    const firstDateTime = reader.readUInt32LE();
+    const period = reader.readUInt32LE();
+    reader.readUInt32LE(); // SlidingFlag
+    let freq;
+    let interval;
+    let byDay;
+    let byMonthDay;
+    let byMonth;
+    switch (recurFrequency) {
+        case RecurFrequencyWire.Daily:
+            if (patternType !== PatternTypeWire.Day) {
+                throw new Error(`AppointmentRecurrence: unsupported PatternType 0x${patternType.toString(16)} for Daily`);
+            }
+            freq = RecurrenceFrequency.DAILY;
+            interval = period / MINUTES_PER_DAY;
+            break;
+        case RecurFrequencyWire.Weekly: {
+            if (patternType !== PatternTypeWire.Week) {
+                throw new Error(`AppointmentRecurrence: unsupported PatternType 0x${patternType.toString(16)} for Weekly`);
+            }
+            const mask = reader.readUInt32LE();
+            freq = RecurrenceFrequency.WEEKLY;
+            interval = period;
+            byDay = byDayFromMask(mask);
+            break;
+        }
+        case RecurFrequencyWire.Monthly: {
+            if (patternType !== PatternTypeWire.Month) {
+                throw new Error(`AppointmentRecurrence: unsupported PatternType 0x${patternType.toString(16)} for Monthly`);
+            }
+            const day = reader.readUInt32LE();
+            freq = RecurrenceFrequency.MONTHLY;
+            interval = period;
+            byMonthDay = [day];
+            break;
+        }
+        case RecurFrequencyWire.Yearly: {
+            if (patternType !== PatternTypeWire.Month) {
+                throw new Error(`AppointmentRecurrence: unsupported PatternType 0x${patternType.toString(16)} for Yearly`);
+            }
+            const day = reader.readUInt32LE();
+            freq = RecurrenceFrequency.YEARLY;
+            interval = 1;
+            byMonthDay = [day];
+            byMonth = [minutesSince1601ToDate(firstDateTime).getUTCMonth() + 1];
+            break;
+        }
+        default:
+            throw new Error(`AppointmentRecurrence: unsupported RecurFrequency 0x${recurFrequency.toString(16)}`);
+    }
+    const endType = reader.readUInt32LE();
+    const occurrenceCount = reader.readUInt32LE();
+    reader.readUInt32LE(); // FirstDOW
+    // DeletedInstanceDates holds the original dates of every deleted *or* modified occurrence; ModifiedInstanceDates
+    // the (new) dates of the modified ones. An occurrence deleted outright is in the first list only.
+    const deletedDates = readDateList(reader);
+    const modifiedDates = new Set(readDateList(reader));
+    reader.readUInt32LE(); // StartDate
+    const endDateMinutes = reader.readUInt32LE();
+    let until;
+    let count;
+    if (endType === EndTypeWire.AfterDate) {
+        until = minutesSince1601ToDate(endDateMinutes);
+    }
+    else if (endType === EndTypeWire.AfterN) {
+        count = occurrenceCount;
+    }
+    reader.readUInt32LE(); // ReaderVersion2
+    reader.readUInt32LE(); // WriterVersion2
+    const startTimeOffset = reader.readUInt32LE();
+    // Everything after this (ExceptionCount, the variable-length ExceptionInfo/ExtendedException blocks for modified
+    // occurrences, and the reserved blocks) describes per-occurrence changes RecurrenceRule has no field for, so it is
+    // not read. A modified occurrence that stayed on its day remains an ordinary occurrence; one moved to another day
+    // only drops out of its original day, since its new time has nowhere to go.
+    return {
+        freq,
+        interval,
+        ...(byDay ? { byDay } : {}),
+        ...(byMonthDay ? { byMonthDay } : {}),
+        ...(byMonth ? { byMonth } : {}),
+        ...(until ? { until } : {}),
+        ...(count != null ? { count } : {}),
+        // A deleted occurrence's date is midnight (minutes since 1601); its start is that plus the series' start time.
+        exceptions: deletedDates.filter((minutes) => !modifiedDates.has(minutes)).map((minutes) => minutesSince1601ToDate(minutes + startTimeOffset)),
+    };
+}
+//# sourceMappingURL=AppointmentRecurrence.js.map

package/dist/lib/codec/AppointmentRecurrence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppointmentRecurrence.js","sourceRoot":"","sources":["../../../src/codec/AppointmentRecurrence.ts"],"names":[],"mappings":"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"}