@remit/data-ports 0.0.70 → 0.0.72

package/package.json

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

package/src/index.ts

@@ -100,6 +100,7 @@ export type {
 	CreateFilterInput,
 	CreateLabelInput,
 	CreateMailboxInput,
+	CreateMailboxResult,
 	CreateMessageFlagInput,
 	CreateMessageInput,
 	CreateMessageLabelInput,

package/src/interfaces/mailbox.ts

@@ -1,5 +1,6 @@
 import type {
 	CreateMailboxInput,
+	CreateMailboxResult,
 	MailboxItem,
 	MailboxSubtreeTransitionIntent,
 	MailboxTransitionIntent,
@@ -8,7 +9,7 @@ import type {
 } from "../types.js";
 
 export interface IMailboxRepository {
-	create(input: CreateMailboxInput): Promise<MailboxItem>;
+	create(input: CreateMailboxInput): Promise<CreateMailboxResult>;
 	get(accountId: string, mailboxId: string): Promise<MailboxItem>;
 	get(accountId: string, mailboxIds: string[]): Promise<MailboxItem[]>;
 	/**

package/src/interfaces/thread-message.ts

@@ -58,11 +58,12 @@ export interface IThreadMessageRepository {
 		},
 	): Promise<ResultList<ThreadMessageItem>>;
 	/**
-	 * Search rows for a config across every mailbox in `mailboxIds`, newest
-	 * first — the cross-account, cross-folder counterpart of `searchByMailbox`.
+	 * Search rows for a config across every mailbox in `mailboxIds` — the
+	 * cross-account, cross-folder counterpart of `searchByMailbox`. A row whose
+	 * From matches any `query` term ranks above one that only mentions the
+	 * terms, and each tier runs in date order.
 	 *
-	 * Backed by the same date-ordered access pattern as `listByDate`; the caller
-	 * supplies the mailbox scope, so a search reaching Archive, Sent, Spam and
+	 * The caller supplies the mailbox scope, so a search reaching Archive, Sent, Spam and
 	 * custom folders is a matter of which set is passed. An empty or absent
 	 * `mailboxIds` means no narrowing (every mailbox of the config), which is why
 	 * handlers pass an explicitly built set rather than relying on the default.

package/src/mutation-events.ts

@@ -9,6 +9,8 @@
  */
 export const MUTATION_EVENT_SCHEMA_VERSION = 2;
 
+export const PATHLESS_MUTATION_EVENT_SCHEMA_VERSION = 3;
+
 /**
  * Queue payloads are `JSON.parse`d and cast with no validation, so the declared
  * type is a promise the queue cannot keep. A handler that cannot vouch for an
@@ -16,5 +18,6 @@ export const MUTATION_EVENT_SCHEMA_VERSION = 2;
  * makes the unverified expunge the default for every event we cannot vouch for,
  * including any future producer that forgets the field.
  */
-export const isCurrentSchemaVersion = (value: unknown): boolean =>
-	value === MUTATION_EVENT_SCHEMA_VERSION;
+export const isAcceptedSchemaVersion = (value: unknown): boolean =>
+	value === MUTATION_EVENT_SCHEMA_VERSION ||
+	value === PATHLESS_MUTATION_EVENT_SCHEMA_VERSION;

package/src/types.ts

@@ -386,6 +386,10 @@ export type CreateMailboxInput = Omit<
 	syncStatus?: MailboxItem["syncStatus"];
 };
 
+export type CreateMailboxResult =
+	| { outcome: "Created"; mailbox: MailboxItem }
+	| { outcome: "PathTaken" };
+
 /**
  * Everything about a mailbox that is not its mutation state.
  *