@rapidmx/mapi-plugin 1.0.0-beta.10

package/dist/lib/rop/RopQueryRowsHandler.js

@@ -0,0 +1,120 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { BufferWriter } from "../codec/BufferCursor.js";
+import { resolveContentsWindow } from "./ContentsTable.js";
+import { resolvePropertyValues, writePropertyValueSafely } from "./PropertyResolvers.js";
+const ROP_ID_QUERY_ROWS = 0x15;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a table (or
+ * doesn't exist)" - the same constant `RopGetHierarchyTableHandler` uses for its own analogous check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** `BOOKMARK_END` (`[MS-OXCTABL]`'s `Origin` field) - this pragmatic subset has no separate seek/bookmark ROP
+ * support, so every response reports the cursor as having landed at the table's current end. */
+const ORIGIN_BOOKMARK_END = 0x02;
+/** The most rows one `RopQueryRows` returns. Fewer rows than requested is normal table paging: the client asks
+ * again from the new cursor position. */
+export const MAX_ROWS_PER_QUERY = 500;
+/** `ecBufferTooSmall`: not even one row fits in the room left in the ROP output buffer. */
+const ERROR_BUFFER_TOO_SMALL = 0x0000047d;
+/** RopId, InputHandleIndex, ReturnValue, Origin and RowCount. */
+const RESPONSE_HEADER_BYTES = 9;
+/**
+ * `RopQueryRows` (`[MS-OXCTABL]`/`[MS-OXCROPS]`): fetches up to `RowCount` rows from an already-configured
+ * table (`RopGetHierarchyTable` + `RopSetColumns`), advancing the table's cursor. Confirmed field-by-field
+ * against `[MS-OXCTABL]`'s own real captured request/response byte example - including the response's
+ * `RowData` encoding (`PropertyRow`: a leading `Flags` byte, `0x00` for a `StandardPropertyRow` where every
+ * column is a plain `PropertyValue`, `0x01` for a `FlaggedPropertyRow` where each column gets its own
+ * `FlaggedPropertyValue` flag+optional-value). This pragmatic subset always emits `StandardPropertyRow`
+ * (`Flags = 0x00`) - every configured column always resolves to *some* value here (falling back to a
+ * type-appropriate zero/empty default for an unsupported property, never an error), so `FlaggedPropertyRow`'s
+ * per-column error signaling is never needed. That "never an error" promise covers a client-requested
+ * `propertyType` that doesn't match what a column's own `propertyId` resolves to, not just an entirely
+ * unmodeled `propertyId` - `buildRow` writes each column through `PropertyResolvers.writePropertyValueSafely`,
+ * which falls back to the same type-appropriate default there too, so one row's mismatched column degrades
+ * instead of failing this whole call (and discarding every row already built in it).
+ *
+ * Backward reads (`ForwardRead = FALSE`) and the `NoAdvance` flag are decoded (to advance the reader
+ * correctly) but not honored - this pragmatic subset's tables are simple forward-only cursors. Works generically
+ * against either a `RopGetHierarchyTable` (folder rows, `"folder:"`/`"virtual:"` targets) or a
+ * `RopGetContentsTable` (message rows, `"message:"` targets) handle - dispatching to `FolderTarget`'s or
+ * `MessageTarget`'s resolver and property-value mapping by row-target prefix, since a single table handle only
+ * ever holds one kind of row.
+ *
+ * **Known, deliberate performance limitation**: `resolvePropertyValues` still does one `repo.findOne()` per
+ * row (message/calendarEvent/contact/task) rather than a single batched fetch for the whole page - a genuine
+ * N+1 for a large `RowCount`. A real fix needs a batched "fetch all these uids" query, which this codebase's
+ * `RepoUtils<T>` abstraction doesn't expose a backend-agnostic way to express (Mongo's `$in` and TypeORM's
+ * `In()` aren't interchangeable at this call site, which has no idea which backend it's running against) - see
+ * `ResolutionCache` for the narrower, safe win this pass *did* make (the redundant *identical* whole-mailbox-
+ * folder-list and calendar-mailbox fetches that were happening once per row regardless of which distinct
+ * entity each row was, now happen at most once per call).
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopQueryRowsHandler {
+    constructor() {
+        this.ropId = ROP_ID_QUERY_ROWS;
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // QueryRowsFlags - NoAdvance/EnablePackedBuffers not supported; always advances
+        reader.readUInt8(); // ForwardRead - backward reads not supported; always reads forward
+        const requestedCount = reader.readUInt16LE();
+        const table = context.session.handles[inputHandleIndex];
+        if (!table || table.type !== "table") {
+            writer.writeUInt8(ROP_ID_QUERY_ROWS);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const cursor = table.cursor ?? 0;
+        const count = Math.min(requestedCount, MAX_ROWS_PER_QUERY);
+        // A hierarchy table carries its rows; a contents table reads just this window from the database.
+        const slice = table.contentsKind
+            ? await resolveContentsWindow(context, table, cursor, count)
+            : (table.rows ?? []).slice(cursor, cursor + count);
+        // Shared across every row this call resolves - see ResolutionCache's own doc comment for why: without
+        // it, a hierarchy table's `hasChildren` column (or a calendar table's organizer/attendee resolution)
+        // would re-fetch the same whole-mailbox folder list/mailbox record once per row instead of once per
+        // call.
+        const cache = {};
+        const rowBuffers = [];
+        // Only as many rows as fit in the room left in this request's ROP output buffer; the rest stay for the next
+        // call, since the cursor only advances past rows actually returned.
+        let room = (context.ropOutputRemaining ?? Infinity) - RESPONSE_HEADER_BYTES;
+        for (const target of slice) {
+            const row = await this.buildRow(context, target, table.columns ?? [], cache);
+            if (row.length > room) {
+                break;
+            }
+            room -= row.length;
+            rowBuffers.push(row);
+        }
+        if (rowBuffers.length === 0 && slice.length > 0) {
+            // Not even one row fits: [MS-OXCTABL] ecBufferTooSmall, and the cursor stays put.
+            writer.writeUInt8(ROP_ID_QUERY_ROWS);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_BUFFER_TOO_SMALL);
+            return;
+        }
+        table.cursor = cursor + rowBuffers.length;
+        writer.writeUInt8(ROP_ID_QUERY_ROWS);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(ORIGIN_BOOKMARK_END);
+        writer.writeUInt16LE(rowBuffers.length);
+        for (const rowBuffer of rowBuffers) {
+            writer.writeBytes(rowBuffer);
+        }
+    }
+    async buildRow(context, target, columns, cache) {
+        const writer = new BufferWriter();
+        writer.writeUInt8(0x00); // Flags - StandardPropertyRow, see class doc comment
+        const values = await resolvePropertyValues(target, columns, context, cache);
+        columns.forEach((column, index) => writePropertyValueSafely(writer, column.propertyType, values[index]));
+        return writer.toBuffer();
+    }
+}
+//# sourceMappingURL=RopQueryRowsHandler.js.map

package/dist/lib/rop/RopQueryRowsHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RopQueryRowsHandler.js","sourceRoot":"","sources":["../../../src/rop/RopQueryRowsHandler.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAgB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAmB,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAG1G,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B;yGACyG;AACzG,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;gGACgG;AAChG,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;yCACyC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,2FAA2F;AAC3F,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAE1C,iEAAiE;AACjE,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,mBAAmB;IAAhC;QACoB,UAAK,GAAG,iBAAiB,CAAC;IAwE9C,CAAC;IAtEU,KAAK,CAAC,MAAM,CAAC,MAAoB,EAAE,MAAoB,EAAE,OAAmB;QAC/E,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,uFAAuF;QAC3G,MAAM,gBAAgB,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACpD,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,gFAAgF;QACpG,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,mEAAmE;QACvF,MAAM,cAAc,GAAW,MAAM,CAAC,YAAY,EAAE,CAAC;QAErD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACnC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,MAAM,MAAM,GAAW,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAW,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACnE,iGAAiG;QACjG,MAAM,KAAK,GAAa,KAAK,CAAC,YAAY;YACtC,CAAC,CAAC,MAAM,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;YAC5D,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;QAEvD,sGAAsG;QACtG,qGAAqG;QACrG,oGAAoG;QACpG,QAAQ;QACR,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,4GAA4G;QAC5G,oEAAoE;QACpE,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,QAAQ,CAAC,GAAG,qBAAqB,CAAC;QAC5E,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YAC7E,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;gBACpB,MAAM;YACV,CAAC;YACD,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,kFAAkF;YAClF,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAAC;YAC7C,OAAO;QACX,CAAC;QACD,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAE1C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;QACjD,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QACvC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACjC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,QAAQ,CAClB,OAAmB,EACnB,MAAc,EACd,OAAuD,EACvD,KAAsB;QAEtB,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,qDAAqD;QAC9E,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5E,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzG,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;CACJ"}

package/dist/lib/rop/RopReadStreamHandler.js

@@ -0,0 +1,73 @@
+import { loadStreamBody } from "./MessageBodyStream.js";
+const ROP_ID_READ_STREAM = 0x2c;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a stream (or
+ * doesn't exist)" - the same constant `RopGetHierarchyTableHandler` uses for its own analogous check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** `0xBABE`: `ByteCount`'s sentinel value signaling "the real limit is the following 4-byte `MaximumByteCount`
+ * field instead" (`[MS-OXCPRPT]`'s own `RopReadStream` request-buffer page). */
+const BYTE_COUNT_USE_MAXIMUM = 0xbabe;
+/** The response's own `DataSize` field is a 16-bit count (`[MS-OXCPRPT]`'s own `RopReadStream` response-buffer
+ * page), so a single call can never actually return more than this many bytes - regardless of what `ByteCount`/
+ * `MaximumByteCount` (a full 32-bit value in the latter case) the client asked for. Returning fewer bytes than
+ * requested is spec-legal (the client just calls `RopReadStream` again for the rest, exactly how paging a large
+ * stream is meant to work) - `writeUInt16LE` throwing `RangeError` for an out-of-range value is not. */
+const MAX_DATA_SIZE = 0xffff;
+/** RopId, InputHandleIndex, ReturnValue and DataSize. */
+const RESPONSE_HEADER_BYTES = 8;
+/**
+ * `RopReadStream` (`[MS-OXCPRPT]`/`[MS-OXCROPS]`): reads up to `ByteCount` (or `MaximumByteCount`, if
+ * `ByteCount` is the `0xBABE` sentinel) bytes from an already-opened stream (`RopOpenStream`), advancing the
+ * stream's read position - clamped to `MAX_DATA_SIZE` (`0xFFFF`) regardless of what the client asked for, since
+ * the response's own `DataSize` field can't carry more than that; a client wanting more of a large body simply
+ * calls `RopReadStream` again from the advanced `streamPosition`, the same paging behavior real Exchange uses. It is
+ * likewise held to the room left in the request's ROP output buffer (`context.ropOutputRemaining`).
+ * Unlike most other ROPs in this pragmatic subset, `[MS-OXCROPS]` documents only one combined response-buffer
+ * shape for this ROP (no separate Success/Failure pages) - `DataSize`/`Data` are always present, `DataSize = 0`
+ * (empty `Data`) standing in for the failure case rather than the fields being omitted entirely.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopReadStreamHandler {
+    constructor() {
+        this.ropId = ROP_ID_READ_STREAM;
+        this.failureTailBytes = 2; // DataSize/WrittenSize
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const byteCount = reader.readUInt16LE();
+        const requestedCount = byteCount === BYTE_COUNT_USE_MAXIMUM ? reader.readUInt32LE() : byteCount;
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "stream") {
+            writer.writeUInt8(ROP_ID_READ_STREAM);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            writer.writeUInt16LE(0); // DataSize - see class doc comment on why this is still written on failure
+            return;
+        }
+        const bytes = await loadStreamBody(context, inputHandleIndex, handle);
+        const position = handle.streamPosition ?? 0;
+        // Also held to the room left in this request's ROP output buffer, after this response's 8 fixed bytes.
+        const room = Math.max(0, (context.ropOutputRemaining ?? Infinity) - RESPONSE_HEADER_BYTES);
+        const wanted = Math.min(requestedCount, MAX_DATA_SIZE);
+        const available = bytes.subarray(position, position + wanted);
+        if (room === 0 && available.length > 0) {
+            // No room for even one byte: a DataSize of 0 would read as the end of the stream. Answer with what the read
+            // needs instead, which doesn't fit, so the dispatcher turns it into RopBufferTooSmall. The position stays.
+            writer.writeUInt8(ROP_ID_READ_STREAM);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(0);
+            writer.writeUInt16LE(available.length);
+            writer.writeBytes(available);
+            return;
+        }
+        const slice = available.subarray(0, room);
+        handle.streamPosition = position + slice.length;
+        writer.writeUInt8(ROP_ID_READ_STREAM);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt16LE(slice.length); // DataSize
+        writer.writeBytes(slice);
+    }
+}
+//# sourceMappingURL=RopReadStreamHandler.js.map

package/dist/lib/rop/RopReadStreamHandler.js.map

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

package/dist/lib/rop/RopReleaseHandler.js

@@ -0,0 +1,23 @@
+import { releaseHandle } from "../MapiSessionManager.js";
+const ROP_ID_RELEASE = 0x01;
+/**
+ * `RopRelease` (`[MS-OXCROPS]`): releases a Server object handle. Confirmed against the spec's own real
+ * captured example (`08 00 01 00 00 01 00 01 6F 00 00 00 6E 00 00 00`) that the request is exactly 3 bytes
+ * (`RopId`/`LogonId`/`InputHandleIndex`) and, uniquely among ROPs, **produces no response entry at all** - the
+ * server MUST NOT write anything to the output buffer for it, so `handle()` never touches `writer`.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopReleaseHandler {
+    constructor() {
+        this.ropId = ROP_ID_RELEASE;
+        this.hasNoResponse = true;
+    }
+    handle(reader, _writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track per-logon-id state separately
+        const inputHandleIndex = reader.readUInt8();
+        // Also releases write streams opened against this handle and drops its cached data - see releaseHandle.
+        releaseHandle(context.session, inputHandleIndex);
+    }
+}
+//# sourceMappingURL=RopReleaseHandler.js.map

package/dist/lib/rop/RopReleaseHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RopReleaseHandler.js","sourceRoot":"","sources":["../../../src/rop/RopReleaseHandler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IAA9B;QACoB,UAAK,GAAG,cAAc,CAAC;QACvB,kBAAa,GAAG,IAAI,CAAC;IAQzC,CAAC;IANU,MAAM,CAAC,MAAoB,EAAE,OAAqB,EAAE,OAAmB;QAC1E,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,8EAA8E;QAClG,MAAM,gBAAgB,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACpD,wGAAwG;QACxG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACrD,CAAC;CACJ"}

package/dist/lib/rop/RopSaveChangesMessageHandler.js

@@ -0,0 +1,269 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import crypto from "crypto";
+import { AttendeeResponseStatus, AttendeeRole, BusyStatus, RecipientType, } from "@rapidmx/restapi";
+import { decodeAppointmentRecurrence } from "../codec/AppointmentRecurrence.js";
+import { BufferReader } from "../codec/BufferCursor.js";
+import { decodeTimeZoneStruct } from "../codec/MapiTimeZone.js";
+import { BUSY_STATUS_FROM_CODE, LID_APPOINTMENT_END_WHOLE, LID_APPOINTMENT_RECUR, LID_APPOINTMENT_START_WHOLE, LID_BUSY_STATUS, LID_LOCATION, LID_REMINDER_DELTA, LID_TIME_ZONE_STRUCT, PSETID_APPOINTMENT, PSETID_COMMON, } from "./CalendarNamedProperties.js";
+import { assignOrGetMid } from "./MessageTarget.js";
+import { resolveNamedProperty } from "./NamedPropertyRegistry.js";
+import { MAX_RECIPIENTS_PER_MESSAGE } from "./AddressList.js";
+import { asEntity, isInvitePending } from "./RestapiRules.js";
+import { parseAddressList } from "./RopSubmitMessageHandler.js";
+const ROP_ID_SAVE_CHANGES_MESSAGE = 0x0c;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a message (or
+ * doesn't exist)" - the same constant `RopGetPropertiesSpecificHandler` uses for its own analogous check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** `MAPI_E_TOO_BIG`: a meeting with more than `MAX_RECIPIENTS_PER_MESSAGE` attendees. */
+const ERROR_TOO_BIG = 0x80040305;
+// The same well-known property IDs RopSetPropertiesHandler tracks - duplicated here (rather than imported)
+// since importing them would only save a handful of literals; see that file for the real documentation of what
+// each means.
+const PID_TAG_SUBJECT = 0x0037;
+const PID_TAG_MESSAGE_CLASS = 0x001a;
+const PID_TAG_DISPLAY_CC = 0x0e03;
+const PID_TAG_DISPLAY_TO = 0x0e04;
+/** `PidTagMessageClass` values starting with this prefix route through `saveAppointment()` instead of the
+ * generic draft-MID-assignment path below - see that method's own doc comment. */
+const MESSAGE_CLASS_APPOINTMENT_PREFIX = "IPM.Appointment";
+/**
+ * `RopSaveChangesMessage` (`[MS-OXCMSG]`/`[MS-OXCROPS]`): persists a message's pending changes, returning the
+ * `MID` a client can reference it by afterwards. **Pragmatic subset**: this library has no separate Drafts-
+ * folder persistence step (matching EAS's own `ComposeMailCommand`, which never creates a standalone draft
+ * `Message` row either) - saving a `RopCreateMessage` draft does not yet write anything to a database. It only
+ * assigns a session-scoped MID (`MessageTarget.assignOrGetMid`, the exact mechanism a `RopQueryRows` row's
+ * `PidTagMid` column already uses) so the wire contract's `MessageId` field is well-formed, keyed by this
+ * handle's own index (`` `draft:${inputHandleIndex}` ``) since an unsaved draft has no real `"message:<uid>"`
+ * target yet. The real work - actually building and sending a MIME message from the properties/body
+ * accumulated so far - happens at `RopSubmitMessage` time, not here; calling Save without ever calling Submit
+ * silently discards the draft when the session expires, a real, deliberate limitation (this pragmatic subset
+ * has no autosave-recovery story) rather than a silently-wrong one.
+ *
+ * Re-saving an already-real message (a `RopOpenMessage` handle, not a fresh `RopCreateMessage` draft) is
+ * accepted but is a no-op beyond echoing that message's own already-assigned MID - editing an existing
+ * message's properties is out of scope for this pragmatic subset's compose/send-only ROP coverage.
+ *
+ * `SaveFlags` is decoded to advance past it correctly but not honored - this pragmatic subset has no
+ * conflict-resolution/force-save semantics to vary by flag.
+ *
+ * **Calendar branch**: unlike mail, a draft whose `PidTagMessageClass` starts with `"IPM.Appointment"` *is*
+ * durably persisted here (`saveAppointment()`) - creating (or updating, if this handle already refers to a real
+ * `"calendarEvent:<uid>"`) a real `CalendarEvent` row, so a subsequent `RopGetPropertiesSpecific` can read it
+ * back before `RopSubmitMessage` is ever called (a calendar item must exist as soon as it's saved, the same way
+ * a real Exchange server behaves - unlike a mail draft, which this pragmatic subset never persists at all until
+ * Submit). Saving never invites anyone: a saved revision is stamped as already handled (`inviteSequenceSent =
+ * sequence`), so restapi's `MeetingSchedulingJob` skips it until `RopSubmitMessageHandler.submitAppointment` asks for
+ * invites. Attendees of a submitted meeting are then mailed by that job, which is why a meeting is capped at
+ * `MAX_RECIPIENTS_PER_MESSAGE` attendees here. Client-supplied times and reminder minutes that don't parse are ignored (the field keeps its
+ * existing or default value) rather than stored as `Invalid Date`/`NaN`, and an update is versioned (`asEntity`).
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopSaveChangesMessageHandler {
+    constructor() {
+        this.ropId = ROP_ID_SAVE_CHANGES_MESSAGE;
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const responseHandleIndex = reader.readUInt8();
+        const inputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // SaveFlags - see class doc comment
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "message") {
+            writer.writeUInt8(ROP_ID_SAVE_CHANGES_MESSAGE);
+            writer.writeUInt8(responseHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const draftProperties = handle.draftProperties ?? {};
+        const messageClass = draftProperties[String(PID_TAG_MESSAGE_CLASS)] ?? "IPM.Note";
+        const mid = messageClass.startsWith(MESSAGE_CLASS_APPOINTMENT_PREFIX)
+            ? await this.saveAppointment(handle, draftProperties, context)
+            : BigInt(assignOrGetMid(context.session, handle.entityUid !== "" ? handle.entityUid : `draft:${inputHandleIndex}`));
+        if (mid === undefined) {
+            writer.writeUInt8(ROP_ID_SAVE_CHANGES_MESSAGE);
+            writer.writeUInt8(responseHandleIndex);
+            writer.writeUInt32LE(ERROR_TOO_BIG);
+            return;
+        }
+        writer.writeUInt8(ROP_ID_SAVE_CHANGES_MESSAGE);
+        writer.writeUInt8(responseHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeBigUInt64LE(mid);
+    }
+    /**
+     * Persists (creating, or updating an already-real one) a `CalendarEvent` from the draft's accumulated
+     * `RopSetProperties` values, and returns the MID a client can reference it by. Every field this pragmatic
+     * subset understands (per `CalendarNamedProperties.ts`) is decoded via `decodeCalendarFieldsFromDraft`
+     * below - the write-side mirror of `PropertyResolvers.calendarEventValueFor`'s read-side switch. A field the
+     * client never set (e.g. no `RopSetProperties` call touched `PidLidBusyStatus`) falls back to the existing
+     * row's own value on an update, or the entity class's own default on a fresh create.
+     *
+     * Returns `undefined`, saving nothing, for more than `MAX_RECIPIENTS_PER_MESSAGE` attendees: restapi's
+     * `MeetingSchedulingJob` mails every attendee of a saved meeting.
+     */
+    async saveAppointment(handle, draftProperties, context) {
+        const decoded = decodeCalendarFieldsFromDraft(context.session, draftProperties);
+        if (decoded.attendeeAddresses.length > MAX_RECIPIENTS_PER_MESSAGE) {
+            return undefined;
+        }
+        const attendees = decoded.attendeeAddresses.map((address) => ({
+            address,
+            role: AttendeeRole.REQUIRED,
+            responseStatus: AttendeeResponseStatus.NEEDS_ACTION,
+            isOrganizer: false,
+        }));
+        if (handle.entityUid.startsWith("calendarEvent:")) {
+            const uid = handle.entityUid.slice("calendarEvent:".length);
+            const existing = await context.calendarEventRepo.findOne(uid, {
+                ignoreACL: true,
+            });
+            if (existing) {
+                const updated = {
+                    uid: existing.uid,
+                    version: existing.version,
+                    title: decoded.title ?? existing.title,
+                    location: decoded.location ?? existing.location,
+                    startDate: decoded.startDate ?? existing.startDate,
+                    endDate: decoded.endDate ?? existing.endDate,
+                    busyStatus: decoded.busyStatus ?? existing.busyStatus,
+                    recurrenceRule: decoded.recurrenceRule ?? existing.recurrenceRule,
+                    timezone: decoded.timezone ?? existing.timezone,
+                    reminderMinutesBeforeStart: decoded.reminderMinutesBeforeStart ?? existing.reminderMinutesBeforeStart,
+                    // An attendee who is still invited keeps their recorded response.
+                    attendees: attendees.length > 0
+                        ? attendees.map((attendee) => existing.attendees.find((prior) => prior.address.toLowerCase() === attendee.address.toLowerCase()) ??
+                            attendee)
+                        : existing.attendees,
+                };
+                const sequence = (existing.sequence ?? 0) + (isSchedulingRelevantChange(existing, updated) ? 1 : 0);
+                await context.calendarEventRepo.update({
+                    ...updated,
+                    sequence,
+                    // Saving sends nothing, so this revision counts as handled - unless a submitted revision is still
+                    // waiting for the job, which then sends the meeting as it now stands rather than not at all.
+                    inviteSequenceSent: isInvitePending(existing) ? (existing.inviteSequenceSent ?? null) : sequence,
+                }, asEntity(context.calendarEventRepo, existing), { ignoreACL: true });
+            }
+            return BigInt(assignOrGetMid(context.session, handle.entityUid));
+        }
+        const mailbox = await context.mailboxRepo.findOne(context.mailboxUid, { ignoreACL: true });
+        // draftFolderUid is a "folder:<uid>"-prefixed target string (RopCreateMessageHandler stores the same
+        // target FolderTarget.assignOrGetFid assigned), not a bare uid - strip the prefix before persisting.
+        const draftFolderTarget = handle.draftFolderUid ?? "";
+        const folderUid = draftFolderTarget.startsWith("folder:") ? draftFolderTarget.slice("folder:".length) : draftFolderTarget;
+        const created = await context.calendarEventRepo.create(new context.calendarEventClass({
+            folderUid,
+            mailboxUid: context.mailboxUid,
+            title: decoded.title ?? "",
+            location: decoded.location,
+            startDate: decoded.startDate ?? new Date(),
+            endDate: decoded.endDate ?? new Date(),
+            timezone: decoded.timezone ?? "UTC",
+            organizer: { address: mailbox?.primarySmtpAddress ?? "", displayName: mailbox?.displayName, type: RecipientType.TO },
+            attendees,
+            busyStatus: decoded.busyStatus ?? BusyStatus.BUSY,
+            recurrenceRule: decoded.recurrenceRule,
+            reminderMinutesBeforeStart: decoded.reminderMinutesBeforeStart,
+            icalUid: `${crypto.randomUUID()}@mapi`,
+            sequence: 0,
+            // Handled until submitted: saving a meeting doesn't invite its attendees.
+            inviteSequenceSent: 0,
+        }), { ignoreACL: true });
+        handle.entityUid = `calendarEvent:${created.uid}`;
+        return BigInt(assignOrGetMid(context.session, handle.entityUid));
+    }
+}
+/**
+ * `true` when an update changes what attendees were invited to: the start or end time, location, recurrence, or
+ * who is invited. The same fields restapi's `BaseCalendarEventRoute.update()` bumps `sequence` for (a MAPI save
+ * never sets `status`), so an edit made in Outlook is re-sent to attendees and supersedes their copy (RFC 5546
+ * `SEQUENCE`) exactly like one made through REST.
+ */
+export function isSchedulingRelevantChange(existing, updated) {
+    const addresses = (attendees) => JSON.stringify(attendees.map((attendee) => attendee.address.toLowerCase()).sort());
+    return (new Date(updated.startDate).getTime() !== new Date(existing.startDate).getTime() ||
+        new Date(updated.endDate).getTime() !== new Date(existing.endDate).getTime() ||
+        (updated.location ?? "") !== (existing.location ?? "") ||
+        JSON.stringify(updated.recurrenceRule ?? null) !== JSON.stringify(existing.recurrenceRule ?? null) ||
+        addresses(updated.attendees) !== addresses(existing.attendees));
+}
+/** Decodes a draft message handle's accumulated `RopSetProperties` values (`Record<string, string>`, keyed by
+ * decimal `PropertyId`) back into typed `CalendarEvent` fields - the write-side mirror of
+ * `PropertyResolvers.calendarEventValueFor`'s read-side switch, sharing the same `CalendarNamedProperties.ts`
+ * LID table. `PidTagDisplayTo`/`Cc` (not `Bcc` - a meeting has no concept of a blind attendee) become
+ * `attendeeAddresses`, matching `RopSubmitMessageHandler`'s own mail-side addressing pragmatic subset (no
+ * `RopModifyRecipients` support - see that file's own doc comment).
+ *
+ * `title` used to default to `""` whenever `PidTagSubject` wasn't present in `properties` at all, rather than
+ * staying `undefined` the way every other optional field here already did (the named-property loop below only
+ * ever assigns a field when its key is actually present) - `saveAppointment`'s update branch then wrote that
+ * `""` straight through with no existing-value fallback, silently blanking the title of any event edited via a
+ * `RopSetProperties` call that only touched some other property (e.g. just `PidLidBusyStatus`). Checking `in`
+ * explicitly (rather than `properties[key] ?? ""`) preserves the same "present but genuinely empty" vs.
+ * "absent" distinction `PidTagSubject` deserves alongside every other field here. */
+function decodeCalendarFieldsFromDraft(session, properties) {
+    const subjectKey = String(PID_TAG_SUBJECT);
+    const decoded = {
+        title: subjectKey in properties ? properties[subjectKey] : undefined,
+        attendeeAddresses: [
+            ...parseAddressList(properties[String(PID_TAG_DISPLAY_TO)]),
+            ...parseAddressList(properties[String(PID_TAG_DISPLAY_CC)]),
+        ],
+    };
+    for (const [key, value] of Object.entries(properties)) {
+        const propertyId = Number(key);
+        if (propertyId < 0x8000) {
+            continue;
+        }
+        const named = resolveNamedProperty(session, propertyId);
+        if (!named || named.kind !== "lid") {
+            continue;
+        }
+        const guid = named.guid.toLowerCase();
+        if (guid === PSETID_APPOINTMENT) {
+            switch (named.lid) {
+                case LID_LOCATION:
+                    decoded.location = value;
+                    break;
+                case LID_APPOINTMENT_START_WHOLE:
+                    decoded.startDate = validDate(value);
+                    break;
+                case LID_APPOINTMENT_END_WHOLE:
+                    decoded.endDate = validDate(value);
+                    break;
+                case LID_BUSY_STATUS:
+                    decoded.busyStatus = BUSY_STATUS_FROM_CODE[Number(value)] ?? BusyStatus.BUSY;
+                    break;
+                case LID_APPOINTMENT_RECUR:
+                    decoded.recurrenceRule = decodeAppointmentRecurrence(new BufferReader(Buffer.from(value, "base64")));
+                    break;
+                case LID_TIME_ZONE_STRUCT:
+                    decoded.timezone = decodeTimeZoneStruct(new BufferReader(Buffer.from(value, "base64")));
+                    break;
+                default:
+                    break;
+            }
+        }
+        else if (guid === PSETID_COMMON && named.lid === LID_REMINDER_DELTA) {
+            decoded.reminderMinutesBeforeStart = validMinutes(value);
+        }
+    }
+    return decoded;
+}
+/** `value` as a date, or `undefined` (the field is left as it was) when it doesn't parse. A client picks the property
+ * type it sends, so a "time" can arrive as any string. */
+function validDate(value) {
+    const date = new Date(value);
+    return Number.isNaN(date.getTime()) ? undefined : date;
+}
+/** `value` as a whole, non-negative number of minutes, or `undefined` when it isn't one. */
+function validMinutes(value) {
+    const minutes = Number(value);
+    return value.trim() !== "" && Number.isSafeInteger(minutes) && minutes >= 0 ? minutes : undefined;
+}
+//# sourceMappingURL=RopSaveChangesMessageHandler.js.map

package/dist/lib/rop/RopSaveChangesMessageHandler.js.map

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

package/dist/lib/rop/RopSetColumnsHandler.js

@@ -0,0 +1,50 @@
+import { readPropertyTagArray } from "../codec/PropertyValue.js";
+const ROP_ID_SET_COLUMNS = 0x12;
+/** `TBLSTAT_COMPLETE` - this pragmatic subset's tables are always populated synchronously, so `RopSetColumns`
+ * (and every other table ROP) never reports any other `TableStatus` value. */
+const TABLE_STATUS_COMPLETE = 0x00;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a table (or
+ * doesn't exist)" - the same constant `RopQueryRowsHandler`/`RopGetHierarchyTableHandler` use for their own
+ * analogous checks. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** `MAPI_E_TOO_BIG`, for more than `MAX_PROPERTY_TAG_COUNT` columns. */
+const ERROR_TOO_BIG = 0x80040305;
+/**
+ * `RopSetColumns` (`[MS-OXCTABL]`/`[MS-OXCROPS]`): configures which properties a table's subsequent
+ * `RopQueryRows` calls return, and in what order. Unlike `RopOpenFolder`/`RopGetHierarchyTable`, this ROP
+ * doesn't create a new handle - it mutates the existing table handle referenced by `InputHandleIndex` in
+ * place, so its response echoes `InputHandleIndex` rather than an `OutputHandleIndex`, the same convention
+ * `RopQueryRows`' own response uses (confirmed against `[MS-OXCTABL]`'s real captured response example).
+ *
+ * Validates that `InputHandleIndex` actually refers to a `"table"` handle before mutating it, the same check
+ * every other handle-consuming ROP in this pragmatic subset already makes - a missing or wrong-type handle
+ * previously fell through silently (no `else` branch) to a bare success response, meaning a client that set
+ * columns against a stale/released/wrong-kind handle index only discovered the real problem one ROP later,
+ * when `RopQueryRows` on that same index returned `MAPI_E_INVALID_OBJECT` instead.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopSetColumnsHandler {
+    constructor() {
+        this.ropId = ROP_ID_SET_COLUMNS;
+    }
+    handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // SetColumnsFlags - this pragmatic subset has no async/deferred column-set variant
+        const columns = readPropertyTagArray(reader, reader.readUInt16LE());
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "table" || !columns) {
+            writer.writeUInt8(ROP_ID_SET_COLUMNS);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(columns ? ERROR_INVALID_OBJECT : ERROR_TOO_BIG);
+            return;
+        }
+        handle.columns = columns;
+        writer.writeUInt8(ROP_ID_SET_COLUMNS);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(TABLE_STATUS_COMPLETE);
+    }
+}
+//# sourceMappingURL=RopSetColumnsHandler.js.map

package/dist/lib/rop/RopSetColumnsHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RopSetColumnsHandler.js","sourceRoot":"","sources":["../../../src/rop/RopSetColumnsHandler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;8EAC8E;AAC9E,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;uBAEuB;AACvB,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,wEAAwE;AACxE,MAAM,aAAa,GAAG,UAAU,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,oBAAoB;IAAjC;QACoB,UAAK,GAAG,kBAAkB,CAAC;IAsB/C,CAAC;IApBU,MAAM,CAAC,MAAoB,EAAE,MAAoB,EAAE,OAAmB;QACzE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,uFAAuF;QAC3G,MAAM,gBAAgB,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACpD,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,mFAAmF;QACvG,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;YACtC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YACrE,OAAO;QACX,CAAC;QACD,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QAEzB,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QACtC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;QACjD,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAC7C,CAAC;CACJ"}