@rapidmx/activesync-plugin 1.0.0-beta.2

package/dist/lib/commands/SearchCommand.js

@@ -0,0 +1,234 @@
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ApiError, ObjectDecorators, StringUtils } from "@rapidrest/core";
+import { ACLAction, ACLUtils, ApiErrorMessages, ApiErrors, RepoUtils } from "@rapidrest/service-core";
+import { WbxmlCodePage } from "../codec/WbxmlCodePages.js";
+import { childText, element, findChild, textElement } from "../codec/WbxmlElement.js";
+const { Config, Init, Inject } = ObjectDecorators;
+/** Parses a `Range` value (`"m-n"`, a zero-based inclusive index pair) into `{ start, end }`, falling back to
+ * `defaultEnd` for a missing/malformed value - never trusting the client to request more than `maxEnd` rows. */
+function parseRange(raw, defaultEnd, maxEnd) {
+    const match = raw?.match(/^(\d+)-(\d+)$/);
+    if (!match) {
+        return { start: 0, end: Math.min(defaultEnd, maxEnd) };
+    }
+    const start = Number(match[1]);
+    const end = Math.min(Number(match[2]), maxEnd);
+    return start <= end ? { start, end } : { start: 0, end: Math.min(defaultEnd, maxEnd) };
+}
+/** Clamps a matched-results array against a requested `[start, end]` Range, reporting both the sliced page and
+ * the actual Range/Total to echo back - shared by the `GAL` and `Mailbox` branches below, which otherwise
+ * differ only in how they produce `matches` and render one entry. Both ends are forced to `0` when there are no
+ * matches at all - `start` alone (from a client-requested Range like `"5-10"`) would otherwise survive
+ * unclamped, producing a malformed `"5-0"` (start > end) once `end` collapses to `0`. */
+function paginate(matches, start, end) {
+    return {
+        page: matches.slice(start, end + 1),
+        rangeStart: matches.length === 0 ? 0 : start,
+        rangeEnd: matches.length === 0 ? 0 : Math.min(end, matches.length - 1),
+    };
+}
+/**
+ * Handles EAS `Search` for the `GAL` and `Mailbox` stores - `DocumentLibrary` (the real spec's third store type)
+ * remains out of scope, matching `ItemOperationsCommand`'s identical scope decision; this library has no
+ * document-library model.
+ *
+ * **`GAL`**: this library's `Contact` records are also the source of truth for GAL lookups against a mailbox's
+ * own address book (see the architecture note on `Contact` itself). A simple case-insensitive substring match
+ * via `RepoUtils.find()` directly, not the heavier `SearchProvider` full-text index - GAL lookups are
+ * small-scale exact/prefix matching against a personal address book, not relevance-ranked full text over large
+ * content. Only `displayName`/`givenName`/`surname`/`company` are matched - `Contact.emails`/`phones` are
+ * embedded arrays of objects, which a plain per-field regex query can't reach into on either backend (confirmed:
+ * MongoDB's `$regex` against an array-of-objects field matches nothing useful, and this library's own
+ * query-injection guard rejects dot-notation field paths like `"emails.address"` outright) - a documented gap,
+ * not an oversight.
+ *
+ * **`Mailbox`**: real full-text search over the caller's own `Email` messages, backed by `restapi`'s
+ * `SearchProvider` (its own full-text index, kept eventually-consistent with the primary datastore via
+ * `SearchIndexJob` - a just-sent/just-received message may briefly not be findable yet). **Pragmatic subset**:
+ * only `Class` `Email` is supported (a `Query` naming any other class is rejected, matching the `GAL`-only
+ * precedent this file already established for search generally); only the common real-world `Query` shape -
+ * `Class`/`CollectionId`/`FreeText`, optionally grouped under one `And` - is parsed, not the full recursive
+ * `And`/`Or`/`EqualTo`/`GreaterThan`/`LessThan` boolean-tree grammar MS-ASCMD's schema allows for, so a
+ * multi-level nested query silently only sees the first `And` group's own direct children. Each match is
+ * re-verified for `READ` on its own current `folderUid` before being included - `SearchProvider`'s index is
+ * scoped by `mailboxUid` alone, not per-folder ACL, so this is the one place that check still has to happen
+ * per-result rather than once up front. `SearchResultPage` carries no total count (the underlying providers
+ * don't compute one cheaply over a relevance-ranked query), so `Total` here means "how many matches this
+ * request's own capped fetch actually returned" - a client requesting a `Range` past that cap sees fewer
+ * results than may really exist, a documented approximation rather than exact server-side paging.
+ *
+ * `contactClass`/`messageClass`/`emailAdapterClass` are supplied by the Mongo/SQL concrete subclasses.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class SearchCommand {
+    constructor() {
+        this.command = "Search";
+        this.defaultRangeEnd = 9;
+        this.maxRangeEnd = 99;
+    }
+    async init() {
+        this.contactRepo = await this._objectFactory.newInstance(RepoUtils, {
+            name: this.contactClass.name,
+            args: [this.contactClass],
+        });
+        this.messageRepo = await this._objectFactory.newInstance(RepoUtils, {
+            name: this.messageClass.name,
+            args: [this.messageClass],
+        });
+        this.emailAdapter = await this._objectFactory.newInstance(this.emailAdapterClass);
+    }
+    async handle(ctx) {
+        if (!this.contactRepo || !this.messageRepo || !this.searchProvider || !this.emailAdapter) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        const storeEl = ctx.request ? findChild(ctx.request, "Store") : undefined;
+        const name = storeEl ? childText(storeEl, "Name") : undefined;
+        if (!storeEl || (name !== "GAL" && name !== "Mailbox")) {
+            throw new ApiError(ApiErrors.INVALID_REQUEST, 400, "Search requires a Store with Name 'GAL' or 'Mailbox'.");
+        }
+        const optionsEl = findChild(storeEl, "Options");
+        const { start, end } = parseRange(optionsEl ? childText(optionsEl, "Range") : undefined, this.defaultRangeEnd, this.maxRangeEnd);
+        const storeResponse = name === "GAL" ? await this.handleGal(ctx, storeEl, start, end) : await this.handleMailbox(ctx, storeEl, start, end);
+        return element(WbxmlCodePage.Search, "Search", [
+            textElement(WbxmlCodePage.Search, "Status", "1"),
+            element(WbxmlCodePage.Search, "Response", [storeResponse]),
+        ]);
+    }
+    async handleGal(ctx, storeEl, start, end) {
+        const query = childText(storeEl, "Query");
+        if (!query) {
+            throw new ApiError(ApiErrors.INVALID_REQUEST, 400, "Search requires a Store with Name 'GAL' and a Query.");
+        }
+        // `$or` is a Mongo-only feature of this framework's query builder - `buildSearchQuerySQL` (confirmed by
+        // reading its source) has no handling for it at all, so passing one on the SQL backend silently builds
+        // a broken TypeORM `where` clause (a literal `$or` property, not a real OR) and 500s. Querying each
+        // field separately and merging in memory - the same workaround `EasSyncKeyUtils.computeChanges()`
+        // already uses for its own two-backend query gap - works identically on both backends instead.
+        //
+        // Uses `regex()`, not `like()`: `like()` (`@rapidrest/service-core` ^2.0) compiles a **glob** pattern
+        // (`*`/`?` as wildcards), anchored on both backends, so a substring match needs wrapping the term in
+        // `*...*` - and even then a literal `*`/`?` the user typed still acts as a wildcard, since glob syntax
+        // has no escape mechanism for either character. `regex()` takes a real, unanchored regular expression
+        // compiled case-insensitively on both backends (`$regex`/driver-native `REGEXP`), so escaping the term
+        // with `StringUtils.escapeRegExp` gives a genuine literal-substring match with no residual wildcard
+        // ambiguity - no `*...*` wrapping needed, `regex()` already matches anywhere in the field by default.
+        const pattern = StringUtils.escapeRegExp(query);
+        const findOptions = { ignoreACL: true, limit: this.maxRangeEnd + 1 };
+        const perField = await Promise.all(["displayName", "givenName", "surname", "company"].map((field) => this.contactRepo.find({ mailboxUid: ctx.mailboxUid, [field]: `regex(${pattern})`, limit: this.maxRangeEnd + 1 }, findOptions)));
+        const byUid = new Map();
+        for (const contact of perField.flat()) {
+            byUid.set((contact).uid, contact);
+        }
+        const matches = Array.from(byUid.values()).sort((a, b) => a.displayName.localeCompare(b.displayName));
+        const { page, rangeStart, rangeEnd } = paginate(matches, start, end);
+        return element(WbxmlCodePage.Search, "Store", [
+            textElement(WbxmlCodePage.Search, "Status", "1"),
+            ...page.map((contact) => this.contactToResult(contact)),
+            textElement(WbxmlCodePage.Search, "Range", `${rangeStart}-${rangeEnd}`),
+            textElement(WbxmlCodePage.Search, "Total", String(matches.length)),
+        ]);
+    }
+    async handleMailbox(ctx, storeEl, start, end) {
+        const queryEl = findChild(storeEl, "Query");
+        if (!queryEl) {
+            throw new ApiError(ApiErrors.INVALID_REQUEST, 400, "Search requires a Store with Name 'Mailbox' and a Query.");
+        }
+        // The common real-world shape groups Class/CollectionId/FreeText under one And - see this class's own
+        // doc comment for why a deeper And/Or tree isn't parsed. Falling back to Query's own direct children
+        // also accepts a client that omits the And wrapper entirely, which the schema itself permits.
+        const container = findChild(queryEl, "And") ?? queryEl;
+        const className = childText(container, "Class");
+        const folderUid = childText(container, "CollectionId");
+        const freeText = childText(container, "FreeText");
+        if (className !== "Email" || !freeText) {
+            throw new ApiError(ApiErrors.INVALID_REQUEST, 400, "Search on the 'Mailbox' store requires a Query with Class 'Email' and a FreeText term.");
+        }
+        const resultPage = await this.searchProvider.search({
+            mailboxUid: ctx.mailboxUid,
+            text: freeText,
+            entityTypes: ["message"],
+            folderUid,
+            limit: this.maxRangeEnd + 1,
+        });
+        const matches = [];
+        for (const result of resultPage.results) {
+            const message = await this.messageRepo.findOne(result.entityUid, { ignoreACL: true });
+            if (!message) {
+                continue;
+            }
+            if (!(await this.aclUtils.hasPermission(ctx.user, message.folderUid, ACLAction.READ))) {
+                continue;
+            }
+            matches.push(message);
+        }
+        const { page, rangeStart, rangeEnd } = paginate(matches, start, end);
+        const results = await Promise.all(page.map((message) => this.messageToResult(message)));
+        return element(WbxmlCodePage.Search, "Store", [
+            textElement(WbxmlCodePage.Search, "Status", "1"),
+            ...results,
+            textElement(WbxmlCodePage.Search, "Range", `${rangeStart}-${rangeEnd}`),
+            textElement(WbxmlCodePage.Search, "Total", String(matches.length)),
+        ]);
+    }
+    contactToResult(contact) {
+        const properties = [
+            textElement(WbxmlCodePage.Gal, "DisplayName", contact.displayName),
+            ...(contact.givenName ? [textElement(WbxmlCodePage.Gal, "FirstName", contact.givenName)] : []),
+            ...(contact.surname ? [textElement(WbxmlCodePage.Gal, "LastName", contact.surname)] : []),
+            ...(contact.company ? [textElement(WbxmlCodePage.Gal, "Company", contact.company)] : []),
+            ...(contact.jobTitle ? [textElement(WbxmlCodePage.Gal, "Title", contact.jobTitle)] : []),
+            ...(contact.emails[0] ? [textElement(WbxmlCodePage.Gal, "EmailAddress", contact.emails[0].address)] : []),
+            ...(contact.phones[0] ? [textElement(WbxmlCodePage.Gal, "Phone", contact.phones[0].phoneNumber)] : []),
+        ];
+        return element(WbxmlCodePage.Search, "Result", [element(WbxmlCodePage.Search, "Properties", properties)]);
+    }
+    /** Reuses `EmailSyncAdapter.toApplicationData()`'s own field mapping (Subject/From/To/Cc/Bcc/DateReceived/
+     * Importance/Read/Flag/Body/ConversationId) for a Mailbox-store search hit's `Properties` - the same
+     * per-field shape `Sync` already renders for this message, rather than a second, parallel mapping that
+     * could drift out of sync with it. */
+    async messageToResult(message) {
+        const applicationData = await this.emailAdapter.toApplicationData(message);
+        return element(WbxmlCodePage.Search, "Result", [
+            textElement(WbxmlCodePage.AirSync, "Class", "Email"),
+            textElement(WbxmlCodePage.AirSync, "CollectionId", message.folderUid),
+            textElement(WbxmlCodePage.AirSync, "ServerId", message.uid),
+            element(WbxmlCodePage.Search, "Properties", applicationData.children),
+        ]);
+    }
+}
+__decorate([
+    Inject("SearchProvider"),
+    __metadata("design:type", Object)
+], SearchCommand.prototype, "searchProvider", void 0);
+__decorate([
+    Inject(ACLUtils),
+    __metadata("design:type", ACLUtils)
+], SearchCommand.prototype, "aclUtils", void 0);
+__decorate([
+    Config("mail:eas:search_default_range", 9),
+    __metadata("design:type", Number)
+], SearchCommand.prototype, "defaultRangeEnd", void 0);
+__decorate([
+    Config("mail:eas:search_max_range", 99),
+    __metadata("design:type", Number)
+], SearchCommand.prototype, "maxRangeEnd", void 0);
+__decorate([
+    Init,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], SearchCommand.prototype, "init", null);
+//# sourceMappingURL=SearchCommand.js.map

package/dist/lib/commands/SearchCommand.js.map

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

package/dist/lib/commands/SendMailCommand.js

@@ -0,0 +1,18 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ComposeMailCommand } from "./ComposeMailCommand.js";
+/**
+ * Handles EAS `SendMail`: relays a freshly composed message with no referenced original - see
+ * `ComposeMailCommand`'s own doc comment for the full shared implementation.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class SendMailCommand extends ComposeMailCommand {
+    constructor() {
+        super(...arguments);
+        this.command = "SendMail";
+    }
+}
+//# sourceMappingURL=SendMailCommand.js.map

package/dist/lib/commands/SendMailCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendMailCommand.js","sourceRoot":"","sources":["../../../src/commands/SendMailCommand.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,OAAgB,eAAgB,SAAQ,kBAAkB;IAAhE;;QACoB,YAAO,GAAG,UAAU,CAAC;IACzC,CAAC;CAAA"}

package/dist/lib/commands/SettingsCommand.js

@@ -0,0 +1,138 @@
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ApiError, ObjectDecorators } from "@rapidrest/core";
+import { ApiErrorMessages, ApiErrors, RepoUtils } from "@rapidrest/service-core";
+import { WbxmlCodePage } from "../codec/WbxmlCodePages.js";
+import { childText, element, findChild, textElement } from "../codec/WbxmlElement.js";
+const { Init } = ObjectDecorators;
+/**
+ * Handles EAS `Settings`: the first-run/general-purpose device<->server settings exchange. This pragmatic
+ * subset supports the sub-elements every real client actually depends on:
+ *
+ * - `UserInformation`/`Get`: returns the mailbox's `primarySmtpAddress`/`aliasAddresses` as `EmailAddresses`.
+ * - `DeviceInformation`/`Set`: acknowledged with `Status 1` but not persisted anywhere - `DeviceSyncState` has
+ * no fields for a device's model/IMEI/OS/friendly name, and nothing else in this library currently consumes
+ * them. A real client only requires the acknowledgement to proceed past first-run setup, not that the values
+ * are retrievable later.
+ * - `Oof`/`Get` and `Oof`/`Set`: reads/writes `Mailbox.oofEnabled`/`oofMessage`/`oofStartTime`/`oofEndTime`.
+ * `StartTime`/`EndTime` use MS-ASDTYPE's plain `dateTime` type (`Date.prototype.toISOString()`), not Compact
+ * DateTime - confirmed against MS-ASSETTINGS directly, unlike `Calendar`/`Tasks`' timestamp fields (see
+ * `CompactDateTime.ts`'s own doc comment on that exact distinction). A single combined reply message is stored
+ * rather than the spec's three audience-specific `OofMessage` variants (internal/external-known/
+ * external-unknown) - matches this codebase's existing "one thing, not three" simplification precedent (e.g.
+ * `ContactsSyncAdapter`'s single-slot phone/email handling).
+ * - `RightsManagementInformation` is not implemented - deferred, matching this library's "pragmatic subset"
+ * precedent elsewhere (e.g. `ComposeMailCommand`'s own documented gaps).
+ *
+ * `mailboxClass` is supplied by the Mongo/SQL concrete subclasses.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class SettingsCommand {
+    constructor() {
+        this.command = "Settings";
+    }
+    async init() {
+        this.mailboxRepo = await this._objectFactory.newInstance(RepoUtils, {
+            name: this.mailboxClass.name,
+            args: [this.mailboxClass],
+        });
+    }
+    async handle(ctx) {
+        if (!this.mailboxRepo) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        const children = [textElement(WbxmlCodePage.Settings, "Status", "1")];
+        if (ctx.request && findChild(ctx.request, "DeviceInformation")) {
+            children.push(element(WbxmlCodePage.Settings, "DeviceInformation", [textElement(WbxmlCodePage.Settings, "Status", "1")]));
+        }
+        if (ctx.request && findChild(ctx.request, "UserInformation")) {
+            const mailbox = await this.mailboxRepo.findOne(ctx.mailboxUid, { ignoreACL: true });
+            if (!mailbox) {
+                throw new ApiError(ApiErrors.NOT_FOUND, 404, ApiErrorMessages.NOT_FOUND);
+            }
+            children.push(element(WbxmlCodePage.Settings, "UserInformation", [
+                textElement(WbxmlCodePage.Settings, "Status", "1"),
+                element(WbxmlCodePage.Settings, "EmailAddresses", [
+                    textElement(WbxmlCodePage.Settings, "SmtpAddress", mailbox.primarySmtpAddress),
+                    ...mailbox.aliasAddresses.map((address) => textElement(WbxmlCodePage.Settings, "SmtpAddress", address)),
+                ]),
+            ]));
+        }
+        const oofEl = ctx.request ? findChild(ctx.request, "Oof") : undefined;
+        if (oofEl) {
+            const mailbox = await this.mailboxRepo.findOne(ctx.mailboxUid, { ignoreACL: true });
+            if (!mailbox) {
+                throw new ApiError(ApiErrors.NOT_FOUND, 404, ApiErrorMessages.NOT_FOUND);
+            }
+            const setEl = findChild(oofEl, "Set");
+            children.push(setEl ? await this.setOof(ctx, mailbox, setEl) : this.getOof(mailbox));
+        }
+        return element(WbxmlCodePage.Settings, "Settings", children);
+    }
+    /** `OofState`: `0`=disabled, `1`=enabled indefinitely, `2`=time-based (only while now is within
+     * `StartTime`/`EndTime`). */
+    getOof(mailbox) {
+        const timed = mailbox.oofEnabled && !!mailbox.oofStartTime && !!mailbox.oofEndTime;
+        return element(WbxmlCodePage.Settings, "Oof", [
+            textElement(WbxmlCodePage.Settings, "Status", "1"),
+            element(WbxmlCodePage.Settings, "Get", [
+                textElement(WbxmlCodePage.Settings, "OofState", mailbox.oofEnabled ? (timed ? "2" : "1") : "0"),
+                ...(timed
+                    ? [
+                        textElement(WbxmlCodePage.Settings, "StartTime", mailbox.oofStartTime.toISOString()),
+                        textElement(WbxmlCodePage.Settings, "EndTime", mailbox.oofEndTime.toISOString()),
+                    ]
+                    : []),
+                element(WbxmlCodePage.Settings, "OofMessage", [
+                    element(WbxmlCodePage.Settings, "AppliesToInternal", []),
+                    textElement(WbxmlCodePage.Settings, "Enabled", mailbox.oofEnabled ? "1" : "0"),
+                    textElement(WbxmlCodePage.Settings, "ReplyMessage", mailbox.oofMessage),
+                    textElement(WbxmlCodePage.Settings, "BodyType", "Text"),
+                ]),
+            ]),
+        ]);
+    }
+    async setOof(ctx, mailbox, setEl) {
+        const oofState = childText(setEl, "OofState") ?? "0";
+        const oofMessageEl = findChild(setEl, "OofMessage");
+        const replyMessage = oofMessageEl ? (childText(oofMessageEl, "ReplyMessage") ?? "") : "";
+        const startTime = childText(setEl, "StartTime");
+        const endTime = childText(setEl, "EndTime");
+        const timed = oofState === "2" && startTime !== undefined && endTime !== undefined;
+        // `null`, not `undefined`, to clear a previously-set window when switching away from time-based Oof:
+        // TypeORM's `UpdateQueryBuilder` silently drops any `undefined`-valued key from the generated SQL `SET`
+        // clause (confirmed by reading its source), so `undefined` here would leave a stale StartTime/EndTime
+        // in place on the SQL backend while correctly clearing it on Mongo - `null` clears it on both.
+        await this.mailboxRepo.update({
+            uid: mailbox.uid,
+            version: mailbox.version,
+            oofEnabled: oofState !== "0",
+            oofMessage: replyMessage,
+            oofStartTime: timed ? new Date(startTime) : null,
+            oofEndTime: timed ? new Date(endTime) : null,
+        }, mailbox, { ignoreACL: true, user: ctx.user });
+        return element(WbxmlCodePage.Settings, "Oof", [
+            textElement(WbxmlCodePage.Settings, "Status", "1"),
+            element(WbxmlCodePage.Settings, "Set", [textElement(WbxmlCodePage.Settings, "Status", "1")]),
+        ]);
+    }
+}
+__decorate([
+    Init,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], SettingsCommand.prototype, "init", null);
+//# sourceMappingURL=SettingsCommand.js.map

package/dist/lib/commands/SettingsCommand.js.map

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

package/dist/lib/commands/SmartForwardCommand.js

@@ -0,0 +1,22 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ComposeMailCommand } from "./ComposeMailCommand.js";
+/**
+ * Handles EAS `SmartForward`: relays a freshly composed message threaded to (and referencing) the original via
+ * `<Source>`, then flips the original's `Forwarded` flag - see `ComposeMailCommand`'s own doc comment for the
+ * full shared implementation and this pragmatic subset's scope.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class SmartForwardCommand extends ComposeMailCommand {
+    constructor() {
+        super(...arguments);
+        this.command = "SmartForward";
+    }
+    async markOriginal(ctx, original) {
+        await this.messageRepo.update({ uid: original.uid, version: original.version, flags: { ...original.flags, forwarded: true } }, original, { ignoreACL: true, user: ctx.user });
+    }
+}
+//# sourceMappingURL=SmartForwardCommand.js.map

package/dist/lib/commands/SmartForwardCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartForwardCommand.js","sourceRoot":"","sources":["../../../src/commands/SmartForwardCommand.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7D;;;;;;GAMG;AACH,MAAM,OAAgB,mBAAoB,SAAQ,kBAAkB;IAApE;;QACoB,YAAO,GAAG,cAAc,CAAC;IAS7C,CAAC;IAPsB,KAAK,CAAC,YAAY,CAAC,GAAsB,EAAE,QAAoD;QAC9G,MAAM,IAAI,CAAC,WAAY,CAAC,MAAM,CAC1B,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAS,EACtG,QAAQ,EACR,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CACtC,CAAC;IACN,CAAC;CACJ"}

package/dist/lib/commands/SmartReplyCommand.js

@@ -0,0 +1,22 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ComposeMailCommand } from "./ComposeMailCommand.js";
+/**
+ * Handles EAS `SmartReply`: relays a freshly composed message threaded to (and referencing) the original via
+ * `<Source>`, then flips the original's `Answered` flag - see `ComposeMailCommand`'s own doc comment for the
+ * full shared implementation and this pragmatic subset's scope.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class SmartReplyCommand extends ComposeMailCommand {
+    constructor() {
+        super(...arguments);
+        this.command = "SmartReply";
+    }
+    async markOriginal(ctx, original) {
+        await this.messageRepo.update({ uid: original.uid, version: original.version, flags: { ...original.flags, answered: true } }, original, { ignoreACL: true, user: ctx.user });
+    }
+}
+//# sourceMappingURL=SmartReplyCommand.js.map

package/dist/lib/commands/SmartReplyCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartReplyCommand.js","sourceRoot":"","sources":["../../../src/commands/SmartReplyCommand.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7D;;;;;;GAMG;AACH,MAAM,OAAgB,iBAAkB,SAAQ,kBAAkB;IAAlE;;QACoB,YAAO,GAAG,YAAY,CAAC;IAS3C,CAAC;IAPsB,KAAK,CAAC,YAAY,CAAC,GAAsB,EAAE,QAAoD;QAC9G,MAAM,IAAI,CAAC,WAAY,CAAC,MAAM,CAC1B,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAS,EACrG,QAAQ,EACR,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CACtC,CAAC;IACN,CAAC;CACJ"}