@rapidmx/mapi-plugin 1.0.0-beta.10

package/dist/lib/rop/RopDeleteFolderHandler.js

@@ -0,0 +1,174 @@
+import { auditMessageDelete } from "./RopDeleteMessagesHandler.js";
+import { findAllCapped, findPage, MAX_COLLECTION_ROWS } from "./RepoPaging.js";
+const ROP_ID_DELETE_FOLDER = 0x1d;
+/** The well-known MAPI HRESULT `MAPI_E_NOT_FOUND`, reused for an unrecognized `FolderId` - the same constant
+ * `RopOpenFolderHandler` uses for its own analogous lookup miss. */
+const ERROR_NOT_FOUND = 0x8004010f;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for both "the referenced handle isn't a folder"
+ * and "the folder has content/subfolders but the matching cascade flag wasn't set" - the same constant reused
+ * throughout this pragmatic subset as a generic "can't do this" signal, not a claim of exact per-condition
+ * `[MS-OXCFOLD]` return-value-table parity (the real spec's own `ecFolderNotEmpty` isn't separately modeled). */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** `MAPI_E_TOO_COMPLEX`, for a subfolder tree deeper than `MAX_FOLDER_DEPTH` or larger than `MAX_FOLDERS_PER_DELETE`. */
+const ERROR_TOO_COMPLEX = 0x80040117;
+/** `DeleteFolderFlags` bits (`[MS-OXCFOLD]` §2.2.1.3.1). `DELETE_HARD_DELETE` (`0x10`) is deliberately not
+ * honored - see the class doc comment. */
+const DEL_MESSAGES = 0x01;
+const DEL_FOLDERS = 0x04;
+/** The deepest subfolder nesting a recursive delete walks. */
+export const MAX_FOLDER_DEPTH = 32;
+/** The most folders one recursive delete removes. */
+export const MAX_FOLDERS_PER_DELETE = 1000;
+/** The most items (messages, events, contacts, tasks) one `RopDeleteFolder` deletes. Past this the ROP stops,
+ * reports `PartialCompletion`, and leaves the folders that still hold items in place; the client can retry. */
+export const MAX_ITEMS_PER_DELETE = MAX_COLLECTION_ROWS;
+const UID_SORT = { uid: "ASC" };
+/**
+ * `RopDeleteFolder` (`[MS-OXCFOLD]`/`[MS-OXCROPS]`, RopId `0x1D`): deletes a folder by `FolderId`, via
+ * `RecoverableRepoUtils.delete()` - see `RopDeleteMessagesHandler.ts`'s own doc comment for why that matters (EAS's
+ * watermark-based incremental delete detection depends on it).
+ *
+ * **Real spec semantics honored**: `RopDeleteFolder` only operates on an empty folder by default - `DEL_MESSAGES`
+ * must be set to also delete the folder's own messages/calendar events/contacts/tasks, and `DEL_FOLDERS` to also
+ * delete (recursively) its subfolders; a non-empty folder deleted without the matching flag fails rather than
+ * silently cascading.
+ *
+ * **Always a soft delete.** `DELETE_HARD_DELETE` is ignored. A permanent delete has to go through restapi's legal
+ * hold check first (the REST routes call `LegalHoldUtils.assertNotOnLegalHold()` for `purge=true`), and that helper
+ * isn't part of `@rapidmx/restapi`'s public exports. A soft-deleted item stays recoverable and discoverable, which is
+ * exactly what a hold requires, so MAPI never purges. Each deleted message is audited as `MESSAGE_DELETE`, like the
+ * REST message route.
+ *
+ * **Bounded.** The subfolder tree is walked iteratively with a visited set (a corrupt `parentFolderUid` cycle
+ * can't loop), at most `MAX_FOLDER_DEPTH` deep and `MAX_FOLDERS_PER_DELETE` wide, and only through folders in the
+ * caller's own mailbox. Items are fetched in explicit, paged queries (a bare `find()` stops at 100 rows, which used
+ * to leave items behind in a folder that was then deleted), up to `MAX_ITEMS_PER_DELETE`. Every query and delete is
+ * charged to the request's `ExecuteBudget` before it runs, so repeating this ROP can't multiply the walk unbounded.
+ *
+ * The request's own `InputHandleIndex` (nominally the *parent* folder of the one being deleted) is validated to
+ * be a real, open folder handle but not cross-checked against the target folder's actual `parentFolderUid` -
+ * the same pragmatic simplification `RopOpenMessageHandler`'s own doc comment documents for its analogous
+ * `FolderId` field.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopDeleteFolderHandler {
+    constructor() {
+        this.ropId = ROP_ID_DELETE_FOLDER;
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const deleteFolderFlags = reader.readUInt8();
+        const folderId = reader.readBigUInt64LE();
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "folder") {
+            this.writeFailure(writer, inputHandleIndex, ERROR_INVALID_OBJECT);
+            return;
+        }
+        const target = context.session.folderIds[folderId.toString()];
+        if (!target?.startsWith("folder:")) {
+            this.writeFailure(writer, inputHandleIndex, ERROR_NOT_FOUND);
+            return;
+        }
+        const uid = target.slice("folder:".length);
+        if ((deleteFolderFlags & DEL_MESSAGES) === 0 && (await this.hasItems(uid, context))) {
+            this.writeFailure(writer, inputHandleIndex, ERROR_INVALID_OBJECT);
+            return;
+        }
+        const childQuery = { parentFolderUid: uid, mailboxUid: context.mailboxUid };
+        if ((deleteFolderFlags & DEL_FOLDERS) === 0 && (await findPage(context.folderRepo, childQuery, UID_SORT, 0, 1, context.budget)).length > 0) {
+            this.writeFailure(writer, inputHandleIndex, ERROR_INVALID_OBJECT);
+            return;
+        }
+        const folders = await this.collectSubtree(uid, context);
+        if (!folders) {
+            this.writeFailure(writer, inputHandleIndex, ERROR_TOO_COMPLEX);
+            return;
+        }
+        const budget = { remaining: MAX_ITEMS_PER_DELETE };
+        let partialCompletion = false;
+        for (const folderUid of folders) {
+            if (!(await this.deleteItems(folderUid, context, budget))) {
+                partialCompletion = true;
+                // Every folder deleted below (this loop's earlier iterations) is gone outright - nothing to refresh.
+                // This one is different: it survives (the budget ran out before `deleteItems` could empty it, so it's
+                // never reached below), but `itemRepos()` always drains `context.messageRepo` for a folder before any
+                // other repo, so some or all of its messages may already be gone - its stored counts must be
+                // refreshed rather than left counting messages that no longer exist.
+                await context.notifyFolderCounts?.([folderUid]);
+                break;
+            }
+            context.budget?.chargeQueries();
+            await context.folderRepo.delete(folderUid, { ignoreACL: true });
+        }
+        writer.writeUInt8(ROP_ID_DELETE_FOLDER);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(partialCompletion ? 1 : 0); // PartialCompletion
+    }
+    writeFailure(writer, inputHandleIndex, returnValue) {
+        writer.writeUInt8(ROP_ID_DELETE_FOLDER);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(returnValue);
+    }
+    /** The repos a folder's items can live in, skipping the optional ones the context doesn't have. */
+    itemRepos(context) {
+        return [context.messageRepo, context.calendarEventRepo, context.contactRepo, context.taskRepo].filter((repo) => repo !== undefined);
+    }
+    async hasItems(folderUid, context) {
+        for (const repo of this.itemRepos(context)) {
+            if ((await findPage(repo, { folderUid, mailboxUid: context.mailboxUid }, UID_SORT, 0, 1, context.budget)).length > 0) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * `rootUid` and every folder below it in the caller's mailbox, children before their parents, or `undefined` when
+     * the tree is deeper than `MAX_FOLDER_DEPTH` or has more than `MAX_FOLDERS_PER_DELETE` folders.
+     */
+    async collectSubtree(rootUid, context) {
+        const visited = new Set([rootUid]);
+        const preOrder = [];
+        const stack = [{ uid: rootUid, depth: 0 }];
+        while (stack.length > 0) {
+            const { uid, depth } = stack.pop();
+            preOrder.push(uid);
+            const { items: children, truncated } = await findAllCapped(context.folderRepo, { parentFolderUid: uid, mailboxUid: context.mailboxUid }, UID_SORT, MAX_FOLDERS_PER_DELETE, context.budget);
+            if (truncated) {
+                return undefined;
+            }
+            for (const child of children) {
+                if (visited.has(child.uid)) {
+                    continue;
+                }
+                if (depth + 1 > MAX_FOLDER_DEPTH || visited.size >= MAX_FOLDERS_PER_DELETE) {
+                    return undefined;
+                }
+                visited.add(child.uid);
+                stack.push({ uid: child.uid, depth: depth + 1 });
+            }
+        }
+        return preOrder.reverse();
+    }
+    /** Soft-deletes `folderUid`'s items within `budget`. Returns `false` if items remain once the budget is spent. */
+    async deleteItems(folderUid, context, budget) {
+        for (const repo of this.itemRepos(context)) {
+            const { items, truncated } = await findAllCapped(repo, { folderUid, mailboxUid: context.mailboxUid }, UID_SORT, budget.remaining, context.budget);
+            for (const item of items) {
+                context.budget?.chargeQueries();
+                await repo.delete(item.uid, { ignoreACL: true });
+                if (repo === context.messageRepo) {
+                    await auditMessageDelete(context, item);
+                }
+            }
+            budget.remaining -= items.length;
+            if (truncated) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=RopDeleteFolderHandler.js.map

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

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

package/dist/lib/rop/RopDeleteMessagesHandler.js

@@ -0,0 +1,110 @@
+import { AuditAction } from "@rapidmx/restapi";
+const ROP_ID_DELETE_MESSAGES = 0x1e;
+/** Audits a message deleted through MAPI with the same `MESSAGE_DELETE` entry the REST message route records.
+ * Charged to `context.budget` like the `findOne`/`delete` calls around every call site of this function - a real
+ * DB `create()` whenever `context.audit` is configured (the case in every real deployment), so leaving it
+ * uncharged undercounted this loop's real DB work by a third. No-op (and no charge - there's no DB work to
+ * account for) when `context.audit` is absent, the same as an optional-repo item kind this pragmatic subset
+ * already skips charging for. */
+export async function auditMessageDelete(context, message) {
+    if (!context.audit) {
+        return;
+    }
+    context.budget?.chargeQueries();
+    await context.audit({
+        action: AuditAction.MESSAGE_DELETE,
+        targetType: "Message",
+        targetUid: message.uid,
+        mailboxUid: message.mailboxUid,
+        details: { subject: message.subject, folderUid: message.folderUid },
+    });
+}
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a folder (or
+ * doesn't exist)" - the same constant `RopGetContentsTableHandler` uses for its own analogous check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/**
+ * `RopDeleteMessages` (`[MS-OXCMSG]`/`[MS-OXCROPS]`, RopId `0x1E`): deletes one or more messages by `MessageId`
+ * from an already-open folder handle. Reuses `RecoverableRepoUtils.delete()` exactly as-built in Phase 2 - the
+ * same soft-delete-with-watermark-bump machinery EAS's own `Sync`/`FolderSync` incremental-delete detection
+ * already relies on (see `BaseMapiEmsmdbRoute.ts`'s own doc comment for why `folderRepo`/`messageRepo`/
+ * `calendarEventRepo` are built as `RecoverableRepoUtils`, not plain `RepoUtils`) - no new deletion-tracking
+ * code, zero duplication.
+ *
+ * A `MessageId` resolves via `session.messageIds` (`MessageTarget.assignOrGetMid`'s own registry, already
+ * generic over both `"message:<uid>"` and `"calendarEvent:<uid>"` target strings, since a Calendar item is
+ * itself a Message object on the wire - see `CalendarEventTarget.ts`'s own doc comment) directly to the entity
+ * to delete, the same "the session already knows what this small integer refers to" design every other MID-
+ * consuming ROP in this pragmatic subset already uses (`RopOpenMessage`, `RopSaveChangesMessage`) - the
+ * request's own `InputHandleIndex` (nominally the messages' shared parent folder) is validated to be a real,
+ * open folder handle but not cross-checked against each message's actual `folderUid`, the same pragmatic
+ * simplification `RopOpenMessageHandler`'s own doc comment documents for its analogous `FolderId` field.
+ *
+ * `WantAsynchronous` (`RopProgress`-reported async completion) and `NotifyNonRead` (non-read-receipt generation
+ * to the original sender) are decoded to advance the reader correctly but not honored - this pragmatic subset
+ * has no async-ROP or non-read-receipt machinery. `PartialCompletion` is reported `true` if any requested
+ * `MessageId` didn't resolve to a real message/calendar-event target - the rest are still deleted, matching
+ * this pragmatic subset's "don't fail the whole ROP over one stale reference" principle used throughout.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopDeleteMessagesHandler {
+    constructor() {
+        this.ropId = ROP_ID_DELETE_MESSAGES;
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // WantAsynchronous - no RopProgress/async-ROP support in this pragmatic subset
+        reader.readUInt8(); // NotifyNonRead - no non-read-receipt generation support
+        const messageIdCount = reader.readUInt16LE();
+        const messageIds = [];
+        for (let i = 0; i < messageIdCount; i++) {
+            messageIds.push(reader.readBigUInt64LE());
+        }
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "folder") {
+            writer.writeUInt8(ROP_ID_DELETE_MESSAGES);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        let partialCompletion = false;
+        // The folders that lost a message - refreshed once below, after the loop, rather than once per message (a
+        // client can name several `MessageId`s in one call, several of which are often the same folder).
+        const affectedFolderUids = new Set();
+        for (const messageId of messageIds) {
+            const target = context.session.messageIds[messageId.toString()];
+            if (target?.startsWith("message:")) {
+                const uid = target.slice("message:".length);
+                // Always fetched now (not just when `context.audit` is set): `notifyFolderCounts` below needs to know
+                // which folder this message was in, the same as `auditMessageDelete` already needed its subject.
+                // Charged like `resolveContentsKind`'s own single-row lookup and `RopDeleteFolderHandler.deleteItems()`'s
+                // own per-item delete - each is a real DB round trip, so a client can't repeat this ROP with a large
+                // `messageIdCount` to run unbounded queries against its own mailbox within one `Execute`.
+                context.budget?.chargeQueries();
+                const message = await context.messageRepo.findOne(uid, { ignoreACL: true });
+                context.budget?.chargeQueries();
+                await context.messageRepo.delete(uid, { ignoreACL: true });
+                if (message) {
+                    affectedFolderUids.add(message.folderUid);
+                    await auditMessageDelete(context, message);
+                }
+            }
+            else if (target?.startsWith("calendarEvent:")) {
+                context.budget?.chargeQueries();
+                await context.calendarEventRepo.delete(target.slice("calendarEvent:".length), { ignoreACL: true });
+            }
+            else {
+                partialCompletion = true;
+            }
+        }
+        // Not `bumpSyncKey` - only adding a message to a folder does that (see `refreshFolderCounts()`'s own doc
+        // comment); a deletion doesn't, matching restapi's own `ScanQueueJob.processRecall()` deletion call site.
+        await context.notifyFolderCounts?.(affectedFolderUids);
+        writer.writeUInt8(ROP_ID_DELETE_MESSAGES);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(partialCompletion ? 1 : 0); // PartialCompletion
+    }
+}
+//# sourceMappingURL=RopDeleteMessagesHandler.js.map

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

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

package/dist/lib/rop/RopFastTransferSourceCopyPropertiesHandler.js

@@ -0,0 +1,61 @@
+import { readPropertyTagArray } from "../codec/PropertyValue.js";
+import { openFastTransferHandle } from "./FastTransferStream.js";
+const ROP_ID_COPY_PROPERTIES = 0x69;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a folder or
+ * message (or doesn't exist)" - the same constant `RopGetPropertiesSpecificHandler` uses for its own analogous
+ * check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** `MAPI_E_TOO_BIG`: more than `MAX_PROPERTY_TAG_COUNT` tags, or a stream past `MAX_FAST_TRANSFER_BYTES`. */
+const ERROR_TOO_BIG = 0x80040305;
+/**
+ * `RopFastTransferSourceCopyProperties` (`[MS-OXCFXICS]`/`[MS-OXCROPS]`, RopId `0x69`): the explicit-column
+ * sibling of `RopFastTransferSourceCopyTo` - `PropertyTags` here is the properties to **copy** (an include
+ * list, per `[MS-OXCROPS]`'s own wording, the opposite of `CopyTo`'s exclude list), applied uniformly at both
+ * folder- and message-level wherever `FastTransferStream.ts` builds a `propList` - see that file's own doc
+ * comment for this pragmatic subset's overall ICS scope. An empty `PropertyTags` list is honored literally
+ * (copies zero properties, i.e. empty `propList`s) rather than falling back to `CopyTo`'s own default column
+ * set - that fallback belongs to `CopyTo` alone, since an explicit "copy nothing" request here is spec-valid
+ * and distinguishable from "use the default set" (`CopyTo` simply has no `PropertyTags`-supplied alternative to
+ * fall back from).
+ *
+ * `Level`/`CopyFlags`/`SendOptions` are decoded to advance the reader correctly but not honored - see
+ * `RopFastTransferSourceCopyToHandler`'s own doc comment for the identical reasoning. Note `CopyFlags` here is
+ * **1 byte**, not 4 like `CopyTo`'s own field of the same name - confirmed against each ROP's own request-buffer
+ * page separately, not assumed identical.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopFastTransferSourceCopyPropertiesHandler {
+    constructor() {
+        this.ropId = ROP_ID_COPY_PROPERTIES;
+        this.responseHandleIndexOffset = 3; // OutputHandleIndex
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const outputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // Level - subfolder recursion not honored, see class doc comment
+        reader.readUInt8(); // CopyFlags (1 byte here, unlike CopyTo's 4) - not honored, see class doc comment
+        reader.readUInt8(); // SendOptions - not honored, see class doc comment
+        const tags = readPropertyTagArray(reader, reader.readUInt16LE());
+        // One column per property: a repeated tag would only repeat the same value in every row of the stream.
+        const columns = tags?.filter((tag, index) => tags.findIndex((other) => other.propertyId === tag.propertyId) === index);
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || (handle.type !== "folder" && handle.type !== "message")) {
+            writer.writeUInt8(ROP_ID_COPY_PROPERTIES);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        if (!columns || !(await openFastTransferHandle(context, outputHandleIndex, handle, { columns }))) {
+            writer.writeUInt8(ROP_ID_COPY_PROPERTIES);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_TOO_BIG);
+            return;
+        }
+        writer.writeUInt8(ROP_ID_COPY_PROPERTIES);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+    }
+}
+//# sourceMappingURL=RopFastTransferSourceCopyPropertiesHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopFastTransferSourceCopyPropertiesHandler.js","sourceRoot":"","sources":["../../../src/rop/RopFastTransferSourceCopyPropertiesHandler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC;;YAEY;AACZ,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,6GAA6G;AAC7G,MAAM,aAAa,GAAG,UAAU,CAAC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,0CAA0C;IAAvD;QACoB,UAAK,GAAG,sBAAsB,CAAC;QAC/B,8BAAyB,GAAG,CAAC,CAAC,CAAC,oBAAoB;IA+BvE,CAAC;IA7BU,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,iBAAiB,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,iEAAiE;QACrF,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,kFAAkF;QACtG,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,mDAAmD;QACvE,MAAM,IAAI,GAA8B,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5F,uGAAuG;QACvG,MAAM,OAAO,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,GAAG,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,CAAC;QAEvH,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;YACrE,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;YAC1C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;YAC/F,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;YAC1C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YACpC,OAAO;QACX,CAAC;QAED,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;IACrD,CAAC;CACJ"}

package/dist/lib/rop/RopFastTransferSourceCopyToHandler.js

@@ -0,0 +1,60 @@
+import { readPropertyTagArray } from "../codec/PropertyValue.js";
+import { openFastTransferHandle } from "./FastTransferStream.js";
+const ROP_ID_COPY_TO = 0x4d;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a folder or
+ * message (or doesn't exist)" - the same constant `RopGetPropertiesSpecificHandler` uses for its own analogous
+ * check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** `MAPI_E_TOO_BIG`: more than `MAX_PROPERTY_TAG_COUNT` tags, or a stream past `MAX_FAST_TRANSFER_BYTES`. */
+const ERROR_TOO_BIG = 0x80040305;
+/**
+ * `RopFastTransferSourceCopyTo` (`[MS-OXCFXICS]`/`[MS-OXCROPS]`, RopId `0x4D`): begins a FastTransfer download
+ * of an already-open Folder or Message (or Calendar item, itself a Message object on the wire) object,
+ * producing a new `"fastTransfer"` Server object handle `RopFastTransferSourceGetBuffer` pages the built stream
+ * out of. See `FastTransferStream.ts`'s own doc comment for this pragmatic subset's "full, non-differential
+ * dump" ICS scope and its default property columns.
+ *
+ * `Level` (whether to recurse into subfolders) is decoded to advance the reader correctly but not honored -
+ * this pragmatic subset never recurses into subfolders regardless. `CopyFlags`/`SendOptions` (Move mode, best-
+ * body preference, Unicode preference, recoverable-mode, ...) are likewise decoded but not honored - this
+ * pragmatic subset always copies (never moves) and always encodes the same way regardless of client
+ * preference, matching `RopGetPropertiesSpecificHandler`'s own treatment of its analogous `WantUnicode` field.
+ * `PropertyTags` is the properties to *exclude* from the default column set (`[MS-OXCROPS]`'s own wording) -
+ * see `FastTransferStream.ts` for why an explicit include list instead is `RopFastTransferSourceCopyProperties`'s
+ * own job, not this ROP's.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopFastTransferSourceCopyToHandler {
+    constructor() {
+        this.ropId = ROP_ID_COPY_TO;
+        this.responseHandleIndexOffset = 3; // OutputHandleIndex
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const outputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // Level - subfolder recursion not honored, see class doc comment
+        reader.readUInt32LE(); // CopyFlags - not honored, see class doc comment
+        reader.readUInt8(); // SendOptions - not honored, see class doc comment
+        const excludeTags = readPropertyTagArray(reader, reader.readUInt16LE());
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || (handle.type !== "folder" && handle.type !== "message")) {
+            writer.writeUInt8(ROP_ID_COPY_TO);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const excludePropertyIds = excludeTags ? [...new Set(excludeTags.map((tag) => tag.propertyId))] : undefined;
+        if (!excludePropertyIds || !(await openFastTransferHandle(context, outputHandleIndex, handle, { excludePropertyIds }))) {
+            writer.writeUInt8(ROP_ID_COPY_TO);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_TOO_BIG);
+            return;
+        }
+        writer.writeUInt8(ROP_ID_COPY_TO);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+    }
+}
+//# sourceMappingURL=RopFastTransferSourceCopyToHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopFastTransferSourceCopyToHandler.js","sourceRoot":"","sources":["../../../src/rop/RopFastTransferSourceCopyToHandler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B;;YAEY;AACZ,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,6GAA6G;AAC7G,MAAM,aAAa,GAAG,UAAU,CAAC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,kCAAkC;IAA/C;QACoB,UAAK,GAAG,cAAc,CAAC;QACvB,8BAAyB,GAAG,CAAC,CAAC,CAAC,oBAAoB;IA8BvE,CAAC;IA5BU,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,iBAAiB,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,iEAAiE;QACrF,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,iDAAiD;QACxE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,mDAAmD;QACvE,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAExE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;YACrE,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YAClC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QACD,MAAM,kBAAkB,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5G,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAAE,CAAC,CAAC,EAAE,CAAC;YACrH,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YAClC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YACpC,OAAO;QACX,CAAC;QAED,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;IACrD,CAAC;CACJ"}

package/dist/lib/rop/RopFastTransferSourceGetBufferHandler.js

@@ -0,0 +1,76 @@
+import { loadFastTransferBuffer } from "./FastTransferStream.js";
+const ROP_ID_GET_BUFFER = 0x4e;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a
+ * `fastTransfer` handle (or doesn't exist)" - the same constant `RopGetPropertiesSpecificHandler` uses for its
+ * own analogous check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** The `BufferSize` sentinel (`[MS-OXCROPS]`'s own documented value) meaning "let the server pick the chunk
+ * size". */
+const BUFFER_SIZE_SERVER_DETERMINED = 0xbabe;
+/** The response's own `TransferBufferSize` field is a 16-bit count, so a single call never returns more than this. */
+const MAX_TRANSFER_BUFFER_SIZE = 0xffff;
+/** `MAPI_E_TOO_BIG`: rebuilding the stream passed `MAX_FAST_TRANSFER_BYTES`. */
+const ERROR_TOO_BIG = 0x80040305;
+/** `MAPI_E_CALL_FAILED`: the stream was lost part-way through paging and can't be continued - see
+ * `loadFastTransferBuffer`. The client starts the transfer again. */
+const ERROR_TRANSFER_LOST = 0x80004005;
+/** The response bytes before `TransferBuffer`: RopId, InputHandleIndex, ReturnValue, TransferStatus,
+ * InProgressCount, TotalStepCount, Reserved, TransferBufferSize. */
+const RESPONSE_HEADER_BYTES = 15;
+/** `TransferStatus` values (`[MS-OXCFXICS]` §2.2.3.1.1.5.2). */
+const TRANSFER_STATUS_PARTIAL = 0x0001;
+const TRANSFER_STATUS_NO_ROOM = 0x0002;
+const TRANSFER_STATUS_DONE = 0x0003;
+/**
+ * `RopFastTransferSourceGetBuffer` (`[MS-OXCFXICS]`/`[MS-OXCROPS]`, RopId `0x4E`): pages the FastTransfer
+ * stream a prior `RopFastTransferSourceCopyTo`/`CopyProperties` built (`FastTransferStream.ts`) out of its
+ * `"fastTransfer"` handle, `BufferSize` bytes at a time. For the `0xBABE` "server-determined" sentinel the server
+ * picks the size, up to the client's `MaximumBufferSize`.
+ *
+ * Every chunk is also held to the room left in this request's ROP output buffer (`context.ropOutputRemaining`) and
+ * the 16-bit `TransferBufferSize`. Reports `Done` once the whole stream has been returned, `Partial` otherwise, and
+ * `NoRoom` when the output buffer has no space for any bytes this time (the client asks again in a new request).
+ *
+ * Fails with `MAPI_E_TOO_BIG` when a stream that had to be rebuilt is too large, and with `MAPI_E_CALL_FAILED` when
+ * the stream was lost part-way through (see `loadFastTransferBuffer`) - never with bytes from a different stream.
+ * Failure responses carry only `ReturnValue`, like every other failing handler here. `BackoffTime` is never emitted.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopFastTransferSourceGetBufferHandler {
+    constructor() {
+        this.ropId = ROP_ID_GET_BUFFER;
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const bufferSize = reader.readUInt16LE();
+        const requestedSize = bufferSize === BUFFER_SIZE_SERVER_DETERMINED ? reader.readUInt16LE() : bufferSize;
+        const handle = context.session.handles[inputHandleIndex];
+        const loaded = handle?.type === "fastTransfer" ? await loadFastTransferBuffer(context, inputHandleIndex, handle) : undefined;
+        if (!loaded || typeof loaded === "string") {
+            writer.writeUInt8(ROP_ID_GET_BUFFER);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(!loaded ? ERROR_INVALID_OBJECT : loaded === "tooBig" ? ERROR_TOO_BIG : ERROR_TRANSFER_LOST);
+            return;
+        }
+        const position = handle.transferPosition ?? 0;
+        const remaining = loaded.length - position;
+        const room = Math.max(0, (context.ropOutputRemaining ?? Infinity) - RESPONSE_HEADER_BYTES);
+        const chunkSize = Math.min(requestedSize, remaining, MAX_TRANSFER_BUFFER_SIZE, room);
+        const chunk = loaded.subarray(position, position + chunkSize);
+        handle.transferPosition = position + chunk.length;
+        const done = position + chunk.length >= loaded.length;
+        const status = done ? TRANSFER_STATUS_DONE : room === 0 ? TRANSFER_STATUS_NO_ROOM : TRANSFER_STATUS_PARTIAL;
+        writer.writeUInt8(ROP_ID_GET_BUFFER);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt16LE(status);
+        writer.writeUInt16LE(0); // InProgressCount - no real progress tracking in this pragmatic subset
+        writer.writeUInt16LE(1); // TotalStepCount - pragmatic constant, only ever used for progress-bar display
+        writer.writeUInt8(0); // Reserved
+        writer.writeUInt16LE(chunk.length); // TransferBufferSize
+        writer.writeBytes(chunk); // TransferBuffer
+    }
+}
+//# sourceMappingURL=RopFastTransferSourceGetBufferHandler.js.map

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

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

package/dist/lib/rop/RopGetContentsTableHandler.js

@@ -0,0 +1,55 @@
+import { assignHandle } from "../MapiSessionManager.js";
+import { resolveContentsKind } from "./ContentsTable.js";
+const ROP_ID_GET_CONTENTS_TABLE = 0x05;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a folder (or
+ * doesn't exist)" - the same constant `RopGetHierarchyTableHandler` uses for its own analogous check. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/**
+ * `RopGetContentsTable` (`[MS-OXCFOLD]`/`[MS-OXCROPS]`): opens a table listing an already-opened folder's
+ * messages, producing a new `"table"` Server object handle `RopSetColumns`/`RopQueryRows` reference by
+ * `InputHandleIndex` - the exact same request/response shape as `RopGetHierarchyTable` (confirmed identical
+ * field-by-field against `[MS-OXCROPS]`'s own request-buffer page, differing only in `RopId`), just listing
+ * messages instead of child folders.
+ *
+ * The table holds no rows. It records which kind of item the folder contains (`contentsKind`, decided once here
+ * from the folder's own `type`: Calendar folders list `"calendarEvent:<uid>"` rows, Contacts `"contact:<uid>"`,
+ * Tasks `"task:<uid>"`, everything else `"message:<uid>"`), and `RopQueryRows` reads each requested window from
+ * the database - see `ContentsTable.ts`.
+ *
+ * A folder's contents table is only ever non-empty for a real folder (`"folder:<uid>"`) - the virtual special
+ * folders (`RopLogonHandler`'s own doc comment) have no real backing row to hold messages under, so opening a
+ * contents table on one always yields an empty table rather than an error.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopGetContentsTableHandler {
+    constructor() {
+        this.ropId = ROP_ID_GET_CONTENTS_TABLE;
+        this.responseHandleIndexOffset = 3; // OutputHandleIndex
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const outputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // TableFlags - only the Standard (0x00) case is supported; see RopGetHierarchyTableHandler's own doc comment
+        const folderHandle = context.session.handles[inputHandleIndex];
+        if (!folderHandle || folderHandle.type !== "folder") {
+            writer.writeUInt8(ROP_ID_GET_CONTENTS_TABLE);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const entityUid = folderHandle.entityUid;
+        if (entityUid.startsWith("folder:")) {
+            const contentsKind = await resolveContentsKind(entityUid.slice("folder:".length), context);
+            assignHandle(context.session, outputHandleIndex, { type: "table", entityUid, contentsKind, cursor: 0 });
+        }
+        else {
+            assignHandle(context.session, outputHandleIndex, { type: "table", entityUid, rows: [], cursor: 0 });
+        }
+        writer.writeUInt8(ROP_ID_GET_CONTENTS_TABLE);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+    }
+}
+//# sourceMappingURL=RopGetContentsTableHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopGetContentsTableHandler.js","sourceRoot":"","sources":["../../../src/rop/RopGetContentsTableHandler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAEvC;yGACyG;AACzG,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QACoB,UAAK,GAAG,yBAAyB,CAAC;QAClC,8BAAyB,GAAG,CAAC,CAAC,CAAC,oBAAoB;IA4BvE,CAAC;IA1BU,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,iBAAiB,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,6GAA6G;QAEjI,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC/D,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;YAC7C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC;QACzC,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;YAC3F,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5G,CAAC;aAAM,CAAC;YACJ,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACxG,CAAC;QAED,MAAM,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;IACrD,CAAC;CACJ"}

package/dist/lib/rop/RopGetHierarchyTableHandler.js

@@ -0,0 +1,42 @@
+import { assignHandle } from "../MapiSessionManager.js";
+import { resolveFolderChildren } from "./FolderTarget.js";
+const ROP_ID_GET_HIERARCHY_TABLE = 0x04;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a folder
+ * (or doesn't exist)". */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/**
+ * `RopGetHierarchyTable` (`[MS-OXCFOLD]`/`[MS-OXCROPS]`): opens a table listing an already-opened folder's
+ * direct child folders, producing a new `"table"` Server object handle `RopSetColumns`/`RopQueryRows`
+ * reference by `InputHandleIndex`. Only `TableFlags = 0x00` ("Standard") is supported - this pragmatic subset
+ * has no deferred/async table population, so the immediate-row-count-returning variants some `TableFlags`
+ * values request are moot, and the response omits the row-count field those variants add (confirmed absent
+ * for the Standard case against `[MS-OXCROPS]`'s own request-buffer page, which explicitly lists `TableFlags`
+ * as this ROP's only request payload beyond the common handle-index header).
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopGetHierarchyTableHandler {
+    constructor() {
+        this.ropId = ROP_ID_GET_HIERARCHY_TABLE;
+        this.responseHandleIndexOffset = 3; // OutputHandleIndex
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        const outputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // TableFlags - only the Standard (0x00) case is supported; see class doc comment
+        const folderHandle = context.session.handles[inputHandleIndex];
+        if (!folderHandle || folderHandle.type !== "folder") {
+            writer.writeUInt8(ROP_ID_GET_HIERARCHY_TABLE);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const rows = await resolveFolderChildren(context.mailboxUid, folderHandle.entityUid, context.folderRepo, undefined, context.budget);
+        assignHandle(context.session, outputHandleIndex, { type: "table", entityUid: folderHandle.entityUid, rows, cursor: 0 });
+        writer.writeUInt8(ROP_ID_GET_HIERARCHY_TABLE);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+    }
+}
+//# sourceMappingURL=RopGetHierarchyTableHandler.js.map