@rapidmx/activesync 1.0.0-beta.0

package/dist/lib/commands/sql/SmartForwardCommandSQL.js

@@ -0,0 +1,17 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { FolderSQL, MessageSQL } from "@rapidmx/restapi/sql";
+import { SmartForwardCommand } from "../SmartForwardCommand.js";
+/**
+ * @author Jean-Philippe Steinmetz
+ */
+export class SmartForwardCommandSQL extends SmartForwardCommand {
+    constructor() {
+        super(...arguments);
+        this.folderClass = FolderSQL;
+        this.messageClass = MessageSQL;
+    }
+}
+//# sourceMappingURL=SmartForwardCommandSQL.js.map

package/dist/lib/commands/sql/SmartForwardCommandSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartForwardCommandSQL.js","sourceRoot":"","sources":["../../../../src/commands/sql/SmartForwardCommandSQL.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,mBAAmB;IAA/D;;QACc,gBAAW,GAAQ,SAAS,CAAC;QAC7B,iBAAY,GAAQ,UAAU,CAAC;IAC7C,CAAC;CAAA"}

package/dist/lib/commands/sql/SmartReplyCommandSQL.js

@@ -0,0 +1,17 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { FolderSQL, MessageSQL } from "@rapidmx/restapi/sql";
+import { SmartReplyCommand } from "../SmartReplyCommand.js";
+/**
+ * @author Jean-Philippe Steinmetz
+ */
+export class SmartReplyCommandSQL extends SmartReplyCommand {
+    constructor() {
+        super(...arguments);
+        this.folderClass = FolderSQL;
+        this.messageClass = MessageSQL;
+    }
+}
+//# sourceMappingURL=SmartReplyCommandSQL.js.map

package/dist/lib/commands/sql/SmartReplyCommandSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartReplyCommandSQL.js","sourceRoot":"","sources":["../../../../src/commands/sql/SmartReplyCommandSQL.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IAA3D;;QACc,gBAAW,GAAQ,SAAS,CAAC;QAC7B,iBAAY,GAAQ,UAAU,CAAC;IAC7C,CAAC;CAAA"}

package/dist/lib/commands/sql/SyncCommandSQL.js

@@ -0,0 +1,26 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { MessageSQL, ContactSQL, CalendarEventSQL, TaskSQL, MailboxSQL } from "@rapidmx/restapi/sql";
+import { EmailSyncAdapter } from "../../adapters/EmailSyncAdapter.js";
+import { ContactsSyncAdapter } from "../../adapters/ContactsSyncAdapter.js";
+import { CalendarSyncAdapter } from "../../adapters/CalendarSyncAdapter.js";
+import { TasksSyncAdapter } from "../../adapters/TasksSyncAdapter.js";
+import { SyncCommand } from "../SyncCommand.js";
+/**
+ * @author Jean-Philippe Steinmetz
+ */
+export class SyncCommandSQL extends SyncCommand {
+    constructor() {
+        super(...arguments);
+        this.mailboxClass = MailboxSQL;
+        this.collectionBindings = {
+            Email: { entityClass: MessageSQL, adapterClass: EmailSyncAdapter },
+            Contacts: { entityClass: ContactSQL, adapterClass: ContactsSyncAdapter },
+            Calendar: { entityClass: CalendarEventSQL, adapterClass: CalendarSyncAdapter },
+            Tasks: { entityClass: TaskSQL, adapterClass: TasksSyncAdapter },
+        };
+    }
+}
+//# sourceMappingURL=SyncCommandSQL.js.map

package/dist/lib/commands/sql/SyncCommandSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncCommandSQL.js","sourceRoot":"","sources":["../../../../src/commands/sql/SyncCommandSQL.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,WAAW,EAA8B,MAAM,mBAAmB,CAAC;AAE5E;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,WAAW;IAA/C;;QACc,iBAAY,GAAQ,UAAU,CAAC;QAC/B,uBAAkB,GAA+C;YACvE,KAAK,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE;YAClE,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE;YACxE,QAAQ,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAE;YAC9E,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE;SAClE,CAAC;IACN,CAAC;CAAA"}

package/dist/lib/commands/sql/index.js

@@ -0,0 +1,14 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+export * from "./FolderSyncCommandSQL.js";
+export * from "./SyncCommandSQL.js";
+export * from "./SendMailCommandSQL.js";
+export * from "./SmartForwardCommandSQL.js";
+export * from "./SmartReplyCommandSQL.js";
+export * from "./ItemOperationsCommandSQL.js";
+export * from "./SearchCommandSQL.js";
+export * from "./MeetingResponseCommandSQL.js";
+export * from "./SettingsCommandSQL.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/commands/sql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/sql/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,56 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+/**
+ * Exchange ActiveSync protocol compatibility (Phase 2 of this library's roadmap): a WBXML codec, JWT-secured
+ * transport (`BaseEasRoute`, reusing the framework's existing `@Auth(["jwt"])` strategy - no EAS-specific auth
+ * code of its own), and the pragmatic command subset agreed in the architecture plan - `Provision`,
+ * `FolderSync`, `Sync` (`Email`/`Contacts`/`Calendar`/`Tasks`), `SendMail`/`SmartForward`/`SmartReply`,
+ * `ItemOperations`, `Ping`, `Search` (GAL), `MeetingResponse`, and `Settings`.
+ *
+ * This module exports only the backend-agnostic surface: the codec, the abstract route/command base classes,
+ * the shared sync-cursor/date-format utilities, and the `Sync` collection adapters. The concrete Mongo/SQL
+ * classes a deployment actually instantiates (`EasRouteMongo`/`EasRouteSQL` and each command's Mongo/SQL
+ * variant) are exported from this package's `./mongo`/`./sql` subpaths instead, alongside every other
+ * entity/route/job this library defines - see `MongoConnection`/`ConnectionManager` usage elsewhere in this
+ * library's own README for that convention.
+ *
+ * A deployment mounts EAS at the protocol's well-known path with a trivial one-line subclass, the same pattern
+ * `push/MailPushRoute.ts`'s doc comment describes for `BasePushRoute`:
+ * ```ts
+ * import { EasRouteMongo } from "@rapidrest/mail/mongo";
+ * import { RouteDecorators } from "@rapidrest/service-core";
+ * const { Route } = RouteDecorators;
+ *
+ * @Route("/Microsoft-Server-ActiveSync")
+ * export class MyEasRoute extends EasRouteMongo {}
+ * ```
+ */
+export * from "./codec/WbxmlCodePages.js";
+export * from "./codec/WbxmlElement.js";
+export * from "./codec/WbxmlEncoder.js";
+export * from "./codec/WbxmlDecoder.js";
+export * from "./BaseEasRoute.js";
+export * from "./BaseDeviceSyncStateRoute.js";
+export * from "./EasCommandHandler.js";
+export * from "./EasSyncKeyUtils.js";
+export * from "./CompactDateTime.js";
+export * from "./commands/ProvisionCommand.js";
+export * from "./commands/FolderSyncCommand.js";
+export * from "./commands/SyncCommand.js";
+export * from "./commands/ComposeMailCommand.js";
+export * from "./commands/SendMailCommand.js";
+export * from "./commands/SmartForwardCommand.js";
+export * from "./commands/SmartReplyCommand.js";
+export * from "./commands/PingCommand.js";
+export * from "./commands/ItemOperationsCommand.js";
+export * from "./commands/SearchCommand.js";
+export * from "./commands/MeetingResponseCommand.js";
+export * from "./commands/SettingsCommand.js";
+export * from "./adapters/EasCollectionSyncAdapter.js";
+export * from "./adapters/EmailSyncAdapter.js";
+export * from "./adapters/ContactsSyncAdapter.js";
+export * from "./adapters/CalendarSyncAdapter.js";
+export * from "./adapters/TasksSyncAdapter.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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC"}

package/dist/lib/mongo/DeviceSyncStateRouteMongo.js

@@ -0,0 +1,16 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { DeviceSyncStateMongo } from "@rapidmx/restapi/mongo";
+import { BaseDeviceSyncStateRoute } from "../BaseDeviceSyncStateRoute.js";
+/**
+ * @author Jean-Philippe Steinmetz
+ */
+export class DeviceSyncStateRouteMongo extends BaseDeviceSyncStateRoute {
+    constructor() {
+        super(...arguments);
+        this.deviceSyncStateClass = DeviceSyncStateMongo;
+    }
+}
+//# sourceMappingURL=DeviceSyncStateRouteMongo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceSyncStateRouteMongo.js","sourceRoot":"","sources":["../../../src/mongo/DeviceSyncStateRouteMongo.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,wBAA8C;IAA7F;;QACc,yBAAoB,GAAQ,oBAAoB,CAAC;IAC/D,CAAC;CAAA"}

package/dist/lib/mongo/EasRouteMongo.js

@@ -0,0 +1,51 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { DeviceSyncStateMongo, MailboxMongo } from "@rapidmx/restapi/mongo";
+import { BaseEasRoute } from "../BaseEasRoute.js";
+import { ProvisionCommand } from "../commands/ProvisionCommand.js";
+import { PingCommand } from "../commands/PingCommand.js";
+import { FolderSyncCommandMongo } from "../commands/mongo/FolderSyncCommandMongo.js";
+import { SyncCommandMongo } from "../commands/mongo/SyncCommandMongo.js";
+import { SendMailCommandMongo } from "../commands/mongo/SendMailCommandMongo.js";
+import { SmartForwardCommandMongo } from "../commands/mongo/SmartForwardCommandMongo.js";
+import { SmartReplyCommandMongo } from "../commands/mongo/SmartReplyCommandMongo.js";
+import { ItemOperationsCommandMongo } from "../commands/mongo/ItemOperationsCommandMongo.js";
+import { SearchCommandMongo } from "../commands/mongo/SearchCommandMongo.js";
+import { MeetingResponseCommandMongo } from "../commands/mongo/MeetingResponseCommandMongo.js";
+import { SettingsCommandMongo } from "../commands/mongo/SettingsCommandMongo.js";
+import { GetItemEstimateCommandMongo } from "../commands/mongo/GetItemEstimateCommandMongo.js";
+import { MoveItemsCommandMongo } from "../commands/mongo/MoveItemsCommandMongo.js";
+import { ResolveRecipientsCommandMongo } from "../commands/mongo/ResolveRecipientsCommandMongo.js";
+/**
+ * Mongo-backed concrete `BaseEasRoute`. A deployment mounts this at the well-known EAS path via its own
+ * trivial `@Route("/Microsoft-Server-ActiveSync")` subclass, following the same pattern
+ * `push/MailPushRoute.ts`'s doc comment describes for `BasePushRoute`.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class EasRouteMongo extends BaseEasRoute {
+    constructor() {
+        super(...arguments);
+        this.deviceSyncStateClass = DeviceSyncStateMongo;
+        this.mailboxClass = MailboxMongo;
+        this.commandHandlerClasses = [
+            ProvisionCommand,
+            FolderSyncCommandMongo,
+            SyncCommandMongo,
+            SendMailCommandMongo,
+            SmartForwardCommandMongo,
+            SmartReplyCommandMongo,
+            ItemOperationsCommandMongo,
+            SearchCommandMongo,
+            MeetingResponseCommandMongo,
+            SettingsCommandMongo,
+            PingCommand,
+            GetItemEstimateCommandMongo,
+            MoveItemsCommandMongo,
+            ResolveRecipientsCommandMongo,
+        ];
+    }
+}
+//# sourceMappingURL=EasRouteMongo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EasRouteMongo.js","sourceRoot":"","sources":["../../../src/mongo/EasRouteMongo.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,YAAgD;IAAnF;;QACc,yBAAoB,GAAQ,oBAAoB,CAAC;QACjD,iBAAY,GAAQ,YAAY,CAAC;QACjC,0BAAqB,GAAU;YACrC,gBAAgB;YAChB,sBAAsB;YACtB,gBAAgB;YAChB,oBAAoB;YACpB,wBAAwB;YACxB,sBAAsB;YACtB,0BAA0B;YAC1B,kBAAkB;YAClB,2BAA2B;YAC3B,oBAAoB;YACpB,WAAW;YACX,2BAA2B;YAC3B,qBAAqB;YACrB,6BAA6B;SAChC,CAAC;IACN,CAAC;CAAA"}

package/dist/lib/mongo/index.js

@@ -0,0 +1,8 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+export * from "./EasRouteMongo.js";
+export * from "./DeviceSyncStateRouteMongo.js";
+export * from "../commands/mongo/index.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,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,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"}

package/dist/lib/sql/DeviceSyncStateRouteSQL.js

@@ -0,0 +1,16 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { DeviceSyncStateSQL } from "@rapidmx/restapi/sql";
+import { BaseDeviceSyncStateRoute } from "../BaseDeviceSyncStateRoute.js";
+/**
+ * @author Jean-Philippe Steinmetz
+ */
+export class DeviceSyncStateRouteSQL extends BaseDeviceSyncStateRoute {
+    constructor() {
+        super(...arguments);
+        this.deviceSyncStateClass = DeviceSyncStateSQL;
+    }
+}
+//# sourceMappingURL=DeviceSyncStateRouteSQL.js.map

package/dist/lib/sql/DeviceSyncStateRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceSyncStateRouteSQL.js","sourceRoot":"","sources":["../../../src/sql/DeviceSyncStateRouteSQL.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,wBAA4C;IAAzF;;QACc,yBAAoB,GAAQ,kBAAkB,CAAC;IAC7D,CAAC;CAAA"}

package/dist/lib/sql/EasRouteSQL.js

@@ -0,0 +1,50 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { DeviceSyncStateSQL, MailboxSQL } from "@rapidmx/restapi/sql";
+import { BaseEasRoute } from "../BaseEasRoute.js";
+import { ProvisionCommand } from "../commands/ProvisionCommand.js";
+import { PingCommand } from "../commands/PingCommand.js";
+import { FolderSyncCommandSQL } from "../commands/sql/FolderSyncCommandSQL.js";
+import { SyncCommandSQL } from "../commands/sql/SyncCommandSQL.js";
+import { SendMailCommandSQL } from "../commands/sql/SendMailCommandSQL.js";
+import { SmartForwardCommandSQL } from "../commands/sql/SmartForwardCommandSQL.js";
+import { SmartReplyCommandSQL } from "../commands/sql/SmartReplyCommandSQL.js";
+import { ItemOperationsCommandSQL } from "../commands/sql/ItemOperationsCommandSQL.js";
+import { SearchCommandSQL } from "../commands/sql/SearchCommandSQL.js";
+import { MeetingResponseCommandSQL } from "../commands/sql/MeetingResponseCommandSQL.js";
+import { SettingsCommandSQL } from "../commands/sql/SettingsCommandSQL.js";
+import { GetItemEstimateCommandSQL } from "../commands/sql/GetItemEstimateCommandSQL.js";
+import { MoveItemsCommandSQL } from "../commands/sql/MoveItemsCommandSQL.js";
+import { ResolveRecipientsCommandSQL } from "../commands/sql/ResolveRecipientsCommandSQL.js";
+/**
+ * SQL-backed concrete `BaseEasRoute`. See `EasRouteMongo.ts`'s doc comment - the same mounting pattern
+ * applies here.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class EasRouteSQL extends BaseEasRoute {
+    constructor() {
+        super(...arguments);
+        this.deviceSyncStateClass = DeviceSyncStateSQL;
+        this.mailboxClass = MailboxSQL;
+        this.commandHandlerClasses = [
+            ProvisionCommand,
+            FolderSyncCommandSQL,
+            SyncCommandSQL,
+            SendMailCommandSQL,
+            SmartForwardCommandSQL,
+            SmartReplyCommandSQL,
+            ItemOperationsCommandSQL,
+            SearchCommandSQL,
+            MeetingResponseCommandSQL,
+            SettingsCommandSQL,
+            PingCommand,
+            GetItemEstimateCommandSQL,
+            MoveItemsCommandSQL,
+            ResolveRecipientsCommandSQL,
+        ];
+    }
+}
+//# sourceMappingURL=EasRouteSQL.js.map

package/dist/lib/sql/EasRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EasRouteSQL.js","sourceRoot":"","sources":["../../../src/sql/EasRouteSQL.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,YAA4C;IAA7E;;QACc,yBAAoB,GAAQ,kBAAkB,CAAC;QAC/C,iBAAY,GAAQ,UAAU,CAAC;QAC/B,0BAAqB,GAAU;YACrC,gBAAgB;YAChB,oBAAoB;YACpB,cAAc;YACd,kBAAkB;YAClB,sBAAsB;YACtB,oBAAoB;YACpB,wBAAwB;YACxB,gBAAgB;YAChB,yBAAyB;YACzB,kBAAkB;YAClB,WAAW;YACX,yBAAyB;YACzB,mBAAmB;YACnB,2BAA2B;SAC9B,CAAC;IACN,CAAC;CAAA"}

package/dist/lib/sql/index.js

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

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

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

package/dist/lib/sql.js

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

package/dist/lib/sql.js.map

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

package/dist/types/BaseDeviceSyncStateRoute.d.ts

@@ -0,0 +1,34 @@
+import { type JWTUser } from "@rapidrest/core";
+import { HttpRequest } from "@rapidrest/service-core";
+import type { DeviceSyncState } from "@rapidmx/restapi";
+/**
+ * Admin-only trigger for the `RemoteWipe` sub-flow `ProvisionCommand` implements. `restapi` has no route of its
+ * own for `DeviceSyncState` (it's a protocol-internal entity, not a domain object a normal API consumer ever
+ * lists or edits directly), so this lives here instead, following the exact `trustedRoles`/`UserUtils.hasRoles`
+ * gating pattern `BaseMailboxRoute` already uses for its own admin-vs-owner scoping.
+ *
+ * Setting `remoteWipeRequested: true` (and `provisioned: false` alongside it) is the entire trigger: the next
+ * request that device makes of any kind is already forced back through `Provision` by `BaseEasRoute.dispatch()`'s
+ * existing 449 gate, at which point `ProvisionCommand.issuePolicy` sees the flag and sends the device a
+ * `RemoteWipe` directive instead of a normal policy document - no separate push/notification channel is needed.
+ *
+ * `deviceSyncStateClass` is supplied by the Mongo/SQL concrete subclasses, the same one-line-per-backend
+ * pattern used throughout this library.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export declare abstract class BaseDeviceSyncStateRoute<D extends DeviceSyncState> {
+    protected abstract deviceSyncStateClass: any;
+    protected trustedRoles: string[];
+    private _objectFactory?;
+    private deviceSyncStateRepo?;
+    private getDeviceSyncStateRepo;
+    /**
+     * Marks `uid` (a `DeviceSyncState`'s own id, not a device id string - the admin looks this up via whatever
+     * device-listing view a deployment builds on top of `DeviceSyncState`'s ordinary CRUD, out of scope here)
+     * for remote wipe. Optional JSON body `{ accountOnly?: boolean }` — recorded for admin audit only; see
+     * `ProvisionCommand`'s own doc comment for why the wire directive sent to the device doesn't distinguish
+     * the two.
+     */
+    remoteWipe(uid: string, req: HttpRequest, user?: JWTUser): Promise<D>;
+}

package/dist/types/BaseEasRoute.d.ts

@@ -0,0 +1,64 @@
+import { type JWTUser } from "@rapidrest/core";
+import { HttpRequest, HttpResponse } from "@rapidrest/service-core";
+import { DeviceSyncState, Mailbox } from "@rapidmx/restapi";
+/**
+ * Abstract base for the single fixed EAS endpoint (`POST /Microsoft-Server-ActiveSync` by MS-ASHTTP
+ * convention, though the concrete path is left to the consuming application to mount via `@Route(...)` — see
+ * `BaseMailIngestRoute.ts` for the identical undecorated-base-class pattern this follows). Unlike every other
+ * route in this library, EAS dispatches on a `Cmd` query parameter against one URL rather than path-based REST
+ * routing, so there is exactly one `@Post()` method here, not one per operation.
+ *
+ * **Auth**: `@Auth(["jwt"])` — the framework's own default strategy, unchanged from every other route in this
+ * app. A real native EAS client obtaining that JWT in the first place (rather than the app's own web/API
+ * clients, which already have one) requires an OAuth 2.0 Authorization Server capability this library
+ * deliberately does not implement itself — see the architecture plan's "Auth" section for the full reasoning
+ * behind this choice over a per-request Basic Auth strategy.
+ *
+ * **Dispatch flow**: resolve the caller's own `Mailbox` (never a client-supplied one — `resolveCallerMailboxUid`,
+ * the same helper `BaseSearchRoute` already uses), find-or-create that (mailbox, device) pair's
+ * `DeviceSyncState`, enforce the provisioning gate, decode the WBXML request body (if any), dispatch to the
+ * matching registered `EasCommandHandler`, bump `lastSyncAt`, and encode the handler's response back to WBXML.
+ *
+ * **Command handlers** are supplied via `commandHandlerClasses` (empty by default — this class alone is just
+ * the transport skeleton; concrete command support, e.g. `ProvisionCommand`/`FolderSyncCommand`, is added
+ * incrementally in later work by having a concrete subclass populate this array) and instantiated once each in
+ * `@Init` via `ObjectFactory`, so a handler can `@Inject` its own dependencies like any other DI-managed class
+ * in this library.
+ *
+ * **`OPTIONS` protocol discovery**: real EAS clients conventionally probe `OPTIONS` before their first `POST`
+ * to read `MS-ASProtocolVersions`/`MS-ASProtocolCommands` and learn what the server supports - see `options()`
+ * below. This requires `@rapidrest/service-core` >=1.5.0, whose global CORS middleware consults
+ * `IHttpRouter.hasExplicitOptionsRoute()` before its blanket preflight `204` - confirmed live end to end
+ * against a real `service-core` 1.5.0 install (`test/routes/{mongo,sql}/EasRoute.test.ts`'s `OPTIONS`
+ * describe block), not assumed.
+ *
+ * `deviceSyncStateClass`/`mailboxClass` are supplied by the Mongo/SQL concrete subclasses, following the exact
+ * one-line-per-backend pattern used throughout this library's other routes/jobs.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export declare abstract class BaseEasRoute<D extends DeviceSyncState, M extends Mailbox = Mailbox> {
+    protected abstract deviceSyncStateClass: any;
+    protected abstract mailboxClass: any;
+    /** Command handler classes to instantiate (one each) in `@Init`. Empty until a concrete command lands -
+     * every request is then answered with HTTP 501 (see `dispatch()`), which is the correct, honest behavior
+     * for a transport skeleton with no commands implemented yet, not a bug to work around. */
+    protected commandHandlerClasses: any[];
+    private _objectFactory?;
+    private deviceSyncStateRepo?;
+    private mailboxRepo?;
+    private readonly handlers;
+    private logger;
+    init(): Promise<void>;
+    /**
+     * Answers a real client's pre-flight `MS-ASProtocolVersions`/`MS-ASProtocolCommands` capability probe -
+     * see this class's own doc comment for the `service-core` version dependency this needs to actually run.
+     * Deliberately unauthenticated (no `@Auth`): this is capability discovery, not mailbox access, and a real
+     * Exchange server answers it the same way regardless of credentials. `MS-ASProtocolCommands` is built from
+     * `this.handlers`, not a separately-maintained list, so it can never drift out of sync with the commands a
+     * concrete subclass actually registered via `commandHandlerClasses`.
+     */
+    options(res: HttpResponse): Promise<void>;
+    dispatch(req: HttpRequest, res: HttpResponse, user?: JWTUser): Promise<void>;
+    private findOrCreateDeviceSyncState;
+}

package/dist/types/CompactDateTime.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Formats a date as MS-ASDTYPE's "Compact DateTime" (`YYYYMMDDTHHMMSSZ`, always UTC) - the format
+ * `Calendar`/`Tasks` timestamp fields (`StartTime`/`EndTime`/`UtcDueDate`/...) use, distinct from the plain
+ * `dateTime` type (`YYYY-MM-DDTHH:MM:SS.MSSZ`, i.e. `Date.prototype.toISOString()`) `Email`'s `DateReceived`
+ * uses - confirmed against the published MS-ASDTYPE spec (`2.7.2 Compact DateTime` vs `2.7 dateTime Data
+ * Type`), not assumed, since sending the wrong one is exactly the kind of silent-until-a-real-device-connects
+ * bug this library's WBXML codec work already ran into once with tag casing (`"Mime"` vs `"MIME"`).
+ *
+ * Accepts `Date | string` and normalizes via `new Date(...)` - a real, discovered-by-testing gap: fields
+ * embedded inside a `simple-json` column (e.g. `RecurrenceRule.until`) round-trip through `JSON.stringify`/
+ * `JSON.parse` on the SQL backend, which does not preserve `Date` instances, so `until` comes back as a plain
+ * ISO string there even though the Mongo backend (native BSON dates) hands back a real `Date` for the exact
+ * same field - a caller passing either must work on both backends without knowing which one it's talking to.
+ */
+export declare function toCompactDateTime(date: Date | string): string;
+/**
+ * Parses MS-ASDTYPE's "Compact DateTime" (`YYYYMMDDTHHMMSSZ`) back into a `Date` - the reverse of
+ * `toCompactDateTime`, needed for `Sync`'s client-originated `Add`/`Change` commands on `Calendar`/`Tasks`.
+ * Throws (rather than returning an unvalidated `Date` that would silently carry `NaN`s) for anything not
+ * matching the exact expected shape.
+ */
+export declare function fromCompactDateTime(value: string): Date;

package/dist/types/EasCommandHandler.d.ts

@@ -0,0 +1,59 @@
+import type { JWTUser } from "@rapidrest/core";
+import type { HttpRequest, RepoUtils } from "@rapidrest/service-core";
+import type { WbxmlElement } from "./codec/WbxmlElement.js";
+import type { DeviceSyncState } from "@rapidmx/restapi";
+/**
+ * Everything an `EasCommandHandler` needs to process one dispatched EAS command — assembled once by
+ * `BaseEasRoute.dispatch()` per request and handed to whichever handler matches `?Cmd=`.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export interface EasCommandContext {
+    /** The authenticated caller, per the same `@AuthUser` JWT payload every other route in this library reads. */
+    readonly user: JWTUser;
+    /** The `Mailbox` this request operates against — resolved server-side from `user` (`ownerUserUid`), never
+     * taken from client input. */
+    readonly mailboxUid: string;
+    /** The client-supplied `?DeviceId=` query value, identifying this device within the mailbox. */
+    readonly deviceId: string;
+    /** The client-supplied `?DeviceType=` query value (e.g. `iPhone`, `Android`). */
+    readonly deviceType: string;
+    /** The client-supplied `?PolicyKey=` query value, if present - the provisioning policy key the device is
+     * currently operating under. Not yet validated against `deviceSyncState.policyKey` here (deferred to
+     * `ProvisionCommand`'s own implementation); handlers that care should compare it themselves for now. */
+    readonly policyKey?: string;
+    /** This device's persisted sync/provisioning state, looked up (or newly created) by `BaseEasRoute` before
+     * dispatch. Handlers read/write cursor and provisioning fields on this directly. */
+    readonly deviceSyncState: DeviceSyncState;
+    /** The live repo backing `deviceSyncState`'s concrete entity class, for handlers that need to persist a
+     * change to it (e.g. a new `SyncKey`, an updated `policyKey`, flipping `provisioned`). Typed `RepoUtils<any>`
+     * rather than `RepoUtils<DeviceSyncState>` deliberately - `RepoUtils<D>`'s underlying TypeORM `Repository<D>`
+     * is not covariant in `D` (a handful of its methods, e.g. `sum()`, use `D`-dependent conditional types), so
+     * `BaseEasRoute`'s own `RepoUtils<D>` (for its concrete `D extends DeviceSyncState`) cannot be narrowed to
+     * this field's type without `any` somewhere in between. */
+    readonly deviceSyncStateRepo: RepoUtils<any>;
+    /** Every query-string parameter on the request, for the handful of commands with additional command-
+     * specific query parameters beyond the common four already broken out above. */
+    readonly query: Record<string, string | string[]>;
+    /** The decoded WBXML request body, or `undefined` for a command sent with an empty body (legal for a few
+     * commands, e.g. a bare `GetItemEstimate`-less `Ping` continuation). */
+    readonly request?: WbxmlElement;
+    /** The raw underlying HTTP request, for the rare handler that needs something this context doesn't
+     * already surface (e.g. a header). */
+    readonly req: HttpRequest;
+}
+/**
+ * One EAS protocol command (`Provision`, `FolderSync`, `Sync`, ...). `BaseEasRoute` builds one instance of
+ * each registered handler class in its own `@Init` (via `ObjectFactory`, so a handler can `@Inject` its own
+ * dependencies exactly like any other DI-managed class in this library) and dispatches to the one whose
+ * `command` matches the request's `?Cmd=` value.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export interface EasCommandHandler {
+    /** The exact `?Cmd=` value this handler answers to (e.g. `"FolderSync"`). */
+    readonly command: string;
+    /** Processes the command and returns the WBXML element tree to send back as the response body, or
+     * `undefined` for a command whose successful response is legitimately empty. */
+    handle(ctx: EasCommandContext): Promise<WbxmlElement | undefined>;
+}