@rapidmx/mapi-plugin 1.0.0-beta.10

package/dist/lib/rop/RopSetPropertiesHandler.js

@@ -0,0 +1,173 @@
+import { PropertyType, readTaggedPropertyValue } from "../codec/PropertyValue.js";
+import { LID_APPOINTMENT_END_WHOLE, LID_APPOINTMENT_RECUR, LID_APPOINTMENT_START_WHOLE, LID_BUSY_STATUS, LID_GLOBAL_OBJECT_ID, LID_LOCATION, LID_REMINDER_DELTA, LID_TIME_ZONE_STRUCT, PSETID_APPOINTMENT, PSETID_COMMON, PSETID_MEETING, } from "./CalendarNamedProperties.js";
+import { resolveNamedProperty } from "./NamedPropertyRegistry.js";
+const ROP_ID_SET_PROPERTIES = 0x0a;
+/** 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.
+ * `RopSetProperties` is also spec-valid on Folder/Attachment/Logon objects, none of which this pragmatic
+ * subset's compose/send path ever needs to set properties on. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** `MAPI_E_INVALID_PARAMETER`: `PropertyValues` couldn't be decoded, or didn't match `PropertyValueSize`. */
+const ERROR_INVALID_PARAMETER = 0x80070057;
+// The small, well-known set of plain (non-named) properties this pragmatic subset's compose/send path tracks -
+// exactly what RopSubmitMessageHandler/RopSaveChangesMessageHandler need to build a MIME message or persist a
+// CalendarEvent (Subject, an inline small body, the PidTagDisplayTo/Cc/Bcc "cached recipient display string"
+// properties real Outlook also always sets alongside RopModifyRecipients - see RopSubmitMessageHandler's own
+// doc comment for why this pragmatic subset reads addresses from these instead of implementing
+// RopModifyRecipients - and PidTagMessageClass, which RopSaveChangesMessageHandler/RopSubmitMessageHandler
+// branch on to route Calendar items down a different path than ordinary mail). Every other plain property a
+// client sets is accepted (this ROP always reports success, no PropertyProblems) but simply not tracked -
+// harmless for this pragmatic subset's narrow compose/send scope. A *named* property (ID `>= 0x8000`, resolved
+// via `resolveNamedProperty`) is tracked separately below, against the Calendar LID table `PropertyResolvers.ts`
+// also reads from - see `CalendarNamedProperties.ts`.
+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;
+/** `PidTagReadReceiptRequested` (`PT_BOOLEAN`) - a client checking "Request a read receipt" before Submit sets
+ * this; `RopSubmitMessageHandler` reads it back to attach a real `Disposition-Notification-To` header, mirroring
+ * `BaseMessageRoute.send()`'s own explicit-`Message.requestReceipt` handling (see `util/ReceiptUtils.ts`). */
+export const PID_TAG_READ_RECEIPT_REQUESTED = 0x0029;
+/** `PidTagDeferredSendTime` (`PT_SYSTIME`) - real Outlook's "Do not deliver before" compose option;
+ * `RopSubmitMessageHandler` reads it back to defer relay exactly like `BaseMessageRoute.send()`'s own
+ * `Message.scheduledSendTime` branch does (moving the message to Outbox for `ScheduledSendJob` to relay later)
+ * instead of sending immediately. */
+export const PID_TAG_DEFERRED_SEND_TIME = 0x3fef;
+const TRACKED_PROPERTY_IDS = new Set([
+    PID_TAG_SUBJECT,
+    PID_TAG_MESSAGE_CLASS,
+    PID_TAG_DISPLAY_BCC,
+    PID_TAG_DISPLAY_CC,
+    PID_TAG_DISPLAY_TO,
+    PID_TAG_BODY,
+    PID_TAG_READ_RECEIPT_REQUESTED,
+    PID_TAG_DEFERRED_SEND_TIME,
+]);
+/** The Calendar named-property LIDs this handler tracks when set under the correct property-set GUID (per
+ * `CalendarNamedProperties.ts`) - the write-side mirror of `PropertyResolvers.calendarEventValueFor`'s read-side
+ * switch. `PidLidRecurring`/`PidLidReminderSet` are deliberately not tracked here: both are purely-derived
+ * boolean flags on the read side (`recurrenceRule !== undefined` / `reminderMinutesBeforeStart != null`), so a
+ * client setting them carries no additional information `RopSaveChangesMessageHandler` needs to persist. */
+const TRACKED_APPOINTMENT_LIDS = new Set([
+    LID_LOCATION,
+    LID_APPOINTMENT_START_WHOLE,
+    LID_APPOINTMENT_END_WHOLE,
+    LID_BUSY_STATUS,
+    LID_APPOINTMENT_RECUR,
+    LID_TIME_ZONE_STRUCT,
+]);
+const TRACKED_COMMON_LIDS = new Set([LID_REMINDER_DELTA]);
+/** `PidLidGlobalObjectId` - the meeting-response side needs this tracked so `RopSubmitMessageHandler` can
+ * correlate an incoming `"IPM.Schedule.Meeting.Resp.*"` response back to the `CalendarEvent` it answers, via
+ * `MeetingMessageClassHandler.ts`. */
+const TRACKED_MEETING_LIDS = new Set([LID_GLOBAL_OBJECT_ID]);
+/**
+ * `RopSetProperties` (`[MS-OXCPRPT]`/`[MS-OXCROPS]`): sets an explicit, client-chosen list of properties
+ * (`TaggedPropertyValue`s, each carrying its own `PropertyTag`) on an already-open object. This pragmatic
+ * subset supports only `"message"` handles (a `RopCreateMessage` draft, or an already-open `RopOpenMessage`
+ * handle) and only tracks the small property set `TRACKED_PROPERTY_IDS`/`TRACKED_APPOINTMENT_LIDS`/
+ * `TRACKED_COMMON_LIDS` name - see those constants' own comments for why. A named property (ID `>= 0x8000`) is
+ * resolved back to its `(PropertySet GUID, LID)` identity via `resolveNamedProperty` before it can be tracked,
+ * since MAPI has no fixed numeric ID for any Calendar property the way `PidTagSubject` has one.
+ *
+ * Every value is coerced to a plain string via `stringifyValue` before being stored in `handle.draftProperties`
+ * (itself a `Record<string, string>` for `MapiSessionContext`'s own JSON-safety reasons, see
+ * `MapiSessionManager.ts`) - a lossless, type-aware encoding (ISO-8601 for `PtypTime`, base64 for `PtypBinary`,
+ * plain `String()` otherwise) so `RopSaveChangesMessageHandler` can decode a Calendar item's properties back
+ * into a real `CalendarEvent`'s typed fields, not just display strings.
+ *
+ * Always reports success with zero `PropertyProblems`, even for a property this pragmatic subset doesn't
+ * track - the same "never fail over an unsupported property" pragmatic stance `RopQueryRows`/
+ * `RopGetPropertiesSpecific` already take (falling back to a default value there; simply not tracking the
+ * property here, since there is no row to fill in for a *set* operation).
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopSetPropertiesHandler {
+    constructor() {
+        this.ropId = ROP_ID_SET_PROPERTIES;
+    }
+    handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const propertyValueSize = reader.readUInt16LE();
+        // PropertyValueSize covers the PropertyValueCount field itself plus PropertyValues, counted from right
+        // here (immediately after the PropertyValueSize field, before PropertyValueCount is read).
+        const propertyValuesEnd = reader.position + propertyValueSize;
+        let values = [];
+        try {
+            const propertyValueCount = reader.readUInt16LE();
+            for (let i = 0; i < propertyValueCount; i++) {
+                values.push(readTaggedPropertyValue(reader));
+            }
+        }
+        catch {
+            values = undefined; // e.g. an unsupported property type, whose size can't be known
+        }
+        // PropertyValueSize frames this ROP, so a list that couldn't be decoded, or decoded to a different length, is
+        // skipped by it and only this ROP fails; the ROPs after it are still where PropertyValueSize says. When
+        // PropertyValueSize itself points past the request, seek throws and the whole request is rejected.
+        const decodedEnd = reader.position;
+        reader.seek(propertyValuesEnd);
+        if (!values || decodedEnd !== propertyValuesEnd) {
+            writer.writeUInt8(ROP_ID_SET_PROPERTIES);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_PARAMETER);
+            return;
+        }
+        const handle = context.session.handles[inputHandleIndex];
+        // A draft already submitted is finished: changing it can't change what was sent, and must not set up a resend.
+        if (!handle || handle.type !== "message" || handle.submitted) {
+            writer.writeUInt8(ROP_ID_SET_PROPERTIES);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        handle.draftProperties ?? (handle.draftProperties = {});
+        for (const tagged of values) {
+            if (TRACKED_PROPERTY_IDS.has(tagged.propertyId)) {
+                handle.draftProperties[String(tagged.propertyId)] = stringifyValue(tagged);
+            }
+            else if (tagged.propertyId >= 0x8000 && this.isTrackedNamedProperty(context, tagged.propertyId)) {
+                handle.draftProperties[String(tagged.propertyId)] = stringifyValue(tagged);
+            }
+        }
+        writer.writeUInt8(ROP_ID_SET_PROPERTIES);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt16LE(0); // PropertyProblemCount - never reported, see class doc comment
+    }
+    isTrackedNamedProperty(context, propertyId) {
+        const named = resolveNamedProperty(context.session, propertyId);
+        if (!named || named.kind !== "lid" || named.lid === undefined) {
+            return false;
+        }
+        const guid = named.guid.toLowerCase();
+        if (guid === PSETID_APPOINTMENT) {
+            return TRACKED_APPOINTMENT_LIDS.has(named.lid);
+        }
+        if (guid === PSETID_COMMON) {
+            return TRACKED_COMMON_LIDS.has(named.lid);
+        }
+        if (guid === PSETID_MEETING) {
+            return TRACKED_MEETING_LIDS.has(named.lid);
+        }
+        return false;
+    }
+}
+function stringifyValue(tagged) {
+    switch (tagged.propertyType) {
+        case PropertyType.PtypString:
+        case PropertyType.PtypString8:
+            return tagged.value;
+        case PropertyType.PtypTime:
+            return tagged.value.toISOString();
+        case PropertyType.PtypBinary:
+            return tagged.value.toString("base64");
+        default:
+            return String(tagged.value);
+    }
+}
+//# sourceMappingURL=RopSetPropertiesHandler.js.map

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

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

package/dist/lib/rop/RopSubmitMessageHandler.js

@@ -0,0 +1,342 @@
+///////////////////////////////////////////////////////////////////////////////
+// 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 { ApiErrors } from "@rapidrest/service-core";
+import { findOrCreateWellKnownFolder, FolderType, MessageImportance, RecipientType, scanAndRelay, } from "@rapidmx/restapi";
+import { MAX_RECIPIENTS_PER_MESSAGE, parseRecipientList, resolveRecipientList } from "./AddressList.js";
+import { handleDataOwners, writeStreamKey } from "./HandleDataCache.js";
+import { submitMeetingResponse } from "./MeetingMessageClassHandler.js";
+import { handleDataStoreOf } from "./RopHandler.js";
+import { readWriteStream } from "./RopWriteStreamHandler.js";
+import { asEntity, isInvitePending } from "./RestapiRules.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;
+/** `MAPI_E_INVALID_PARAMETER`: the draft has no recipients, a recipient that isn't a usable address, or no sender. */
+const ERROR_INVALID_PARAMETER = 0x80070057;
+/** `MAPI_E_NOT_FOUND`: a recipient given only by display name matches no single contact of the caller's. */
+const ERROR_NOT_FOUND = 0x8004010f;
+/** `MAPI_E_TOO_BIG`: more than `MAX_RECIPIENTS_PER_MESSAGE` recipients. */
+const ERROR_TOO_BIG = 0x80040305;
+/** `MAPI_E_CALL_FAILED`: the body written through `RopWriteStream` can no longer be reassembled (its chunks expired). */
+const ERROR_CALL_FAILED = 0x80004005;
+// 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.";
+// Re-exported for existing importers; the implementation lives in AddressList.ts.
+export { isPlainEmailAddress, parseAddressList } from "./AddressList.js";
+function writeResult(writer, inputHandleIndex, returnValue) {
+    writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+    writer.writeUInt8(inputHandleIndex);
+    writer.writeUInt32LE(returnValue);
+}
+/**
+ * `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). Entries are separated by `;` and parsed with nodemailer's `addressparser`, so both bare
+ * addresses and resolved `Name <address>` forms work. A client that resolved a name against an address book may
+ * write the display name alone; that is looked up among the caller's own contacts (see `resolveRecipientList`), and
+ * a name matching no single contact fails the submit with `MAPI_E_NOT_FOUND`. It is still **not** a substitute for
+ * real recipient rows (there is no recipient table to fall back on), so the whole send is refused rather than sent to
+ * fewer people than the user addressed. A malformed recipient fails with `MAPI_E_INVALID_PARAMETER`.
+ *
+ * `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).
+ *
+ * **Once per draft.** A mail or meeting-response draft is marked `submitted` as soon as a submit gets past the handle
+ * check, whatever the outcome, and a submitted draft can't be submitted again (`MAPI_E_INVALID_OBJECT`) or changed by
+ * `RopSetProperties`/`RopWriteStream`; its write-stream chunks are deleted once read. Each `Execute` runs at most
+ * `MAX_SUBMITS_PER_EXECUTE` submits, and a message may have at most `MAX_RECIPIENTS_PER_MESSAGE` recipients
+ * (`MAPI_E_TOO_BIG`), counted before any display name is looked up.
+ *
+ * **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" || handle.submitted) {
+            writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        context.budget?.chargeSubmit();
+        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;
+        }
+        // From here on the draft is used up by this attempt, whatever its outcome, so it can't be sent again.
+        handle.submitted = true;
+        if (messageClass.startsWith(MESSAGE_CLASS_MEETING_RESPONSE_PREFIX)) {
+            writeResult(writer, inputHandleIndex, await submitMeetingResponse(messageClass, properties, context));
+            return;
+        }
+        const recipientCount = [PID_TAG_DISPLAY_TO, PID_TAG_DISPLAY_CC, PID_TAG_DISPLAY_BCC].reduce((count, propertyId) => count + parseRecipientList(properties[String(propertyId)]).length, 0);
+        if (recipientCount > MAX_RECIPIENTS_PER_MESSAGE) {
+            writeResult(writer, inputHandleIndex, ERROR_TOO_BIG);
+            return;
+        }
+        const resolutions = [
+            await resolveRecipientList(properties[String(PID_TAG_DISPLAY_TO)], context),
+            await resolveRecipientList(properties[String(PID_TAG_DISPLAY_CC)], context),
+            await resolveRecipientList(properties[String(PID_TAG_DISPLAY_BCC)], context),
+        ];
+        const [to, cc, bcc] = resolutions.map((resolution) => resolution.recipients);
+        const mailbox = await context.mailboxRepo.findOne(context.mailboxUid, { ignoreACL: true });
+        const envelopeFrom = mailbox?.primarySmtpAddress;
+        // Refuse the whole send over one malformed or unresolvable recipient rather than silently dropping it.
+        if (!envelopeFrom || to.length + cc.length + bcc.length === 0 || resolutions.some((resolution) => resolution.invalid.length > 0)) {
+            writeResult(writer, inputHandleIndex, ERROR_INVALID_PARAMETER);
+            return;
+        }
+        if (resolutions.some((resolution) => resolution.unresolved.length > 0)) {
+            writeResult(writer, inputHandleIndex, ERROR_NOT_FOUND);
+            return;
+        }
+        const subject = properties[String(PID_TAG_SUBJECT)] ?? "";
+        const bodyText = await resolveDraftBody(context, inputHandleIndex, properties);
+        if (bodyText === undefined) {
+            writeResult(writer, inputHandleIndex, ERROR_CALL_FAILED);
+            return;
+        }
+        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: to.map(mailAddress),
+            cc: cc.map(mailAddress),
+            bcc: bcc.map(mailAddress),
+            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].map((recipient) => recipient.address);
+        const bodyBlobKey = `bodies/${crypto.randomUUID()}`;
+        const recipients = [
+            ...to.map((recipient) => storedRecipient(recipient, RecipientType.TO)),
+            ...cc.map((recipient) => storedRecipient(recipient, RecipientType.CC)),
+            ...bcc.map((recipient) => storedRecipient(recipient, 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 });
+            // Adding a message to a folder always bumps its sync key too - see `refreshFolderCounts()`'s own doc comment.
+            await context.notifyFolderCounts?.([outbox.uid], { bumpSyncKey: true });
+            writer.writeUInt8(ROP_ID_SUBMIT_MESSAGE);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(0); // ReturnValue - success
+            return;
+        }
+        const relayed = await scanAndRelay(raw, envelopeFrom, envelopeTo, context.scanPipeline, context.mailTransport, context.blobStore);
+        // The Sent Items copy stores exactly what was relayed: scanAndRelay may have added a Message-ID header, and
+        // that header's value (plus the thread it derived) is what recipients' copies carry and what recall targets.
+        await context.blobStore.put(bodyBlobKey, relayed.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: relayed.messageId,
+            conversationId: relayed.conversationId,
+            encrypted: relayed.encrypted,
+            subject,
+            from: { address: envelopeFrom, type: RecipientType.TO },
+            recipients,
+            sentDate: new Date(),
+            receivedDate: new Date(),
+            bodyBlobKey,
+            sanitizedHtmlBlobKey: relayed.sanitizedHtmlBlobKey,
+            bodyPreview: bodyText.slice(0, 200),
+            flags: { read: true, flagged: false, answered: false, forwarded: false },
+            importance: MessageImportance.NORMAL,
+            references: [],
+            hasAttachments: false,
+            requestReceipt,
+        }), { ignoreACL: true });
+        // Adding a message to a folder always bumps its sync key too - see `refreshFolderCounts()`'s own doc comment.
+        await context.notifyFolderCounts?.([sentFolder.uid], { bumpSyncKey: 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), so there
+     * is nothing left to store and nothing is sent from here.
+     *
+     * **Invites are restapi's `MeetingSchedulingJob`'s job.** That job sends an iTIP `REQUEST` for every
+     * organizer-owned event whose `inviteSequenceSent` differs from its `sequence`, claiming each revision with a
+     * versioned update before sending and building the invite with restapi's own `buildEventIcs` (so a recurring
+     * meeting's invite carries its `RRULE` and exceptions). Saving stamps `inviteSequenceSent = sequence`, so a meeting
+     * that is only saved ("Save & Close", or "save changes but don't send") invites no one. Submitting clears the stamp
+     * (`inviteSequenceSent: null`) with a versioned update, which makes the job send the current revision exactly once.
+     * - A revision that is already waiting for the job (submitted and not yet sent, or never stamped) is left alone, so
+     * submitting it again before the job runs doesn't cause a second invite.
+     * - The update is versioned (`asEntity`). The job only ever claims a waiting revision, so a conflict here comes from
+     * some other edit (an attendee's reply updating the row, a REST edit); the row is read again and the check repeated,
+     * up to `MAX_INVITE_REQUEST_ATTEMPTS` times, after which the ROP fails (`MAPI_E_CALL_FAILED`).
+     * - Submitting a revision the job has already sent sends it again: the client asked to send.
+     *
+     * Only the organizer's own copy may be submitted (an attendee's copy of someone else's meeting answers
+     * `MAPI_E_INVALID_OBJECT`, as before, and nothing is changed).
+     */
+    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;
+        const mailbox = event?.mailboxUid === context.mailboxUid ? await context.mailboxRepo.findOne(context.mailboxUid, { ignoreACL: true }) : undefined;
+        const callerAddresses = mailbox ? [mailbox.primarySmtpAddress, ...(mailbox.aliasAddresses ?? [])].map((a) => a.toLowerCase()) : [];
+        const isOrganizer = !!event && callerAddresses.includes((event.organizer?.address ?? "").toLowerCase());
+        if (!isOrganizer) {
+            writeResult(writer, inputHandleIndex, ERROR_INVALID_OBJECT);
+            return;
+        }
+        writeResult(writer, inputHandleIndex, (await requestInvites(context, uid, event)) ? 0 : ERROR_NOT_FOUND);
+    }
+}
+/** How many times `requestInvites` re-reads a row whose versioned update lost to another edit before giving up. */
+export const MAX_INVITE_REQUEST_ATTEMPTS = 3;
+/** Makes restapi's `MeetingSchedulingJob` send invites for the organizer copy `event`'s current revision (see
+ * `submitAppointment`). `false` when the row disappeared meanwhile. */
+async function requestInvites(context, uid, event) {
+    let row = event;
+    for (let attempt = 0; attempt < MAX_INVITE_REQUEST_ATTEMPTS; attempt++) {
+        if (!row) {
+            return false;
+        }
+        if (isInvitePending(row)) {
+            return true;
+        }
+        try {
+            await context.calendarEventRepo.update({ uid: row.uid, version: row.version, inviteSequenceSent: null }, asEntity(context.calendarEventRepo, row), { ignoreACL: true });
+            return true;
+        }
+        catch (err) {
+            if (err?.code !== ApiErrors.INVALID_OBJECT_VERSION) {
+                throw err;
+            }
+            row = await context.calendarEventRepo.findOne(uid, { ignoreACL: true });
+        }
+    }
+    throw new Error("RopSubmitMessage: the meeting kept changing while its invites were requested.");
+}
+/** A recipient as nodemailer's `MailComposer` takes it: a display name only when there is one. */
+function mailAddress(recipient) {
+    return recipient.name ? { name: recipient.name, address: recipient.address } : recipient.address;
+}
+/** A recipient as the Sent Items copy stores it. */
+function storedRecipient(recipient, type) {
+    return { address: recipient.address, ...(recipient.name ? { displayName: recipient.name } : {}), type };
+}
+/** 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. The generation must match too, so a stream left over from an
+ * earlier message at the same handle index never supplies this message's body. `undefined` when the stream's
+ * chunks can no longer be reassembled - sending a truncated body would be worse than failing. */
+async function resolveDraftBody(context, messageHandleIndex, properties) {
+    const generation = context.session.handles[messageHandleIndex].generation;
+    for (const [index, candidate] of Object.entries(context.session.handles)) {
+        if (candidate.type === "stream" &&
+            candidate.writeTargetHandleIndex === messageHandleIndex &&
+            candidate.writeTargetGeneration === generation &&
+            candidate.writeSize) {
+            const raw = await readWriteStream(context, Number(index), candidate);
+            // The chunks are only needed for this one submit; best effort, they expire anyway.
+            await handleDataStoreOf(context)
+                .delete(writeStreamKey(context.session.uid, Number(index), candidate.generation), handleDataOwners(context.session.uid, context.session.userUid))
+                .catch(() => undefined);
+            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,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EACH,2BAA2B,EAC3B,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,GAEf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,oBAAoB,EAA0B,MAAM,kBAAkB,CAAC;AAChI,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAoC,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;gCAGgC;AAChC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,sHAAsH;AACtH,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAE3C,4GAA4G;AAC5G,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC,2EAA2E;AAC3E,MAAM,aAAa,GAAG,UAAU,CAAC;AAEjC,yHAAyH;AACzH,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAErC,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,kFAAkF;AAClF,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzE,SAAS,WAAW,CAAC,MAAoB,EAAE,gBAAwB,EAAE,WAAmB;IACpF,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;IACzC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACpC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,OAAO,uBAAuB;IAApC;QACoB,UAAK,GAAG,qBAAqB,CAAC;IAyMlD,CAAC;IAvMU,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,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC3D,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;QACD,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;QAE/B,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,sGAAsG;QACtG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,IAAI,YAAY,CAAC,UAAU,CAAC,qCAAqC,CAAC,EAAE,CAAC;YACjE,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YACtG,OAAO;QACX,CAAC;QAED,MAAM,cAAc,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,MAAM,CACvF,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,KAAK,GAAG,kBAAkB,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EACxF,CAAC,CACJ,CAAC;QACF,IAAI,cAAc,GAAG,0BAA0B,EAAE,CAAC;YAC9C,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;YACrD,OAAO;QACX,CAAC;QAED,MAAM,WAAW,GAAG;YAChB,MAAM,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC;YAC3E,MAAM,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC;YAC3E,MAAM,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC;SAC/E,CAAC;QACF,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC7E,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,uGAAuG;QACvG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YAC/H,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;YAC/D,OAAO;QACX,CAAC;QACD,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YACrE,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC;YACvD,OAAO;QACX,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;QAC/E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;YACzD,OAAO;QACX,CAAC;QACD,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,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;YACvB,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;YACvB,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC;YACzB,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,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEhF,MAAM,WAAW,GAAG,UAAU,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG;YACf,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;YACtE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;YACtE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;SAC3E,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;YACF,8GAA8G;YAC9G,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YAExE,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,OAAO,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAElI,4GAA4G;QAC5G,6GAA6G;QAC7G,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACzF,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,OAAO,CAAC,SAAS;YAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,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,EAAE,OAAO,CAAC,oBAAoB;YAClD,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;QACF,8GAA8G;QAC9G,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5E,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;;;;;;;;;;;;;;;;;;;;OAoBG;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,MAAM,OAAO,GAAG,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClJ,MAAM,eAAe,GAAa,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrJ,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACxG,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;YAC5D,OAAO;QACX,CAAC;QACD,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,GAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAC9G,CAAC;CACJ;AAED,mHAAmH;AACnH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAE7C;uEACuE;AACvE,KAAK,UAAU,cAAc,CAAC,OAAmB,EAAE,GAAW,EAAE,KAAoB;IAChF,IAAI,GAAG,GAA8B,KAAK,CAAC;IAC3C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,2BAA2B,EAAE,OAAO,EAAE,EAAE,CAAC;QACrE,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,CAAC;YACD,MAAM,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAClC,EAAE,GAAG,EAAG,GAAW,CAAC,GAAG,EAAE,OAAO,EAAG,GAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAS,EACzF,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,EACxC,EAAE,SAAS,EAAE,IAAI,EAAE,CACtB,CAAC;YACF,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,EAAE,IAAI,KAAK,SAAS,CAAC,sBAAsB,EAAE,CAAC;gBACjD,MAAM,GAAG,CAAC;YACd,CAAC;YACD,GAAG,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;AACrG,CAAC;AAED,kGAAkG;AAClG,SAAS,WAAW,CAAC,SAA4B;IAC7C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;AACrG,CAAC;AAED,oDAAoD;AACpD,SAAS,eAAe,CAAC,SAA4B,EAAE,IAAmB;IACtE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;AAC5G,CAAC;AAED;;;;;iGAKiG;AACjG,KAAK,UAAU,gBAAgB,CAAC,OAAmB,EAAE,kBAA0B,EAAE,UAAkC;IAC/G,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,UAAU,CAAC;IAC1E,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,IACI,SAAS,CAAC,IAAI,KAAK,QAAQ;YAC3B,SAAS,CAAC,sBAAsB,KAAK,kBAAkB;YACvD,SAAS,CAAC,qBAAqB,KAAK,UAAU;YAC9C,SAAS,CAAC,SAAS,EACrB,CAAC;YACC,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;YACrE,mFAAmF;YACnF,MAAM,iBAAiB,CAAC,OAAO,CAAC;iBAC3B,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;iBAChJ,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC5B,OAAO,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACxD,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,72 @@
+import { handleDataOwners, writeStreamKey } from "./HandleDataCache.js";
+import { handleDataStoreOf } from "./RopHandler.js";
+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;
+/** `MAPI_E_TOO_BIG`, for a write that would take the stream past `MAX_WRITE_STREAM_BYTES`. */
+const ERROR_TOO_BIG = 0x80040305;
+/** The largest body a write stream accumulates. */
+export const MAX_WRITE_STREAM_BYTES = 4 * 1024 * 1024;
+/** How long a write stream's chunks are kept after its last write - the session's own idle lifetime. */
+export const WRITE_STREAM_TTL_SECONDS = 15 * 60;
+// Re-exported for existing importers; the key lives next to the other handle data keys.
+export { writeStreamKey } from "./HandleDataCache.js";
+/**
+ * `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`). Each write is stored as a chunk keyed by its
+ * offset in the `HandleDataStore` (Redis when configured), not in the session: only `writeSize` is session state.
+ * Keying by offset makes a retried write (after a request whose session save lost a conflict) replace its chunk
+ * instead of appending it twice. Up to `MAX_WRITE_STREAM_BYTES`; a write past that fails with `MAPI_E_TOO_BIG` and
+ * nothing is stored, as it is when the session's or user's handle data quota (`handleDataOwners`) is used up. A stream
+ * whose draft has already been submitted takes no more writes. `RopSubmitMessageHandler` reassembles the body (`readWriteStream`) 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;
+        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 dataSize = reader.readUInt16LE();
+        const data = reader.readBytes(dataSize);
+        const handle = context.session.handles[inputHandleIndex];
+        const target = handle?.writeTargetHandleIndex !== undefined ? context.session.handles[handle.writeTargetHandleIndex] : undefined;
+        if (!handle || handle.type !== "stream" || handle.writeTargetHandleIndex === undefined || target?.submitted) {
+            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 existingSize = handle.writeSize ?? 0;
+        const stored = existingSize + data.length <= MAX_WRITE_STREAM_BYTES &&
+            (data.length === 0 ||
+                (await handleDataStoreOf(context).putChunk(writeStreamKey(context.session.uid, inputHandleIndex, handle.generation), existingSize, data, WRITE_STREAM_TTL_SECONDS, handleDataOwners(context.session.uid, context.session.userUid))));
+        if (!stored) {
+            writer.writeUInt8(ROP_ID_WRITE_STREAM);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_TOO_BIG);
+            writer.writeUInt16LE(0); // WrittenSize
+            return;
+        }
+        handle.writeSize = existingSize + data.length;
+        writer.writeUInt8(ROP_ID_WRITE_STREAM);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt16LE(data.length); // WrittenSize
+    }
+}
+/** The bytes written so far to the write stream `stream` at `handleIndex`, or `undefined` when they can no longer be
+ * reassembled (a chunk expired or was evicted). */
+export async function readWriteStream(context, handleIndex, stream) {
+    return handleDataStoreOf(context).readChunks(writeStreamKey(context.session.uid, handleIndex, stream.generation), stream.writeSize ?? 0);
+}
+//# 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":"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"}