@rapidmx/mapi-plugin 1.0.0-beta.3

package/dist/lib/rop/RopSubmitMessageHandler.js

@@ -0,0 +1,314 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import * as crypto from "crypto";
+import MailComposer from "nodemailer/lib/mail-composer/index.js";
+import { findOrCreateWellKnownFolder, FolderType, MessageImportance, RecipientType, scanAndRelay, } from "@rapidmx/restapi";
+import { submitMeetingResponse } from "./MeetingMessageClassHandler.js";
+const ROP_ID_SUBMIT_MESSAGE = 0x32;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for both "the referenced handle isn't a draft
+ * message" and "the draft has no resolvable recipients/sender" - the same constant reused throughout this
+ * pragmatic subset as a generic "can't do this" signal, not a claim of exact per-condition `[MS-OXCRPC]`
+ * return-value-table parity. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+// 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_BCC = 0x0e02;
+const PID_TAG_DISPLAY_CC = 0x0e03;
+const PID_TAG_DISPLAY_TO = 0x0e04;
+const PID_TAG_BODY = 0x1000;
+const PID_TAG_READ_RECEIPT_REQUESTED = 0x0029;
+const PID_TAG_DEFERRED_SEND_TIME = 0x3fef;
+/** `PidTagMessageClass` values starting with this prefix (`IPM.Appointment`, `IPM.Appointment.*`) route through
+ * `submitAppointment()` instead of the ordinary mail compose/send path below - see that method's own doc
+ * comment. */
+const MESSAGE_CLASS_APPOINTMENT_PREFIX = "IPM.Appointment";
+/** `PidTagMessageClass` values starting with this prefix (`IPM.Schedule.Meeting.Resp.{Pos,Neg,Tent}`) route
+ * through `MeetingMessageClassHandler.submitMeetingResponse()` instead of every other path here - see that
+ * function's own doc comment. */
+const MESSAGE_CLASS_MEETING_RESPONSE_PREFIX = "IPM.Schedule.Meeting.Resp.";
+/** Splits a `PidTagDisplayTo`/`Cc`/`Bcc`-style string on the semicolons real Outlook separates recipients
+ * with (also tolerating commas, in case a client or test harness uses that convention instead), trimming and
+ * dropping empty entries. Exported since `RopSaveChangesMessageHandler.ts` reads the same accumulated
+ * `PidTagDisplayTo`/`Cc` draft properties to build a Calendar item's attendee list. */
+export function parseAddressList(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(/[;,]/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+/**
+ * `RopSubmitMessage` (`[MS-OXOMSG]`/`[MS-OXCROPS]`): sends a composed message - the actual trigger point for
+ * this pragmatic subset's compose/send pipeline, since `RopSaveChangesMessage` itself does no real persistence
+ * (see its own doc comment). Builds a raw MIME buffer from whatever `RopSetProperties`/`RopWriteStream` calls
+ * accumulated on the draft handle (`Subject`, the `PidTagBody` stream or an inline `PidTagBody` property, and
+ * addressing - see below), via `nodemailer`'s `MailComposer` (already a dependency, used elsewhere in this
+ * library only to *send*, not build, MIME - this is its first use purely as a RFC 5322 serializer), then calls
+ * the exact same `scanAndRelay()` scan-then-relay pipeline `BaseMessageRoute.send()`/EAS's `ComposeMailCommand`
+ * already share, and persists a Sent Items copy (mirroring `ComposeMailCommand`'s own always-committed Sent
+ * Items behavior for MAPI submission specifically, since - unlike EAS's optional `SaveInSentItems` - a MAPI
+ * `RopSubmitMessage` call has no "don't keep a copy" option to honor).
+ *
+ * **Known, deliberate limitation - no `RopModifyRecipients` support**: real recipient rows (`[MS-OXCMSG]`
+ * §2.2.3.2, each with its own `PidTagEmailAddress`/`PidTagRecipientType`) are a substantial structure this
+ * pragmatic subset's ROP coverage doesn't include. Instead, addressing is read from `PidTagDisplayTo`/
+ * `DisplayCc`/`DisplayBcc` - the same semicolon-separated "cached recipient display string" properties real
+ * Outlook *also* always sets via `RopSetProperties` alongside `RopModifyRecipients` (as a display-only
+ * convenience cache). This works correctly for the common case of composing to bare, unresolved email
+ * addresses (nothing to resolve to a distinct display name) - the case this library's own integration tests
+ * exercise - but is **not** a substitute for real recipient rows: a client that resolves typed names against an
+ * address book before submitting would populate these fields with display names, not addresses, and this
+ * pragmatic subset has no way to recover a real SMTP address from a bare display name. Documented here rather
+ * than silently producing wrong addressing.
+ *
+ * `SubmitFlags` (`PreprocessOnly`, ...) is decoded to advance past it correctly but not honored - this
+ * pragmatic subset has no transport-agent preprocessing distinction to vary by flag.
+ *
+ * **`PidTagDeferredSendTime`** ("Do not deliver before"), if set to a future time via `RopSetProperties`,
+ * parks the message in Outbox with `Message.scheduledSendTime` set instead of relaying immediately - mirroring
+ * `BaseMessageRoute.send()`'s own identical branch - for `ScheduledSendJob` to relay later via this same
+ * `scanAndRelay()` pipeline. **`PidTagReadReceiptRequested`**, if `true`, attaches a real
+ * `Disposition-Notification-To` header (see `util/ReceiptUtils.ts`) and is recorded on the persisted message's
+ * own `requestReceipt` field - honored only when the client explicitly sets it, not this mailbox's
+ * `alwaysRequestReceiptInternal`/`External` defaults (those apply to the REST/webmail compose path only).
+ *
+ * **Calendar branches**: a draft whose `PidTagMessageClass` starts with `"IPM.Appointment"` is routed to
+ * `submitAppointment()` instead of the mail path below - see that method's own doc comment. One starting with
+ * `"IPM.Schedule.Meeting.Resp."` (an attendee's own accept/decline/tentative response to a meeting this server
+ * previously invited them to) is routed to `MeetingMessageClassHandler.submitMeetingResponse()` instead - see
+ * that function's own doc comment.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopSubmitMessageHandler {
+    constructor() {
+        this.ropId = ROP_ID_SUBMIT_MESSAGE;
+    }
+    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(); // SubmitFlags - see class doc comment
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "message") {
+            writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const properties = handle.draftProperties ?? {};
+        const messageClass = properties[String(PID_TAG_MESSAGE_CLASS)] ?? "IPM.Note";
+        if (messageClass.startsWith(MESSAGE_CLASS_APPOINTMENT_PREFIX)) {
+            await this.submitAppointment(handle, context, writer, inputHandleIndex);
+            return;
+        }
+        if (messageClass.startsWith(MESSAGE_CLASS_MEETING_RESPONSE_PREFIX)) {
+            await submitMeetingResponse(messageClass, properties, context);
+            writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(0); // ReturnValue - success, see MeetingMessageClassHandler's own doc comment
+            // on why every failure mode there is a silent no-op rather than surfaced here.
+            return;
+        }
+        const to = parseAddressList(properties[String(PID_TAG_DISPLAY_TO)]);
+        const cc = parseAddressList(properties[String(PID_TAG_DISPLAY_CC)]);
+        const bcc = parseAddressList(properties[String(PID_TAG_DISPLAY_BCC)]);
+        const mailbox = await context.mailboxRepo.findOne(context.mailboxUid, { ignoreACL: true });
+        const envelopeFrom = mailbox?.primarySmtpAddress;
+        if (!envelopeFrom || to.length + cc.length + bcc.length === 0) {
+            writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const subject = properties[String(PID_TAG_SUBJECT)] ?? "";
+        const bodyText = resolveDraftBody(context, inputHandleIndex, properties);
+        const requestReceipt = properties[String(PID_TAG_READ_RECEIPT_REQUESTED)] === "true";
+        // "Do not deliver before" - a real Outlook compose option, tracked as a plain ISO-8601 string by
+        // RopSetPropertiesHandler.stringifyValue()'s PtypTime encoding.
+        const deferredSendTimeRaw = properties[String(PID_TAG_DEFERRED_SEND_TIME)];
+        const deferredSendTime = deferredSendTimeRaw ? new Date(deferredSendTimeRaw) : undefined;
+        const isDeferred = deferredSendTime !== undefined && deferredSendTime.getTime() > Date.now();
+        const raw = await new MailComposer({
+            from: envelopeFrom,
+            to,
+            cc,
+            bcc,
+            subject,
+            text: bodyText,
+            // A real Disposition-Notification-To request, mirroring BaseMessageRoute.send()'s own explicit
+            // Message.requestReceipt handling (see util/ReceiptUtils.ts) - honored here only when the client
+            // itself asked for one via PidTagReadReceiptRequested, not this mailbox's own
+            // alwaysRequestReceiptInternal/External defaults (those apply to the REST/webmail compose path,
+            // which already goes through BaseMessageRoute.send() directly).
+            ...(requestReceipt ? { headers: [{ key: "Disposition-Notification-To", value: envelopeFrom }] } : {}),
+        })
+            .compile()
+            .build();
+        const envelopeTo = [...to, ...cc, ...bcc];
+        const bodyBlobKey = `bodies/${crypto.randomUUID()}`;
+        const recipients = [
+            ...to.map((address) => ({ address, type: RecipientType.TO })),
+            ...cc.map((address) => ({ address, type: RecipientType.CC })),
+            ...bcc.map((address) => ({ address, type: RecipientType.BCC })),
+        ];
+        if (isDeferred) {
+            // Mirrors BaseMessageRoute.send()'s own scheduledSendTime branch: park the message in Outbox,
+            // unscanned/unrelayed, for the same ScheduledSendJob to pick up and relay (via this exact
+            // scanAndRelay() pipeline) once due - see that job's own doc comment.
+            await context.blobStore.put(bodyBlobKey, raw, { contentType: "message/rfc822" });
+            const outbox = await findOrCreateWellKnownFolder(context.folderRepo, context.folderClass, context.mailboxUid, FolderType.OUTBOX);
+            await context.messageRepo.create(new context.messageClass({
+                folderUid: outbox.uid,
+                mailboxUid: context.mailboxUid,
+                messageId: `${crypto.randomUUID()}@mapi`,
+                subject,
+                from: { address: envelopeFrom, type: RecipientType.TO },
+                recipients,
+                sentDate: new Date(),
+                receivedDate: new Date(),
+                bodyBlobKey,
+                bodyPreview: bodyText.slice(0, 200),
+                flags: { read: true, flagged: false, answered: false, forwarded: false },
+                importance: MessageImportance.NORMAL,
+                references: [],
+                hasAttachments: false,
+                scheduledSendTime: deferredSendTime,
+                requestReceipt,
+            }), { ignoreACL: true });
+            writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(0); // ReturnValue - success
+            return;
+        }
+        const { sanitizedHtmlBlobKey } = await scanAndRelay(raw, envelopeFrom, envelopeTo, context.scanPipeline, context.mailTransport, context.blobStore);
+        await context.blobStore.put(bodyBlobKey, raw, { contentType: "message/rfc822" });
+        const sentFolder = await findOrCreateWellKnownFolder(context.folderRepo, context.folderClass, context.mailboxUid, FolderType.SENT_ITEMS);
+        await context.messageRepo.create(new context.messageClass({
+            folderUid: sentFolder.uid,
+            mailboxUid: context.mailboxUid,
+            messageId: `${crypto.randomUUID()}@mapi`,
+            subject,
+            from: { address: envelopeFrom, type: RecipientType.TO },
+            recipients,
+            sentDate: new Date(),
+            receivedDate: new Date(),
+            bodyBlobKey,
+            sanitizedHtmlBlobKey,
+            bodyPreview: bodyText.slice(0, 200),
+            flags: { read: true, flagged: false, answered: false, forwarded: false },
+            importance: MessageImportance.NORMAL,
+            references: [],
+            hasAttachments: false,
+            requestReceipt,
+        }), { ignoreACL: true });
+        writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+    }
+    /**
+     * Submits a Calendar item. The appointment itself is already persisted (`RopSaveChangesMessageHandler`
+     * writes the real `CalendarEvent` row at Save time, unlike a mail draft, which stays purely in-session until
+     * Submit) - this method's only job is notifying attendees, if any were set (via `PidTagDisplayTo`/`Cc`,
+     * decoded into `CalendarEvent.attendees` at Save time). No attendees means no invite to send (e.g. a private,
+     * non-meeting appointment) - a well-formed success response either way, since the appointment already exists.
+     *
+     * Unlike ordinary mail, there is no separate "Sent Items copy" to create - the appointment's durable copy
+     * *is* the `CalendarEvent` row already sitting in the organizer's own Calendar folder.
+     *
+     * The invite itself is a minimal iCalendar (`RFC 5545`) `VEVENT` with `METHOD:REQUEST` (`RFC 5546`),
+     * attached via `nodemailer`'s own `MailComposer` `icalEvent` option (which produces both a `text/calendar;
+     * method=REQUEST` MIME alternative and an `.ics` attachment - the standard dual form real invite emails use)
+     * - reusing the identical `scanAndRelay()` pipeline the mail path above already calls.
+     */
+    async submitAppointment(handle, context, writer, inputHandleIndex) {
+        const uid = handle.entityUid.startsWith("calendarEvent:") ? handle.entityUid.slice("calendarEvent:".length) : undefined;
+        const event = uid ? await context.calendarEventRepo.findOne(uid, { ignoreACL: true }) : undefined;
+        if (!event) {
+            writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        if (event.attendees.length > 0) {
+            const mailbox = await context.mailboxRepo.findOne(context.mailboxUid, { ignoreACL: true });
+            const envelopeFrom = mailbox?.primarySmtpAddress;
+            if (envelopeFrom) {
+                const attendeeAddresses = event.attendees.map((attendee) => attendee.address);
+                const ics = buildMeetingRequestIcs(event, envelopeFrom);
+                const raw = await new MailComposer({
+                    from: envelopeFrom,
+                    to: attendeeAddresses,
+                    subject: event.title,
+                    text: `You have been invited to: ${event.title}`,
+                    icalEvent: { method: "REQUEST", content: ics },
+                })
+                    .compile()
+                    .build();
+                await scanAndRelay(raw, envelopeFrom, attendeeAddresses, context.scanPipeline, context.mailTransport, context.blobStore);
+            }
+        }
+        writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+    }
+}
+/** `YYYYMMDDTHHMMSSZ` - the `RFC 5545` "form 2" (UTC) `DATE-TIME` format every field below uses. */
+function formatIcsDateUtc(date) {
+    return date.toISOString().replace(/[-:]/g, "").split(".")[0] + "Z";
+}
+/** Escapes the `RFC 5545` §3.3.11 `TEXT` value special characters (backslash, semicolon, comma, newline) - the
+ * only value types this minimal builder ever emits unescaped text into (`SUMMARY`/`LOCATION`). */
+function escapeIcsText(value) {
+    return value.replace(/\\/g, "\\\\").replace(/;/g, "\\;").replace(/,/g, "\\,").replace(/\r?\n/g, "\\n");
+}
+/**
+ * Builds a minimal `RFC 5545`/`RFC 5546` `METHOD:REQUEST` iCalendar document for `event`. Deliberately not a
+ * general-purpose iCalendar writer (see `AutodiscoverXml.ts`'s own doc comment for the same "hand-build just
+ * the fields this pass needs" precedent) - no `RRULE` (recurring meeting invites are a documented gap, same as
+ * this pragmatic subset's other recurrence-adjacent limitations), no line-folding at the 75-octet boundary
+ * `RFC 5545` §3.1 technically requires (every field emitted here is short enough in practice that folding would
+ * never trigger), no `VTIMEZONE` block (times are always emitted as UTC `Z`-suffixed values instead).
+ */
+function buildMeetingRequestIcs(event, organizerAddress) {
+    const lines = [
+        "BEGIN:VCALENDAR",
+        "PRODID:-//RapidREST//Mail//EN",
+        "VERSION:2.0",
+        "METHOD:REQUEST",
+        "BEGIN:VEVENT",
+        `UID:${event.icalUid}`,
+        `SEQUENCE:${event.sequence}`,
+        `DTSTAMP:${formatIcsDateUtc(new Date())}`,
+        `DTSTART:${formatIcsDateUtc(event.startDate)}`,
+        `DTEND:${formatIcsDateUtc(event.endDate)}`,
+        `SUMMARY:${escapeIcsText(event.title)}`,
+        ...(event.location ? [`LOCATION:${escapeIcsText(event.location)}`] : []),
+        `ORGANIZER:mailto:${organizerAddress}`,
+        ...event.attendees.map((attendee) => `ATTENDEE;RSVP=TRUE:mailto:${attendee.address}`),
+        "STATUS:CONFIRMED",
+        "END:VEVENT",
+        "END:VCALENDAR",
+    ];
+    return lines.join("\r\n");
+}
+/** Prefers a `RopWriteStream`-accumulated body (the real path a large body takes) over an inline `PidTagBody`
+ * set directly via `RopSetProperties` (only realistic for a short body small enough to set inline) - see
+ * `RopOpenStreamHandler`'s write-mode branch for how `writeTargetHandleIndex` links a stream handle back to the
+ * draft message handle it was opened against. */
+function resolveDraftBody(context, messageHandleIndex, properties) {
+    for (const candidate of Object.values(context.session.handles)) {
+        if (candidate.type === "stream" && candidate.writeTargetHandleIndex === messageHandleIndex && candidate.writeBufferBase64) {
+            const raw = Buffer.from(candidate.writeBufferBase64, "base64");
+            return raw.toString("utf16le").replace(/\0+$/, "");
+        }
+    }
+    return properties[String(PID_TAG_BODY)] ?? "";
+}
+//# sourceMappingURL=RopSubmitMessageHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopSubmitMessageHandler.js","sourceRoot":"","sources":["../../../src/rop/RopSubmitMessageHandler.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,YAAY,MAAM,uCAAuC,CAAC;AACjE,OAAO,EACH,2BAA2B,EAC3B,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,GAEf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;gCAGgC;AAChC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,2GAA2G;AAC3G,+GAA+G;AAC/G,cAAc;AACd,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,qBAAqB,GAAG,MAAM,CAAC;AACrC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAC9C,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAE1C;;cAEc;AACd,MAAM,gCAAgC,GAAG,iBAAiB,CAAC;AAE3D;;iCAEiC;AACjC,MAAM,qCAAqC,GAAG,4BAA4B,CAAC;AAE3E;;;uFAGuF;AACvF,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,KAAK;SACP,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,OAAO,uBAAuB;IAApC;QACoB,UAAK,GAAG,qBAAqB,CAAC;IA8LlD,CAAC;IA5LU,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,sCAAsC;QAE1D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;QAChD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,UAAU,CAAC;QAC7E,IAAI,YAAY,CAAC,UAAU,CAAC,gCAAgC,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;YACxE,OAAO;QACX,CAAC;QACD,IAAI,YAAY,CAAC,UAAU,CAAC,qCAAqC,CAAC,EAAE,CAAC;YACjE,MAAM,qBAAqB,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,0EAA0E;YACnG,+EAA+E;YAC/E,OAAO;QACX,CAAC;QAED,MAAM,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3F,MAAM,YAAY,GAAuB,OAAO,EAAE,kBAAkB,CAAC;QAErE,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;QACzE,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC,KAAK,MAAM,CAAC;QACrF,iGAAiG;QACjG,gEAAgE;QAChE,MAAM,mBAAmB,GAAG,UAAU,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAC;QAC3E,MAAM,gBAAgB,GAAqB,mBAAmB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3G,MAAM,UAAU,GAAG,gBAAgB,KAAK,SAAS,IAAI,gBAAgB,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7F,MAAM,GAAG,GAAW,MAAM,IAAI,YAAY,CAAC;YACvC,IAAI,EAAE,YAAY;YAClB,EAAE;YACF,EAAE;YACF,GAAG;YACH,OAAO;YACP,IAAI,EAAE,QAAQ;YACd,+FAA+F;YAC/F,iGAAiG;YACjG,8EAA8E;YAC9E,gGAAgG;YAChG,gEAAgE;YAChE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,6BAA6B,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxG,CAAC;aACG,OAAO,EAAE;aACT,KAAK,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,CAAC;QAE1C,MAAM,WAAW,GAAG,UAAU,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG;YACf,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7D,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7D,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;SAClE,CAAC;QAEF,IAAI,UAAU,EAAE,CAAC;YACb,8FAA8F;YAC9F,0FAA0F;YAC1F,sEAAsE;YACtE,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YACjI,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAC5B,IAAI,OAAO,CAAC,YAAY,CAAC;gBACrB,SAAS,EAAE,MAAM,CAAC,GAAG;gBACrB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,SAAS,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO;gBACxC,OAAO;gBACP,IAAI,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE;gBACvD,UAAU;gBACV,QAAQ,EAAE,IAAI,IAAI,EAAE;gBACpB,YAAY,EAAE,IAAI,IAAI,EAAE;gBACxB,WAAW;gBACX,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBACnC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;gBACxE,UAAU,EAAE,iBAAiB,CAAC,MAAM;gBACpC,UAAU,EAAE,EAAE;gBACd,cAAc,EAAE,KAAK;gBACrB,iBAAiB,EAAE,gBAAgB;gBACnC,cAAc;aACjB,CAAC,EACF,EAAE,SAAS,EAAE,IAAI,EAAE,CACtB,CAAC;YAEF,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;YACjD,OAAO;QACX,CAAC;QAED,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAEnJ,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACjF,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QACzI,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAC5B,IAAI,OAAO,CAAC,YAAY,CAAC;YACrB,SAAS,EAAE,UAAU,CAAC,GAAG;YACzB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,SAAS,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO;YACxC,OAAO;YACP,IAAI,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE;YACvD,UAAU;YACV,QAAQ,EAAE,IAAI,IAAI,EAAE;YACpB,YAAY,EAAE,IAAI,IAAI,EAAE;YACxB,WAAW;YACX,oBAAoB;YACpB,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YACnC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;YACxE,UAAU,EAAE,iBAAiB,CAAC,MAAM;YACpC,UAAU,EAAE,EAAE;YACd,cAAc,EAAE,KAAK;YACrB,cAAc;SACjB,CAAC,EACF,EAAE,SAAS,EAAE,IAAI,EAAE,CACtB,CAAC;QAEF,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;QACzC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;IACrD,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACK,KAAK,CAAC,iBAAiB,CAAC,MAAwB,EAAE,OAAmB,EAAE,MAAoB,EAAE,gBAAwB;QACzH,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxH,MAAM,KAAK,GAA8B,GAAG,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7H,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3F,MAAM,YAAY,GAAuB,OAAO,EAAE,kBAAkB,CAAC;YACrE,IAAI,YAAY,EAAE,CAAC;gBACf,MAAM,iBAAiB,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC9E,MAAM,GAAG,GAAG,sBAAsB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;gBACxD,MAAM,GAAG,GAAW,MAAM,IAAI,YAAY,CAAC;oBACvC,IAAI,EAAE,YAAY;oBAClB,EAAE,EAAE,iBAAiB;oBACrB,OAAO,EAAE,KAAK,CAAC,KAAK;oBACpB,IAAI,EAAE,6BAA6B,KAAK,CAAC,KAAK,EAAE;oBAChD,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE;iBACjD,CAAC;qBACG,OAAO,EAAE;qBACT,KAAK,EAAE,CAAC;gBACb,MAAM,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,iBAAiB,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7H,CAAC;QACL,CAAC;QAED,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;QACzC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;IACrD,CAAC;CACJ;AAED,oGAAoG;AACpG,SAAS,gBAAgB,CAAC,IAAU;IAChC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AACvE,CAAC;AAED;kGACkG;AAClG,SAAS,aAAa,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAAC,KAAoB,EAAE,gBAAwB;IAC1E,MAAM,KAAK,GAAG;QACV,iBAAiB;QACjB,+BAA+B;QAC/B,aAAa;QACb,gBAAgB;QAChB,cAAc;QACd,OAAO,KAAK,CAAC,OAAO,EAAE;QACtB,YAAY,KAAK,CAAC,QAAQ,EAAE;QAC5B,WAAW,gBAAgB,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE;QACzC,WAAW,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;QAC9C,SAAS,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;QAC1C,WAAW,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACvC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,oBAAoB,gBAAgB,EAAE;QACtC,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,6BAA6B,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrF,kBAAkB;QAClB,YAAY;QACZ,eAAe;KAClB,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED;;;iDAGiD;AACjD,SAAS,gBAAgB,CAAC,OAAmB,EAAE,kBAA0B,EAAE,UAAkC;IACzG,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,sBAAsB,KAAK,kBAAkB,IAAI,SAAS,CAAC,iBAAiB,EAAE,CAAC;YACxH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;YAC/D,OAAO,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;IACL,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/lib/rop/RopWriteStreamHandler.js

@@ -0,0 +1,45 @@
+const ROP_ID_WRITE_STREAM = 0x2d;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a write-mode
+ * stream (or doesn't exist)" - the same constant `RopReadStreamHandler` uses for its own analogous check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/**
+ * `RopWriteStream` (`[MS-OXCPRPT]`/`[MS-OXCROPS]`): writes bytes to a stream opened in `ReadWrite`/`Create`
+ * mode (`RopOpenStreamHandler`'s write-mode branch - the only kind of writable stream this pragmatic subset
+ * ever produces, always a `RopCreateMessage` draft's `PidTagBody`). Accumulates `Data` into the stream handle's
+ * `writeBufferBase64` field, decode-concat-reencode each call rather than a naive string concatenation of
+ * per-call base64 chunks - base64 is not concatenation-safe (a chunk's padding only belongs at the true end of
+ * the data), so reassembling the real bytes requires decoding what's accumulated so far, appending the new raw
+ * bytes, and re-encoding the whole thing. `RopSaveChangesMessageHandler`/`RopSubmitMessageHandler` decode this
+ * buffer back to the final body text once composing is complete.
+ *
+ * Like `RopReadStream`, `[MS-OXCROPS]` documents only one combined response-buffer shape for this ROP (no
+ * separate Success/Failure pages) - `WrittenSize` is always present, `0` standing in for the failure case.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopWriteStreamHandler {
+    constructor() {
+        this.ropId = ROP_ID_WRITE_STREAM;
+    }
+    handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const dataSize = reader.readUInt16LE();
+        const data = reader.readBytes(dataSize);
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "stream" || handle.writeTargetHandleIndex === undefined) {
+            writer.writeUInt8(ROP_ID_WRITE_STREAM);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            writer.writeUInt16LE(0); // WrittenSize - see class doc comment on why this is still written on failure
+            return;
+        }
+        const existing = handle.writeBufferBase64 ? Buffer.from(handle.writeBufferBase64, "base64") : Buffer.alloc(0);
+        handle.writeBufferBase64 = Buffer.concat([existing, data]).toString("base64");
+        writer.writeUInt8(ROP_ID_WRITE_STREAM);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt16LE(data.length); // WrittenSize
+    }
+}
+//# sourceMappingURL=RopWriteStreamHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopWriteStreamHandler.js","sourceRoot":"","sources":["../../../src/rop/RopWriteStreamHandler.ts"],"names":[],"mappings":"AAOA,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;6GAC6G;AAC7G,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,qBAAqB;IAAlC;QACoB,UAAK,GAAG,mBAAmB,CAAC;IAyBhD,CAAC;IAvBU,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,QAAQ,GAAW,MAAM,CAAC,YAAY,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAW,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;YACrF,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YACvC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,8EAA8E;YACvG,OAAO;QACX,CAAC;QAED,MAAM,QAAQ,GAAW,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtH,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE9E,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QACvC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;QACjD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc;IACrD,CAAC;CACJ"}

package/dist/lib/rop/TaskNamedProperties.js

@@ -0,0 +1,29 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+/**
+ * The Task named-property identity table (`(PropertySet GUID, LID)` pairs) this pragmatic subset supports, per
+ * `[MS-OXPROPS]`/`[MS-OXOTASK]` - the exact `CalendarNamedProperties.ts` precedent, adapted for `PSETID_Task`,
+ * shared by `PropertyResolvers.ts` (the read side: `taskValueFor`). Read-only in this pass - see
+ * `TaskTarget.ts`'s own doc comment for why there's no write-side (`RopSetProperties`/`RopSaveChangesMessage`)
+ * counterpart yet.
+ */
+export const PSETID_TASK = "00062003-0000-0000-c000-000000000046";
+/** `PidLidTaskStatus` (`PT_LONG`) - `[MS-OXOTASK]` §2.2.2.1.5's own `olTaskNotStarted`(0)/`olTaskInProgress`(1)/
+ * `olTaskComplete`(2)/`olTaskWaiting`(3)/`olTaskDeferred`(4) values. This data model's `Task.completed` is a
+ * plain boolean with no in-progress/waiting/deferred distinction, so only `olTaskNotStarted`/`olTaskComplete`
+ * are ever produced - a documented, harmless approximation, the same category as `CalendarNamedProperties.ts`'s
+ * own `olWorkingElsewhere` gap. */
+export const LID_TASK_STATUS = 0x8101;
+export const TASK_STATUS_NOT_STARTED = 0;
+export const TASK_STATUS_COMPLETE = 2;
+/** `PidLidPercentComplete` (`PT_R8`, `[MS-OXOTASK]` §2.2.2.1.6) - `0.0`-`1.0`. No partial-progress tracking in
+ * this data model either, so this is always `1.0` (complete) or `0.0` (not started), mirroring
+ * `LID_TASK_STATUS`'s own two-value approximation. */
+export const LID_PERCENT_COMPLETE = 0x8102;
+/** `PidLidTaskDueDate` (`PT_SYSTIME`, `[MS-OXOTASK]` §2.2.2.2.4). */
+export const LID_TASK_DUE_DATE = 0x8105;
+/** `PidLidTaskComplete` (`PT_BOOLEAN`, `[MS-OXOTASK]` §2.2.2.1.9) - maps directly to `Task.completed`. */
+export const LID_TASK_COMPLETE = 0x811c;
+//# sourceMappingURL=TaskNamedProperties.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskNamedProperties.js","sourceRoot":"","sources":["../../../src/rop/TaskNamedProperties.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAElE;;;;mCAImC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AACtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC;;sDAEsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE3C,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAExC,0GAA0G;AAC1G,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC"}

package/dist/lib/rop/TaskTarget.js

@@ -0,0 +1,19 @@
+/** Degrades to empty-looking values for a `"task:<uid>"` target whose real `Task` has since vanished
+ * (soft-deleted or otherwise) - the same "don't fail the whole ROP over one stale row" principle
+ * `MessageTarget.resolveMessageInfo`/`ContactTarget.resolveContactInfo` already apply. */
+export async function resolveTaskInfo(target, taskRepo) {
+    const uid = target.slice("task:".length);
+    const task = await taskRepo.findOne(uid, { ignoreACL: true });
+    return {
+        title: task?.title ?? "",
+        completed: task?.completed ?? false,
+        dueDate: task?.dueDate,
+    };
+}
+/** Resolves the tasks directly in `folderUid`, as `"task:<uid>"` target strings, for `RopGetContentsTable`
+ * against a `TASKS`-type folder. */
+export async function resolveFolderTasks(folderUid, taskRepo) {
+    const tasks = await taskRepo.find({ folderUid }, { ignoreACL: true });
+    return tasks.map((t) => `task:${t.uid}`);
+}
+//# sourceMappingURL=TaskTarget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskTarget.js","sourceRoot":"","sources":["../../../src/rop/TaskTarget.ts"],"names":[],"mappings":"AAwBA;;0FAE0F;AAC1F,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,QAAwB;IAC1E,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,IAAI,GAAqB,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,OAAO;QACH,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;QACxB,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,KAAK;QACnC,OAAO,EAAE,IAAI,EAAE,OAAO;KACzB,CAAC;AACN,CAAC;AAED;oCACoC;AACpC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAwB;IAChF,MAAM,KAAK,GAAW,MAAM,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/lib/sql/MapiEmsmdbRouteSQL.js

@@ -0,0 +1,84 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { CalendarEventSQL, ContactSQL, FolderSQL, LabelSQL, MailboxSQL, MessageSQL, TaskSQL } from "@rapidmx/restapi/sql";
+import { BaseMapiEmsmdbRoute } from "../BaseMapiEmsmdbRoute.js";
+import { RopLogonHandler } from "../rop/RopLogonHandler.js";
+import { RopReleaseHandler } from "../rop/RopReleaseHandler.js";
+import { RopOpenFolderHandler } from "../rop/RopOpenFolderHandler.js";
+import { RopGetHierarchyTableHandler } from "../rop/RopGetHierarchyTableHandler.js";
+import { RopGetContentsTableHandler } from "../rop/RopGetContentsTableHandler.js";
+import { RopSetColumnsHandler } from "../rop/RopSetColumnsHandler.js";
+import { RopQueryRowsHandler } from "../rop/RopQueryRowsHandler.js";
+import { RopOpenMessageHandler } from "../rop/RopOpenMessageHandler.js";
+import { RopGetPropertiesSpecificHandler } from "../rop/RopGetPropertiesSpecificHandler.js";
+import { RopOpenStreamHandler } from "../rop/RopOpenStreamHandler.js";
+import { RopReadStreamHandler } from "../rop/RopReadStreamHandler.js";
+import { RopCreateMessageHandler } from "../rop/RopCreateMessageHandler.js";
+import { RopSetPropertiesHandler } from "../rop/RopSetPropertiesHandler.js";
+import { RopWriteStreamHandler } from "../rop/RopWriteStreamHandler.js";
+import { RopSaveChangesMessageHandler } from "../rop/RopSaveChangesMessageHandler.js";
+import { RopSubmitMessageHandler } from "../rop/RopSubmitMessageHandler.js";
+import { RopGetPropertyIdsFromNamesHandler } from "../rop/RopGetPropertyIdsFromNamesHandler.js";
+import { RopDeleteMessagesHandler } from "../rop/RopDeleteMessagesHandler.js";
+import { RopDeleteFolderHandler } from "../rop/RopDeleteFolderHandler.js";
+import { RopFastTransferSourceCopyToHandler } from "../rop/RopFastTransferSourceCopyToHandler.js";
+import { RopFastTransferSourceCopyPropertiesHandler } from "../rop/RopFastTransferSourceCopyPropertiesHandler.js";
+import { RopFastTransferSourceGetBufferHandler } from "../rop/RopFastTransferSourceGetBufferHandler.js";
+import { RouteDecorators } from "@rapidrest/service-core";
+const { Route } = RouteDecorators;
+/**
+ * SQL-backed concrete `BaseMapiEmsmdbRoute`, mounted at `/mapi/emsmdb`. Exported from this plugin's
+ * `./sql` entry point, so the server host mounts it without a wrapper class of its
+ * own.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let MapiEmsmdbRouteSQL = class MapiEmsmdbRouteSQL extends BaseMapiEmsmdbRoute {
+    constructor() {
+        super(...arguments);
+        this.mailboxClass = MailboxSQL;
+        this.folderClass = FolderSQL;
+        this.messageClass = MessageSQL;
+        this.calendarEventClass = CalendarEventSQL;
+        this.contactClass = ContactSQL;
+        this.taskClass = TaskSQL;
+        this.labelClass = LabelSQL;
+        this.ropHandlerClasses = [
+            RopLogonHandler,
+            RopReleaseHandler,
+            RopOpenFolderHandler,
+            RopGetHierarchyTableHandler,
+            RopGetContentsTableHandler,
+            RopSetColumnsHandler,
+            RopQueryRowsHandler,
+            RopOpenMessageHandler,
+            RopGetPropertiesSpecificHandler,
+            RopOpenStreamHandler,
+            RopReadStreamHandler,
+            RopCreateMessageHandler,
+            RopSetPropertiesHandler,
+            RopWriteStreamHandler,
+            RopSaveChangesMessageHandler,
+            RopSubmitMessageHandler,
+            RopGetPropertyIdsFromNamesHandler,
+            RopDeleteMessagesHandler,
+            RopDeleteFolderHandler,
+            RopFastTransferSourceCopyToHandler,
+            RopFastTransferSourceCopyPropertiesHandler,
+            RopFastTransferSourceGetBufferHandler,
+        ];
+    }
+};
+MapiEmsmdbRouteSQL = __decorate([
+    Route("/mapi/emsmdb")
+], MapiEmsmdbRouteSQL);
+export { MapiEmsmdbRouteSQL };
+//# sourceMappingURL=MapiEmsmdbRouteSQL.js.map

package/dist/lib/sql/MapiEmsmdbRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapiEmsmdbRouteSQL.js","sourceRoot":"","sources":["../../../src/sql/MapiEmsmdbRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1H,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,kCAAkC,EAAE,MAAM,8CAA8C,CAAC;AAClG,OAAO,EAAE,0CAA0C,EAAE,MAAM,sDAAsD,CAAC;AAClH,OAAO,EAAE,qCAAqC,EAAE,MAAM,iDAAiD,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC;AAElC;;;;;;GAMG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,mBAA+B;IAAhE;;QACO,iBAAY,GAAQ,UAAU,CAAC;QAC/B,gBAAW,GAAQ,SAAS,CAAC;QAC7B,iBAAY,GAAQ,UAAU,CAAC;QAC/B,uBAAkB,GAAQ,gBAAgB,CAAC;QAC3C,iBAAY,GAAQ,UAAU,CAAC;QAC/B,cAAS,GAAQ,OAAO,CAAC;QACzB,eAAU,GAAQ,QAAQ,CAAC;QAC3B,sBAAiB,GAAU;YACjC,eAAe;YACf,iBAAiB;YACjB,oBAAoB;YACpB,2BAA2B;YAC3B,0BAA0B;YAC1B,oBAAoB;YACpB,mBAAmB;YACnB,qBAAqB;YACrB,+BAA+B;YAC/B,oBAAoB;YACpB,oBAAoB;YACpB,uBAAuB;YACvB,uBAAuB;YACvB,qBAAqB;YACrB,4BAA4B;YAC5B,uBAAuB;YACvB,iCAAiC;YACjC,wBAAwB;YACxB,sBAAsB;YACtB,kCAAkC;YAClC,0CAA0C;YAC1C,qCAAqC;SACxC,CAAC;IACN,CAAC;CAAA,CAAA;AAhCY,kBAAkB;IAD9B,KAAK,CAAC,cAAc,CAAC;GACT,kBAAkB,CAgC9B"}

package/dist/lib/sql/MapiNspiRouteSQL.js

@@ -0,0 +1,33 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ContactSQL, MailboxSQL } from "@rapidmx/restapi/sql";
+import { BaseMapiNspiRoute } from "../BaseMapiNspiRoute.js";
+import { RouteDecorators } from "@rapidrest/service-core";
+const { Route } = RouteDecorators;
+/**
+ * SQL-backed concrete `BaseMapiNspiRoute`, mounted at `/mapi/nspi`. Exported from this plugin's
+ * `./sql` entry point, so the server host mounts it without a wrapper class of its
+ * own.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let MapiNspiRouteSQL = class MapiNspiRouteSQL extends BaseMapiNspiRoute {
+    constructor() {
+        super(...arguments);
+        this.mailboxClass = MailboxSQL;
+        this.contactClass = ContactSQL;
+    }
+};
+MapiNspiRouteSQL = __decorate([
+    Route("/mapi/nspi")
+], MapiNspiRouteSQL);
+export { MapiNspiRouteSQL };
+//# sourceMappingURL=MapiNspiRouteSQL.js.map

package/dist/lib/sql/MapiNspiRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapiNspiRouteSQL.js","sourceRoot":"","sources":["../../../src/sql/MapiNspiRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC;AAElC;;;;;;GAMG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,iBAA6B;IAA5D;;QACO,iBAAY,GAAQ,UAAU,CAAC;QAC/B,iBAAY,GAAQ,UAAU,CAAC;IAC7C,CAAC;CAAA,CAAA;AAHY,gBAAgB;IAD5B,KAAK,CAAC,YAAY,CAAC;GACP,gBAAgB,CAG5B"}

package/dist/lib/sql/index.js

@@ -0,0 +1,7 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+export * from "./MapiEmsmdbRouteSQL.js";
+export * from "./MapiNspiRouteSQL.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/sql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sql/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/dist/lib/sql.js

@@ -0,0 +1,6 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+export * from "./sql/index.js";
+//# sourceMappingURL=sql.js.map

package/dist/lib/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../src/sql.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,cAAc,gBAAgB,CAAC"}