@rapidmx/mapi-plugin 1.0.0-beta.3

package/dist/lib/rop/PropertyResolvers.js

@@ -0,0 +1,313 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { encodeAppointmentRecurrence } from "../codec/AppointmentRecurrence.js";
+import { encodeTimeZoneStruct } from "../codec/MapiTimeZone.js";
+import { PropertyType } from "../codec/PropertyValue.js";
+import { BUSY_STATUS_CODES, LID_APPOINTMENT_END_WHOLE, LID_APPOINTMENT_RECUR, LID_APPOINTMENT_START_WHOLE, LID_BUSY_STATUS, LID_LOCATION, LID_RECURRING, LID_REMINDER_DELTA, LID_REMINDER_SET, LID_RESPONSE_STATUS, LID_TIME_ZONE_STRUCT, PSETID_APPOINTMENT, PSETID_COMMON, RESPONSE_STATUS_CODES, RESPONSE_STATUS_NONE, RESPONSE_STATUS_ORGANIZED, } from "./CalendarNamedProperties.js";
+import { resolveCalendarEventInfo } from "./CalendarEventTarget.js";
+import { resolveContactInfo } from "./ContactTarget.js";
+import { assignOrGetFid, resolveFolderInfo } from "./FolderTarget.js";
+import { assignOrGetMid, resolveMessageInfo } from "./MessageTarget.js";
+import { resolveNamedProperty } from "./NamedPropertyRegistry.js";
+import { LID_PERCENT_COMPLETE, LID_TASK_COMPLETE, LID_TASK_DUE_DATE, LID_TASK_STATUS, PSETID_TASK, TASK_STATUS_COMPLETE, TASK_STATUS_NOT_STARTED, } from "./TaskNamedProperties.js";
+import { resolveTaskInfo } from "./TaskTarget.js";
+// Well-known folder property IDs this pragmatic subset supports - the small set a real client needs to render
+// a folder-hierarchy view. Add more as a real need arises, not speculatively.
+const PID_TAG_DISPLAY_NAME = 0x3001;
+const PID_TAG_FOLDER_ID = 0x6748;
+const PID_TAG_CONTENT_COUNT = 0x3602;
+const PID_TAG_CONTENT_UNREAD_COUNT = 0x3603;
+const PID_TAG_SUBFOLDERS = 0x360a;
+// Well-known message property IDs this pragmatic subset supports - the small set a real client needs to render
+// a message list or a single message's metadata.
+const PID_TAG_SUBJECT = 0x0037;
+const PID_TAG_MESSAGE_FLAGS = 0x0e07;
+const PID_TAG_HAS_ATTACHMENTS = 0x0e1b;
+const PID_TAG_MESSAGE_DELIVERY_TIME = 0x0e06;
+const PID_TAG_MID = 0x674a;
+/** `MSGFLAG_READ`, the one `PidTagMessageFlags` bit this pragmatic subset ever sets. */
+const MSGFLAG_READ = 0x01;
+/** `PidNameKeywords` ([MS-OXPROPS] "Keywords") - Outlook's Categories feature, a `Kind=name` named property
+ * (unlike every other named property this pragmatic subset resolves, all `Kind=lid` - see
+ * `NamedPropertyRegistry.ts`'s own `PropertyName` shape for why both kinds are supported). Maps directly onto
+ * this data model's Gmail-style `Message.labelUids`: Outlook only understands free-text category names, not a
+ * `Label.uid` reference, so `resolvePropertyValues` resolves each uid to its `Label.name` before this property
+ * is ever read. `PT_MV_UNICODE` (`PtypMultipleString` in this codebase's own enum naming). */
+const PSETID_PUBLIC_STRINGS = "00020329-0000-0000-c000-000000000046";
+const NAME_KEYWORDS = "Keywords";
+// Well-known Contact property IDs this pragmatic subset supports - all plain (non-named) PidTags, per
+// [MS-OXOCNTC], since a Contact needs no PSETID/LID lookup the way Calendar/Task properties do.
+const PID_TAG_GIVEN_NAME = 0x3a06;
+const PID_TAG_SURNAME = 0x3a11;
+const PID_TAG_EMAIL_ADDRESS = 0x3003;
+const PID_TAG_BUSINESS_TELEPHONE_NUMBER = 0x3a08;
+const PID_TAG_COMPANY_NAME = 0x3a16;
+const PID_TAG_TITLE = 0x3a17;
+// Calendar named-property identity (`(PropertySet GUID, LID)` pairs) this pragmatic subset supports - see
+// CalendarNamedProperties.ts's own doc comment. A calendar item's property IDs `>= 0x8000` are resolved back
+// to one of these via `NamedPropertyRegistry.resolveNamedProperty` before this switch can run, since MAPI has
+// no fixed numeric ID for any of them the way `PidTagSubject` has one.
+/** A type-appropriate zero/empty value for a requested property this handler has no real data for - keeps
+ * `StandardPropertyRow` encoding valid (a real value of the right type, per `writePropertyValue`'s
+ * expectations) without needing to model every property a client could ever ask for. Shared by
+ * `RopQueryRowsHandler` (table rows) and `RopGetPropertiesSpecificHandler` (single-object property fetch). */
+export function defaultValueForType(propertyType) {
+    switch (propertyType) {
+        case PropertyType.PtypBoolean:
+            return false;
+        case PropertyType.PtypInteger16:
+        case PropertyType.PtypInteger32:
+        case PropertyType.PtypFloating32:
+        case PropertyType.PtypFloating64:
+            return 0;
+        case PropertyType.PtypInteger64:
+            return 0n;
+        case PropertyType.PtypTime:
+            return new Date(0);
+        case PropertyType.PtypGuid:
+            return "00000000-0000-0000-0000-000000000000";
+        case PropertyType.PtypBinary:
+            return Buffer.alloc(0);
+        case PropertyType.PtypMultipleInteger32:
+        case PropertyType.PtypMultipleString:
+        case PropertyType.PtypMultipleString8:
+        case PropertyType.PtypMultipleBinary:
+            return [];
+        case PropertyType.PtypString:
+        case PropertyType.PtypString8:
+        default:
+            return "";
+    }
+}
+/** Resolves one requested property's value for a `"folder:<uid>"`/`"virtual:<name>"` target. */
+export function folderValueFor(session, propertyId, propertyType, target, info) {
+    switch (propertyId) {
+        case PID_TAG_DISPLAY_NAME:
+            return info.displayName;
+        case PID_TAG_FOLDER_ID:
+            return BigInt(assignOrGetFid(session, target));
+        case PID_TAG_CONTENT_COUNT:
+            return info.totalCount;
+        case PID_TAG_CONTENT_UNREAD_COUNT:
+            return info.unreadCount;
+        case PID_TAG_SUBFOLDERS:
+            return info.hasChildren;
+        default:
+            return defaultValueForType(propertyType);
+    }
+}
+/** Resolves one requested property's value for a `"message:<uid>"` target. `labelNames` is this message's own
+ * `labelUids` already resolved to display names (see `resolvePropertyValues`'s own doc comment) - a plain
+ * parameter rather than a repo lookup here, since this function (like every other `xxxValueFor`) is
+ * synchronous and can't do its own async DB access. */
+export function messageValueFor(session, propertyId, propertyType, target, info, labelNames = []) {
+    switch (propertyId) {
+        case PID_TAG_SUBJECT:
+            return info.subject;
+        case PID_TAG_MESSAGE_FLAGS:
+            return info.read ? MSGFLAG_READ : 0;
+        case PID_TAG_HAS_ATTACHMENTS:
+            return info.hasAttachments;
+        case PID_TAG_MESSAGE_DELIVERY_TIME:
+            return info.receivedDate;
+        case PID_TAG_MID:
+            return BigInt(assignOrGetMid(session, target));
+        default: {
+            if (propertyId >= 0x8000) {
+                const named = resolveNamedProperty(session, propertyId);
+                if (named && named.kind === "name" && named.name === NAME_KEYWORDS && named.guid.toLowerCase() === PSETID_PUBLIC_STRINGS) {
+                    return labelNames;
+                }
+            }
+            return defaultValueForType(propertyType);
+        }
+    }
+}
+/** Resolves one requested property's value for a `"calendarEvent:<uid>"` target. Almost every Appointment
+ * property is a *named* property (`PidLid*`, no fixed numeric ID) rather than a plain `PidTag*` - a property ID
+ * `>= 0x8000` is resolved back to its `(PropertySet GUID, LID)` identity via `resolveNamedProperty` before this
+ * can dispatch on it (see `NamedPropertyRegistry.ts`'s own doc comment and the architecture plan's "Calendar
+ * support" section for the full named-property table this switch implements). */
+export function calendarEventValueFor(session, propertyId, propertyType, target, info, callerAddress) {
+    if (propertyId === PID_TAG_SUBJECT) {
+        return info.title;
+    }
+    if (propertyId === PID_TAG_MID) {
+        return BigInt(assignOrGetMid(session, target));
+    }
+    if (propertyId < 0x8000) {
+        return defaultValueForType(propertyType);
+    }
+    const namedProperty = resolveNamedProperty(session, propertyId);
+    if (!namedProperty || namedProperty.kind !== "lid") {
+        return defaultValueForType(propertyType);
+    }
+    const guid = namedProperty.guid.toLowerCase();
+    const isAppointmentProperty = guid === PSETID_APPOINTMENT;
+    const isCommonProperty = guid === PSETID_COMMON;
+    switch (namedProperty.lid) {
+        case LID_LOCATION:
+            return isAppointmentProperty ? (info.location ?? "") : defaultValueForType(propertyType);
+        case LID_APPOINTMENT_START_WHOLE:
+            return isAppointmentProperty ? info.startDate : defaultValueForType(propertyType);
+        case LID_APPOINTMENT_END_WHOLE:
+            return isAppointmentProperty ? info.endDate : defaultValueForType(propertyType);
+        case LID_BUSY_STATUS:
+            return isAppointmentProperty ? BUSY_STATUS_CODES[info.busyStatus] : defaultValueForType(propertyType);
+        case LID_RECURRING:
+            return isAppointmentProperty ? info.recurrenceRule !== undefined : defaultValueForType(propertyType);
+        case LID_APPOINTMENT_RECUR:
+            return isAppointmentProperty && info.recurrenceRule
+                ? encodeAppointmentRecurrence(info.recurrenceRule, info.startDate, info.endDate)
+                : defaultValueForType(propertyType);
+        case LID_TIME_ZONE_STRUCT:
+            return isAppointmentProperty ? encodeTimeZoneStruct(info.timezone, info.startDate) : defaultValueForType(propertyType);
+        case LID_RESPONSE_STATUS:
+            return isAppointmentProperty ? responseStatusFor(info, callerAddress) : defaultValueForType(propertyType);
+        case LID_REMINDER_SET:
+            return isCommonProperty ? info.reminderMinutesBeforeStart != null : defaultValueForType(propertyType);
+        case LID_REMINDER_DELTA:
+            return isCommonProperty ? (info.reminderMinutesBeforeStart ?? 0) : defaultValueForType(propertyType);
+        default:
+            return defaultValueForType(propertyType);
+    }
+}
+/** The caller's own `PidLidResponseStatus` value: `respOrganized` if the caller mailbox *is* this event's
+ * organizer, else the matching `Attendee.responseStatus` (by address, case-insensitive), else `respNone` if the
+ * caller isn't party to this event at all (e.g. a shared/delegate calendar view). */
+function responseStatusFor(info, callerAddress) {
+    if (callerAddress && info.organizerAddress.toLowerCase() === callerAddress.toLowerCase()) {
+        return RESPONSE_STATUS_ORGANIZED;
+    }
+    const attendee = info.attendees.find((a) => a.address.toLowerCase() === callerAddress.toLowerCase());
+    return attendee ? RESPONSE_STATUS_CODES[attendee.responseStatus] : RESPONSE_STATUS_NONE;
+}
+/** Resolves one requested property's value for a `"contact:<uid>"` target - a `Folder` of type `CONTACTS`'s
+ * content-table rows/opened items. Every field here is a plain fixed `PidTag` (`[MS-OXOCNTC]`), unlike Calendar/
+ * Task's named-property tables, since Contact's own well-known fields all have real numeric IDs. */
+export function contactValueFor(session, propertyId, propertyType, target, info) {
+    switch (propertyId) {
+        case PID_TAG_SUBJECT:
+            return info.displayName;
+        case PID_TAG_MID:
+            return BigInt(assignOrGetMid(session, target));
+        case PID_TAG_GIVEN_NAME:
+            return info.givenName ?? "";
+        case PID_TAG_SURNAME:
+            return info.surname ?? "";
+        case PID_TAG_EMAIL_ADDRESS:
+            return info.email ?? "";
+        case PID_TAG_BUSINESS_TELEPHONE_NUMBER:
+            return info.businessPhone ?? "";
+        case PID_TAG_COMPANY_NAME:
+            return info.companyName ?? "";
+        case PID_TAG_TITLE:
+            return info.jobTitle ?? "";
+        default:
+            return defaultValueForType(propertyType);
+    }
+}
+/** Resolves one requested property's value for a `"task:<uid>"` target - a `Folder` of type `TASKS`'s
+ * content-table rows/opened items. Almost every Task-specific property is a *named* property (`PidLid*`) under
+ * `PSETID_Task`, resolved back to its `(PropertySet GUID, LID)` identity via `resolveNamedProperty` exactly the
+ * same way `calendarEventValueFor` handles `PSETID_Appointment`/`PSETID_Common` - see `TaskNamedProperties.ts`'s
+ * own doc comment for the LID table this switch implements. */
+export function taskValueFor(session, propertyId, propertyType, target, info) {
+    if (propertyId === PID_TAG_SUBJECT) {
+        return info.title;
+    }
+    if (propertyId === PID_TAG_MID) {
+        return BigInt(assignOrGetMid(session, target));
+    }
+    if (propertyId < 0x8000) {
+        return defaultValueForType(propertyType);
+    }
+    const namedProperty = resolveNamedProperty(session, propertyId);
+    if (!namedProperty || namedProperty.kind !== "lid" || namedProperty.guid.toLowerCase() !== PSETID_TASK) {
+        return defaultValueForType(propertyType);
+    }
+    switch (namedProperty.lid) {
+        case LID_TASK_STATUS:
+            return info.completed ? TASK_STATUS_COMPLETE : TASK_STATUS_NOT_STARTED;
+        case LID_PERCENT_COMPLETE:
+            return info.completed ? 1.0 : 0.0;
+        case LID_TASK_DUE_DATE:
+            return info.dueDate ?? defaultValueForType(propertyType);
+        case LID_TASK_COMPLETE:
+            return info.completed;
+        default:
+            return defaultValueForType(propertyType);
+    }
+}
+/** Resolves every column in `columns` for a single `target` (a `"folder:"`/`"virtual:"`/`"message:"`/
+ * `"calendarEvent:"`/`"contact:"`/`"task:"` target string), in order - the shared implementation behind both
+ * `RopQueryRowsHandler` (one call per table row) and `RopGetPropertiesSpecificHandler` (one call for the single
+ * object a handle refers to). */
+export async function resolvePropertyValues(target, columns, context, cache) {
+    const isMessage = target.startsWith("message:");
+    const isCalendarEvent = target.startsWith("calendarEvent:");
+    const isContact = target.startsWith("contact:");
+    const isTask = target.startsWith("task:");
+    const folderInfo = isMessage || isCalendarEvent || isContact || isTask
+        ? undefined
+        : await resolveFolderInfo(context.mailboxUid, target, context.folderRepo, cache);
+    const messageInfo = isMessage ? await resolveMessageInfo(target, context.messageRepo) : undefined;
+    const calendarEventInfo = isCalendarEvent ? await resolveCalendarEventInfo(target, context.calendarEventRepo) : undefined;
+    const contactInfo = isContact && context.contactRepo ? await resolveContactInfo(target, context.contactRepo) : undefined;
+    const taskInfo = isTask && context.taskRepo ? await resolveTaskInfo(target, context.taskRepo) : undefined;
+    let labelNames = [];
+    if (messageInfo && messageInfo.labelUids.length > 0 && context.labelRepo) {
+        let labelNamesByUid;
+        if (cache) {
+            if (!cache.labelNamesByUid) {
+                const labels = await context.labelRepo.find({ mailboxUid: context.mailboxUid }, { ignoreACL: true });
+                cache.labelNamesByUid = new Map(labels.map((l) => [l.uid, l.name]));
+            }
+            labelNamesByUid = cache.labelNamesByUid;
+        }
+        else {
+            const labels = await context.labelRepo.find({ mailboxUid: context.mailboxUid }, { ignoreACL: true });
+            labelNamesByUid = new Map(labels.map((l) => [l.uid, l.name]));
+        }
+        labelNames = messageInfo.labelUids.map((uid) => labelNamesByUid.get(uid)).filter((name) => name !== undefined);
+    }
+    let callerAddress = "";
+    if (isCalendarEvent) {
+        if (cache) {
+            if (cache.callerAddress === undefined) {
+                const mailbox = await context.mailboxRepo.findOne(context.mailboxUid, { ignoreACL: true });
+                cache.callerAddress = mailbox?.primarySmtpAddress ?? "";
+            }
+            callerAddress = cache.callerAddress ?? "";
+        }
+        else {
+            const mailbox = await context.mailboxRepo.findOne(context.mailboxUid, { ignoreACL: true });
+            callerAddress = mailbox?.primarySmtpAddress ?? "";
+        }
+    }
+    return columns.map((column) => {
+        if (calendarEventInfo) {
+            return calendarEventValueFor(context.session, column.propertyId, column.propertyType, target, calendarEventInfo, callerAddress);
+        }
+        if (contactInfo) {
+            return contactValueFor(context.session, column.propertyId, column.propertyType, target, contactInfo);
+        }
+        if (taskInfo) {
+            return taskValueFor(context.session, column.propertyId, column.propertyType, target, taskInfo);
+        }
+        if (messageInfo) {
+            return messageValueFor(context.session, column.propertyId, column.propertyType, target, messageInfo, labelNames);
+        }
+        if (isContact || isTask) {
+            // contactRepo/taskRepo absent (see RopHandler.ts's own doc comment on why they're optional) - no
+            // real data to resolve against, so every column degrades to its type-appropriate default rather
+            // than falling through to the folder-info branch below (folderInfo is never populated for these
+            // target prefixes, see above - forcing that branch would throw on the `!` assertion).
+            return defaultValueForType(column.propertyType);
+        }
+        return folderValueFor(context.session, column.propertyId, column.propertyType, target, folderInfo);
+    });
+}
+//# sourceMappingURL=PropertyResolvers.js.map

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

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

package/dist/lib/rop/RopCreateMessageHandler.js

@@ -0,0 +1,53 @@
+const ROP_ID_CREATE_MESSAGE = 0x06;
+/** The well-known MAPI HRESULT `MAPI_E_NOT_FOUND`, reused as this handler's only failure `ReturnValue` - an
+ * unrecognized `FolderId`, the same constant `RopOpenFolderHandler` uses for its own analogous lookup miss. */
+const ERROR_NOT_FOUND = 0x8004010f;
+/**
+ * `RopCreateMessage` (`[MS-OXCMSG]`/`[MS-OXCROPS]`): begins composing a new message in a folder, producing a
+ * new `"message"` Server object handle later ROPs (`RopSetProperties`, `RopOpenStream`, `RopSaveChangesMessage`)
+ * reference by `InputHandleIndex`. Unlike `RopOpenMessage`'s handle (an already-real, already-saved message),
+ * this handle's `entityUid` is deliberately left `""` - there is no real backing `Message` row, and won't be
+ * one until `RopSubmitMessage` actually sends it (this pragmatic subset has no separate Drafts-folder
+ * persistence step; see `RopSaveChangesMessageHandler`'s own doc comment). `draftFolderUid` remembers the
+ * target folder for that eventual send, and `draftProperties` starts empty, filled in by later
+ * `RopSetProperties`/`RopWriteStream` calls.
+ *
+ * `CodePageId` is decoded to advance past it correctly but not otherwise acted on (this pragmatic subset always
+ * encodes strings as UTF-16LE/UTF-8 directly, the same treatment `RopOpenMessageHandler` gives it).
+ * `AssociatedFlag` (FAI messages - hidden configuration/rules objects, not real mail) is decoded but not
+ * honored - this pragmatic subset's compose/send path only ever produces ordinary mail messages.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopCreateMessageHandler {
+    constructor() {
+        this.ropId = ROP_ID_CREATE_MESSAGE;
+    }
+    handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        reader.readUInt8(); // InputHandleIndex - the logon handle this create is performed against; not
+        // separately validated, matching RopOpenFolderHandler's own treatment of its input handle.
+        const outputHandleIndex = reader.readUInt8();
+        reader.readUInt16LE(); // CodePageId - see class doc comment
+        const folderId = reader.readBigUInt64LE();
+        reader.readUInt8(); // AssociatedFlag - see class doc comment
+        const target = context.session.folderIds[folderId.toString()];
+        if (!target) {
+            writer.writeUInt8(ROP_ID_CREATE_MESSAGE);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_NOT_FOUND);
+            return;
+        }
+        context.session.handles[outputHandleIndex] = {
+            type: "message",
+            entityUid: "",
+            draftFolderUid: target,
+            draftProperties: {},
+        };
+        writer.writeUInt8(ROP_ID_CREATE_MESSAGE);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(0); // HasMessageId - no MID is assigned until RopSaveChangesMessage
+    }
+}
+//# sourceMappingURL=RopCreateMessageHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopCreateMessageHandler.js","sourceRoot":"","sources":["../../../src/rop/RopCreateMessageHandler.ts"],"names":[],"mappings":"AAOA,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;+GAC+G;AAC/G,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,uBAAuB;IAApC;QACoB,UAAK,GAAG,qBAAqB,CAAC;IA+BlD,CAAC;IA7BU,MAAM,CAAC,MAAoB,EAAE,MAAoB,EAAE,OAAmB;QACzE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,uFAAuF;QAC3G,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,4EAA4E;QAChG,2FAA2F;QAC3F,MAAM,iBAAiB,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,qCAAqC;QAC5D,MAAM,QAAQ,GAAW,MAAM,CAAC,eAAe,EAAE,CAAC;QAClD,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,yCAAyC;QAE7D,MAAM,MAAM,GAAuB,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;YACtC,OAAO;QACX,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG;YACzC,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,EAAE;YACb,cAAc,EAAE,MAAM;YACtB,eAAe,EAAE,EAAE;SACtB,CAAC;QAEF,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;QACzC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;QACjD,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,gEAAgE;IAC1F,CAAC;CACJ"}

package/dist/lib/rop/RopDeleteFolderHandler.js

@@ -0,0 +1,133 @@
+const ROP_ID_DELETE_FOLDER = 0x1d;
+/** The well-known MAPI HRESULT `MAPI_E_NOT_FOUND`, reused for an unrecognized `FolderId` - the same constant
+ * `RopOpenFolderHandler` uses for its own analogous lookup miss. */
+const ERROR_NOT_FOUND = 0x8004010f;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for both "the referenced handle isn't a folder"
+ * and "the folder has content/subfolders but the matching cascade flag wasn't set" - the same constant reused
+ * throughout this pragmatic subset as a generic "can't do this" signal, not a claim of exact per-condition
+ * `[MS-OXCFOLD]` return-value-table parity (the real spec's own `ecFolderNotEmpty` isn't separately modeled). */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** `DeleteFolderFlags` bits (`[MS-OXCFOLD]` §2.2.1.3.1, confirmed this session). */
+const DEL_MESSAGES = 0x01;
+const DEL_FOLDERS = 0x04;
+const DELETE_HARD_DELETE = 0x10;
+/**
+ * `RopDeleteFolder` (`[MS-OXCFOLD]`/`[MS-OXCROPS]`, RopId `0x1D`): deletes a folder by `FolderId`. Reuses
+ * `RecoverableRepoUtils.delete()` exactly as-built in Phase 2 for `Folder`/`Message`/`CalendarEvent` - see
+ * `RopDeleteMessagesHandler.ts`'s own doc comment for why that matters (EAS's watermark-based incremental
+ * delete detection depends on it).
+ *
+ * **Real spec semantics honored, not simplified away**: per `[MS-OXCFOLD]`, `RopDeleteFolder` only operates on
+ * an empty folder by default - `DEL_MESSAGES` must be set to also delete the folder's own messages/calendar
+ * events/contacts/tasks, and `DEL_FOLDERS` to also delete (recursively) its subfolders; a non-empty folder
+ * deleted without the matching flag fails rather than silently cascading. `DELETE_HARD_DELETE` maps directly
+ * onto `RepoDeleteOptions.purge` - real, exact semantic overlap with this library's own soft-delete model, not
+ * a coincidence this codec papers over.
+ *
+ * **Contacts/Tasks folders**: emptiness is checked against `contactRepo`/`taskRepo` alongside `messageRepo`/
+ * `calendarEventRepo`, and both are included in the delete cascade - a `CONTACTS`/`TASKS` folder's real content
+ * lives in those repos (see `ContactTarget.ts`/`TaskTarget.ts`), not `messageRepo`, so checking only the latter
+ * would let a non-empty Contacts/Tasks folder be deleted without `DEL_MESSAGES` and orphan its rows. Guarded
+ * with `context.contactRepo`/`taskRepo` presence checks the same way `RopGetContentsTableHandler` does, since
+ * `RopContext`'s doc comment documents both as optional.
+ *
+ * The request's own `InputHandleIndex` (nominally the *parent* folder of the one being deleted) is validated to
+ * be a real, open folder handle but not cross-checked against the target folder's actual `parentFolderUid` -
+ * the same pragmatic simplification `RopOpenMessageHandler`'s own doc comment documents for its analogous
+ * `FolderId` field.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopDeleteFolderHandler {
+    constructor() {
+        this.ropId = ROP_ID_DELETE_FOLDER;
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const deleteFolderFlags = reader.readUInt8();
+        const folderId = reader.readBigUInt64LE();
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "folder") {
+            writer.writeUInt8(ROP_ID_DELETE_FOLDER);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const target = context.session.folderIds[folderId.toString()];
+        if (!target?.startsWith("folder:")) {
+            writer.writeUInt8(ROP_ID_DELETE_FOLDER);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_NOT_FOUND);
+            return;
+        }
+        const uid = target.slice("folder:".length);
+        const purge = (deleteFolderFlags & DELETE_HARD_DELETE) !== 0;
+        const messages = await context.messageRepo.find({ folderUid: uid }, { ignoreACL: true });
+        const events = await context.calendarEventRepo.find({ folderUid: uid }, { ignoreACL: true });
+        const contacts = context.contactRepo ? await context.contactRepo.find({ folderUid: uid }, { ignoreACL: true }) : [];
+        const tasks = context.taskRepo ? await context.taskRepo.find({ folderUid: uid }, { ignoreACL: true }) : [];
+        const childFolders = await context.folderRepo.find({ parentFolderUid: uid }, { ignoreACL: true });
+        if ((messages.length > 0 || events.length > 0 || contacts.length > 0 || tasks.length > 0) &&
+            (deleteFolderFlags & DEL_MESSAGES) === 0) {
+            writer.writeUInt8(ROP_ID_DELETE_FOLDER);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        if (childFolders.length > 0 && (deleteFolderFlags & DEL_FOLDERS) === 0) {
+            writer.writeUInt8(ROP_ID_DELETE_FOLDER);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        for (const message of messages) {
+            await context.messageRepo.delete(message.uid, { ignoreACL: true, purge });
+        }
+        for (const event of events) {
+            await context.calendarEventRepo.delete(event.uid, { ignoreACL: true, purge });
+        }
+        for (const contact of contacts) {
+            await context.contactRepo.delete(contact.uid, { ignoreACL: true, purge });
+        }
+        for (const task of tasks) {
+            await context.taskRepo.delete(task.uid, { ignoreACL: true, purge });
+        }
+        for (const childFolder of childFolders) {
+            await this.deleteFolderRecursive(childFolder.uid, context, purge);
+        }
+        await context.folderRepo.delete(uid, { ignoreACL: true, purge });
+        writer.writeUInt8(ROP_ID_DELETE_FOLDER);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(0); // PartialCompletion - always false; a partial failure above already returned early
+    }
+    /** Cascades a `DEL_FOLDERS` delete into `folderUid`'s own messages/calendar events/subfolders before
+     * deleting it - this data model's folder hierarchy is a plain parent-pointer tree (never a graph), so
+     * unbounded recursion here needs no cycle protection, the same assumption `FolderTarget.resolveFolderChildren`
+     * already makes. */
+    async deleteFolderRecursive(folderUid, context, purge) {
+        const messages = await context.messageRepo.find({ folderUid }, { ignoreACL: true });
+        const events = await context.calendarEventRepo.find({ folderUid }, { ignoreACL: true });
+        const contacts = context.contactRepo ? await context.contactRepo.find({ folderUid }, { ignoreACL: true }) : [];
+        const tasks = context.taskRepo ? await context.taskRepo.find({ folderUid }, { ignoreACL: true }) : [];
+        const childFolders = await context.folderRepo.find({ parentFolderUid: folderUid }, { ignoreACL: true });
+        for (const message of messages) {
+            await context.messageRepo.delete(message.uid, { ignoreACL: true, purge });
+        }
+        for (const event of events) {
+            await context.calendarEventRepo.delete(event.uid, { ignoreACL: true, purge });
+        }
+        for (const contact of contacts) {
+            await context.contactRepo.delete(contact.uid, { ignoreACL: true, purge });
+        }
+        for (const task of tasks) {
+            await context.taskRepo.delete(task.uid, { ignoreACL: true, purge });
+        }
+        for (const childFolder of childFolders) {
+            await this.deleteFolderRecursive(childFolder.uid, context, purge);
+        }
+        await context.folderRepo.delete(folderUid, { ignoreACL: true, purge });
+    }
+}
+//# sourceMappingURL=RopDeleteFolderHandler.js.map

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

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

package/dist/lib/rop/RopDeleteMessagesHandler.js

@@ -0,0 +1,70 @@
+const ROP_ID_DELETE_MESSAGES = 0x1e;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a folder (or
+ * doesn't exist)" - the same constant `RopGetContentsTableHandler` uses for its own analogous check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/**
+ * `RopDeleteMessages` (`[MS-OXCMSG]`/`[MS-OXCROPS]`, RopId `0x1E`): deletes one or more messages by `MessageId`
+ * from an already-open folder handle. Reuses `RecoverableRepoUtils.delete()` exactly as-built in Phase 2 - the
+ * same soft-delete-with-watermark-bump machinery EAS's own `Sync`/`FolderSync` incremental-delete detection
+ * already relies on (see `BaseMapiEmsmdbRoute.ts`'s own doc comment for why `folderRepo`/`messageRepo`/
+ * `calendarEventRepo` are built as `RecoverableRepoUtils`, not plain `RepoUtils`) - no new deletion-tracking
+ * code, zero duplication.
+ *
+ * A `MessageId` resolves via `session.messageIds` (`MessageTarget.assignOrGetMid`'s own registry, already
+ * generic over both `"message:<uid>"` and `"calendarEvent:<uid>"` target strings, since a Calendar item is
+ * itself a Message object on the wire - see `CalendarEventTarget.ts`'s own doc comment) directly to the entity
+ * to delete, the same "the session already knows what this small integer refers to" design every other MID-
+ * consuming ROP in this pragmatic subset already uses (`RopOpenMessage`, `RopSaveChangesMessage`) - the
+ * request's own `InputHandleIndex` (nominally the messages' shared parent folder) is validated to be a real,
+ * open folder handle but not cross-checked against each message's actual `folderUid`, the same pragmatic
+ * simplification `RopOpenMessageHandler`'s own doc comment documents for its analogous `FolderId` field.
+ *
+ * `WantAsynchronous` (`RopProgress`-reported async completion) and `NotifyNonRead` (non-read-receipt generation
+ * to the original sender) are decoded to advance the reader correctly but not honored - this pragmatic subset
+ * has no async-ROP or non-read-receipt machinery. `PartialCompletion` is reported `true` if any requested
+ * `MessageId` didn't resolve to a real message/calendar-event target - the rest are still deleted, matching
+ * this pragmatic subset's "don't fail the whole ROP over one stale reference" principle used throughout.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopDeleteMessagesHandler {
+    constructor() {
+        this.ropId = ROP_ID_DELETE_MESSAGES;
+    }
+    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(); // WantAsynchronous - no RopProgress/async-ROP support in this pragmatic subset
+        reader.readUInt8(); // NotifyNonRead - no non-read-receipt generation support
+        const messageIdCount = reader.readUInt16LE();
+        const messageIds = [];
+        for (let i = 0; i < messageIdCount; i++) {
+            messageIds.push(reader.readBigUInt64LE());
+        }
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "folder") {
+            writer.writeUInt8(ROP_ID_DELETE_MESSAGES);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        let partialCompletion = false;
+        for (const messageId of messageIds) {
+            const target = context.session.messageIds[messageId.toString()];
+            if (target?.startsWith("message:")) {
+                await context.messageRepo.delete(target.slice("message:".length), { ignoreACL: true });
+            }
+            else if (target?.startsWith("calendarEvent:")) {
+                await context.calendarEventRepo.delete(target.slice("calendarEvent:".length), { ignoreACL: true });
+            }
+            else {
+                partialCompletion = true;
+            }
+        }
+        writer.writeUInt8(ROP_ID_DELETE_MESSAGES);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(partialCompletion ? 1 : 0); // PartialCompletion
+    }
+}
+//# sourceMappingURL=RopDeleteMessagesHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopDeleteMessagesHandler.js","sourceRoot":"","sources":["../../../src/rop/RopDeleteMessagesHandler.ts"],"names":[],"mappings":"AAOA,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC;wGACwG;AACxG,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,wBAAwB;IAArC;QACoB,UAAK,GAAG,sBAAsB,CAAC;IAsCnD,CAAC;IApCU,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,+EAA+E;QACnG,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,yDAAyD;QAC7E,MAAM,cAAc,GAAW,MAAM,CAAC,YAAY,EAAE,CAAC;QACrD,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;YAC1C,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAC9B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACjC,MAAM,MAAM,GAAuB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;YACpF,IAAI,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjC,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3F,CAAC;iBAAM,IAAI,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC9C,MAAM,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvG,CAAC;iBAAM,CAAC;gBACJ,iBAAiB,GAAG,IAAI,CAAC;YAC7B,CAAC;QACL,CAAC;QAED,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;QACjD,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB;IACtE,CAAC;CACJ"}