@rapidmx/mapi-plugin 1.0.0-beta.10

package/dist/lib/codec/PropertyValue.js

@@ -0,0 +1,240 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { DecodeError } from "./BufferCursor.js";
+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 };
+}
+/** The most `PropertyTag`s accepted in one request's tag array (`RopSetColumns`, `RopGetPropertiesSpecific`,
+ * the FastTransfer source ROPs, NSPI `Columns`). Every tag multiplies the per-row resolution work and, for
+ * `RopSetColumns`, the stored session state; a real client asks for far fewer. */
+export const MAX_PROPERTY_TAG_COUNT = 256;
+/**
+ * Reads `count` consecutive `PropertyTag`s. When `count` exceeds `MAX_PROPERTY_TAG_COUNT`, the tags' bytes are
+ * skipped (still bounds-checked, so a count larger than the buffer throws) and `undefined` is returned, leaving
+ * the reader positioned after the array so the caller can send an error response and keep parsing later ROPs.
+ */
+export function readPropertyTagArray(reader, count) {
+    if (count > MAX_PROPERTY_TAG_COUNT) {
+        reader.readBytes(count * 4);
+        return undefined;
+    }
+    const tags = [];
+    for (let i = 0; i < count; i++) {
+        tags.push(readPropertyTag(reader));
+    }
+    return tags;
+}
+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:
+            // The value's size is unknown, so nothing after it in the request can be located.
+            throw new DecodeError(`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 DecodeError(`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,38 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { BufferReader, BufferWriter } from "./BufferCursor.js";
+/** The largest `ServerObjectHandleTable` accepted. Every ROP addresses a handle by a one-byte index, so a table
+ * with more than 255 entries can't be referenced anyway; a larger one is only a way to make the server allocate
+ * and echo back an oversized array. */
+export const MAX_HANDLE_TABLE_ENTRIES = 255;
+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);
+    // One allocation for the whole table instead of one small buffer per entry.
+    const table = Buffer.alloc(buf.handleTable.length * 4);
+    buf.handleTable.forEach((handle, index) => table.writeUInt32LE(handle >>> 0, index * 4));
+    writer.writeBytes(table);
+    return writer.toBuffer();
+}
+/** Throws a `RangeError` for a malformed buffer: a `RopSize` smaller than its own field or larger than the
+ * buffer, a handle table that isn't a whole number of 4-byte entries, or one with more than
+ * `MAX_HANDLE_TABLE_ENTRIES` entries. */
+export function decodeRopBuffer(buffer) {
+    const reader = new BufferReader(buffer);
+    const ropSize = reader.readUInt16LE();
+    const ropsList = reader.readBytes(ropSize - 2);
+    const tableBytes = reader.remaining;
+    if (tableBytes % 4 !== 0 || tableBytes / 4 > MAX_HANDLE_TABLE_ENTRIES) {
+        throw new RangeError(`RopBuffer: invalid ServerObjectHandleTable of ${tableBytes} bytes.`);
+    }
+    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;;uCAEuC;AACvC,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,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,4EAA4E;IAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvD,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED;;yCAEyC;AACzC,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,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,IAAI,UAAU,GAAG,CAAC,KAAK,CAAC,IAAI,UAAU,GAAG,CAAC,GAAG,wBAAwB,EAAE,CAAC;QACpE,MAAM,IAAI,UAAU,CAAC,iDAAiD,UAAU,SAAS,CAAC,CAAC;IAC/F,CAAC;IACD,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"}

package/dist/lib/mongo/MapiEmsmdbRouteMongo.js

@@ -0,0 +1,85 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { AuditLogEntryMongo, CalendarEventMongo, ContactMongo, FolderMongo, LabelMongo, MailboxMongo, MessageMongo, TaskMongo, } from "@rapidmx/restapi/mongo";
+import { BaseMapiEmsmdbRoute } from "../BaseMapiEmsmdbRoute.js";
+import { RopLogonHandler } from "../rop/RopLogonHandler.js";
+import { RopReleaseHandler } from "../rop/RopReleaseHandler.js";
+import { RopOpenFolderHandler } from "../rop/RopOpenFolderHandler.js";
+import { RopGetHierarchyTableHandler } from "../rop/RopGetHierarchyTableHandler.js";
+import { RopGetContentsTableHandler } from "../rop/RopGetContentsTableHandler.js";
+import { RopSetColumnsHandler } from "../rop/RopSetColumnsHandler.js";
+import { RopQueryRowsHandler } from "../rop/RopQueryRowsHandler.js";
+import { RopOpenMessageHandler } from "../rop/RopOpenMessageHandler.js";
+import { RopGetPropertiesSpecificHandler } from "../rop/RopGetPropertiesSpecificHandler.js";
+import { RopOpenStreamHandler } from "../rop/RopOpenStreamHandler.js";
+import { RopReadStreamHandler } from "../rop/RopReadStreamHandler.js";
+import { RopCreateMessageHandler } from "../rop/RopCreateMessageHandler.js";
+import { RopSetPropertiesHandler } from "../rop/RopSetPropertiesHandler.js";
+import { RopWriteStreamHandler } from "../rop/RopWriteStreamHandler.js";
+import { RopSaveChangesMessageHandler } from "../rop/RopSaveChangesMessageHandler.js";
+import { RopSubmitMessageHandler } from "../rop/RopSubmitMessageHandler.js";
+import { RopGetPropertyIdsFromNamesHandler } from "../rop/RopGetPropertyIdsFromNamesHandler.js";
+import { RopDeleteMessagesHandler } from "../rop/RopDeleteMessagesHandler.js";
+import { RopDeleteFolderHandler } from "../rop/RopDeleteFolderHandler.js";
+import { RopFastTransferSourceCopyToHandler } from "../rop/RopFastTransferSourceCopyToHandler.js";
+import { RopFastTransferSourceCopyPropertiesHandler } from "../rop/RopFastTransferSourceCopyPropertiesHandler.js";
+import { RopFastTransferSourceGetBufferHandler } from "../rop/RopFastTransferSourceGetBufferHandler.js";
+import { RouteDecorators } from "@rapidrest/service-core";
+const { Route } = RouteDecorators;
+/**
+ * Mongo-backed concrete `BaseMapiEmsmdbRoute`, mounted at `/mapi/emsmdb`. Exported from this plugin's
+ * `./mongo` entry point, so the server host mounts it without a wrapper class of its
+ * own.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let MapiEmsmdbRouteMongo = class MapiEmsmdbRouteMongo extends BaseMapiEmsmdbRoute {
+    constructor() {
+        super(...arguments);
+        this.mailboxClass = MailboxMongo;
+        this.folderClass = FolderMongo;
+        this.messageClass = MessageMongo;
+        this.calendarEventClass = CalendarEventMongo;
+        this.contactClass = ContactMongo;
+        this.taskClass = TaskMongo;
+        this.labelClass = LabelMongo;
+        this.auditLogClass = AuditLogEntryMongo;
+        this.ropHandlerClasses = [
+            RopLogonHandler,
+            RopReleaseHandler,
+            RopOpenFolderHandler,
+            RopGetHierarchyTableHandler,
+            RopGetContentsTableHandler,
+            RopSetColumnsHandler,
+            RopQueryRowsHandler,
+            RopOpenMessageHandler,
+            RopGetPropertiesSpecificHandler,
+            RopOpenStreamHandler,
+            RopReadStreamHandler,
+            RopCreateMessageHandler,
+            RopSetPropertiesHandler,
+            RopWriteStreamHandler,
+            RopSaveChangesMessageHandler,
+            RopSubmitMessageHandler,
+            RopGetPropertyIdsFromNamesHandler,
+            RopDeleteMessagesHandler,
+            RopDeleteFolderHandler,
+            RopFastTransferSourceCopyToHandler,
+            RopFastTransferSourceCopyPropertiesHandler,
+            RopFastTransferSourceGetBufferHandler,
+        ];
+    }
+};
+MapiEmsmdbRouteMongo = __decorate([
+    Route("/mapi/emsmdb")
+], MapiEmsmdbRouteMongo);
+export { MapiEmsmdbRouteMongo };
+//# sourceMappingURL=MapiEmsmdbRouteMongo.js.map

package/dist/lib/mongo/MapiEmsmdbRouteMongo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapiEmsmdbRouteMongo.js","sourceRoot":"","sources":["../../../src/mongo/MapiEmsmdbRouteMongo.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,kCAAkC,EAAE,MAAM,8CAA8C,CAAC;AAClG,OAAO,EAAE,0CAA0C,EAAE,MAAM,sDAAsD,CAAC;AAClH,OAAO,EAAE,qCAAqC,EAAE,MAAM,iDAAiD,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC;AAElC;;;;;;GAMG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,mBAAiC;IAApE;;QACO,iBAAY,GAAQ,YAAY,CAAC;QACjC,gBAAW,GAAQ,WAAW,CAAC;QAC/B,iBAAY,GAAQ,YAAY,CAAC;QACjC,uBAAkB,GAAQ,kBAAkB,CAAC;QAC7C,iBAAY,GAAQ,YAAY,CAAC;QACjC,cAAS,GAAQ,SAAS,CAAC;QAC3B,eAAU,GAAQ,UAAU,CAAC;QAC7B,kBAAa,GAAQ,kBAAkB,CAAC;QACxC,sBAAiB,GAAU;YACjC,eAAe;YACf,iBAAiB;YACjB,oBAAoB;YACpB,2BAA2B;YAC3B,0BAA0B;YAC1B,oBAAoB;YACpB,mBAAmB;YACnB,qBAAqB;YACrB,+BAA+B;YAC/B,oBAAoB;YACpB,oBAAoB;YACpB,uBAAuB;YACvB,uBAAuB;YACvB,qBAAqB;YACrB,4BAA4B;YAC5B,uBAAuB;YACvB,iCAAiC;YACjC,wBAAwB;YACxB,sBAAsB;YACtB,kCAAkC;YAClC,0CAA0C;YAC1C,qCAAqC;SACxC,CAAC;IACN,CAAC;CAAA,CAAA;AAjCY,oBAAoB;IADhC,KAAK,CAAC,cAAc,CAAC;GACT,oBAAoB,CAiChC"}

package/dist/lib/mongo/MapiNspiRouteMongo.js

@@ -0,0 +1,33 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ContactMongo, MailboxMongo } from "@rapidmx/restapi/mongo";
+import { BaseMapiNspiRoute } from "../BaseMapiNspiRoute.js";
+import { RouteDecorators } from "@rapidrest/service-core";
+const { Route } = RouteDecorators;
+/**
+ * Mongo-backed concrete `BaseMapiNspiRoute`, mounted at `/mapi/nspi`. Exported from this plugin's
+ * `./mongo` entry point, so the server host mounts it without a wrapper class of its
+ * own.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let MapiNspiRouteMongo = class MapiNspiRouteMongo extends BaseMapiNspiRoute {
+    constructor() {
+        super(...arguments);
+        this.mailboxClass = MailboxMongo;
+        this.contactClass = ContactMongo;
+    }
+};
+MapiNspiRouteMongo = __decorate([
+    Route("/mapi/nspi")
+], MapiNspiRouteMongo);
+export { MapiNspiRouteMongo };
+//# sourceMappingURL=MapiNspiRouteMongo.js.map

package/dist/lib/mongo/MapiNspiRouteMongo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapiNspiRouteMongo.js","sourceRoot":"","sources":["../../../src/mongo/MapiNspiRouteMongo.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC;AAElC;;;;;;GAMG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,iBAA+B;IAAhE;;QACO,iBAAY,GAAQ,YAAY,CAAC;QACjC,iBAAY,GAAQ,YAAY,CAAC;IAC/C,CAAC;CAAA,CAAA;AAHY,kBAAkB;IAD9B,KAAK,CAAC,YAAY,CAAC;GACP,kBAAkB,CAG9B"}

package/dist/lib/mongo/index.js

@@ -0,0 +1,7 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+export * from "./MapiEmsmdbRouteMongo.js";
+export * from "./MapiNspiRouteMongo.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/mongo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mongo/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}

package/dist/lib/mongo.js

@@ -0,0 +1,6 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+export * from "./mongo/index.js";
+//# sourceMappingURL=mongo.js.map

package/dist/lib/mongo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.js","sourceRoot":"","sources":["../../src/mongo.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,cAAc,kBAAkB,CAAC"}