@remit/api-http-client 0.0.17 → 0.0.18

package/@tanstack/react-query.gen.ts

@@ -939,7 +939,7 @@ export const systemOperationsApplySystemUpdateMutation = (options?: Partial<Opti
 export const unifiedThreadOperationsListAllThreadsQueryKey = (options?: Options<UnifiedThreadOperationsListAllThreadsData>) => createQueryKey('unifiedThreadOperationsListAllThreads', options);
 
 /**
- * List threads across all non-muted accounts of the caller, ordered by sentDate desc. Each row carries an attached `accountId` (derived from a mailboxId→accountId map at read time) plus the usual `senderTrust`/`category` enrichment. Served by the `byDate` LSI1 (pk = the caller's account config), so the caller can never see another account config's threads.
+ * List threads across all non-muted accounts of the caller, ordered by sentDate desc. Each row carries an attached `accountId` (derived from a mailboxId→accountId map at read time) plus the usual `senderTrust` enrichment; `category` is served from the ThreadMessage row. Served by the `byDate` LSI1 (pk = the caller's account config), so the caller can never see another account config's threads.
  *
  * INBOX scope: results are filtered to each account's top-level INBOX, matched by exact path `fullPath === "INBOX"` (RFC 6154 defines no Inbox special-use). By design this excludes namespaced sub-paths like `INBOX/Receipts` and non-English server primaries — the unified inbox is each account's primary INBOX, not its sub-folders. Soft-deleted rows are also excluded.
  *

package/package.json

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

package/sdk.gen.ts

@@ -546,7 +546,7 @@ export const systemOperationsApplySystemUpdate = <ThrowOnError extends boolean =
 });
 
 /**
- * List threads across all non-muted accounts of the caller, ordered by sentDate desc. Each row carries an attached `accountId` (derived from a mailboxId→accountId map at read time) plus the usual `senderTrust`/`category` enrichment. Served by the `byDate` LSI1 (pk = the caller's account config), so the caller can never see another account config's threads.
+ * List threads across all non-muted accounts of the caller, ordered by sentDate desc. Each row carries an attached `accountId` (derived from a mailboxId→accountId map at read time) plus the usual `senderTrust` enrichment; `category` is served from the ThreadMessage row. Served by the `byDate` LSI1 (pk = the caller's account config), so the caller can never see another account config's threads.
  *
  * INBOX scope: results are filtered to each account's top-level INBOX, matched by exact path `fullPath === "INBOX"` (RFC 6154 defines no Inbox special-use). By design this excludes namespaced sub-paths like `INBOX/Receipts` and non-English server primaries — the unified inbox is each account's primary INBOX, not its sub-folders. Soft-deleted rows are also excluded.
  *

package/types.gen.ts

@@ -963,9 +963,9 @@ export type RemitImapEnvelopeResponse = {
      */
     replyTo: Array<RemitImapEnvelopeAddressResponse>;
     /**
-     * Header-derived category for the message. Absent for messages synced before classification rolled out.
+     * Header-derived category for the message. Always present: `Message.category` is NOT NULL with an `uncategorized` default, and `uncategorized` names the not-yet-classified state rather than standing for absence (issue #45).
      */
-    category?: RemitImapMessageCategory;
+    category: RemitImapMessageCategory;
     /**
      * Trust level for the From address, derived from AddressFlags at read time.
      */
@@ -2060,7 +2060,7 @@ export type RemitImapTestConnectionResponse = {
 };
 
 /**
- * Thread message item returned by list/search operations. `category` and `senderTrust` are attached at read time via batch-fetch so the inbox row can render badges without a per-row round trip.
+ * Thread message item returned by list/search operations. `senderTrust` is attached at read time via batch-fetch so the inbox row can render its badge without a per-row round trip. `category` is served from the ThreadMessage row itself, which is also the row the category filter matches, so the badge and the filter cannot disagree.
  */
 export type RemitImapThreadMessageResponse = {
     /**
@@ -2126,9 +2126,9 @@ export type RemitImapThreadMessageResponse = {
     readonly createdAt: number;
     readonly updatedAt: number;
     /**
-     * Header-derived category for the message (from the underlying Message). Absent for messages synced before classification rolled out — clients should treat this as `personal`.
+     * Header-derived category for the message, served from the ThreadMessage row. Always present: the column is NOT NULL with an `uncategorized` default, and `uncategorized` is a named value for the not-yet-classified state, never a stand-in for `personal` (issue #45).
      */
-    category?: RemitImapMessageCategory;
+    category: RemitImapMessageCategory;
     /**
      * Trust level for the From address, derived from AddressFlags at read time. Defaults to `unknown` when no Address row resolves.
      */
@@ -2717,13 +2717,13 @@ export type RemitImapQuarantineResponseWritable = {
 };
 
 /**
- * Thread message item returned by list/search operations. `category` and `senderTrust` are attached at read time via batch-fetch so the inbox row can render badges without a per-row round trip.
+ * Thread message item returned by list/search operations. `senderTrust` is attached at read time via batch-fetch so the inbox row can render its badge without a per-row round trip. `category` is served from the ThreadMessage row itself, which is also the row the category filter matches, so the badge and the filter cannot disagree.
  */
 export type RemitImapThreadMessageResponseWritable = {
     /**
-     * Header-derived category for the message (from the underlying Message). Absent for messages synced before classification rolled out — clients should treat this as `personal`.
+     * Header-derived category for the message, served from the ThreadMessage row. Always present: the column is NOT NULL with an `uncategorized` default, and `uncategorized` is a named value for the not-yet-classified state, never a stand-in for `personal` (issue #45).
      */
-    category?: RemitImapMessageCategory;
+    category: RemitImapMessageCategory;
     /**
      * Trust level for the From address, derived from AddressFlags at read time. Defaults to `unknown` when no Address row resolves.
      */
@@ -3399,7 +3399,7 @@ export type ThreadOperationsSearchThreadsData = {
          */
         senderTrust?: Array<RemitImapSenderTrust>;
         /**
-         * Filter to messages with one of these header-derived categories. Off-row criterion, resolved by in-handler enrichment over the capped window.
+         * Filter to messages with one of these header-derived categories. Applied as a SQL predicate over the whole mailbox, so a page comes back full of matches however rare the category is. `uncategorized` is one of them.
          */
         category?: Array<RemitImapMessageCategory>;
         /**