@remit/data-ports 0.0.82 → 0.0.83

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/data-ports",
-  "version": "0.0.82",
+  "version": "0.0.83",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/errors.ts

@@ -131,6 +131,24 @@ export class MessagePlacementUnsettledError extends ConflictError {
 	}
 }
 
+/**
+ * The row named a message the mail server no longer holds at that UID —
+ * another client expunged it or moved it away. Distinct from a plain
+ * not-found so the client can say where the message went rather than
+ * claiming the user deleted it.
+ */
+export class MessageGoneFromServerError extends NotFoundError {
+	name = "MessageGoneFromServerError";
+
+	constructor(messageId: string) {
+		super("This message is no longer on the mail server.");
+		this.publicApiError = {
+			code: "message_gone_from_server",
+			details: { messageId },
+		};
+	}
+}
+
 /**
  * A configuration import refused because this configuration is not empty
  * (#1021). The default is to refuse rather than to fold the file in: a person

package/src/interfaces/message.ts

@@ -22,6 +22,15 @@ export interface IMessageRepository {
 	clearSpamReport(messageId: string): Promise<MessageItem>;
 	delete(messageId: string): Promise<void>;
 	deleteMany(messageIds: string[]): Promise<void>;
+	/**
+	 * Delete the row only while its placement still matches what the caller
+	 * read (imap-mutations R3). Resolves `false` when the predicate did not
+	 * match and nothing was deleted.
+	 */
+	deleteIfPlacement(
+		messageId: string,
+		expected: PlacementPredicate,
+	): Promise<boolean>;
 	listByMailbox(
 		mailboxId: string,
 		options?: { limit?: number; continuationToken?: string },