@remit/api-http-client 0.0.19 → 0.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/api-http-client",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "type": "module",
   "exports": {
     ".": "./index.ts",

package/types.gen.ts

@@ -707,7 +707,7 @@ export type RemitImapCreateFilterInput = {
      */
     actionLabelId: string;
     /**
-     * Mailbox matched messages are moved into — exclusive action, since a message lives in exactly one mailbox (RFC 034 Decision 3.1). On conflict between filters, the one with the latest ruleChangedAt wins. `"None"` means no move action.
+     * Mailbox matched messages are moved into — exclusive action, since a message lives in exactly one mailbox (RFC 034 Decision 3.1). On conflict between filters, the one with the latest actionChangedAt wins. `"None"` means no move action.
      */
     actionMailboxId: string;
     /**
@@ -1029,9 +1029,13 @@ export type RemitImapFilterResponse = {
      */
     readonly hasAnchor: boolean;
     /**
-     * Epoch seconds, written only when the predicate (literalClauses, hasAnchor) or the action (actionLabelId, actionMailboxId) changes — never on a cosmetic rename. Backs most-recently-changed-filter-wins precedence for the exclusive move action (RFC 034 Decision 3.2). Distinct from ElectroDB's own updatedAt, which bumps on any write.
+     * Epoch seconds, written whenever the predicate, the action, the scope, or the expiry changes (reader #266) — never on a cosmetic rename. This is the broad "the user asserted something new about this rule" signal the settings UI uses to decide whether to re-offer a lapsed filter's back-application. It is deliberately NOT the precedence signal for the exclusive move action — see actionChangedAt for that (RFC 034 Decision 3.2, reader #384). Distinct from ElectroDB's own updatedAt, which bumps on any write.
      */
     readonly ruleChangedAt: number;
+    /**
+     * Epoch seconds, written only when the predicate (literalClauses, hasAnchor) or the action (actionLabelId, actionMailboxId) changes — never on scope, expiresAt, or a cosmetic rename. Backs most-recently-changed-filter-wins precedence for the exclusive move action (RFC 034 Decision 3.2). Split out from ruleChangedAt (reader #384): extending a filter's expiry or flipping its scope changes its lifecycle, not what it matches or does, so it must not promote the filter to move-winner.
+     */
+    readonly actionChangedAt: number;
     /**
      * How literalClauses combine. Meaningless when literalClauses is empty.
      */
@@ -1045,7 +1049,7 @@ export type RemitImapFilterResponse = {
      */
     actionLabelId: string;
     /**
-     * Mailbox matched messages are moved into — exclusive action, since a message lives in exactly one mailbox (RFC 034 Decision 3.1). On conflict between filters, the one with the latest ruleChangedAt wins. `"None"` means no move action.
+     * Mailbox matched messages are moved into — exclusive action, since a message lives in exactly one mailbox (RFC 034 Decision 3.1). On conflict between filters, the one with the latest actionChangedAt wins. `"None"` means no move action.
      */
     actionMailboxId: string;
     readonly createdAt: number;
@@ -2157,10 +2161,10 @@ export type RemitImapThreadMessageResponse = {
 
 /**
  * Aggregate response for `searchThreads`. Carries the matching rows (`items`), a
- * pagination `continuationToken`, and an optional `count` of matches within the
- * server-capped window. `items` is omitted when `results=false` (count-only);
- * `count` is present only when `count=true`. Thread-specific so the shared
- * `ResultList<T>` (7 endpoints) stays untouched.
+ * pagination `continuationToken`, and an optional `count` of every message the
+ * query matches. `items` is omitted when `results=false` (count-only); `count` is
+ * present only when `count=true`. Thread-specific so the shared `ResultList<T>`
+ * (7 endpoints) stays untouched.
  */
 export type RemitImapThreadSearchResponse = {
     /**
@@ -2172,7 +2176,7 @@ export type RemitImapThreadSearchResponse = {
      */
     continuationToken?: String800;
     /**
-     * Number of matches within the server-capped window. Present only when `count=true`.
+     * How many messages the query matches, over the whole mailbox and independent of `limit`. Present only when `count=true`. With `senderTrust` or `dkimMismatch` in the query the count is over the enriched window instead, since those are resolved off the row.
      */
     count?: number;
 };
@@ -2307,10 +2311,13 @@ export type RemitImapUpdateAddressInput = {
  * Input for updating a filter (RFC 034, reader #266). The name, predicate,
  * action, scope, and expiresAt are all updatable; `ttl` is always
  * server-derived from `scope`/`expiresAt`, never client-supplied, and
- * `state`/`hasAnchor`/`ruleChangedAt`/`filterId` are server-derived too. A
- * patch touching the predicate, the action, `scope`, or `expiresAt` bumps
- * `ruleChangedAt`; a name-only rename never does (RFC 034 Decision 3.2, reader
- * #266).
+ * `state`/`hasAnchor`/`ruleChangedAt`/`actionChangedAt`/`filterId` are
+ * server-derived too. A patch touching the predicate, the action, `scope`, or
+ * `expiresAt` bumps `ruleChangedAt`; a name-only rename never does (RFC 034
+ * Decision 3.2, reader #266). Only a patch touching the predicate or the
+ * action bumps `actionChangedAt`, the narrower signal exclusive-move
+ * precedence reads (reader #384) — a scope/expiresAt-only edit leaves it
+ * untouched.
  *
  * The semantic anchor has no field here at all — it is set once, from
  * `anchorMessageId`, only on `CreateFilterInput`. Repointing an anchor would
@@ -2344,7 +2351,7 @@ export type RemitImapUpdateFilterInput = {
      */
     actionLabelId?: string;
     /**
-     * Mailbox matched messages are moved into — exclusive action, since a message lives in exactly one mailbox (RFC 034 Decision 3.1). On conflict between filters, the one with the latest ruleChangedAt wins. `"None"` means no move action.
+     * Mailbox matched messages are moved into — exclusive action, since a message lives in exactly one mailbox (RFC 034 Decision 3.1). On conflict between filters, the one with the latest actionChangedAt wins. `"None"` means no move action.
      */
     actionMailboxId?: string;
 };
@@ -2637,7 +2644,7 @@ export type RemitImapFilterResponseWritable = {
      */
     actionLabelId: string;
     /**
-     * Mailbox matched messages are moved into — exclusive action, since a message lives in exactly one mailbox (RFC 034 Decision 3.1). On conflict between filters, the one with the latest ruleChangedAt wins. `"None"` means no move action.
+     * Mailbox matched messages are moved into — exclusive action, since a message lives in exactly one mailbox (RFC 034 Decision 3.1). On conflict between filters, the one with the latest actionChangedAt wins. `"None"` means no move action.
      */
     actionMailboxId: string;
 };
@@ -2756,10 +2763,10 @@ export type RemitImapThreadMessageResponseWritable = {
 
 /**
  * Aggregate response for `searchThreads`. Carries the matching rows (`items`), a
- * pagination `continuationToken`, and an optional `count` of matches within the
- * server-capped window. `items` is omitted when `results=false` (count-only);
- * `count` is present only when `count=true`. Thread-specific so the shared
- * `ResultList<T>` (7 endpoints) stays untouched.
+ * pagination `continuationToken`, and an optional `count` of every message the
+ * query matches. `items` is omitted when `results=false` (count-only); `count` is
+ * present only when `count=true`. Thread-specific so the shared `ResultList<T>`
+ * (7 endpoints) stays untouched.
  */
 export type RemitImapThreadSearchResponseWritable = {
     /**
@@ -2771,7 +2778,7 @@ export type RemitImapThreadSearchResponseWritable = {
      */
     continuationToken?: String800;
     /**
-     * Number of matches within the server-capped window. Present only when `count=true`.
+     * How many messages the query matches, over the whole mailbox and independent of `limit`. Present only when `count=true`. With `senderTrust` or `dkimMismatch` in the query the count is over the enriched window instead, since those are resolved off the row.
      */
     count?: number;
 };
@@ -3415,7 +3422,7 @@ export type ThreadOperationsSearchThreadsData = {
          */
         dkimMismatch?: boolean;
         /**
-         * Include a count of matches within the server-capped window.
+         * Include how many messages the query matches. Counted over the whole mailbox, independent of `limit`.
          */
         count?: boolean;
         /**
@@ -3423,7 +3430,7 @@ export type ThreadOperationsSearchThreadsData = {
          */
         results?: boolean;
         /**
-         * Caller-set recency window, capped server-side at 500. Bounds the read.
+         * Page size for the rows returned, capped server-side at 500. Bounds the read, not the `count`.
          */
         limit?: number;
     };