@rapidmx/restapi 0.1.0

package/dist/lib/models/sql/DeviceSyncStateSQL.js

@@ -0,0 +1,97 @@
+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 { BaseEntity, DocDecorators, ModelDecorators, PersistenceDecorators } from "@rapidrest/service-core";
+import { ObjectDecorators } from "@rapidrest/core";
+const { Description } = DocDecorators;
+const { DataStore, Protect } = ModelDecorators;
+const { Nullable } = ObjectDecorators;
+const { Column, Entity, Index } = PersistenceDecorators;
+/**
+ * Implementation of the `DeviceSyncState` interface for storage in a SQL database. If MongoDB is desired,
+ * please use `models.mongo.DeviceSyncStateMongo` instead.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let DeviceSyncStateSQL = class DeviceSyncStateSQL extends BaseEntity {
+    constructor(other) {
+        super(other);
+        this.mailboxUid = "";
+        this.deviceId = "";
+        this.deviceType = "";
+        this.folderSyncKeys = {};
+        this.provisioned = false;
+        if (other) {
+            this.mailboxUid = other.mailboxUid !== undefined ? other.mailboxUid : this.mailboxUid;
+            this.deviceId = other.deviceId !== undefined ? other.deviceId : this.deviceId;
+            this.deviceType = other.deviceType !== undefined ? other.deviceType : this.deviceType;
+            this.policyKey = "policyKey" in other ? other.policyKey : this.policyKey;
+            this.folderSyncKeys = other.folderSyncKeys !== undefined ? other.folderSyncKeys : this.folderSyncKeys;
+            this.lastSyncAt = "lastSyncAt" in other ? other.lastSyncAt : this.lastSyncAt;
+            this.provisioned = other.provisioned !== undefined ? other.provisioned : this.provisioned;
+        }
+    }
+};
+__decorate([
+    Column(),
+    Description("The unique identifier of the `Mailbox` this device is synced against."),
+    __metadata("design:type", String)
+], DeviceSyncStateSQL.prototype, "mailboxUid", void 0);
+__decorate([
+    Column(),
+    Description("The unique identifier of the paired device."),
+    __metadata("design:type", String)
+], DeviceSyncStateSQL.prototype, "deviceId", void 0);
+__decorate([
+    Column(),
+    Description("The device type/model string reported by the device."),
+    __metadata("design:type", String)
+], DeviceSyncStateSQL.prototype, "deviceType", void 0);
+__decorate([
+    Column({ nullable: true }),
+    Description("The EAS provisioning policy key most recently acknowledged by the device."),
+    Nullable,
+    __metadata("design:type", String)
+], DeviceSyncStateSQL.prototype, "policyKey", void 0);
+__decorate([
+    Column({ type: "simple-json" }),
+    Description("The per-folder EAS `SyncKey` cursor, keyed by `Folder.uid`."),
+    __metadata("design:type", Object)
+], DeviceSyncStateSQL.prototype, "folderSyncKeys", void 0);
+__decorate([
+    Column({ nullable: true }),
+    Description("The date and time of the device's last successful sync."),
+    Nullable,
+    __metadata("design:type", Date)
+], DeviceSyncStateSQL.prototype, "lastSyncAt", void 0);
+__decorate([
+    Column(),
+    Description("`true` if the device has completed EAS provisioning."),
+    __metadata("design:type", Boolean)
+], DeviceSyncStateSQL.prototype, "provisioned", void 0);
+DeviceSyncStateSQL = __decorate([
+    DataStore("sql"),
+    Entity(),
+    Description("Tracks the EAS sync state of a single paired mobile device against a `Mailbox`."),
+    Index("devicesyncstate_mailbox_device", ["mailboxUid", "deviceId"], { unique: true }),
+    Protect({
+        uid: "DeviceSyncState",
+        records: [
+            { userOrRoleId: "anonymous", actions: [] },
+            { userOrRoleId: ".*", actions: [] },
+        ],
+    }, false),
+    __metadata("design:paramtypes", [Object])
+], DeviceSyncStateSQL);
+export { DeviceSyncStateSQL };
+//# sourceMappingURL=DeviceSyncStateSQL.js.map

package/dist/lib/models/sql/DeviceSyncStateSQL.js.map

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

package/dist/lib/models/sql/FolderSQL.js

@@ -0,0 +1,106 @@
+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 { DocDecorators, ModelDecorators, PersistenceDecorators, RecoverableBaseEntity, } from "@rapidrest/service-core";
+import { ObjectDecorators } from "@rapidrest/core";
+import { FolderType } from "../types.js";
+const { Description } = DocDecorators;
+const { DataStore, Protect } = ModelDecorators;
+const { Nullable } = ObjectDecorators;
+const { Column, Entity, Index } = PersistenceDecorators;
+/**
+ * Implementation of the `Folder` interface for storage in a SQL database. If MongoDB is desired, please use
+ * `models.mongo.FolderMongo` instead.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let FolderSQL = class FolderSQL extends RecoverableBaseEntity {
+    constructor(other) {
+        super(other);
+        this.mailboxUid = "";
+        this.name = "";
+        // `type: "varchar"` is required on every enum-typed column: TypeScript's `emitDecoratorMetadata` reflects
+        // a string enum's design type as the enum object itself, not a primitive constructor, which TypeORM/
+        // better-sqlite3 cannot resolve into a column type on its own (it would otherwise fail at
+        // `DataSource.initialize()` with "Data type 'undefined' ... is not supported").
+        this.type = FolderType.USER;
+        this.unreadCount = 0;
+        this.totalCount = 0;
+        this.syncKeyVersion = 0;
+        if (other) {
+            this.mailboxUid = other.mailboxUid !== undefined ? other.mailboxUid : this.mailboxUid;
+            this.name = other.name !== undefined ? other.name : this.name;
+            this.type = other.type !== undefined ? other.type : this.type;
+            this.parentFolderUid = "parentFolderUid" in other ? other.parentFolderUid : this.parentFolderUid;
+            this.unreadCount = other.unreadCount !== undefined ? other.unreadCount : this.unreadCount;
+            this.totalCount = other.totalCount !== undefined ? other.totalCount : this.totalCount;
+            this.syncKeyVersion = other.syncKeyVersion !== undefined ? other.syncKeyVersion : this.syncKeyVersion;
+        }
+    }
+};
+__decorate([
+    Column(),
+    Description("The unique identifier of the `Mailbox` this folder belongs to."),
+    __metadata("design:type", String)
+], FolderSQL.prototype, "mailboxUid", void 0);
+__decorate([
+    Column(),
+    Description("The display name of the folder."),
+    __metadata("design:type", String)
+], FolderSQL.prototype, "name", void 0);
+__decorate([
+    Column({ type: "varchar" }),
+    Description("The kind of well-known folder this is, or `USER` for an ordinary user-created folder."),
+    __metadata("design:type", String)
+], FolderSQL.prototype, "type", void 0);
+__decorate([
+    Column({ nullable: true }),
+    Description("The unique identifier of the parent folder, or `undefined` if this is a top-level folder."),
+    Nullable,
+    __metadata("design:type", String)
+], FolderSQL.prototype, "parentFolderUid", void 0);
+__decorate([
+    Column(),
+    Description("The number of unread items contained directly in this folder."),
+    __metadata("design:type", Number)
+], FolderSQL.prototype, "unreadCount", void 0);
+__decorate([
+    Column(),
+    Description("The total number of items contained directly in this folder."),
+    __metadata("design:type", Number)
+], FolderSQL.prototype, "totalCount", void 0);
+__decorate([
+    Column(),
+    Description("A monotonically increasing counter bumped on every change (add/change/delete of a contained item, or " +
+        "of the folder itself) to this folder's contents. EAS `SyncKey` and MAPI ICS-style folder sync state " +
+        "are both derived from this value."),
+    __metadata("design:type", Number)
+], FolderSQL.prototype, "syncKeyVersion", void 0);
+FolderSQL = __decorate([
+    DataStore("sql"),
+    Entity(),
+    Description("Defines a single folder within a `Mailbox`. Folders form a hierarchy via `parentFolderUid` and hold " +
+        "`Message`, `CalendarEvent`, `Contact`, `Task`, or `Note` records depending on `type`."),
+    Index("folder_mailbox", ["mailboxUid"]),
+    Index("folder_parent", ["parentFolderUid"]),
+    Protect({
+        uid: "Folder",
+        records: [
+            { userOrRoleId: "anonymous", actions: [] },
+            { userOrRoleId: ".*", actions: [] },
+        ],
+    }, true),
+    __metadata("design:paramtypes", [Object])
+], FolderSQL);
+export { FolderSQL };
+//# sourceMappingURL=FolderSQL.js.map

package/dist/lib/models/sql/FolderSQL.js.map

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

package/dist/lib/models/sql/IngestQueueEntrySQL.js

@@ -0,0 +1,97 @@
+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 { BaseEntity, DocDecorators, ModelDecorators, PersistenceDecorators } from "@rapidrest/service-core";
+import { ObjectDecorators } from "@rapidrest/core";
+import { IngestStatus } from "../types.js";
+const { Description } = DocDecorators;
+const { DataStore, Protect } = ModelDecorators;
+const { Nullable } = ObjectDecorators;
+const { Column, Entity, Index } = PersistenceDecorators;
+/**
+ * Implementation of the `IngestQueueEntry` interface for storage in a SQL database. If MongoDB is desired,
+ * please use `models.mongo.IngestQueueEntryMongo` instead.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let IngestQueueEntrySQL = class IngestQueueEntrySQL extends BaseEntity {
+    constructor(other) {
+        super(other);
+        this.mailboxUid = "";
+        this.envelopeFrom = "";
+        this.envelopeTo = [];
+        this.rawBlobKey = "";
+        // `type: "varchar"` is required on every enum-typed column: TypeScript's `emitDecoratorMetadata` reflects
+        // a string enum's design type as the enum object itself, not a primitive constructor, which TypeORM/
+        // better-sqlite3 cannot resolve into a column type on its own (it would otherwise fail at
+        // `DataSource.initialize()` with "Data type 'undefined' ... is not supported").
+        this.status = IngestStatus.PENDING;
+        if (other) {
+            this.mailboxUid = other.mailboxUid !== undefined ? other.mailboxUid : this.mailboxUid;
+            this.envelopeFrom = other.envelopeFrom !== undefined ? other.envelopeFrom : this.envelopeFrom;
+            this.envelopeTo = other.envelopeTo !== undefined ? other.envelopeTo : this.envelopeTo;
+            this.rawBlobKey = other.rawBlobKey !== undefined ? other.rawBlobKey : this.rawBlobKey;
+            this.status = other.status !== undefined ? other.status : this.status;
+            this.errorMessage = "errorMessage" in other ? other.errorMessage : this.errorMessage;
+        }
+    }
+};
+__decorate([
+    Column(),
+    Description("The resolved `Mailbox` this message is addressed to."),
+    __metadata("design:type", String)
+], IngestQueueEntrySQL.prototype, "mailboxUid", void 0);
+__decorate([
+    Column(),
+    Description("The SMTP envelope sender (`MAIL FROM`) address."),
+    __metadata("design:type", String)
+], IngestQueueEntrySQL.prototype, "envelopeFrom", void 0);
+__decorate([
+    Column({ type: "simple-json" }),
+    Description("The SMTP envelope recipient (`RCPT TO`) addresses."),
+    __metadata("design:type", Array)
+], IngestQueueEntrySQL.prototype, "envelopeTo", void 0);
+__decorate([
+    Column(),
+    Description("The key under which the raw MIME source is stored in the `BlobStore`."),
+    __metadata("design:type", String)
+], IngestQueueEntrySQL.prototype, "rawBlobKey", void 0);
+__decorate([
+    Column({ type: "varchar" }),
+    Description("The current processing status of this queue entry."),
+    __metadata("design:type", String)
+], IngestQueueEntrySQL.prototype, "status", void 0);
+__decorate([
+    Column({ nullable: true }),
+    Description("The error message recorded if processing failed, if any."),
+    Nullable,
+    __metadata("design:type", String)
+], IngestQueueEntrySQL.prototype, "errorMessage", void 0);
+IngestQueueEntrySQL = __decorate([
+    DataStore("sql"),
+    Entity(),
+    Description("A staging record for one raw message accepted by the MTA (Postfix) and handed to `MailIngestRoute`, " +
+        "before scanning/parsing/delivery has run."),
+    Index("ingestqueue_status", ["status"]),
+    Index("ingestqueue_mailbox", ["mailboxUid"]),
+    Protect({
+        uid: "IngestQueueEntry",
+        records: [
+            { userOrRoleId: "anonymous", actions: [] },
+            { userOrRoleId: ".*", actions: [] },
+        ],
+    }, false),
+    __metadata("design:paramtypes", [Object])
+], IngestQueueEntrySQL);
+export { IngestQueueEntrySQL };
+//# sourceMappingURL=IngestQueueEntrySQL.js.map

package/dist/lib/models/sql/IngestQueueEntrySQL.js.map

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

package/dist/lib/models/sql/MailboxSQL.js

@@ -0,0 +1,105 @@
+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 { ObjectDecorators } from "@rapidrest/core";
+import { BaseEntity, DocDecorators, ModelDecorators, PersistenceDecorators } from "@rapidrest/service-core";
+const { Description } = DocDecorators;
+const { DataStore, Protect } = ModelDecorators;
+const { Column, Entity, Index } = PersistenceDecorators;
+const { Nullable } = ObjectDecorators;
+/**
+ * Implementation of the `Mailbox` interface for storage in a SQL database. If MongoDB is desired, please use
+ * `models.mongo.MailboxMongo` instead.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let MailboxSQL = class MailboxSQL extends BaseEntity {
+    constructor(other) {
+        super(other);
+        this.ownerUserUid = undefined;
+        this.primarySmtpAddress = "";
+        this.aliasAddresses = [];
+        this.displayName = "";
+        this.timezone = "";
+        this.quotaBytes = 0;
+        this.usedBytes = 0;
+        if (other) {
+            this.ownerUserUid = other.ownerUserUid !== undefined ? other.ownerUserUid : this.ownerUserUid;
+            this.primarySmtpAddress =
+                other.primarySmtpAddress !== undefined ? other.primarySmtpAddress : this.primarySmtpAddress;
+            this.aliasAddresses = other.aliasAddresses !== undefined ? other.aliasAddresses : this.aliasAddresses;
+            this.displayName = other.displayName !== undefined ? other.displayName : this.displayName;
+            this.timezone = other.timezone !== undefined ? other.timezone : this.timezone;
+            this.quotaBytes = other.quotaBytes !== undefined ? other.quotaBytes : this.quotaBytes;
+            this.usedBytes = other.usedBytes !== undefined ? other.usedBytes : this.usedBytes;
+        }
+    }
+};
+__decorate([
+    Column({ type: String, nullable: true }),
+    Description("The unique identifier of the `User` (from `@rapidrest/auth`) that owns this mailbox, if any. Absent " +
+        "for a true shared mailbox with no single owner — see the `Mailbox` interface doc comment."),
+    Nullable,
+    __metadata("design:type", String)
+], MailboxSQL.prototype, "ownerUserUid", void 0);
+__decorate([
+    Column(),
+    Description("The primary SMTP address that mail addressed to this mailbox is delivered under."),
+    __metadata("design:type", String)
+], MailboxSQL.prototype, "primarySmtpAddress", void 0);
+__decorate([
+    Column({ type: "simple-json" }),
+    Description("Additional SMTP addresses that also deliver to this mailbox."),
+    __metadata("design:type", Array)
+], MailboxSQL.prototype, "aliasAddresses", void 0);
+__decorate([
+    Column(),
+    Description("The display name shown to recipients (e.g. in the `From` header) for mail sent from this mailbox."),
+    __metadata("design:type", String)
+], MailboxSQL.prototype, "displayName", void 0);
+__decorate([
+    Column(),
+    Description("The IANA timezone identifier (e.g. `America/Los_Angeles`) used to render dates/times for this mailbox."),
+    __metadata("design:type", String)
+], MailboxSQL.prototype, "timezone", void 0);
+__decorate([
+    Column(),
+    Description("The maximum total size, in bytes, of all messages/attachments this mailbox may store."),
+    __metadata("design:type", Number)
+], MailboxSQL.prototype, "quotaBytes", void 0);
+__decorate([
+    Column(),
+    Description("The current total size, in bytes, of all messages/attachments stored in this mailbox."),
+    __metadata("design:type", Number)
+], MailboxSQL.prototype, "usedBytes", void 0);
+MailboxSQL = __decorate([
+    DataStore("sql"),
+    Entity(),
+    Description("Defines a single mailbox belonging to a `User`. A mailbox is the root of a user's Folder hierarchy and " +
+        "the unit that MAPI/EAS clients log on to."),
+    Index("mailbox_owner", ["ownerUserUid"]),
+    Index("mailbox_primary_smtp", ["primarySmtpAddress"], { unique: true }),
+    Protect({
+        uid: "Mailbox",
+        records: [
+            { userOrRoleId: "anonymous", actions: [] },
+            // Deny-all, including CREATE: mailbox creation is handled entirely by `BaseMailboxRoute.create()`,
+            // which bypasses this class-level ACL (see its doc comment for why a `.*` CREATE grant here would
+            // leak into permission checks against *specific* mailboxes' ACLs, since they parent to this one).
+            { userOrRoleId: ".*", actions: [] },
+        ],
+    }, true),
+    __metadata("design:paramtypes", [Object])
+], MailboxSQL);
+export { MailboxSQL };
+//# sourceMappingURL=MailboxSQL.js.map

package/dist/lib/models/sql/MailboxSQL.js.map

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

package/dist/lib/models/sql/MessageSQL.js

@@ -0,0 +1,184 @@
+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 { DocDecorators, ModelDecorators, PersistenceDecorators, RecoverableBaseEntity, } from "@rapidrest/service-core";
+import { ObjectDecorators } from "@rapidrest/core";
+import { MessageImportance, RecipientType } from "../types.js";
+const { Description } = DocDecorators;
+const { DataStore, Protect } = ModelDecorators;
+const { Nullable } = ObjectDecorators;
+const { Column, Entity, Index } = PersistenceDecorators;
+/**
+ * Implementation of the `Message` interface for storage in a SQL database. If MongoDB is desired, please use
+ * `models.mongo.MessageMongo` instead.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let MessageSQL = class MessageSQL extends RecoverableBaseEntity {
+    constructor(other) {
+        super(other);
+        this.folderUid = "";
+        this.mailboxUid = "";
+        this.messageId = "";
+        this.subject = "";
+        this.from = { address: "", type: RecipientType.TO };
+        this.recipients = [];
+        this.sentDate = new Date();
+        this.receivedDate = new Date();
+        this.bodyBlobKey = "";
+        this.bodyPreview = "";
+        this.flags = { read: false, flagged: false, answered: false, forwarded: false };
+        // `type: "varchar"` is required on every enum-typed column: TypeScript's `emitDecoratorMetadata` reflects
+        // a string enum's design type as the enum object itself, not a primitive constructor, which TypeORM/
+        // better-sqlite3 cannot resolve into a column type on its own (it would otherwise fail at
+        // `DataSource.initialize()` with "Data type 'undefined' ... is not supported").
+        this.importance = MessageImportance.NORMAL;
+        this.references = [];
+        this.hasAttachments = false;
+        if (other) {
+            this.folderUid = other.folderUid !== undefined ? other.folderUid : this.folderUid;
+            this.mailboxUid = other.mailboxUid !== undefined ? other.mailboxUid : this.mailboxUid;
+            this.messageId = other.messageId !== undefined ? other.messageId : this.messageId;
+            this.subject = other.subject !== undefined ? other.subject : this.subject;
+            this.from = other.from !== undefined ? other.from : this.from;
+            this.recipients = other.recipients !== undefined ? other.recipients : this.recipients;
+            this.sentDate = other.sentDate !== undefined ? other.sentDate : this.sentDate;
+            this.receivedDate = other.receivedDate !== undefined ? other.receivedDate : this.receivedDate;
+            this.bodyBlobKey = other.bodyBlobKey !== undefined ? other.bodyBlobKey : this.bodyBlobKey;
+            this.sanitizedHtmlBlobKey = "sanitizedHtmlBlobKey" in other ? other.sanitizedHtmlBlobKey : this.sanitizedHtmlBlobKey;
+            this.bodyPreview = other.bodyPreview !== undefined ? other.bodyPreview : this.bodyPreview;
+            this.flags = other.flags !== undefined ? other.flags : this.flags;
+            this.importance = other.importance !== undefined ? other.importance : this.importance;
+            this.inReplyTo = "inReplyTo" in other ? other.inReplyTo : this.inReplyTo;
+            this.references = other.references !== undefined ? other.references : this.references;
+            this.hasAttachments = other.hasAttachments !== undefined ? other.hasAttachments : this.hasAttachments;
+            this.scanResultUid = "scanResultUid" in other ? other.scanResultUid : this.scanResultUid;
+            this.searchIndexedAt = "searchIndexedAt" in other ? other.searchIndexedAt : this.searchIndexedAt;
+        }
+    }
+};
+__decorate([
+    Column(),
+    Description("The unique identifier of the `Folder` this message currently resides in."),
+    __metadata("design:type", String)
+], MessageSQL.prototype, "folderUid", void 0);
+__decorate([
+    Column(),
+    Description("The unique identifier of the `Mailbox` this message belongs to."),
+    __metadata("design:type", String)
+], MessageSQL.prototype, "mailboxUid", void 0);
+__decorate([
+    Column(),
+    Description("The RFC 5322 `Message-ID` header value, used to deduplicate and thread messages."),
+    __metadata("design:type", String)
+], MessageSQL.prototype, "messageId", void 0);
+__decorate([
+    Column(),
+    Description("The subject line of the message."),
+    __metadata("design:type", String)
+], MessageSQL.prototype, "subject", void 0);
+__decorate([
+    Column({ type: "simple-json" }),
+    Description("The sender of the message."),
+    __metadata("design:type", Object)
+], MessageSQL.prototype, "from", void 0);
+__decorate([
+    Column({ type: "simple-json" }),
+    Description("The list of recipients (to/cc/bcc) of the message."),
+    __metadata("design:type", Array)
+], MessageSQL.prototype, "recipients", void 0);
+__decorate([
+    Column(),
+    Description("The date and time the message was sent."),
+    __metadata("design:type", Date)
+], MessageSQL.prototype, "sentDate", void 0);
+__decorate([
+    Column(),
+    Description("The date and time the message was received."),
+    __metadata("design:type", Date)
+], MessageSQL.prototype, "receivedDate", void 0);
+__decorate([
+    Column(),
+    Description("The key under which the raw MIME source is stored in the `BlobStore`, unmodified from ingestion/send."),
+    __metadata("design:type", String)
+], MessageSQL.prototype, "bodyBlobKey", void 0);
+__decorate([
+    Column({ nullable: true }),
+    Description("The key under which the message's HTML body is stored, after ScanPipeline's sanitization pass has " +
+        "run - absent for a not-yet-scanned draft or a message with no HTML body."),
+    Nullable,
+    __metadata("design:type", String)
+], MessageSQL.prototype, "sanitizedHtmlBlobKey", void 0);
+__decorate([
+    Column(),
+    Description("A short plain-text preview of the message body, generated at ingestion time."),
+    __metadata("design:type", String)
+], MessageSQL.prototype, "bodyPreview", void 0);
+__decorate([
+    Column({ type: "simple-json" }),
+    Description("The read/answered/flagged state of the message."),
+    __metadata("design:type", Object)
+], MessageSQL.prototype, "flags", void 0);
+__decorate([
+    Column({ type: "varchar" }),
+    Description("The importance level of the message."),
+    __metadata("design:type", String)
+], MessageSQL.prototype, "importance", void 0);
+__decorate([
+    Column({ nullable: true }),
+    Description("The RFC 5322 `In-Reply-To` header value, if this message is a reply."),
+    Nullable,
+    __metadata("design:type", String)
+], MessageSQL.prototype, "inReplyTo", void 0);
+__decorate([
+    Column({ type: "simple-json" }),
+    Description("The RFC 5322 `References` header value(s), for building conversation threads."),
+    __metadata("design:type", Array)
+], MessageSQL.prototype, "references", void 0);
+__decorate([
+    Column(),
+    Description("`true` if the message has one or more attachments."),
+    __metadata("design:type", Boolean)
+], MessageSQL.prototype, "hasAttachments", void 0);
+__decorate([
+    Column({ nullable: true }),
+    Description("The unique identifier of this message's `ScanResult`, once scanning has completed."),
+    Nullable,
+    __metadata("design:type", String)
+], MessageSQL.prototype, "scanResultUid", void 0);
+__decorate([
+    Column({ nullable: true }),
+    Description("The timestamp this message was last (re)indexed for full-text search, if ever."),
+    Nullable,
+    __metadata("design:type", Date)
+], MessageSQL.prototype, "searchIndexedAt", void 0);
+MessageSQL = __decorate([
+    DataStore("sql"),
+    Entity(),
+    Description("Defines a single email message stored in a `Folder`. The raw MIME source and sanitized HTML body are " +
+        "not stored inline on this record — they live in the configured `BlobStore`, referenced by " +
+        "`bodyBlobKey`/`sanitizedHtmlBlobKey`."),
+    Index("message_folder", ["folderUid"]),
+    Index("message_mailbox", ["mailboxUid"]),
+    Index("message_id", ["messageId"]),
+    Protect({
+        uid: "Message",
+        records: [
+            { userOrRoleId: "anonymous", actions: [] },
+            { userOrRoleId: ".*", actions: [] },
+        ],
+    }, false),
+    __metadata("design:paramtypes", [Object])
+], MessageSQL);
+export { MessageSQL };
+//# sourceMappingURL=MessageSQL.js.map

package/dist/lib/models/sql/MessageSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageSQL.js","sourceRoot":"","sources":["../../../../src/models/sql/MessageSQL.ts"],"names":[],"mappings":";;;;;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAEH,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAyB,iBAAiB,EAAa,aAAa,EAAE,MAAM,aAAa,CAAC;AACjG,MAAM,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC;AACtC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC;AAC/C,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC;AACtC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,qBAAqB,CAAC;AAExD;;;;;GAKG;AAqBI,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,qBAAqB;IAoFjD,YAAY,KAA2B;QACnC,KAAK,CAAC,KAAK,CAAC,CAAC;QAlFV,cAAS,GAAW,EAAE,CAAC;QAIvB,eAAU,GAAW,EAAE,CAAC;QAIxB,cAAS,GAAW,EAAE,CAAC;QAIvB,YAAO,GAAW,EAAE,CAAC;QAIrB,SAAI,GAAc,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC;QAI1D,eAAU,GAAgB,EAAE,CAAC;QAI7B,aAAQ,GAAS,IAAI,IAAI,EAAE,CAAC;QAI5B,iBAAY,GAAS,IAAI,IAAI,EAAE,CAAC;QAIhC,gBAAW,GAAW,EAAE,CAAC;QAYzB,gBAAW,GAAW,EAAE,CAAC;QAIzB,UAAK,GAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAEhG,0GAA0G;QAC1G,qGAAqG;QACrG,0FAA0F;QAC1F,gFAAgF;QAGzE,eAAU,GAAsB,iBAAiB,CAAC,MAAM,CAAC;QASzD,eAAU,GAAa,EAAE,CAAC;QAI1B,mBAAc,GAAY,KAAK,CAAC;QAenC,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;YAClF,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;YACtF,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;YAClF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;YAC1E,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9D,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;YACtF,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;YAC9E,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;YAC9F,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;YAC1F,IAAI,CAAC,oBAAoB,GAAG,sBAAsB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;YACrH,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;YAC1F,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YAClE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;YACtF,IAAI,CAAC,SAAS,GAAG,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;YACzE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;YACtF,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;YACtG,IAAI,CAAC,aAAa,GAAG,eAAe,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;YACzF,IAAI,CAAC,eAAe,GAAG,iBAAiB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;QACrG,CAAC;IACL,CAAC;CACJ,CAAA;AAzGU;IAFN,MAAM,EAAE;IACR,WAAW,CAAC,0EAA0E,CAAC;;6CAC1D;AAIvB;IAFN,MAAM,EAAE;IACR,WAAW,CAAC,iEAAiE,CAAC;;8CAChD;AAIxB;IAFN,MAAM,EAAE;IACR,WAAW,CAAC,kFAAkF,CAAC;;6CAClE;AAIvB;IAFN,MAAM,EAAE;IACR,WAAW,CAAC,kCAAkC,CAAC;;2CACpB;AAIrB;IAFN,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC/B,WAAW,CAAC,4BAA4B,CAAC;;wCACuB;AAI1D;IAFN,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC/B,WAAW,CAAC,oDAAoD,CAAC;;8CAC9B;AAI7B;IAFN,MAAM,EAAE;IACR,WAAW,CAAC,yCAAyC,CAAC;8BACtC,IAAI;4CAAc;AAI5B;IAFN,MAAM,EAAE;IACR,WAAW,CAAC,6CAA6C,CAAC;8BACtC,IAAI;gDAAc;AAIhC;IAFN,MAAM,EAAE;IACR,WAAW,CAAC,uGAAuG,CAAC;;+CACrF;AAQzB;IANN,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,WAAW,CACR,oGAAoG;QAChG,0EAA0E,CACjF;IACA,QAAQ;;wDAC4B;AAI9B;IAFN,MAAM,EAAE;IACR,WAAW,CAAC,8EAA8E,CAAC;;+CAC5D;AAIzB;IAFN,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC/B,WAAW,CAAC,iDAAiD,CAAC;;yCACiC;AAQzF;IAFN,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,WAAW,CAAC,sCAAsC,CAAC;;8CACY;AAKzD;IAHN,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,WAAW,CAAC,sEAAsE,CAAC;IACnF,QAAQ;;6CACiB;AAInB;IAFN,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC/B,WAAW,CAAC,+EAA+E,CAAC;;8CAC5D;AAI1B;IAFN,MAAM,EAAE;IACR,WAAW,CAAC,oDAAoD,CAAC;;kDAC3B;AAKhC;IAHN,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,WAAW,CAAC,oFAAoF,CAAC;IACjG,QAAQ;;iDACqB;AAKvB;IAHN,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,WAAW,CAAC,gFAAgF,CAAC;IAC7F,QAAQ;8BACgB,IAAI;mDAAC;AAlFrB,UAAU;IApBtB,SAAS,CAAC,KAAK,CAAC;IAChB,MAAM,EAAE;IACR,WAAW,CACR,uGAAuG;QACnG,4FAA4F;QAC5F,uCAAuC,CAC9C;IACA,KAAK,CAAC,gBAAgB,EAAE,CAAC,WAAW,CAAC,CAAC;IACtC,KAAK,CAAC,iBAAiB,EAAE,CAAC,YAAY,CAAC,CAAC;IACxC,KAAK,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,CAAC;IAClC,OAAO,CACJ;QACI,GAAG,EAAE,SAAS;QACd,OAAO,EAAE;YACL,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE;YAC1C,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;SACtC;KACJ,EACD,KAAK,CACR;;GACY,UAAU,CA4GtB"}