@remit/data-ports 0.0.20 → 0.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/data-ports",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "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>;
+}