@rapidmx/mapi-plugin 1.0.0-beta.3

package/dist/lib/rop/RopFastTransferSourceCopyPropertiesHandler.js

@@ -0,0 +1,61 @@
+import { readPropertyTag } from "../codec/PropertyValue.js";
+import { buildFastTransferStream } 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;
+/**
+ * `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;
+    }
+    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 propertyTagCount = reader.readUInt16LE();
+        const columns = [];
+        for (let i = 0; i < propertyTagCount; i++) {
+            columns.push(readPropertyTag(reader));
+        }
+        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;
+        }
+        const transferBuffer = await buildFastTransferStream(handle, context, { columns });
+        context.session.handles[outputHandleIndex] = {
+            type: "fastTransfer",
+            entityUid: handle.entityUid,
+            transferBufferBase64: transferBuffer.toString("base64"),
+            transferPosition: 0,
+        };
+        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,eAAe,EAAoB,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC;;YAEY;AACZ,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,0CAA0C;IAAvD;QACoB,UAAK,GAAG,sBAAsB,CAAC;IAmCnD,CAAC;IAjCU,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,gBAAgB,GAAW,MAAM,CAAC,YAAY,EAAE,CAAC;QACvD,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1C,CAAC;QAED,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;QAED,MAAM,cAAc,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG;YACzC,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,oBAAoB,EAAE,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACvD,gBAAgB,EAAE,CAAC;SACtB,CAAC;QAEF,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,61 @@
+import { readPropertyTag } from "../codec/PropertyValue.js";
+import { buildFastTransferStream } 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;
+/**
+ * `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;
+    }
+    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 propertyTagCount = reader.readUInt16LE();
+        const excludePropertyIds = new Set();
+        for (let i = 0; i < propertyTagCount; i++) {
+            excludePropertyIds.add(readPropertyTag(reader).propertyId);
+        }
+        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 transferBuffer = await buildFastTransferStream(handle, context, { excludePropertyIds });
+        context.session.handles[outputHandleIndex] = {
+            type: "fastTransfer",
+            entityUid: handle.entityUid,
+            transferBufferBase64: transferBuffer.toString("base64"),
+            transferPosition: 0,
+        };
+        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,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B;;YAEY;AACZ,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,kCAAkC;IAA/C;QACoB,UAAK,GAAG,cAAc,CAAC;IAmC3C,CAAC;IAjCU,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,gBAAgB,GAAW,MAAM,CAAC,YAAY,EAAE,CAAC;QACvD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,kBAAkB,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAC/D,CAAC;QAED,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;QAED,MAAM,cAAc,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC9F,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG;YACzC,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,oBAAoB,EAAE,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACvD,gBAAgB,EAAE,CAAC;SACtB,CAAC;QAEF,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,75 @@
+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 (`[MS-OXCFXICS]`'s own `RopFastTransferSourceGetBuffer`
+ * response-buffer page), so a single call can never actually return more than this many bytes. For the
+ * `0xBABE` "server-determined" sentinel this caps what would otherwise be "the entire remaining buffer in one
+ * call" (only spec-valid when that buffer happens to fit in a `uint16`) down to the same paging behavior a
+ * client-specified `BufferSize` already gets - `writeUInt16LE` throwing `RangeError` for an out-of-range value
+ * is not spec-valid for any size of transfer. */
+const MAX_TRANSFER_BUFFER_SIZE = 0xffff;
+/** `TransferStatus` values (`[MS-OXCFXICS]` §2.2.3.1.1.5.2, confirmed this session) - only the two this
+ * pragmatic subset (which never errors mid-transfer once a `"fastTransfer"` handle exists, and never returns
+ * `NoRoom`) ever produces. */
+const TRANSFER_STATUS_PARTIAL = 0x0001;
+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 (or the entire remaining buffer, capped to
+ * `MAX_TRANSFER_BUFFER_SIZE`, for the `0xBABE` "server-determined" sentinel - `MaximumBufferSize`, present only
+ * in that case, is decoded to advance the reader correctly but not honored, since honoring it would mean
+ * returning *more* than one chunk can carry, not less). Reports `Done` once the whole buffer has been returned
+ * across one or more calls, `Partial` otherwise - `NoRoom` and `Error` are never produced (a `"fastTransfer"`
+ * handle, once created, always has a complete, already-valid buffer to page from).
+ *
+ * `BackoffTime` is never emitted (this pragmatic subset never returns the one `ReturnValue` that field is
+ * conditional on), and the failure path (`ERROR_INVALID_OBJECT`) omits every field after `ReturnValue` entirely
+ * - the same "just the fixed header, no success-only tail" shape every other failing handler in this pragmatic
+ * subset already uses, not a specific claim about the real spec's own error-path byte layout.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopFastTransferSourceGetBufferHandler {
+    constructor() {
+        this.ropId = ROP_ID_GET_BUFFER;
+    }
+    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();
+        if (bufferSize === BUFFER_SIZE_SERVER_DETERMINED) {
+            reader.readUInt16LE(); // MaximumBufferSize - see class doc comment
+        }
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || handle.type !== "fastTransfer") {
+            writer.writeUInt8(ROP_ID_GET_BUFFER);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const fullBuffer = Buffer.from(handle.transferBufferBase64 ?? "", "base64");
+        const position = handle.transferPosition ?? 0;
+        const remaining = fullBuffer.length - position;
+        const requestedSize = bufferSize === BUFFER_SIZE_SERVER_DETERMINED ? remaining : bufferSize;
+        const chunkSize = Math.min(requestedSize, remaining, MAX_TRANSFER_BUFFER_SIZE);
+        const chunk = fullBuffer.subarray(position, position + chunkSize);
+        handle.transferPosition = position + chunk.length;
+        const done = handle.transferPosition >= fullBuffer.length;
+        writer.writeUInt8(ROP_ID_GET_BUFFER);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt16LE(done ? TRANSFER_STATUS_DONE : TRANSFER_STATUS_PARTIAL);
+        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":"AAOA,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B;;0BAE0B;AAC1B,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;YACY;AACZ,MAAM,6BAA6B,GAAG,MAAM,CAAC;AAE7C;;;;;iDAKiD;AACjD,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAExC;;8BAE8B;AAC9B,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,qCAAqC;IAAlD;QACoB,UAAK,GAAG,iBAAiB,CAAC;IAqC9C,CAAC;IAnCU,MAAM,CAAC,MAAoB,EAAE,MAAoB,EAAE,OAAmB;QACzE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,uFAAuF;QAC3G,MAAM,gBAAgB,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACpD,MAAM,UAAU,GAAW,MAAM,CAAC,YAAY,EAAE,CAAC;QACjD,IAAI,UAAU,KAAK,6BAA6B,EAAE,CAAC;YAC/C,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,4CAA4C;QACvE,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,oBAAoB,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,QAAQ,CAAC;QAC/C,MAAM,aAAa,GAAG,UAAU,KAAK,6BAA6B,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAC5F,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;QAClE,MAAM,CAAC,gBAAgB,GAAG,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,gBAAgB,IAAI,UAAU,CAAC,MAAM,CAAC;QAE1D,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;QACjD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAC5E,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,uEAAuE;QAChG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,+EAA+E;QACxG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;QACjC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB;QACzD,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB;IAC/C,CAAC;CACJ"}

package/dist/lib/rop/RopGetContentsTableHandler.js

@@ -0,0 +1,76 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { FolderType } from "@rapidmx/restapi";
+import { resolveFolderCalendarEvents } from "./CalendarEventTarget.js";
+import { resolveFolderContacts } from "./ContactTarget.js";
+import { resolveFolderMessages } from "./MessageTarget.js";
+import { resolveFolderTasks } from "./TaskTarget.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. `RopSetColumns`/`RopQueryRows` themselves need no changes at all to
+ * support this - they already operate generically on whatever `rows`/`columns` a table handle carries,
+ * dispatching to `FolderTarget`'s or `MessageTarget`'s resolvers by row-target prefix (`"folder:"`/`"virtual:"`
+ * vs `"message:"`).
+ *
+ * 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.
+ *
+ * **Calendar folders** (`Folder.type === FolderType.CALENDAR`) list `"calendarEvent:<uid>"` rows resolved via
+ * `calendarEventRepo` instead of `"message:<uid>"` rows - a single table handle only ever holds one kind of
+ * row, decided once here by checking the folder's own `type`, exactly the same "resolve by target-string
+ * prefix downstream" design `MessageTarget`/`FolderTarget` already use for their own rows. **Contacts and
+ * Tasks** folders (`FolderType.CONTACTS`/`TASKS`) list `"contact:<uid>"`/`"task:<uid>"` rows the same way, via
+ * `contactRepo`/`taskRepo` - empty (rather than an error) when the context has neither wired up, the same
+ * optional-repo degradation `RopContext`'s own doc comment describes.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopGetContentsTableHandler {
+    constructor() {
+        this.ropId = ROP_ID_GET_CONTENTS_TABLE;
+    }
+    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 rows = folderHandle.entityUid.startsWith("folder:")
+            ? await this.resolveRows(folderHandle.entityUid.slice("folder:".length), context)
+            : [];
+        context.session.handles[outputHandleIndex] = { type: "table", entityUid: folderHandle.entityUid, rows, cursor: 0 };
+        writer.writeUInt8(ROP_ID_GET_CONTENTS_TABLE);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+    }
+    async resolveRows(folderUid, context) {
+        const folder = await context.folderRepo.findOne(folderUid, { ignoreACL: true });
+        if (folder?.type === FolderType.CALENDAR) {
+            return resolveFolderCalendarEvents(folderUid, context.calendarEventRepo);
+        }
+        if (folder?.type === FolderType.CONTACTS) {
+            return context.contactRepo ? resolveFolderContacts(folderUid, context.contactRepo) : [];
+        }
+        if (folder?.type === FolderType.TASKS) {
+            return context.taskRepo ? resolveFolderTasks(folderUid, context.taskRepo) : [];
+        }
+        return resolveFolderMessages(folderUid, context.messageRepo);
+    }
+}
+//# 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":"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"}

package/dist/lib/rop/RopGetHierarchyTableHandler.js

@@ -0,0 +1,40 @@
+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;
+    }
+    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);
+        context.session.handles[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

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopGetHierarchyTableHandler.js","sourceRoot":"","sources":["../../../src/rop/RopGetHierarchyTableHandler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAExC;0BAC0B;AAC1B,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,2BAA2B;IAAxC;QACoB,UAAK,GAAG,0BAA0B,CAAC;IAuBvD,CAAC;IArBU,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,iFAAiF;QAErG,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,0BAA0B,CAAC,CAAC;YAC9C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,MAAM,IAAI,GAAa,MAAM,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACnH,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAEnH,MAAM,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;IACrD,CAAC;CACJ"}

package/dist/lib/rop/RopGetPropertiesSpecificHandler.js

@@ -0,0 +1,55 @@
+import { readPropertyTag, writePropertyValue } from "../codec/PropertyValue.js";
+import { resolvePropertyValues } from "./PropertyResolvers.js";
+const ROP_ID_GET_PROPERTIES_SPECIFIC = 0x07;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle isn't a
+ * folder/message (or doesn't exist)" - the same constant `RopGetHierarchyTableHandler`/`RopGetContentsTableHandler`
+ * use for their own analogous checks. Attachment/Logon objects (also spec-valid targets for this ROP) aren't
+ * supported in this pragmatic subset. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/**
+ * `RopGetPropertiesSpecific` (`[MS-OXCPRPT]`/`[MS-OXCROPS]`): fetches named property values for a single
+ * already-opened Folder or Message object (`RopOpenFolder`/`RopOpenMessage`), by an explicit `PropertyTags`
+ * list - the single-object analog of `RopQueryRows`' per-row column fetch, reusing the exact same
+ * `PropertyResolvers` value-resolution logic (a folder/message handle's `entityUid` is already the same
+ * `"folder:"`/`"virtual:"`/`"message:"` target-string format a table row uses). Like `RopQueryRows`, this
+ * pragmatic subset always emits a `StandardPropertyRow` (`Flags = 0x00`, confirmed as the response's `RowData`
+ * format via `[MS-OXCROPS]`'s own "Success Response Buffer" page, which names `[MS-OXCDATA]` §2.8's
+ * `PropertyRow` structure directly) - an unsupported property falls back to a type-appropriate default rather
+ * than a `FlaggedPropertyRow`'s per-column error signaling, exactly as `RopQueryRows` already does.
+ *
+ * `PropertySizeLimit`/`WantUnicode` are decoded (to advance the reader correctly) but not honored - this
+ * pragmatic subset never truncates a property value and always encodes strings the same way regardless of the
+ * client's Unicode preference (see `PropertyValue.ts`'s own string-encoding doc comments).
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopGetPropertiesSpecificHandler {
+    constructor() {
+        this.ropId = ROP_ID_GET_PROPERTIES_SPECIFIC;
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        reader.readUInt16LE(); // PropertySizeLimit - no truncation support in this pragmatic subset
+        reader.readUInt16LE(); // WantUnicode - this pragmatic subset always encodes strings the same way regardless
+        const propertyTagCount = reader.readUInt16LE();
+        const propertyTags = [];
+        for (let i = 0; i < propertyTagCount; i++) {
+            propertyTags.push(readPropertyTag(reader));
+        }
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || (handle.type !== "folder" && handle.type !== "message")) {
+            writer.writeUInt8(ROP_ID_GET_PROPERTIES_SPECIFIC);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const values = await resolvePropertyValues(handle.entityUid, propertyTags, context);
+        writer.writeUInt8(ROP_ID_GET_PROPERTIES_SPECIFIC);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(0x00); // PropertyRow Flags - StandardPropertyRow, see class doc comment
+        propertyTags.forEach((tag, index) => writePropertyValue(writer, tag.propertyType, values[index]));
+    }
+}
+//# sourceMappingURL=RopGetPropertiesSpecificHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopGetPropertiesSpecificHandler.js","sourceRoot":"","sources":["../../../src/rop/RopGetPropertiesSpecificHandler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,MAAM,8BAA8B,GAAG,IAAI,CAAC;AAE5C;;;yCAGyC;AACzC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,+BAA+B;IAA5C;QACoB,UAAK,GAAG,8BAA8B,CAAC;IA6B3D,CAAC;IA3BU,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,YAAY,EAAE,CAAC,CAAC,qEAAqE;QAC5F,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,qFAAqF;QAC5G,MAAM,gBAAgB,GAAW,MAAM,CAAC,YAAY,EAAE,CAAC;QACvD,MAAM,YAAY,GAAmD,EAAE,CAAC;QACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,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,8BAA8B,CAAC,CAAC;YAClD,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QAEpF,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;QAClD,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;QACjD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,iEAAiE;QAC1F,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtG,CAAC;CACJ"}

package/dist/lib/rop/RopGetPropertyIdsFromNamesHandler.js

@@ -0,0 +1,92 @@
+import { decodeGuid } from "../codec/MapiGuid.js";
+import { assignOrGetNamedPropertyId } from "./NamedPropertyRegistry.js";
+const ROP_ID_GET_PROPERTY_IDS_FROM_NAMES = 0x56;
+/** `PropertyName.Kind` (`[MS-OXCDATA]` §2.6.1) values. */
+const KIND_LID = 0x00;
+const KIND_NAME = 0x01;
+// KIND_NONE = 0xFF ("the property does not have an associated PropertyName field") is a real, spec-defined
+// value but never resolvable to a real named property - handled by readPropertyName()'s default/`undefined`
+// return rather than its own named constant.
+/** The trailing UTF-16LE null-terminator code unit `PropertyName.Name` (Kind=0x01) is documented to always
+ * carry - stripped by `charCodeAt`/numeric comparison rather than a string literal containing the null
+ * character itself, to avoid embedding a raw control character in source text. */
+const NULL_CODE_UNIT = 0;
+/** The well-known MAPI HRESULT `MAPI_E_INVALID_OBJECT`, reused for "the referenced handle doesn't exist" - the
+ * same constant `RopGetPropertiesSpecificHandler` uses for its own analogous check. Real Exchange resolves
+ * named properties per-logon regardless of which specific object handle a client happens to call this ROP
+ * against (Store/Folder/Message all share one mailbox-wide mapping table) - this pragmatic subset only
+ * requires *some* real handle to exist, not a particular type, matching that "any object will do" semantics. */
+const ERROR_INVALID_OBJECT = 0x80070005;
+/** Decodes one `PropertyName` structure (`[MS-OXCDATA]` §2.6.1, confirmed field order this session: `Kind`
+ * **then** `GUID` - not the reverse). Returns `undefined` for `Kind = 0xFF` ("no associated PropertyName"),
+ * which cannot resolve to any real named property. */
+function readPropertyName(reader) {
+    const kind = reader.readUInt8();
+    const guid = decodeGuid(reader);
+    if (kind === KIND_LID) {
+        return { guid, kind: "lid", lid: reader.readUInt32LE() };
+    }
+    if (kind === KIND_NAME) {
+        const nameSize = reader.readUInt8();
+        const nameBytes = reader.readBytes(nameSize);
+        // The spec text describing NameSize ("the number of bytes in the Name string that follows it") doesn't
+        // unambiguously say whether that count includes the field's own trailing 2-zero-byte terminator - this
+        // pragmatic subset treats it as inclusive (the common real-world convention for this style of
+        // length-prefixed MAPI string) and strips one trailing null code unit if present. Never exercised by
+        // this pragmatic subset's own Calendar property table (every property it needs is Kind=LID), so this
+        // is defensive completeness for an arbitrary client request, not a property on the critical path.
+        let name = nameBytes.toString("utf16le");
+        if (name.length > 0 && name.charCodeAt(name.length - 1) === NULL_CODE_UNIT) {
+            name = name.slice(0, -1);
+        }
+        return { guid, kind: "name", name };
+    }
+    return undefined;
+}
+/**
+ * `RopGetPropertyIdsFromNames` (`[MS-OXCPRPT]`/`[MS-OXCROPS]` §2.2.8.1): resolves a list of named properties
+ * (`PropertyName` structures - a property-set `GUID` plus a numeric `LID` or string `Name`) into numeric
+ * property IDs a subsequent `RopSetProperties`/`RopGetPropertiesSpecific`/`RopQueryRows` call can use directly.
+ * This is the mechanism almost every Calendar-specific property (`PidLidAppointmentStartWhole`,
+ * `PidLidBusyStatus`, `PidLidAppointmentRecur`, ...) requires, since none of them have a fixed numeric
+ * `PidTag*`-style ID the way `PidTagSubject` does - see `NamedPropertyRegistry.ts`'s own doc comment for the
+ * session-scoped registry this delegates to.
+ *
+ * An unresolvable `PropertyName` (`Kind = 0xFF`) maps to `0x0000` in the response, per spec - this pragmatic
+ * subset has no other unmappable case (no permission/quota/hard-limit checks), so every `Kind = 0x00`/`0x01`
+ * entry always succeeds. `Flags` is decoded to advance past it correctly but not honored - see
+ * `assignOrGetNamedPropertyId`'s own doc comment for why "probe" and "assign" collapse to the same behavior
+ * for a purely session-scoped registry.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopGetPropertyIdsFromNamesHandler {
+    constructor() {
+        this.ropId = ROP_ID_GET_PROPERTY_IDS_FROM_NAMES;
+    }
+    handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const inputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // Flags - see class doc comment
+        const propertyNameCount = reader.readUInt16LE();
+        const propertyNames = [];
+        for (let i = 0; i < propertyNameCount; i++) {
+            propertyNames.push(readPropertyName(reader));
+        }
+        if (!context.session.handles[inputHandleIndex]) {
+            writer.writeUInt8(ROP_ID_GET_PROPERTY_IDS_FROM_NAMES);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(ERROR_INVALID_OBJECT);
+            return;
+        }
+        const propertyIds = propertyNames.map((name) => (name ? assignOrGetNamedPropertyId(context.session, name) : 0x0000));
+        writer.writeUInt8(ROP_ID_GET_PROPERTY_IDS_FROM_NAMES);
+        writer.writeUInt8(inputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt16LE(propertyIds.length);
+        for (const id of propertyIds) {
+            writer.writeUInt16LE(id);
+        }
+    }
+}
+//# sourceMappingURL=RopGetPropertyIdsFromNamesHandler.js.map

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

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

package/dist/lib/rop/RopHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RopHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopHandler.js","sourceRoot":"","sources":["../../../src/rop/RopHandler.ts"],"names":[],"mappings":""}