@remit/api-openapi-spec 0.0.19 → 0.0.21

package/openapi.json

@@ -1573,7 +1573,7 @@
             "name": "count",
             "in": "query",
             "required": false,
-            "description": "Include a count of matches within the server-capped window.",
+            "description": "Include how many messages the query matches. Counted over the whole mailbox, independent of `limit`.",
             "schema": {
               "type": "boolean"
             }
@@ -1591,7 +1591,7 @@
             "name": "limit",
             "in": "query",
             "required": false,
-            "description": "Caller-set recency window, capped server-side at 500. Bounds the read.",
+            "description": "Page size for the rows returned, capped server-side at 500. Bounds the read, not the `count`.",
             "schema": {
               "type": "integer",
               "format": "int32"
@@ -3886,7 +3886,7 @@
           },
           "actionMailboxId": {
             "type": "string",
-            "description": "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.",
+            "description": "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.",
             "default": "None"
           },
           "anchorMessageId": {
@@ -4377,6 +4377,7 @@
           "state",
           "hasAnchor",
           "ruleChangedAt",
+          "actionChangedAt",
           "matchOperator",
           "literalClauses",
           "actionLabelId",
@@ -4442,7 +4443,13 @@
           "ruleChangedAt": {
             "type": "integer",
             "format": "int64",
-            "description": "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.",
+            "description": "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": true
+          },
+          "actionChangedAt": {
+            "type": "integer",
+            "format": "int64",
+            "description": "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": true
           },
           "matchOperator": {
@@ -4469,7 +4476,7 @@
           },
           "actionMailboxId": {
             "type": "string",
-            "description": "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.",
+            "description": "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.",
             "default": "None"
           },
           "createdAt": {
@@ -6443,10 +6450,10 @@
           "count": {
             "type": "integer",
             "format": "int32",
-            "description": "Number of matches within the server-capped window. Present only when `count=true`."
+            "description": "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."
           }
         },
-        "description": "Aggregate response for `searchThreads`. Carries the matching rows (`items`), a\npagination `continuationToken`, and an optional `count` of matches within the\nserver-capped window. `items` is omitted when `results=false` (count-only);\n`count` is present only when `count=true`. Thread-specific so the shared\n`ResultList<T>` (7 endpoints) stays untouched."
+        "description": "Aggregate response for `searchThreads`. Carries the matching rows (`items`), a\npagination `continuationToken`, and an optional `count` of every message the\nquery matches. `items` is omitted when `results=false` (count-only); `count` is\npresent only when `count=true`. Thread-specific so the shared `ResultList<T>`\n(7 endpoints) stays untouched."
       },
       "RemitImap.TrustedFlag": {
         "type": "object",
@@ -6737,11 +6744,11 @@
           },
           "actionMailboxId": {
             "type": "string",
-            "description": "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.",
+            "description": "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.",
             "default": "None"
           }
         },
-        "description": "Input for updating a filter (RFC 034, reader #266). The name, predicate,\naction, scope, and expiresAt are all updatable; `ttl` is always\nserver-derived from `scope`/`expiresAt`, never client-supplied, and\n`state`/`hasAnchor`/`ruleChangedAt`/`filterId` are server-derived too. A\npatch touching the predicate, the action, `scope`, or `expiresAt` bumps\n`ruleChangedAt`; a name-only rename never does (RFC 034 Decision 3.2, reader\n#266).\n\nThe semantic anchor has no field here at all — it is set once, from\n`anchorMessageId`, only on `CreateFilterInput`. Repointing an anchor would\nsilently change what a saved filter matches with nothing visible changing;\nthat deserves a new filter, so the server rejects any attempt to smuggle an\nanchor change through this body (reader #266)."
+        "description": "Input for updating a filter (RFC 034, reader #266). The name, predicate,\naction, scope, and expiresAt are all updatable; `ttl` is always\nserver-derived from `scope`/`expiresAt`, never client-supplied, and\n`state`/`hasAnchor`/`ruleChangedAt`/`actionChangedAt`/`filterId` are\nserver-derived too. A patch touching the predicate, the action, `scope`, or\n`expiresAt` bumps `ruleChangedAt`; a name-only rename never does (RFC 034\nDecision 3.2, reader #266). Only a patch touching the predicate or the\naction bumps `actionChangedAt`, the narrower signal exclusive-move\nprecedence reads (reader #384) — a scope/expiresAt-only edit leaves it\nuntouched.\n\nThe semantic anchor has no field here at all — it is set once, from\n`anchorMessageId`, only on `CreateFilterInput`. Repointing an anchor would\nsilently change what a saved filter matches with nothing visible changing;\nthat deserves a new filter, so the server rejects any attempt to smuggle an\nanchor change through this body (reader #266)."
       },
       "RemitImap.UpdateFlagsInput": {
         "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/api-openapi-spec",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "Remit API OpenAPI 3 document, generated from TypeSpec.",
   "exports": {
     ".": "./openapi.json",