@remit/data-ports 0.0.20 → 0.0.22

package/package.json

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

package/src/index.ts

@@ -6,6 +6,7 @@ export type { IAddressRepository } from "./interfaces/address.js";
 export type { IEnvelopeRepository } from "./interfaces/envelope.js";
 export type { IFilterRepository } from "./interfaces/filter.js";
 export type { IFilterAnchorRepository } from "./interfaces/filter-anchor.js";
+export type { IFilterAnchorTransaction } from "./interfaces/filter-anchor-transaction.js";
 export type { ILabelRepository } from "./interfaces/label.js";
 export type { IMailboxRepository } from "./interfaces/mailbox.js";
 export type { IMailboxLockRepository } from "./interfaces/mailbox-lock.js";

package/src/interfaces/filter-anchor-transaction.ts

@@ -0,0 +1,23 @@
+import type {
+	CreateFilterAnchorInput,
+	CreateFilterInput,
+	FilterItem,
+} from "../types.js";
+
+/**
+ * Atomically creates a `Filter` row and its optional sibling `FilterAnchor`
+ * row (#351). Without this, the two writes ran sequentially: a failure on the
+ * second left a `Filter` durably marked `hasAnchor: true` with no matching
+ * `FilterAnchor` row — a filter that looks normal but silently matches
+ * nothing, forever, with no repair path (the anchor message id is never
+ * retained once `createFilterWithAnchor` returns).
+ *
+ * `anchor` omits `filterId` — it is not known until the `Filter` row is
+ * created inside the same transaction.
+ */
+export interface IFilterAnchorTransaction {
+	createWithAnchor(
+		filter: CreateFilterInput,
+		anchor: Omit<CreateFilterAnchorInput, "filterId"> | null,
+	): Promise<FilterItem>;
+}

package/src/types.ts

@@ -462,6 +462,14 @@ export type SearchOptions = {
 	unread?: boolean;
 	starred?: boolean;
 	attachments?: boolean;
+	/**
+	 * Any-of set over the denormalized `category` column on the ThreadMessage
+	 * row. An empty or absent set means no category filter. `uncategorized` is
+	 * a member like any other — the column is NOT NULL with that default, so it
+	 * names the not-yet-classified state rather than standing for absence
+	 * (issue #45).
+	 */
+	category?: ThreadMessageItem["category"][];
 };
 
 export type CreateLabelInput = Omit<