@rapidmx/mapi-plugin 1.0.0-beta.10

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,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,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;QACnC,8BAAyB,GAAG,CAAC,CAAC,CAAC,oBAAoB;IAuBvE,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,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9I,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAExH,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,56 @@
+import { readPropertyTagArray } from "../codec/PropertyValue.js";
+import { resolvePropertyValues, writePropertyValueSafely } 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;
+/** `MAPI_E_TOO_BIG`, for more than `MAX_PROPERTY_TAG_COUNT` requested tags. */
+const ERROR_TOO_BIG = 0x80040305;
+/**
+ * `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. That includes
+ * a client-requested `propertyType` that doesn't match what a tag's own `propertyId` actually resolves to
+ * (`PropertyResolvers.writePropertyValueSafely`, shared with `RopQueryRowsHandler`) - not just a `propertyId`
+ * this codebase has no data for.
+ *
+ * `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 propertyTags = readPropertyTagArray(reader, reader.readUInt16LE());
+        const handle = context.session.handles[inputHandleIndex];
+        if (!handle || (handle.type !== "folder" && handle.type !== "message") || !propertyTags) {
+            writer.writeUInt8(ROP_ID_GET_PROPERTIES_SPECIFIC);
+            writer.writeUInt8(inputHandleIndex);
+            writer.writeUInt32LE(propertyTags ? ERROR_INVALID_OBJECT : ERROR_TOO_BIG);
+            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) => writePropertyValueSafely(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,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGzF,MAAM,8BAA8B,GAAG,IAAI,CAAC;AAE5C;;;yCAGyC;AACzC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,+EAA+E;AAC/E,MAAM,aAAa,GAAG,UAAU,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,+BAA+B;IAA5C;QACoB,UAAK,GAAG,8BAA8B,CAAC;IAyB3D,CAAC;IAvBU,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,YAAY,GAAG,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAEzE,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,IAAI,CAAC,YAAY,EAAE,CAAC;YACtF,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;YAClD,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YAC1E,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,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5G,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,6 @@
+import { defaultHandleDataStore } from "./HandleDataCache.js";
+/** The `HandleDataStore` a handler should use for `context`. */
+export function handleDataStoreOf(context) {
+    return context.handleData ?? defaultHandleDataStore;
+}
+//# 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":"AAUA,OAAO,EAAE,sBAAsB,EAAwB,MAAM,sBAAsB,CAAC;AA8EpF,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,OAAuC;IACrE,OAAO,OAAO,CAAC,UAAU,IAAI,sBAAsB,CAAC;AACxD,CAAC"}

package/dist/lib/rop/RopLogonHandler.js

@@ -0,0 +1,135 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { BufferWriter } from "../codec/BufferCursor.js";
+import { encodeGuid } from "../codec/MapiGuid.js";
+import { FolderType } from "@rapidmx/restapi";
+import { assignHandle } from "../MapiSessionManager.js";
+import { assignOrGetFid } from "./FolderTarget.js";
+const ROP_ID_LOGON = 0xfe;
+/** A fixed replica identity shared by every logon in this deployment - legitimate per `[MS-OXCSTOR]`'s own
+ * "RopLogon ROP Success Response Buffer for Private Mailbox" section ("If the client did not set
+ * USE_PER_MDB_REPLID_MAPPING... this value MUST be identical for all private mailbox logons on the same RPC
+ * session"); this pragmatic subset never varies replica identity, so one fixed constant satisfies that. */
+const REPL_ID = 1;
+const REPL_GUID = "00000000-0000-0000-0000-000000000001";
+/**
+ * Order matches `[MS-OXCSTOR]` §2.2.1.1.3 ("RopLogon ROP Success Response Buffer for Private Mailbox")'s
+ * `FolderIds` list exactly: Root, Deferred Action, Spooler Queue, IPM Subtree, Inbox, Outbox, Sent Items,
+ * Deleted Items, Common Views, Schedule, Search, Views, Shortcuts (13 folders total, confirmed against the
+ * spec page directly). Folders with a matching `FolderType` resolve to a real `Folder` when one exists for
+ * this mailbox; the rest are virtual placeholders. Root/IPM Subtree have no real backing row at all in this
+ * data model, matching how EAS's own `FolderSync` already represents "the root" as `ParentId "0"` rather than
+ * a real `Folder` - not a new gap this ROP introduces. Deferred Action/Spooler Queue/Common Views/Schedule/
+ * Search/Views/Shortcuts are MAPI-internal administrative folders this library's `FolderType` enum has no
+ * concept of at all (it models the REST/EAS-relevant folder kinds - Inbox/Sent/Drafts/Deleted/Outbox/Junk/
+ * Calendar/Contacts/Tasks/Notes/User - not Exchange's own internal bookkeeping folders). A real client rarely
+ * if ever tries to open most of these directly; documented gap, not silently dropped.
+ */
+const SPECIAL_FOLDERS = [
+    { name: "root" },
+    { name: "deferredAction" },
+    { name: "spoolerQueue" },
+    { name: "ipmSubtree" },
+    { name: "inbox", folderType: FolderType.INBOX },
+    { name: "outbox", folderType: FolderType.OUTBOX },
+    { name: "sentItems", folderType: FolderType.SENT_ITEMS },
+    { name: "deletedItems", folderType: FolderType.DELETED_ITEMS },
+    { name: "commonViews" },
+    { name: "schedule" },
+    { name: "search" },
+    { name: "views" },
+    { name: "shortcuts" },
+];
+/**
+ * `RopLogon` (`[MS-OXCSTOR]`/`[MS-OXCROPS]`): the first ROP of any session, a prerequisite for every other
+ * ROP. This pragmatic subset always performs a private-mailbox logon against the mailbox `BaseMapiEmsmdbRoute`
+ * already resolved and authorized at `Connect` time - the request's own `Essdn` field is decoded (to advance
+ * past it correctly) but never trusted for mailbox identity, the same principle `BaseMapiEmsmdbRoute.Connect`
+ * already applies to that request's `UserDn` field. Because mailbox resolution already happened upstream,
+ * this handler has no real failure path to model (`ecUnknownUser`/`ecLoginFailure`/... are all deferred).
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopLogonHandler {
+    constructor() {
+        this.ropId = ROP_ID_LOGON;
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        const outputHandleIndex = reader.readUInt8();
+        const logonFlags = reader.readUInt8();
+        reader.readUInt32LE(); // OpenFlags - unused; every logon behaves as a plain private-mailbox logon
+        reader.readUInt32LE(); // StoreState - per spec, unused and always 0
+        const essdnSize = reader.readUInt16LE();
+        if (essdnSize > 0) {
+            reader.readBytes(essdnSize); // Essdn - never trusted for mailbox identity, see class doc comment
+        }
+        const fids = await this.assignFolderIds(context);
+        assignHandle(context.session, outputHandleIndex, { type: "logon", entityUid: context.mailboxUid });
+        writer.writeUInt8(ROP_ID_LOGON);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(logonFlags); // echoed back unchanged, per spec
+        for (const folder of SPECIAL_FOLDERS) {
+            writer.writeBigUInt64LE(BigInt(fids[folder.name]));
+        }
+        writer.writeUInt8(0x01); // ResponseFlags - Reserved bit only; no OwnerRight/SendAsRight/OOF claims in this subset
+        writer.writeBytes(encodeGuid(context.mailboxUid));
+        writer.writeUInt16LE(REPL_ID);
+        writer.writeBytes(encodeGuid(REPL_GUID));
+        writer.writeBytes(encodeLogonTime(new Date()));
+        writer.writeBigUInt64LE(1n); // GwartTime - fixed constant; no real GWART/AD concept in this deployment
+        writer.writeUInt32LE(0); // StoreState - unused
+    }
+    /**
+     * Assigns this session's FIDs for the 13 special folders, remembering each one's real-`Folder`-or-virtual-
+     * placeholder target in `session.folderIds` so a later `RopOpenFolder` can resolve it back to something
+     * real. Delegates to `FolderTarget.assignOrGetFid` - the same "reuse an existing FID for this target if one
+     * was already assigned, otherwise mint the next free one" logic `RopGetHierarchyTable`/`RopQueryRows` use
+     * for child folders - rather than wholesale-replacing `session.folderIds` with a freshly-numbered map
+     * starting back at FID 1. A second `RopLogon` on a live session (spec-legal - a real client can reconnect
+     * or re-logon within one session context) previously invalidated every FID a client had already learned
+     * for a child folder via `RopGetHierarchyTable`/`RopQueryRows` (all assigned starting at FID 14, since the
+     * old code always reset the counter to 1-13 for just these specials) and could even cause FIDs 14+ to be
+     * silently re-issued to a *different* folder than the one the client last associated with that number.
+     * Reusing `assignOrGetFid` means a re-`RopLogon` is now purely additive: these 13 targets get their
+     * existing FIDs back if this is a second logon, and any child-folder FIDs already assigned are left alone.
+     */
+    async assignFolderIds(context) {
+        // The four real-folder-type lookups (Inbox/Outbox/Sent Items/Deleted Items) are independent of each
+        // other, so resolve them concurrently rather than one sequential round trip per special folder -
+        // FID *assignment* itself still happens afterward, in SPECIAL_FOLDERS' own fixed order, so which FID
+        // ends up bound to which target is unaffected by fetch order.
+        const targets = await Promise.all(SPECIAL_FOLDERS.map(async (folder) => {
+            if (!folder.folderType) {
+                return `virtual:${folder.name}`;
+            }
+            // The oldest folder of the type, like restapi's findOrCreateWellKnownFolder, so a mailbox that somehow
+            // has two gets the same one every time.
+            const existing = await context.folderRepo.find({ mailboxUid: context.mailboxUid, type: folder.folderType, sort: { dateCreated: "ASC", uid: "ASC" }, limit: 1 }, { ignoreACL: true, limit: 1 });
+            return existing[0] ? `folder:${existing[0].uid}` : `virtual:${folder.name}`;
+        }));
+        const fids = {};
+        SPECIAL_FOLDERS.forEach((folder, index) => {
+            fids[folder.name] = assignOrGetFid(context.session, targets[index]);
+        });
+        return fids;
+    }
+}
+/** `LogonTime` structure (`[MS-OXCROPS]` "LogonTime Structure"): `Seconds`/`Minutes`/`Hour`/`DayOfWeek`
+ * (1 byte each, `DayOfWeek` Sunday=0)/`Day`/`Month` (1 byte each, `Month` January=1)/`Year` (2 bytes) - all
+ * UTC, confirmed against the spec's own byte-layout table. */
+function encodeLogonTime(date) {
+    const writer = new BufferWriter();
+    writer.writeUInt8(date.getUTCSeconds());
+    writer.writeUInt8(date.getUTCMinutes());
+    writer.writeUInt8(date.getUTCHours());
+    writer.writeUInt8(date.getUTCDay());
+    writer.writeUInt8(date.getUTCDate());
+    writer.writeUInt8(date.getUTCMonth() + 1);
+    writer.writeUInt16LE(date.getUTCFullYear());
+    return writer.toBuffer();
+}
+//# sourceMappingURL=RopLogonHandler.js.map

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

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

package/dist/lib/rop/RopOpenFolderHandler.js

@@ -0,0 +1,48 @@
+import { assignHandle } from "../MapiSessionManager.js";
+const ROP_ID_OPEN_FOLDER = 0x02;
+/** The well-known MAPI HRESULT `MAPI_E_NOT_FOUND`, reused as this handler's only failure `ReturnValue` (an
+ * unrecognized `FolderId` - one not present in `session.folderIds`, i.e. not something `RopLogon` handed out
+ * this session). */
+const ERROR_NOT_FOUND = 0x8004010f;
+/**
+ * `RopOpenFolder` (`[MS-OXCFOLD]`/`[MS-OXCROPS]`): opens a folder by FID, producing a new `"folder"` Server
+ * object handle later ROPs (`RopGetHierarchyTable`, a future `RopGetContentsTable`) reference by
+ * `InputHandleIndex`. The request's own `OpenModeFlags` (`OpenSoftDeleted`, ...) is decoded to advance past
+ * it correctly but not acted on - this pragmatic subset has no soft-deleted-folder recovery flow.
+ *
+ * Private-mailbox-only response shape: `IsGhosted` is always `0` and its conditional
+ * `ServerCount`/`CheapServerCount`/`Servers` fields are never present, since `IsGhosted` and its trailing
+ * fields are documented as public-folder-only (`[MS-OXCFOLD]`'s own "RopOpenFolder ROP Response Buffer"
+ * page). `HasRules` is always `0` - this library has no `[MS-OXORULE]` rules-engine support.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopOpenFolderHandler {
+    constructor() {
+        this.ropId = ROP_ID_OPEN_FOLDER;
+        this.responseHandleIndexOffset = 3; // OutputHandleIndex
+    }
+    handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        reader.readUInt8(); // InputHandleIndex - the logon handle this open is performed against; only one
+        // logon exists per session in this pragmatic subset, so it's consumed to advance the reader correctly
+        // but never separately validated.
+        const outputHandleIndex = reader.readUInt8();
+        reader.readUInt8(); // OpenModeFlags - OpenSoftDeleted not supported in this pragmatic subset
+        const folderId = reader.readBigUInt64LE();
+        const target = context.session.folderIds[folderId.toString()];
+        if (!target) {
+            writer.writeUInt8(ROP_ID_OPEN_FOLDER);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_NOT_FOUND);
+            return;
+        }
+        assignHandle(context.session, outputHandleIndex, { type: "folder", entityUid: target });
+        writer.writeUInt8(ROP_ID_OPEN_FOLDER);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(0); // HasRules - no rules-engine support
+        writer.writeUInt8(0); // IsGhosted - always false for a private mailbox
+    }
+}
+//# sourceMappingURL=RopOpenFolderHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopOpenFolderHandler.js","sourceRoot":"","sources":["../../../src/rop/RopOpenFolderHandler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;oBAEoB;AACpB,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oBAAoB;IAAjC;QACoB,UAAK,GAAG,kBAAkB,CAAC;QAC3B,8BAAyB,GAAG,CAAC,CAAC,CAAC,oBAAoB;IA2BvE,CAAC;IAzBU,MAAM,CAAC,MAAoB,EAAE,MAAoB,EAAE,OAAmB;QACzE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,uFAAuF;QAC3G,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,+EAA+E;QACnG,sGAAsG;QACtG,kCAAkC;QAClC,MAAM,iBAAiB,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,yEAAyE;QAC7F,MAAM,QAAQ,GAAW,MAAM,CAAC,eAAe,EAAE,CAAC;QAElD,MAAM,MAAM,GAAuB,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;YACtC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;YACtC,OAAO;QACX,CAAC;QAED,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAExF,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QACtC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;QACjD,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,qCAAqC;QAC3D,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,iDAAiD;IAC3E,CAAC;CACJ"}

package/dist/lib/rop/RopOpenMessageHandler.js

@@ -0,0 +1,83 @@
+import { writeTypedString } from "../codec/TypedString.js";
+import { assignHandle } from "../MapiSessionManager.js";
+import { resolveCalendarEventInfo } from "./CalendarEventTarget.js";
+import { resolveContactInfo } from "./ContactTarget.js";
+import { resolveMessageInfo } from "./MessageTarget.js";
+import { resolveTaskInfo } from "./TaskTarget.js";
+const ROP_ID_OPEN_MESSAGE = 0x03;
+/** The well-known MAPI HRESULT `MAPI_E_NOT_FOUND`, reused as this handler's only failure `ReturnValue` - an
+ * unrecognized `MessageId`, i.e. not something a `RopQueryRows` `PidTagMid` column has handed out this session
+ * (see `MessageTarget.assignOrGetMid`'s own doc comment). Same constant `RopOpenFolderHandler` uses for its
+ * own analogous `FolderId` lookup miss. */
+const ERROR_NOT_FOUND = 0x8004010f;
+/**
+ * `RopOpenMessage` (`[MS-OXCMSG]`/`[MS-OXCROPS]`): opens a message by MID, producing a new `"message"` Server
+ * object handle later ROPs (`RopGetPropertiesSpecific`, `RopOpenStream`) reference by `InputHandleIndex`. The
+ * request's own `FolderId` (the message's expected parent folder) and `CodePageId` are decoded to advance past
+ * them correctly but not otherwise acted on - a MID is resolved directly via `session.messageIds`
+ * (`MessageTarget.assignOrGetMid`), the same "the session already knows what this small integer refers to"
+ * design `RopOpenFolderHandler` uses for FIDs, so cross-checking the caller-supplied `FolderId` would be pure
+ * redundancy. `OpenModeFlags` is likewise decoded but not honored - this pragmatic subset only ever opens a
+ * message for reading (no `RopSetProperties`/`RopSaveChangesMessage` write-back support yet).
+ *
+ * **Pragmatic success response**: `HasNamedProperties` is always `false` - a conservative hint value only, not
+ * a claim that named properties are unsupported (`RopGetPropertyIdsFromNames`/`PropertyResolvers.ts` do resolve
+ * them for a subsequently-opened Calendar item; a real client calls `RopGetPropertyIdsFromNames` unconditionally
+ * for a known Calendar message class regardless of this flag, so leaving it `false` doesn't block that path).
+ * The `SubjectPrefix`/`NormalizedSubject` `TypedString`s are "no prefix" + the item's plain subject/title (this
+ * data model has no separate prefix/normalized-subject split the way real Exchange does), and the recipient
+ * table (`RecipientCount`/`ColumnCount`/`RecipientColumns`/`RowCount`/`RecipientRows`) is always empty - reading
+ * a message's `To`/`Cc` list is a documented gap in this pass, not silently wrong data.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopOpenMessageHandler {
+    constructor() {
+        this.ropId = ROP_ID_OPEN_MESSAGE;
+        this.responseHandleIndexOffset = 3; // OutputHandleIndex
+    }
+    async handle(reader, writer, context) {
+        reader.readUInt8(); // LogonId - this pragmatic subset doesn't track multiple concurrent logons per session
+        reader.readUInt8(); // InputHandleIndex - the folder/logon handle this open is performed against; not
+        // separately validated, matching RopOpenFolderHandler's own treatment of its input handle.
+        const outputHandleIndex = reader.readUInt8();
+        reader.readUInt16LE(); // CodePageId - this pragmatic subset always encodes strings as UTF-16LE/UTF-8 directly
+        reader.readBigUInt64LE(); // FolderId - the message's expected parent folder; not cross-checked, see class doc comment
+        reader.readUInt8(); // OpenModeFlags - read-only opens only in this pragmatic subset
+        const messageId = reader.readBigUInt64LE();
+        const target = context.session.messageIds[messageId.toString()];
+        if (!target) {
+            writer.writeUInt8(ROP_ID_OPEN_MESSAGE);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_NOT_FOUND);
+            return;
+        }
+        // A calendar/contact/task item's "subject" is its title/display name (PidTagSubject, the same tag a
+        // Message uses) - see CalendarEventTarget.ts's own doc comment for why no separate MID-registry
+        // mechanism is needed for any of these target kinds.
+        let subject;
+        if (target.startsWith("calendarEvent:")) {
+            subject = (await resolveCalendarEventInfo(target, context.calendarEventRepo)).title;
+        }
+        else if (target.startsWith("contact:")) {
+            subject = context.contactRepo ? (await resolveContactInfo(target, context.contactRepo)).displayName : "";
+        }
+        else if (target.startsWith("task:")) {
+            subject = context.taskRepo ? (await resolveTaskInfo(target, context.taskRepo)).title : "";
+        }
+        else {
+            subject = (await resolveMessageInfo(target, context.messageRepo)).subject;
+        }
+        assignHandle(context.session, outputHandleIndex, { type: "message", entityUid: target });
+        writer.writeUInt8(ROP_ID_OPEN_MESSAGE);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt8(0); // HasNamedProperties - conservative fixed value, see class doc comment
+        writeTypedString(writer, undefined); // SubjectPrefix - no prefix/normalized-subject split in this data model
+        writeTypedString(writer, subject); // NormalizedSubject
+        writer.writeUInt16LE(0); // RecipientCount - reading recipients is a documented gap, see class doc comment
+        writer.writeUInt16LE(0); // ColumnCount
+        writer.writeUInt8(0); // RowCount
+    }
+}
+//# sourceMappingURL=RopOpenMessageHandler.js.map

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

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

package/dist/lib/rop/RopOpenStreamHandler.js

@@ -0,0 +1,84 @@
+import { PropertyType, readPropertyTag } from "../codec/PropertyValue.js";
+import { assignHandle } from "../MapiSessionManager.js";
+import { loadStreamBody, PID_TAG_BODY } from "./MessageBodyStream.js";
+const ROP_ID_OPEN_STREAM = 0x2b;
+/** `[MS-OXCPRPT]` §2.2.14.1 `OpenModeFlags` values - `ReadOnly` opens the existing value for reading;
+ * `ReadWrite`/`Create` both open for writing (`Create` additionally discards any existing value first, "the
+ * mode required for a property that has not been set" per the spec - always true for a fresh
+ * `RopCreateMessage` draft's body, which is the only write-mode case this pragmatic subset ever produces). */
+const OPEN_MODE_READ_ONLY = 0x00;
+/** The well-known MAPI HRESULT `MAPI_E_NOT_FOUND`, reused for "the referenced handle isn't a message, or the
+ * requested property isn't one this pragmatic subset can stream" - the same constant `RopOpenFolderHandler`
+ * uses for its own analogous lookup-miss case. */
+const ERROR_NOT_FOUND = 0x8004010f;
+/**
+ * `RopOpenStream` (`[MS-OXCPRPT]`/`[MS-OXCROPS]`): opens a property for streaming access, producing a new
+ * `"stream"` Server object handle `RopReadStream`/`RopWriteStream` reads/writes by `InputHandleIndex`.
+ * **Pragmatic subset**: only `PidTagBody` (`PtypString`, the plain-text message body) on a `"message"` handle
+ * is supported - a real client also streams `PidTagHtml`/`PidTagRtfCompressed` (rich body formats) and
+ * folder/attachment binary properties, none of which this pass implements; requesting any other `PropertyTag`,
+ * or opening a stream against a non-message handle, fails with `MAPI_E_NOT_FOUND` rather than succeeding with
+ * wrong data.
+ *
+ * `OpenModeFlags` (`[MS-OXCPRPT]` §2.2.14.1) selects which of two independent code paths runs:
+ * - `ReadOnly` (`0x00`): the step-7 behavior - resolves the real, already-saved message's body via
+ * `MessageBodyStream.resolveMessageBodyBytes()` (`BlobStore` + `mailparser`) and reports its length as
+ * `StreamSize`, for `RopReadStream` to read back.
+ * - `ReadWrite`/`Create` (`0x01`/`0x02`): a **write-mode** stream, the step-8 addition compose/send needs to
+ * accept a message body via `RopWriteStream` - `StreamSize` is always `0` (matching `Create`'s "discards the
+ * existing value" semantics; this pragmatic subset never opens `ReadWrite` against a body that already has
+ * content) and the new handle's `writeTargetHandleIndex` remembers which message handle to write back into,
+ * the link `RopWriteStream`/`RopSaveChangesMessageHandler`/`RopSubmitMessageHandler` use to find it again.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class RopOpenStreamHandler {
+    constructor() {
+        this.ropId = ROP_ID_OPEN_STREAM;
+        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();
+        const propertyTag = readPropertyTag(reader);
+        const openModeFlags = reader.readUInt8();
+        const handle = context.session.handles[inputHandleIndex];
+        const isSupportedProperty = propertyTag.propertyId === PID_TAG_BODY && propertyTag.propertyType === PropertyType.PtypString;
+        if (!handle || handle.type !== "message" || !isSupportedProperty) {
+            writer.writeUInt8(ROP_ID_OPEN_STREAM);
+            writer.writeUInt8(outputHandleIndex);
+            writer.writeUInt32LE(ERROR_NOT_FOUND);
+            return;
+        }
+        let streamSize;
+        if (openModeFlags === OPEN_MODE_READ_ONLY) {
+            const stream = assignHandle(context.session, outputHandleIndex, {
+                type: "stream",
+                entityUid: handle.entityUid,
+                propertyId: propertyTag.propertyId,
+                propertyType: propertyTag.propertyType,
+                streamPosition: 0,
+            });
+            // Parsed once here and cached per handle, not re-parsed by every RopReadStream.
+            streamSize = (await loadStreamBody(context, outputHandleIndex, stream)).length;
+        }
+        else {
+            streamSize = 0;
+            assignHandle(context.session, outputHandleIndex, {
+                type: "stream",
+                entityUid: handle.entityUid,
+                propertyId: propertyTag.propertyId,
+                propertyType: propertyTag.propertyType,
+                writeTargetHandleIndex: inputHandleIndex,
+                writeTargetGeneration: handle.generation,
+                writeSize: 0,
+            });
+        }
+        writer.writeUInt8(ROP_ID_OPEN_STREAM);
+        writer.writeUInt8(outputHandleIndex);
+        writer.writeUInt32LE(0); // ReturnValue - success
+        writer.writeUInt32LE(streamSize); // StreamSize
+    }
+}
+//# sourceMappingURL=RopOpenStreamHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RopOpenStreamHandler.js","sourceRoot":"","sources":["../../../src/rop/RopOpenStreamHandler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAe,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtE,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;;8GAG8G;AAC9G,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;kDAEkD;AAClD,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,oBAAoB;IAAjC;QACoB,UAAK,GAAG,kBAAkB,CAAC;QAC3B,8BAAyB,GAAG,CAAC,CAAC,CAAC,oBAAoB;IA+CvE,CAAC;IA7CU,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,WAAW,GAAgB,eAAe,CAAC,MAAM,CAAC,CAAC;QACzD,MAAM,aAAa,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QAEjD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzD,MAAM,mBAAmB,GAAG,WAAW,CAAC,UAAU,KAAK,YAAY,IAAI,WAAW,CAAC,YAAY,KAAK,YAAY,CAAC,UAAU,CAAC;QAC5H,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC/D,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;YACtC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;YACtC,OAAO;QACX,CAAC;QAED,IAAI,UAAkB,CAAC;QACvB,IAAI,aAAa,KAAK,mBAAmB,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE;gBAC5D,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,cAAc,EAAE,CAAC;aACpB,CAAC,CAAC;YACH,gFAAgF;YAChF,UAAU,GAAG,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACnF,CAAC;aAAM,CAAC;YACJ,UAAU,GAAG,CAAC,CAAC;YACf,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE;gBAC7C,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,sBAAsB,EAAE,gBAAgB;gBACxC,qBAAqB,EAAE,MAAM,CAAC,UAAU;gBACxC,SAAS,EAAE,CAAC;aACf,CAAC,CAAC;QACP,CAAC;QAED,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QACtC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;QACjD,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;IACnD,CAAC;CACJ"}