@rapidmx/mapi-plugin 1.0.0-beta.10

package/dist/lib/rop/ContentsTable.js

@@ -0,0 +1,60 @@
+import { FolderType } from "@rapidmx/restapi";
+import { CALENDAR_EVENT_SORT } from "./CalendarEventTarget.js";
+import { CONTACT_SORT } from "./ContactTarget.js";
+import { MESSAGE_SORT } from "./MessageTarget.js";
+import { findWindow } from "./RepoPaging.js";
+import { TASK_SORT } from "./TaskTarget.js";
+const SORT_BY_KIND = {
+    message: MESSAGE_SORT,
+    calendarEvent: CALENDAR_EVENT_SORT,
+    contact: CONTACT_SORT,
+    task: TASK_SORT,
+};
+/** Which repo a folder's items live in, decided by the folder's own `type`: a `Contact`/`Task`/`CalendarEvent` is
+ * its own entity, never a `Message` row. */
+export async function resolveContentsKind(folderUid, context) {
+    context.budget?.chargeQueries();
+    const folder = await context.folderRepo.findOne(folderUid, { ignoreACL: true });
+    switch (folder?.type) {
+        case FolderType.CALENDAR:
+            return "calendarEvent";
+        case FolderType.CONTACTS:
+            return "contact";
+        case FolderType.TASKS:
+            return "task";
+        default:
+            return "message";
+    }
+}
+function repoFor(kind, context) {
+    switch (kind) {
+        case "calendarEvent":
+            return context.calendarEventRepo;
+        case "contact":
+            return context.contactRepo;
+        case "task":
+            return context.taskRepo;
+        default:
+            return context.messageRepo;
+    }
+}
+/**
+ * The `"<kind>:<uid>"` row targets at positions `[start, start + count)` of a contents table (a `"folder:<uid>"`
+ * table with `contentsKind` set), read straight from the database in a fixed, stable order. A context without the
+ * matching optional repo yields no rows.
+ *
+ * Reading a window per `RopQueryRows` instead of snapshotting every row at `RopGetContentsTable` time keeps session
+ * state small and makes no folder too large to page through. The trade-off is that a message added or removed
+ * between two `RopQueryRows` calls can shift the rows that follow.
+ */
+export async function resolveContentsWindow(context, table, start, count) {
+    const kind = table.contentsKind;
+    const repo = repoFor(kind, context);
+    if (!repo) {
+        return [];
+    }
+    const folderUid = table.entityUid.slice("folder:".length);
+    const rows = await findWindow(repo, { folderUid, mailboxUid: context.mailboxUid }, SORT_BY_KIND[kind], start, count, context.budget);
+    return rows.map((row) => `${kind}:${row.uid}`);
+}
+//# sourceMappingURL=ContentsTable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContentsTable.js","sourceRoot":"","sources":["../../../src/rop/ContentsTable.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAe,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,YAAY,GAAmC;IACjD,OAAO,EAAE,YAAY;IACrB,aAAa,EAAE,mBAAmB;IAClC,OAAO,EAAE,YAAY;IACrB,IAAI,EAAE,SAAS;CAClB,CAAC;AAEF;4CAC4C;AAC5C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAiB,EAAE,OAAmB;IAC5E,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAChC,MAAM,MAAM,GAAuB,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpG,QAAQ,MAAM,EAAE,IAAI,EAAE,CAAC;QACnB,KAAK,UAAU,CAAC,QAAQ;YACpB,OAAO,eAAe,CAAC;QAC3B,KAAK,UAAU,CAAC,QAAQ;YACpB,OAAO,SAAS,CAAC;QACrB,KAAK,UAAU,CAAC,KAAK;YACjB,OAAO,MAAM,CAAC;QAClB;YACI,OAAO,SAAS,CAAC;IACzB,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,IAAkB,EAAE,OAAmB;IACpD,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,eAAe;YAChB,OAAO,OAAO,CAAC,iBAAiB,CAAC;QACrC,KAAK,SAAS;YACV,OAAO,OAAO,CAAC,WAAW,CAAC;QAC/B,KAAK,MAAM;YACP,OAAO,OAAO,CAAC,QAAQ,CAAC;QAC5B;YACI,OAAO,OAAO,CAAC,WAAW,CAAC;IACnC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAmB,EAAE,KAAuB,EAAE,KAAa,EAAE,KAAa;IAClH,MAAM,IAAI,GAAiB,KAAK,CAAC,YAAa,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAsB,MAAM,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxJ,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/lib/rop/ExecuteBudget.js

@@ -0,0 +1,82 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+/** The most rows (items or folders) whose properties one `Execute` resolves, across all of its ROPs. */
+export const MAX_ROWS_RESOLVED_PER_EXECUTE = 20000;
+/** The most bytes one `Execute` builds or parses (FastTransfer streams and message bodies), across all of its ROPs. */
+export const MAX_BYTES_BUILT_PER_EXECUTE = 64 * 1024 * 1024;
+/** The most database queries (paged reads, table lookups, deletes) one `Execute` runs through the budgeted paths. */
+export const MAX_QUERIES_PER_EXECUTE = 20000;
+/** The most rows one `Execute` reads back from paged queries (folder lists, folder walks, item lists). */
+export const MAX_ROWS_FETCHED_PER_EXECUTE = 100000;
+/** The most `RopSubmitMessage`s one `Execute` runs. Each one can relay mail, so a request can't repeat it 1024 times. */
+export const MAX_SUBMITS_PER_EXECUTE = 16;
+/** Thrown when an `Execute` has used up its `ExecuteBudget`. The ROP that hit it fails; see `RopDispatcher`. */
+export class WorkBudgetExceededError extends Error {
+    constructor(what) {
+        super(`Execute: the per-request ${what} budget is exhausted.`);
+        this.name = "WorkBudgetExceededError";
+    }
+}
+/**
+ * The work one `Execute` may do. Limits on ROP count and per-ROP sizes alone still let one request chain many
+ * expensive ROPs (a dozen 10000-row FastTransfer dumps, the same large body parsed by several streams, or a thousand
+ * hierarchy tables or folder walks), so rows resolved, bytes built, queries run, rows fetched and submits are counted
+ * across the whole request. Every charge happens before the work it pays for. Also dedupes message body parses within
+ * the request (`bodies`).
+ */
+export class ExecuteBudget {
+    constructor(maxRows = MAX_ROWS_RESOLVED_PER_EXECUTE, maxBytes = MAX_BYTES_BUILT_PER_EXECUTE, limits = {}) {
+        /** Message uid -> its decoded body, so opening the same body twice in one request parses it once. */
+        this.bodies = new Map();
+        this.rowsRemaining = maxRows;
+        this.bytesRemaining = maxBytes;
+        this.queriesRemaining = limits.maxQueries ?? MAX_QUERIES_PER_EXECUTE;
+        this.fetchedRowsRemaining = limits.maxFetchedRows ?? MAX_ROWS_FETCHED_PER_EXECUTE;
+        this.submitsRemaining = limits.maxSubmits ?? MAX_SUBMITS_PER_EXECUTE;
+    }
+    /** Uses `count` rows of the budget, throwing `WorkBudgetExceededError` once it is exhausted. */
+    chargeRows(count = 1) {
+        this.rowsRemaining -= count;
+        if (this.rowsRemaining < 0) {
+            throw new WorkBudgetExceededError("row");
+        }
+    }
+    /** Uses `count` bytes of the budget, throwing `WorkBudgetExceededError` once it is exhausted. */
+    chargeBytes(count) {
+        this.bytesRemaining -= count;
+        if (this.bytesRemaining < 0) {
+            throw new WorkBudgetExceededError("byte");
+        }
+    }
+    /** Throws `WorkBudgetExceededError` when no bytes are left, so work that can't be sized up front (fetching a blob)
+     * isn't started at all. */
+    assertBytesLeft() {
+        if (this.bytesRemaining <= 0) {
+            throw new WorkBudgetExceededError("byte");
+        }
+    }
+    /** Uses `count` queries of the budget. Called before running them. */
+    chargeQueries(count = 1) {
+        this.queriesRemaining -= count;
+        if (this.queriesRemaining < 0) {
+            throw new WorkBudgetExceededError("query");
+        }
+    }
+    /** Uses `count` fetched rows of the budget. */
+    chargeFetchedRows(count) {
+        this.fetchedRowsRemaining -= count;
+        if (this.fetchedRowsRemaining < 0) {
+            throw new WorkBudgetExceededError("fetched row");
+        }
+    }
+    /** Uses one submit of the budget. */
+    chargeSubmit() {
+        this.submitsRemaining -= 1;
+        if (this.submitsRemaining < 0) {
+            throw new WorkBudgetExceededError("submit");
+        }
+    }
+}
+//# sourceMappingURL=ExecuteBudget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteBudget.js","sourceRoot":"","sources":["../../../src/rop/ExecuteBudget.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAE/E,wGAAwG;AACxG,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAEnD,uHAAuH;AACvH,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5D,qHAAqH;AACrH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAE7C,0GAA0G;AAC1G,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAEnD,yHAAyH;AACzH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C,gHAAgH;AAChH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9C,YAAmB,IAAY;QAC3B,KAAK,CAAC,4BAA4B,IAAI,uBAAuB,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAC1C,CAAC;CACJ;AAED;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAStB,YACI,UAAkB,6BAA6B,EAC/C,WAAmB,2BAA2B,EAC9C,SAAgF,EAAE;QANtF,qGAAqG;QACrF,WAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;QAOxD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,UAAU,IAAI,uBAAuB,CAAC;QACrE,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,cAAc,IAAI,4BAA4B,CAAC;QAClF,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,UAAU,IAAI,uBAAuB,CAAC;IACzE,CAAC;IAED,gGAAgG;IACzF,UAAU,CAAC,KAAK,GAAG,CAAC;QACvB,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC;QAC5B,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;IACL,CAAC;IAED,iGAAiG;IAC1F,WAAW,CAAC,KAAa;QAC5B,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC;QAC7B,IAAI,IAAI,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;IAED;+BAC2B;IACpB,eAAe;QAClB,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;IAED,sEAAsE;IAC/D,aAAa,CAAC,KAAK,GAAG,CAAC;QAC1B,IAAI,CAAC,gBAAgB,IAAI,KAAK,CAAC;QAC/B,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IAED,+CAA+C;IACxC,iBAAiB,CAAC,KAAa;QAClC,IAAI,CAAC,oBAAoB,IAAI,KAAK,CAAC;QACnC,IAAI,IAAI,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,uBAAuB,CAAC,aAAa,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;IAED,qCAAqC;IAC9B,YAAY;QACf,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;CACJ"}

package/dist/lib/rop/FastTransferStream.js

@@ -0,0 +1,195 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { FolderType } from "@rapidmx/restapi";
+import { BufferWriter } from "../codec/BufferCursor.js";
+import { PropertyType, writeTaggedPropertyValue } from "../codec/PropertyValue.js";
+import { assignHandle, releaseHandle } from "../MapiSessionManager.js";
+import { resolveFolderCalendarEvents } from "./CalendarEventTarget.js";
+import { handleDataKey, handleDataOwners } from "./HandleDataCache.js";
+import { resolveFolderMessages } from "./MessageTarget.js";
+import { resolvePropertyValues } from "./PropertyResolvers.js";
+import { handleDataStoreOf } from "./RopHandler.js";
+/**
+ * Builds the `FastTransfer` binary stream (`[MS-OXCFXICS]` §2.2.4) `RopFastTransferSourceCopyTo`/
+ * `CopyProperties` hand off to `RopFastTransferSourceGetBuffer` for paging out, per this pragmatic subset's own
+ * "ICS" scope (see the architecture plan's "Incremental sync" row): a **full, non-differential** dump of the
+ * target's current live state, built eagerly and stored whole on the output handle - not the real, much larger
+ * `contentsSync`/`hierarchySync` grammar (`IncrSyncChg`/`IncrSyncDel`/`IncrSyncStateBegin` markers), which
+ * requires a persisted per-device ICS state object (an `IDSET` baseline) this pragmatic subset doesn't
+ * implement. A real client that asks for an incremental sync here simply gets a full re-list every time and
+ * reconciles by diffing against its own local cache - spec-legitimate client behavior, just more state
+ * re-fetched per sync than a byte-perfect ICS server would send, exactly the tradeoff the plan accepts.
+ *
+ * Only the plain `PidTag*` properties this pragmatic subset already resolves via `PropertyResolvers.ts` are
+ * ever included - a Calendar item's own named properties (start/end/location/recurrence/...) are **not**
+ * included in the stream (only `PidTagSubject`), a deliberate scope cut: a client wanting those already has to
+ * `RopOpenMessage`+`RopGetPropertiesSpecific` the item directly (the same "just re-fetches more state" tradeoff
+ * applied one level deeper). No recipients/attachments/subfolders are emitted either - `messageChildren` is
+ * always empty and `Level` (whether to recurse into subfolders) is not honored, matching this pragmatic
+ * subset's existing "no `RopModifyRecipients`" and folder-hierarchy-is-flat-per-call precedents elsewhere.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+/** FastTransfer markers (`[MS-OXCFXICS]` §2.2.4.1.4, confirmed this session) - only the four this pragmatic
+ * subset's flat, non-differential dump ever needs. */
+const MARKER_START_TOP_FLD = 0x40090003;
+const MARKER_END_FOLDER = 0x400b0003;
+const MARKER_START_MESSAGE = 0x400c0003;
+const MARKER_END_MESSAGE = 0x400d0003;
+/** The well-known columns this pragmatic subset includes by default when the caller (`RopFastTransferSourceCopyTo`)
+ * didn't supply an explicit include list - the same small "what a real client needs" sets `PropertyResolvers.ts`
+ * already defines its own defaults around. */
+const DEFAULT_FOLDER_COLUMNS = [
+    { propertyId: 0x3001, propertyType: PropertyType.PtypString }, // PidTagDisplayName
+    { propertyId: 0x3602, propertyType: PropertyType.PtypInteger32 }, // PidTagContentCount
+    { propertyId: 0x3603, propertyType: PropertyType.PtypInteger32 }, // PidTagContentUnreadCount
+];
+const DEFAULT_MESSAGE_COLUMNS = [
+    { propertyId: 0x0037, propertyType: PropertyType.PtypString }, // PidTagSubject
+    { propertyId: 0x0e07, propertyType: PropertyType.PtypInteger32 }, // PidTagMessageFlags
+    { propertyId: 0x0e1b, propertyType: PropertyType.PtypBoolean }, // PidTagHasAttachments
+    { propertyId: 0x0e06, propertyType: PropertyType.PtypTime }, // PidTagMessageDeliveryTime
+];
+/** A calendar item's named properties are deliberately excluded from the stream (see class doc comment) -
+ * `PidTagSubject` is the only column emitted for one. */
+const DEFAULT_CALENDAR_COLUMNS = [{ propertyId: 0x0037, propertyType: PropertyType.PtypString }];
+async function writePropList(writer, target, columns, context) {
+    const values = await resolvePropertyValues(target, columns, context);
+    columns.forEach((column, index) => writeTaggedPropertyValue(writer, { propertyId: column.propertyId, propertyType: column.propertyType, value: values[index] }));
+}
+function filterExcluded(columns, excludePropertyIds) {
+    return columns.filter((column) => !excludePropertyIds.has(column.propertyId));
+}
+/** The largest FastTransfer stream built for one handle; a larger source fails with `MAPI_E_TOO_BIG`. */
+export const MAX_FAST_TRANSFER_BYTES = 32 * 1024 * 1024;
+/** How long a built stream is kept for paging out. A client pages a stream out right after opening it; one that
+ * leaves it longer than this has to open the transfer again. */
+export const FAST_TRANSFER_TTL_SECONDS = 10 * 60;
+/** Thrown while building a stream that has grown past its byte limit. */
+export class FastTransferTooBigError extends Error {
+    constructor() {
+        super("FastTransfer: the stream is larger than MAX_FAST_TRANSFER_BYTES.");
+        this.name = "FastTransferTooBigError";
+    }
+}
+/**
+ * Builds the complete FastTransfer stream for `handle` (a `"folder"` or `"message"` Server object). `columns`,
+ * when given (a `RopFastTransferSourceCopyProperties` explicit include list), replaces every default column set
+ * uniformly at both folder- and message-level; `excludePropertyIds` (a `RopFastTransferSourceCopyTo` exclude
+ * list) is only ever applied to this pragmatic subset's own default columns, per the same reasoning.
+ *
+ * The size is checked after every item, so a huge folder stops being built as soon as it passes `maxBytes`
+ * (`FastTransferTooBigError`) instead of being fully built first. Every item resolved and the finished stream's bytes
+ * count against the request's `ExecuteBudget` when there is one.
+ */
+export async function buildFastTransferStream(handle, context, options = {}) {
+    const writer = new BufferWriter();
+    const exclude = options.excludePropertyIds ?? new Set();
+    const maxBytes = options.maxBytes ?? MAX_FAST_TRANSFER_BYTES;
+    const checkSize = () => {
+        if (writer.length > maxBytes) {
+            throw new FastTransferTooBigError();
+        }
+    };
+    if (handle.type === "folder") {
+        const folderColumns = options.columns ?? filterExcluded(DEFAULT_FOLDER_COLUMNS, exclude);
+        writer.writeUInt32LE(MARKER_START_TOP_FLD);
+        await writePropList(writer, handle.entityUid, folderColumns, context);
+        if (handle.entityUid.startsWith("folder:")) {
+            const folderUid = handle.entityUid.slice("folder:".length);
+            const folder = await context.folderRepo.findOne(folderUid, { ignoreACL: true });
+            const isCalendar = folder?.type === FolderType.CALENDAR;
+            const rows = isCalendar
+                ? await resolveFolderCalendarEvents(folderUid, context.calendarEventRepo, context.budget)
+                : await resolveFolderMessages(folderUid, context.messageRepo, context.budget);
+            const messageColumns = options.columns ?? filterExcluded(isCalendar ? DEFAULT_CALENDAR_COLUMNS : DEFAULT_MESSAGE_COLUMNS, exclude);
+            for (const row of rows) {
+                writer.writeUInt32LE(MARKER_START_MESSAGE);
+                await writePropList(writer, row, messageColumns, context);
+                writer.writeUInt32LE(MARKER_END_MESSAGE);
+                checkSize();
+            }
+        }
+        writer.writeUInt32LE(MARKER_END_FOLDER);
+    }
+    else {
+        const isCalendar = handle.entityUid.startsWith("calendarEvent:");
+        const columns = options.columns ?? filterExcluded(isCalendar ? DEFAULT_CALENDAR_COLUMNS : DEFAULT_MESSAGE_COLUMNS, exclude);
+        await writePropList(writer, handle.entityUid, columns, context);
+    }
+    checkSize();
+    context.budget?.chargeBytes(writer.length);
+    return writer.toBuffer();
+}
+/** Builds a `"fastTransfer"` handle's stream from what the handle records about its source, or `undefined` when it
+ * is larger than `MAX_FAST_TRANSFER_BYTES`. */
+async function rebuildFastTransferStream(transfer, context) {
+    try {
+        return await buildFastTransferStream({ type: transfer.transferSourceType, entityUid: transfer.entityUid }, context, {
+            columns: transfer.transferColumns,
+            excludePropertyIds: new Set(transfer.transferExcludeIds ?? []),
+        });
+    }
+    catch (err) {
+        if (err instanceof FastTransferTooBigError) {
+            return undefined;
+        }
+        throw err;
+    }
+}
+/**
+ * The built stream for the `"fastTransfer"` handle at `handleIndex`, from the shared `HandleDataStore` (Redis when
+ * configured, so any replica can page it out).
+ *
+ * When the stream is gone (expired, evicted, or built by a replica without shared storage), it is rebuilt only if
+ * nothing has been paged out yet. Part-way through, a rebuild could differ from what the client already has (items
+ * added or changed since), and continuing at the old offset would hand it bytes from a different stream, so that
+ * case reports `"lost"` and the client restarts the transfer. A rebuild is held to `MAX_FAST_TRANSFER_BYTES` like
+ * the original build, and storing it to the session's and user's handle data quota (`handleDataOwners`); either
+ * failing reports `"tooBig"`.
+ */
+export async function loadFastTransferBuffer(context, handleIndex, transfer) {
+    const store = handleDataStoreOf(context);
+    const key = handleDataKey(context.session.uid, handleIndex, transfer.generation);
+    const stored = await store.get(key);
+    if (stored) {
+        return stored;
+    }
+    if ((transfer.transferPosition ?? 0) > 0) {
+        return "lost";
+    }
+    const buffer = await rebuildFastTransferStream(transfer, context);
+    if (!buffer || !(await store.set(key, buffer, FAST_TRANSFER_TTL_SECONDS, handleDataOwners(context.session.uid, context.session.userUid)))) {
+        return "tooBig";
+    }
+    return buffer;
+}
+/**
+ * Shared by `RopFastTransferSourceCopyTo`/`CopyProperties`: builds the stream for `source`, and on success stores a
+ * `"fastTransfer"` handle at `outputHandleIndex` with the stream in the `HandleDataStore`. Returns `false`, storing
+ * nothing, when the stream exceeds `MAX_FAST_TRANSFER_BYTES` or the session's or user's handle data quota
+ * (`handleDataOwners`) has no room for it.
+ */
+export async function openFastTransferHandle(context, outputHandleIndex, source, options) {
+    const transfer = {
+        type: "fastTransfer",
+        entityUid: source.entityUid,
+        transferSourceType: source.type === "folder" ? "folder" : "message",
+        transferColumns: options.columns,
+        transferExcludeIds: options.excludePropertyIds,
+        transferPosition: 0,
+    };
+    const buffer = await rebuildFastTransferStream(transfer, context);
+    if (!buffer) {
+        return false;
+    }
+    assignHandle(context.session, outputHandleIndex, transfer);
+    const stored = await handleDataStoreOf(context).set(handleDataKey(context.session.uid, outputHandleIndex, transfer.generation), buffer, FAST_TRANSFER_TTL_SECONDS, handleDataOwners(context.session.uid, context.session.userUid));
+    if (!stored) {
+        releaseHandle(context.session, outputHandleIndex);
+    }
+    return stored;
+}
+//# sourceMappingURL=FastTransferStream.js.map

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

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

package/dist/lib/rop/FolderTarget.js

@@ -0,0 +1,118 @@
+import { findAllCapped, MAX_COLLECTION_ROWS } from "./RepoPaging.js";
+/** Every folder in `mailboxUid` (up to `MAX_COLLECTION_ROWS`), by name. Paged explicitly: a bare `find()` stops at
+ * the repo's 100-row default, which silently dropped folders from hierarchy tables in larger mailboxes. Each page is
+ * charged to `budget` before it is read. */
+async function findMailboxFolders(mailboxUid, folderRepo, budget) {
+    return (await findAllCapped(folderRepo, { mailboxUid }, { name: "ASC", uid: "ASC" }, MAX_COLLECTION_ROWS, budget)).items;
+}
+/**
+ * Shared helpers for resolving the `"virtual:<name>"`/`"folder:<uid>"` target strings `RopLogonHandler`
+ * assigns to FIDs (see its own doc comment) into real folder data - used by `RopOpenFolderHandler` and
+ * `RopGetHierarchyTableHandler`.
+ */
+/** Display names for the virtual (no real backing `Folder`) special folders - see `RopLogonHandler`'s own
+ * doc comment for why these don't have real rows in this data model. */
+const VIRTUAL_DISPLAY_NAMES = {
+    root: "Root",
+    deferredAction: "Deferred Action",
+    spoolerQueue: "Spooler Queue",
+    ipmSubtree: "Top of Information Store",
+    commonViews: "Common Views",
+    schedule: "Schedule",
+    search: "Finder",
+    views: "Views",
+    shortcuts: "Shortcuts",
+};
+/** Resolves a target string into the display data a folder-table row needs. A `"folder:<uid>"` target whose
+ * `Folder` has since been deleted (soft-deleted or otherwise vanished) degrades to empty-looking values rather
+ * than throwing - the row simply won't be interesting to a client, not a reason to fail the whole ROP. */
+export async function resolveFolderInfo(mailboxUid, target, folderRepo, cache, budget) {
+    if (target.startsWith("folder:")) {
+        const uid = target.slice("folder:".length);
+        const folder = await folderRepo.findOne(uid, { ignoreACL: true });
+        const hasChildren = (await resolveFolderChildren(mailboxUid, target, folderRepo, cache, budget)).length > 0;
+        return {
+            displayName: folder?.name ?? "",
+            unreadCount: folder?.unreadCount ?? 0,
+            totalCount: folder?.totalCount ?? 0,
+            hasChildren,
+        };
+    }
+    const name = target.slice("virtual:".length);
+    const hasChildren = (await resolveFolderChildren(mailboxUid, target, folderRepo, cache, budget)).length > 0;
+    return { displayName: VIRTUAL_DISPLAY_NAMES[name] ?? name, unreadCount: 0, totalCount: 0, hasChildren };
+}
+/**
+ * Resolves the direct children of `target`, as an array of the same target-string format, for
+ * `RopGetHierarchyTable`. Only `"virtual:root"`/`"virtual:ipmSubtree"` (this mailbox's top-level real
+ * folders - both collapse to the same "top of the visible tree" concept in this pragmatic subset, see
+ * `RopLogonHandler`'s own doc comment) and a real folder (its own real children) have any children at all;
+ * every other virtual folder (Deferred Action, Spooler Queue, ...) is permanently empty, since this data
+ * model has no concept of nesting anything under them.
+ *
+ * Filters an already-fetched full folder list in application code rather than querying by
+ * `parentFolderUid: undefined` directly - query-DSL semantics for "field is unset" aren't reliably consistent
+ * across backends (the exact kind of gap this project's own testing philosophy has caught before, e.g. `$or`
+ * being Mongo-only), so filtering a fetched array sidesteps the question entirely rather than risking it.
+ * The comparison itself uses `== null` (matching both `null` and `undefined`), not `=== undefined` - a
+ * top-level folder's unset `parentFolderUid` round-trips as genuine `undefined` from Mongo but as `null` from
+ * a SQL `nullable` column, a real, previously-confirmed cross-backend discrepancy in this codebase (caught by
+ * this exact test against a real SQLite-backed server, not assumed).
+ *
+ * **`cache`**: without it, this fetches every folder in the mailbox on every call - fine for the single call
+ * `RopGetHierarchyTableHandler` makes to build a table, but `resolveFolderInfo` also calls this once per row
+ * just to compute `hasChildren`, and a table page can hold many rows. A caller resolving a whole page (
+ * `RopQueryRowsHandler`/`RopGetPropertiesSpecificHandler`) passes one shared cache object through every call in
+ * that batch so the full list is fetched at most once per batch instead of once per row - see
+ * `FolderResolutionCache`'s own doc comment for why this isn't session state.
+ */
+export async function resolveFolderChildren(mailboxUid, target, folderRepo, cache, budget) {
+    const isTopLevel = target === "virtual:root" || target === "virtual:ipmSubtree";
+    let parentFolderUid;
+    if (isTopLevel) {
+        parentFolderUid = undefined;
+    }
+    else if (target.startsWith("folder:")) {
+        parentFolderUid = target.slice("folder:".length);
+    }
+    else {
+        return [];
+    }
+    let allFolders;
+    if (cache) {
+        cache.allFolders ?? (cache.allFolders = await findMailboxFolders(mailboxUid, folderRepo, budget));
+        allFolders = cache.allFolders;
+    }
+    else {
+        allFolders = await findMailboxFolders(mailboxUid, folderRepo, budget);
+    }
+    return allFolders
+        .filter((f) => (isTopLevel ? f.parentFolderUid == null : f.parentFolderUid === parentFolderUid))
+        .map((f) => `folder:${f.uid}`);
+}
+/**
+ * Returns `target`'s existing FID if `RopLogon` or an earlier `RopGetHierarchyTable` row already assigned
+ * one, otherwise assigns and remembers the next free small integer FID. This is what lets a client
+ * `RopOpenFolder` a child folder it only ever learned about via a `RopQueryRows` row's `PidTagFolderId`
+ * column - without this, only the 13 `RopLogon`-time special folders could ever be opened.
+ *
+ * Backed by `session.folderTargetIds` (target -> FID) and `session.nextFolderId`, an O(1) reverse index/counter
+ * pair rather than a linear scan of `session.folderIds` plus a `Math.max(...spread)` over its keys - both real
+ * costs, not just theoretical ones: `folderTargetIds` only ever grows for a session's lifetime as a client
+ * browses more of a mailbox's folder tree, so the old scan-per-lookup approach was quadratic across a session
+ * that opens many folders, and `Math.max` spreading an unbounded array as call arguments risked a stack
+ * overflow past V8's argument-count limit on a mailbox with enough folders. `RopLogonHandler` keeps
+ * `folderTargetIds`/`nextFolderId` in sync with `folderIds` for the 13 special folders it assigns directly,
+ * rather than going through this function, since it assigns all 13 as one batch up front.
+ */
+export function assignOrGetFid(session, target) {
+    const existing = session.folderTargetIds[target];
+    if (existing !== undefined) {
+        return existing;
+    }
+    const fid = session.nextFolderId++;
+    session.folderIds[String(fid)] = target;
+    session.folderTargetIds[target] = fid;
+    return fid;
+}
+//# sourceMappingURL=FolderTarget.js.map

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

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