@rapidmx/mapi-plugin 1.0.0-beta.3

package/dist/lib/codec/GlobalObjectId.js.map

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

package/dist/lib/codec/MapiGuid.js

@@ -0,0 +1,41 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { BufferWriter } from "./BufferCursor.js";
+/**
+ * Encodes/decodes the 16-byte binary GUID layout `[MS-DTYP]`'s `GUID` structure defines and every MAPI wire
+ * structure that embeds a GUID (EntryIDs, `PidTagStoreRecordKey`, `PtypGuid` property values, property set
+ * IDs) uses: `Data1`/`Data2`/`Data3` in little-endian order, followed by `Data4`'s 8 bytes unchanged (the same
+ * order they appear in a standard textual GUID's last two hyphen-separated groups). This is distinct from a
+ * plain RFC 4122 UUID's all-big-endian textual byte order, so a generic UUID library's byte form can't be
+ * reused directly - hand-built here, same "no library, build the wire format precisely" precedent as the
+ * WBXML codec and the Autodiscover XML helpers.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+const GUID_STRING_PATTERN = /^([0-9a-f]{8})-([0-9a-f]{4})-([0-9a-f]{4})-([0-9a-f]{4})-([0-9a-f]{12})$/i;
+/** Encodes a standard hyphenated GUID/UUID string into its 16-byte MS wire form. */
+export function encodeGuid(guid) {
+    const match = GUID_STRING_PATTERN.exec(guid);
+    if (!match) {
+        throw new Error(`Invalid GUID string: ${guid}`);
+    }
+    const [, data1, data2, data3, data4a, data4b] = match;
+    const writer = new BufferWriter();
+    writer.writeUInt32LE(parseInt(data1, 16));
+    writer.writeUInt16LE(parseInt(data2, 16));
+    writer.writeUInt16LE(parseInt(data3, 16));
+    writer.writeBytes(Buffer.from(data4a + data4b, "hex"));
+    return writer.toBuffer();
+}
+/** Decodes a 16-byte MS wire-form GUID (read from `reader`'s current position) into a standard hyphenated
+ * GUID/UUID string. */
+export function decodeGuid(reader) {
+    const data1 = reader.readUInt32LE().toString(16).padStart(8, "0");
+    const data2 = reader.readUInt16LE().toString(16).padStart(4, "0");
+    const data3 = reader.readUInt16LE().toString(16).padStart(4, "0");
+    const data4 = reader.readBytes(8).toString("hex");
+    return `${data1}-${data2}-${data3}-${data4.slice(0, 4)}-${data4.slice(4)}`;
+}
+//# sourceMappingURL=MapiGuid.js.map

package/dist/lib/codec/MapiGuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapiGuid.js","sourceRoot":"","sources":["../../../src/codec/MapiGuid.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAgB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,mBAAmB,GAAG,2EAA2E,CAAC;AAExG,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAEtD,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED;uBACuB;AACvB,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/lib/codec/MapiTimeZone.js

@@ -0,0 +1,93 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { BufferWriter } from "./BufferCursor.js";
+/**
+ * Encodes/decodes `CalendarEvent.timezone` (a plain IANA zone identifier) to/from `PidLidTimeZoneStruct`'s
+ * `TimeZoneStruct` BLOB (`[MS-OXOCAL]` §2.2.1.39, confirmed field-by-field this session, including a real
+ * worked example: `lBias(4,LONG)+lStandardBias(4,LONG)+lDaylightBias(4,LONG)+wStandardYear(2,WORD)+
+ * stStandardDate(16,SYSTEMTIME)+wDaylightYear(2,WORD)+stDaylightDate(16,SYSTEMTIME)` = 48 bytes total, all
+ * little-endian. `SYSTEMTIME` (`[MS-DTYP]`) is 8 `WORD` fields (`wYear`/`wMonth`/`wDayOfWeek`/`wDay`/`wHour`/
+ * `wMinute`/`wSecond`/`wMilliseconds`), 16 bytes.
+ *
+ * This is deliberately the older, simpler `TimeZoneStruct` - not the newer `TimeZoneDefinition`/
+ * `PidLidAppointmentTimeZoneDefinitionStartDisplay`, which additionally encodes named DST transition rules.
+ *
+ * **Pragmatic scope, matching the same limits `CalendarSyncAdapter` (EAS) already carries for timezones**:
+ * - `"UTC"` encodes as an all-zero struct (no bias, no DST) - the spec-legitimate representation of "no offset,
+ * no DST".
+ * - Any other IANA zone is approximated as a **fixed-offset** zone: `lBias` is derived from that zone's actual
+ * UTC offset at the given reference instant (via `Intl`), with `lStandardBias`/`lDaylightBias` always `0` and
+ * both `SYSTEMTIME` transition dates all-zero (`wMonth=0`, the spec's own documented way to say "this zone
+ * does not observe daylight saving time"). **This is wrong across a real DST boundary** for a zone that
+ * actually observes DST - a real client will show the correct offset only for occurrences near the reference
+ * instant used at encode time, not a spec violation but a real, documented fidelity gap.
+ * - Decoding a struct back into an IANA identifier is fundamentally lossy (a bias alone doesn't identify a
+ * unique zone name) - this codec resolves it to a synthetic-but-valid `Etc/GMT±N` IANA identifier (note the
+ * IANA `Etc/GMT` area's own sign convention is POSIX-inverted from common usage: `Etc/GMT+8` means UTC-8, not
+ * UTC+8) rounded to the nearest whole hour, since `Etc/GMT` zones only support integer-hour offsets - a further
+ * documented approximation for zones with a half-hour/quarter-hour offset (e.g. India, Nepal).
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+const SYSTEMTIME_FIELD_COUNT = 8;
+function writeZeroTransitionBlock(writer) {
+    writer.writeUInt16LE(0); // wStandardYear / wDaylightYear
+    for (let i = 0; i < SYSTEMTIME_FIELD_COUNT; i++) {
+        writer.writeUInt16LE(0);
+    }
+}
+function skipTransitionBlock(reader) {
+    reader.readUInt16LE(); // wStandardYear / wDaylightYear
+    for (let i = 0; i < SYSTEMTIME_FIELD_COUNT; i++) {
+        reader.readUInt16LE();
+    }
+}
+/** The zone's UTC offset in minutes at instant `at` (standard convention: local minus UTC, e.g. `-480` for
+ * `America/Los_Angeles` in winter), read via `Intl`'s `shortOffset` formatting rather than hand-rolling a
+ * zone database. Throws the same way `Intl.DateTimeFormat` itself does for an unrecognized zone identifier. */
+function utcOffsetMinutes(timezone, at) {
+    const formatter = new Intl.DateTimeFormat("en-US", { timeZone: timezone, timeZoneName: "shortOffset" });
+    // `formatToParts` always includes a "timeZoneName" part when `timeZoneName` is requested in the
+    // formatter's own options, so the non-null assertion below reflects a real `Intl` guarantee, not an
+    // unverified assumption.
+    const tzName = formatter.formatToParts(at).find((part) => part.type === "timeZoneName").value;
+    const match = /^GMT([+-])(\d+)(?::(\d+))?$/.exec(tzName);
+    if (!match) {
+        return 0; // Bare "GMT", i.e. UTC itself.
+    }
+    const sign = match[1] === "-" ? -1 : 1;
+    const hours = parseInt(match[2], 10);
+    const minutes = match[3] ? parseInt(match[3], 10) : 0;
+    return sign * (hours * 60 + minutes);
+}
+/** Encodes `timezone` (an IANA identifier, or `"UTC"`) into a 48-byte `TimeZoneStruct` BLOB, using `at` as the
+ * reference instant for resolving a non-UTC zone's current fixed offset. */
+export function encodeTimeZoneStruct(timezone, at) {
+    const writer = new BufferWriter();
+    const bias = timezone === "UTC" ? 0 : -utcOffsetMinutes(timezone, at);
+    writer.writeInt32LE(bias); // lBias
+    writer.writeInt32LE(0); // lStandardBias - no DST modeled
+    writer.writeInt32LE(0); // lDaylightBias - no DST modeled
+    writeZeroTransitionBlock(writer); // wStandardYear + stStandardDate
+    writeZeroTransitionBlock(writer); // wDaylightYear + stDaylightDate
+    return writer.toBuffer();
+}
+/** Decodes a `TimeZoneStruct` BLOB (read from `reader`'s current position) into an approximate IANA zone
+ * identifier - see this file's own doc comment for the lossy `Etc/GMT±N` fallback's exact rounding rules. */
+export function decodeTimeZoneStruct(reader) {
+    const bias = reader.readInt32LE();
+    reader.readInt32LE(); // lStandardBias - not reconstructable into a real DST rule, ignored
+    reader.readInt32LE(); // lDaylightBias - ditto
+    skipTransitionBlock(reader); // wStandardYear + stStandardDate
+    skipTransitionBlock(reader); // wDaylightYear + stDaylightDate
+    if (bias === 0) {
+        return "UTC";
+    }
+    const offsetMinutes = -bias;
+    const wholeHours = Math.round(offsetMinutes / 60);
+    const etcSign = wholeHours <= 0 ? "+" : "-";
+    return `Etc/GMT${etcSign}${Math.abs(wholeHours)}`;
+}
+//# sourceMappingURL=MapiTimeZone.js.map

package/dist/lib/codec/MapiTimeZone.js.map

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

package/dist/lib/codec/PropertyValue.js

@@ -0,0 +1,214 @@
+import { decodeGuid, encodeGuid } from "./MapiGuid.js";
+/**
+ * The property-value system every meaningful ROP depends on (`RopGetPropertiesSpecific`/`RopSetProperties`,
+ * table row data in `RopQueryRows`, ...), per `[MS-OXCDATA]` §2.11. Only the property types this phase's
+ * planned ROP handlers actually need are implemented (`readPropertyValue`/`writePropertyValue` throw a clear
+ * error for anything else) - add more as a real handler needs them, not speculatively.
+ *
+ * Numeric values and member names (`Ptyp*`) are exactly as published in `[MS-OXCDATA]`'s "Property Data
+ * Types" table - the full `Ptyp`-prefixed spec names are used rather than shorter aliases (`String`,
+ * `Boolean`, ...) both for fidelity to the spec and because those shorter names collide with this project's
+ * lint config's `id-denylist` rule (which exists to stop primitive-wrapper-like names shadowing globals).
+ */
+export var PropertyType;
+(function (PropertyType) {
+    PropertyType[PropertyType["PtypNull"] = 1] = "PtypNull";
+    PropertyType[PropertyType["PtypInteger16"] = 2] = "PtypInteger16";
+    PropertyType[PropertyType["PtypInteger32"] = 3] = "PtypInteger32";
+    PropertyType[PropertyType["PtypFloating32"] = 4] = "PtypFloating32";
+    PropertyType[PropertyType["PtypFloating64"] = 5] = "PtypFloating64";
+    PropertyType[PropertyType["PtypBoolean"] = 11] = "PtypBoolean";
+    PropertyType[PropertyType["PtypInteger64"] = 20] = "PtypInteger64";
+    PropertyType[PropertyType["PtypString8"] = 30] = "PtypString8";
+    PropertyType[PropertyType["PtypString"] = 31] = "PtypString";
+    PropertyType[PropertyType["PtypTime"] = 64] = "PtypTime";
+    PropertyType[PropertyType["PtypGuid"] = 72] = "PtypGuid";
+    PropertyType[PropertyType["PtypBinary"] = 258] = "PtypBinary";
+    PropertyType[PropertyType["PtypMultipleInteger32"] = 4099] = "PtypMultipleInteger32";
+    PropertyType[PropertyType["PtypMultipleString8"] = 4126] = "PtypMultipleString8";
+    PropertyType[PropertyType["PtypMultipleString"] = 4127] = "PtypMultipleString";
+    PropertyType[PropertyType["PtypMultipleBinary"] = 4354] = "PtypMultipleBinary";
+})(PropertyType || (PropertyType = {}));
+/**
+ * `PropertyTag` structure (`[MS-OXCDATA]` §2.9): a 4-byte value with **`PropertyType` in the low-order 16
+ * bits and `PropertyId` in the high-order 16 bits** - confirmed against the spec's own bit-range description
+ * and cross-checked against the well-known real property-tag constant `PR_SUBJECT = 0x0037001F` (`PidTagSubject`
+ * = property ID `0x0037`, `PtypString` = type `0x001F`), which only decodes correctly with `PropertyType` as
+ * the low half. On the wire (little-endian), that means `PropertyType` is read/written first.
+ */
+export function readPropertyTag(reader) {
+    const propertyType = reader.readUInt16LE();
+    const propertyId = reader.readUInt16LE();
+    return { propertyId, propertyType };
+}
+export function writePropertyTag(writer, tag) {
+    writer.writeUInt16LE(tag.propertyType);
+    writer.writeUInt16LE(tag.propertyId);
+}
+/** `TypedPropertyValue` structure (`[MS-OXCDATA]` §2.11.4): `PropertyType` (2 bytes) followed by the value
+ * itself, encoded per `readPropertyValue`/`writePropertyValue` below. */
+export function readTypedPropertyValue(reader) {
+    const propertyType = reader.readUInt16LE();
+    const value = readPropertyValue(reader, propertyType);
+    return { propertyType, value };
+}
+export function writeTypedPropertyValue(writer, typed) {
+    writer.writeUInt16LE(typed.propertyType);
+    writePropertyValue(writer, typed.propertyType, typed.value);
+}
+/** `TaggedPropertyValue` structure (`[MS-OXCDATA]` §2.11.4, confirmed via `RopSetProperties`'s own request-buffer
+ * page): a full `PropertyTag` (4 bytes - `PropertyId` **and** `PropertyType`, unlike `TypedPropertyValue`'s bare
+ * `PropertyType`) followed by the value itself. Used where a property's identity can't be inferred from
+ * context (e.g. `RopSetProperties`, which sets an arbitrary, client-chosen set of properties in one call). */
+export function readTaggedPropertyValue(reader) {
+    const tag = readPropertyTag(reader);
+    const value = readPropertyValue(reader, tag.propertyType);
+    return { propertyId: tag.propertyId, propertyType: tag.propertyType, value };
+}
+export function writeTaggedPropertyValue(writer, tagged) {
+    writePropertyTag(writer, { propertyId: tagged.propertyId, propertyType: tagged.propertyType });
+    writePropertyValue(writer, tagged.propertyType, tagged.value);
+}
+/**
+ * Reads a bare `PropertyValue` (`[MS-OXCDATA]` §2.11.2) of the given, already-known `type`. `PtypBinary`'s
+ * length prefix is 16 bits and every `PtypMultiple*`'s value count is 32 bits wide, per the spec's explicit
+ * "in the context of ROP buffers" sizing rule - the only context every planned caller of this function
+ * operates in (the wider 32-bit `PtypBinary` count only applies to extended rules / a specific MAPI/HTTP
+ * structure this library doesn't implement).
+ */
+export function readPropertyValue(reader, type) {
+    switch (type) {
+        case PropertyType.PtypNull:
+            return 0;
+        case PropertyType.PtypInteger16:
+            return reader.readInt16LE();
+        case PropertyType.PtypInteger32:
+            return reader.readInt32LE();
+        case PropertyType.PtypFloating32:
+            return reader.readFloatLE();
+        case PropertyType.PtypFloating64:
+            return reader.readDoubleLE();
+        case PropertyType.PtypBoolean:
+            return reader.readUInt8() !== 0;
+        case PropertyType.PtypInteger64:
+            return reader.readBigInt64LE();
+        case PropertyType.PtypTime:
+            return filetimeToDate(reader.readBigUInt64LE());
+        case PropertyType.PtypGuid:
+            return decodeGuid(reader);
+        case PropertyType.PtypString:
+            return reader.readNullTerminatedUtf16LE();
+        case PropertyType.PtypString8:
+            return reader.readNullTerminatedString8();
+        case PropertyType.PtypBinary:
+            return reader.readBytes(reader.readUInt16LE());
+        case PropertyType.PtypMultipleInteger32:
+            return readCountedArray(reader, () => reader.readInt32LE());
+        case PropertyType.PtypMultipleString:
+            return readCountedArray(reader, () => reader.readNullTerminatedUtf16LE());
+        case PropertyType.PtypMultipleString8:
+            return readCountedArray(reader, () => reader.readNullTerminatedString8());
+        case PropertyType.PtypMultipleBinary:
+            return readCountedArray(reader, () => reader.readBytes(reader.readUInt16LE()));
+        default:
+            throw new Error(`PropertyValue: unsupported PropertyType 0x${type.toString(16)}`);
+    }
+}
+export function writePropertyValue(writer, type, value) {
+    switch (type) {
+        case PropertyType.PtypNull:
+            return;
+        case PropertyType.PtypInteger16:
+            writer.writeInt16LE(value);
+            return;
+        case PropertyType.PtypInteger32:
+            writer.writeInt32LE(value);
+            return;
+        case PropertyType.PtypFloating32:
+            writer.writeFloatLE(value);
+            return;
+        case PropertyType.PtypFloating64:
+            writer.writeDoubleLE(value);
+            return;
+        case PropertyType.PtypBoolean:
+            writer.writeUInt8(value ? 1 : 0);
+            return;
+        case PropertyType.PtypInteger64:
+            writer.writeBigInt64LE(value);
+            return;
+        case PropertyType.PtypTime:
+            writer.writeBigUInt64LE(dateToFiletime(value));
+            return;
+        case PropertyType.PtypGuid:
+            writer.writeBytes(encodeGuid(value));
+            return;
+        case PropertyType.PtypString:
+            writer.writeNullTerminatedUtf16LE(value);
+            return;
+        case PropertyType.PtypString8:
+            writer.writeNullTerminatedString8(value);
+            return;
+        case PropertyType.PtypBinary: {
+            const buf = value;
+            writer.writeUInt16LE(buf.length);
+            writer.writeBytes(buf);
+            return;
+        }
+        case PropertyType.PtypMultipleInteger32:
+            writeCountedArray(writer, value, (v) => writer.writeInt32LE(v));
+            return;
+        case PropertyType.PtypMultipleString:
+            writeCountedArray(writer, value, (v) => writer.writeNullTerminatedUtf16LE(v));
+            return;
+        case PropertyType.PtypMultipleString8:
+            writeCountedArray(writer, value, (v) => writer.writeNullTerminatedString8(v));
+            return;
+        case PropertyType.PtypMultipleBinary:
+            writeCountedArray(writer, value, (v) => {
+                writer.writeUInt16LE(v.length);
+                writer.writeBytes(v);
+            });
+            return;
+        default:
+            throw new Error(`PropertyValue: unsupported PropertyType 0x${type.toString(16)}`);
+    }
+}
+/** `count` is a fully client-controlled `uint32` (up to ~4.29 billion). Every element type this reads needs at
+ * least 1 byte on the wire, so a `count` exceeding the buffer's actual remaining bytes can never be genuine -
+ * rejecting it immediately, before looping at all, turns a client lying about the count into an instant, clear
+ * `RangeError` instead of a loop that runs until either the heap is exhausted or (for the two `PtypMultipleString*`
+ * variants specifically, whose element reader used to tolerate running past the buffer's end - see
+ * `BufferCursor.ts`'s own doc comment) it simply never terminates. Defense in depth alongside that fix, not a
+ * replacement for it - this also fails fast for a merely-oversized-but-technically-satisfiable count instead of
+ * allocating a huge array first. */
+function readCountedArray(reader, readOne) {
+    const count = reader.readUInt32LE();
+    if (count > reader.remaining) {
+        throw new RangeError(`PropertyValue.readCountedArray(): element count ${count} exceeds the remaining buffer size (${reader.remaining}).`);
+    }
+    const values = [];
+    for (let i = 0; i < count; i++) {
+        values.push(readOne());
+    }
+    return values;
+}
+function writeCountedArray(writer, values, writeOne) {
+    writer.writeUInt32LE(values.length);
+    for (const value of values) {
+        writeOne(value);
+    }
+}
+/** 100-nanosecond intervals between the FILETIME epoch (1601-01-01T00:00:00Z) and the Unix epoch
+ * (1970-01-01T00:00:00Z) - `[MS-DTYP]`'s `FILETIME` structure, which `PtypTime` uses. */
+const FILETIME_EPOCH_DIFF_100NS = 116444736000000000n;
+/** Converts a `PtypTime` value (100-ns intervals since 1601-01-01) into a JS `Date`. Sub-millisecond
+ * precision is truncated - `Date` has no finer resolution, a real, bounded, documented gap. */
+export function filetimeToDate(filetime) {
+    const millis = (filetime - FILETIME_EPOCH_DIFF_100NS) / 10000n;
+    return new Date(Number(millis));
+}
+/** Converts a JS `Date` into a `PtypTime` value (100-ns intervals since 1601-01-01). */
+export function dateToFiletime(date) {
+    return BigInt(date.getTime()) * 10000n + FILETIME_EPOCH_DIFF_100NS;
+}
+//# sourceMappingURL=PropertyValue.js.map

package/dist/lib/codec/PropertyValue.js.map

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

package/dist/lib/codec/RopBuffer.js

@@ -0,0 +1,26 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { BufferReader, BufferWriter } from "./BufferCursor.js";
+export function encodeRopBuffer(buf) {
+    const writer = new BufferWriter();
+    // RopSize covers itself (2 bytes) plus ropsList - the handle table isn't part of RopSize's count.
+    writer.writeUInt16LE(2 + buf.ropsList.length);
+    writer.writeBytes(buf.ropsList);
+    for (const handle of buf.handleTable) {
+        writer.writeUInt32LE(handle);
+    }
+    return writer.toBuffer();
+}
+export function decodeRopBuffer(buffer) {
+    const reader = new BufferReader(buffer);
+    const ropSize = reader.readUInt16LE();
+    const ropsList = reader.readBytes(ropSize - 2);
+    const handleTable = [];
+    while (reader.hasMore()) {
+        handleTable.push(reader.readUInt32LE());
+    }
+    return { ropsList, handleTable };
+}
+//# sourceMappingURL=RopBuffer.js.map

package/dist/lib/codec/RopBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RopBuffer.js","sourceRoot":"","sources":["../../../src/codec/RopBuffer.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA0B/D,MAAM,UAAU,eAAe,CAAC,GAAc;IAC1C,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,kGAAkG;IAClG,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC1C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACtB,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACrC,CAAC"}

package/dist/lib/codec/TypedString.js

@@ -0,0 +1,54 @@
+/** `TypedString` (`[MS-OXCDATA]` §2.11.7) `StringType` enumeration values. */
+const STRING_TYPE_NONE = 0x00;
+const STRING_TYPE_EMPTY = 0x01;
+const STRING_TYPE_STRING8 = 0x02;
+const STRING_TYPE_REDUCED_UNICODE = 0x03;
+const STRING_TYPE_UNICODE = 0x04;
+/**
+ * `TypedString` (`[MS-OXCDATA]` §2.11.7): a leading `StringType` byte followed by an optional string in the
+ * format that byte names - used by `RopOpenMessage`'s success response (`SubjectPrefix`/`NormalizedSubject`).
+ * `writeTypedString` never produces the "reduced Unicode" (`0x03`) form - that's purely a wire-size
+ * optimization real Exchange applies when every character happens to fit in one byte, not something a peer is
+ * ever required to send, so this codec always writes plain UTF-16LE (`0x04`) for non-empty strings. `undefined`
+ * writes as "no string" (`0x00`), matching a field the spec allows to be entirely absent (e.g. no subject
+ * prefix at all, as opposed to an empty one).
+ */
+export function writeTypedString(writer, value) {
+    if (value === undefined) {
+        writer.writeUInt8(STRING_TYPE_NONE);
+    }
+    else if (value === "") {
+        writer.writeUInt8(STRING_TYPE_EMPTY);
+    }
+    else {
+        writer.writeUInt8(STRING_TYPE_UNICODE);
+        writer.writeNullTerminatedUtf16LE(value);
+    }
+}
+/** Reads a `TypedString`, supporting every `StringType` value a peer could legally send (`0x00`-`0x04`) even
+ * though `writeTypedString` only ever produces `0x00`/`0x01`/`0x04` itself - this side of the codec is only
+ * ever exercised in this library's own round-trip tests, since a real MAPI/HTTP client never sends a
+ * `TypedString` value to the server. Returns `undefined` for `StringType = 0x00` ("no string"), matching
+ * `writeTypedString`'s own `undefined` input. */
+export function readTypedString(reader) {
+    const stringType = reader.readUInt8();
+    switch (stringType) {
+        case STRING_TYPE_NONE:
+            return undefined;
+        case STRING_TYPE_EMPTY:
+            return "";
+        case STRING_TYPE_STRING8:
+            return reader.readNullTerminatedString8();
+        case STRING_TYPE_REDUCED_UNICODE: {
+            let value = "";
+            for (let code = reader.readUInt8(); code !== 0; code = reader.readUInt8()) {
+                value += String.fromCharCode(code);
+            }
+            return value;
+        }
+        case STRING_TYPE_UNICODE:
+        default:
+            return reader.readNullTerminatedUtf16LE();
+    }
+}
+//# sourceMappingURL=TypedString.js.map

package/dist/lib/codec/TypedString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedString.js","sourceRoot":"","sources":["../../../src/codec/TypedString.ts"],"names":[],"mappings":"AAMA,8EAA8E;AAC9E,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AACzC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB,EAAE,KAAyB;IAC5E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACtB,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACJ,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QACvC,MAAM,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;AACL,CAAC;AAED;;;;iDAIiD;AACjD,MAAM,UAAU,eAAe,CAAC,MAAoB;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IACtC,QAAQ,UAAU,EAAE,CAAC;QACjB,KAAK,gBAAgB;YACjB,OAAO,SAAS,CAAC;QACrB,KAAK,iBAAiB;YAClB,OAAO,EAAE,CAAC;QACd,KAAK,mBAAmB;YACpB,OAAO,MAAM,CAAC,yBAAyB,EAAE,CAAC;QAC9C,KAAK,2BAA2B,CAAC,CAAC,CAAC;YAC/B,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,KAAK,IAAI,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;gBACxE,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,KAAK,mBAAmB,CAAC;QACzB;YACI,OAAO,MAAM,CAAC,yBAAyB,EAAE,CAAC;IAClD,CAAC;AACL,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,99 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+/**
+ * MAPI-over-HTTP protocol compatibility (Phase 3 of this library's roadmap): a hand-built ROP (Remote
+ * Operation) codec and buffer-framing layer (`[MS-OXCROPS]`), JWT-secured EMSMDB transport (`BaseMapiEmsmdbRoute`,
+ * reusing the framework's existing `@Auth(["jwt"])` strategy - no MAPI-specific auth code of its own), and a
+ * minimal NSPI address-book endpoint (`BaseMapiNspiRoute`) for GAL "search as you type" lookups.
+ *
+ * This module exports only the backend-agnostic surface: the wire-format codecs, the abstract route base
+ * classes, `MapiSessionManager`, the ROP dispatcher, and every ROP/NSPI handler class (each takes a generic
+ * `RopContext`/repo argument, not a concrete entity class, so none of them are backend-specific). The concrete
+ * Mongo/SQL classes a deployment actually instantiates (`MapiEmsmdbRouteMongo`/`SQL`,
+ * `MapiNspiRouteMongo`/`SQL`) are exported from this package's `./mongo`/`./sql` subpaths instead, alongside
+ * every other entity/route/job this library defines - see `src/eas/index.ts`'s identical doc comment for the
+ * same convention.
+ *
+ * A deployment mounts both MAPI endpoints with a trivial one-line subclass each, the same pattern
+ * `src/eas/index.ts`'s doc comment describes for `BaseEasRoute`:
+ * ```ts
+ * import { MapiEmsmdbRouteMongo, MapiNspiRouteMongo } from "@rapidrest/mail/mongo";
+ * import { RouteDecorators } from "@rapidrest/service-core";
+ * const { Route } = RouteDecorators;
+ *
+ * @Route("/mapi/emsmdb")
+ * export class MyMapiEmsmdbRoute extends MapiEmsmdbRouteMongo {}
+ *
+ * @Route("/mapi/nspi")
+ * export class MyMapiNspiRoute extends MapiNspiRouteMongo {}
+ * ```
+ * Real Outlook desktop locates both URLs via `@rapidrest/mail/autodiscover`'s Outlook/EXCH response
+ * (`BaseAutodiscoverRoute`'s `mapiUrl` property) - see that module's own doc comment.
+ *
+ * **Documented gaps in this pragmatic subset** (see the architecture plan's "MAPI over HTTP (Phase 3)" section
+ * for the full reasoning behind each):
+ * - Incremental sync (`RopFastTransferSourceCopyTo`/`CopyProperties`/`GetBuffer`) always builds a full,
+ *   non-differential dump, not real IDSET-based ICS (`[MS-OXCFXICS]`) - a real client still works correctly
+ *   against this, just less efficiently than byte-perfect ICS.
+ * - Calendar/meetings: no counter-proposals, meeting-forwarding, delegate scheduling, or resource-booking
+ *   auto-accept; no DST-aware timezones (fixed-offset approximation only); no recurrence exceptions/modified
+ *   instances; no Hijri/`MonthEnd` recurrence patterns.
+ * - No `RopModifyRecipients` - attendees/recipients are always added via the same `PidTagDisplayTo`/`Cc`
+ *   pragmatic path used for ordinary mail.
+ * - No public-folder support, no delegate/shared-mailbox access, no rules/permissions/search-folder ROPs, no
+ *   client-certificate enrollment.
+ * - Calendar named properties (location/recurrence/timezone/etc.) are excluded from FastTransfer streams -
+ *   only the columns in `FastTransferStream.ts`'s `DEFAULT_*_COLUMNS` tables are included.
+ * - NSPI is limited to `Bind`/`Unbind`/`GetMatches` only - no row/name lookups beyond a single content-
+ *   restriction search, no directory replication.
+ */
+export * from "./codec/BufferCursor.js";
+export * from "./codec/MapiGuid.js";
+export * from "./codec/TypedString.js";
+export * from "./codec/PropertyValue.js";
+export * from "./codec/RopBuffer.js";
+export * from "./codec/AppointmentRecurrence.js";
+export * from "./codec/MapiTimeZone.js";
+export * from "./codec/GlobalObjectId.js";
+export * from "./RopDispatcher.js";
+export * from "./MapiSessionManager.js";
+export * from "./BaseMapiEmsmdbRoute.js";
+export * from "./BaseMapiNspiRoute.js";
+export * from "./rop/RopHandler.js";
+export * from "./rop/FolderTarget.js";
+export * from "./rop/MessageTarget.js";
+export * from "./rop/CalendarEventTarget.js";
+export * from "./rop/MessageBodyStream.js";
+export * from "./rop/PropertyResolvers.js";
+export * from "./rop/NamedPropertyRegistry.js";
+export * from "./rop/CalendarNamedProperties.js";
+export * from "./rop/FastTransferStream.js";
+export * from "./rop/MeetingMessageClassHandler.js";
+export * from "./rop/RopLogonHandler.js";
+export * from "./rop/RopReleaseHandler.js";
+export * from "./rop/RopOpenFolderHandler.js";
+export * from "./rop/RopGetHierarchyTableHandler.js";
+export * from "./rop/RopSetColumnsHandler.js";
+export * from "./rop/RopQueryRowsHandler.js";
+export * from "./rop/RopGetContentsTableHandler.js";
+export * from "./rop/RopOpenMessageHandler.js";
+export * from "./rop/RopGetPropertiesSpecificHandler.js";
+export * from "./rop/RopOpenStreamHandler.js";
+export * from "./rop/RopReadStreamHandler.js";
+export * from "./rop/RopCreateMessageHandler.js";
+export * from "./rop/RopSetPropertiesHandler.js";
+export * from "./rop/RopWriteStreamHandler.js";
+export * from "./rop/RopSaveChangesMessageHandler.js";
+export * from "./rop/RopSubmitMessageHandler.js";
+export * from "./rop/RopGetPropertyIdsFromNamesHandler.js";
+export * from "./rop/RopDeleteMessagesHandler.js";
+export * from "./rop/RopDeleteFolderHandler.js";
+export * from "./rop/RopFastTransferSourceCopyToHandler.js";
+export * from "./rop/RopFastTransferSourceCopyPropertiesHandler.js";
+export * from "./rop/RopFastTransferSourceGetBufferHandler.js";
+export * from "./nspi/NspiCodec.js";
+export * from "./nspi/NspiBindHandler.js";
+export * from "./nspi/NspiGetMatchesHandler.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,qDAAqD,CAAC;AACpE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC"}