@remit/backend 0.0.143 → 0.0.145

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (279) hide show
  1. package/dist/dev-server/content-handler.d.ts +38 -0
  2. package/dist/dev-server/content-handler.js +46 -0
  3. package/dist/src/api.d.ts +5 -0
  4. package/dist/src/api.js +73 -0
  5. package/dist/src/auth.d.ts +24 -0
  6. package/dist/src/auth.js +81 -0
  7. package/dist/src/config/api-config.d.ts +20 -0
  8. package/dist/src/config/api-config.js +1 -0
  9. package/dist/src/config/from-env.d.ts +2 -0
  10. package/dist/src/config/from-env.js +65 -0
  11. package/dist/src/config/msoauth-secrets-manager.d.ts +2 -0
  12. package/dist/src/config/msoauth-secrets-manager.js +28 -0
  13. package/dist/src/config/msoauth.d.ts +19 -0
  14. package/dist/src/config/msoauth.js +6 -0
  15. package/{src/derive/autoMoved.ts → dist/src/derive/autoMoved.d.ts} +1 -29
  16. package/dist/src/derive/autoMoved.js +49 -0
  17. package/dist/src/derive/contentSignature.d.ts +40 -0
  18. package/{src/derive/contentSignature.ts → dist/src/derive/contentSignature.js} +23 -77
  19. package/dist/src/derive/contentUrl.d.ts +33 -0
  20. package/dist/src/derive/contentUrl.js +27 -0
  21. package/{src/derive/deriveMuted.ts → dist/src/derive/deriveMuted.d.ts} +1 -3
  22. package/dist/src/derive/deriveMuted.js +7 -0
  23. package/dist/src/derive/enrichThreadRows.d.ts +118 -0
  24. package/dist/src/derive/enrichThreadRows.js +151 -0
  25. package/dist/src/derive/filterThreadCriteria.d.ts +23 -0
  26. package/dist/src/derive/filterThreadCriteria.js +24 -0
  27. package/{src/derive/pendingMoveCounts.ts → dist/src/derive/pendingMoveCounts.d.ts} +5 -53
  28. package/dist/src/derive/pendingMoveCounts.js +53 -0
  29. package/{src/derive/senderTrust.ts → dist/src/derive/senderTrust.d.ts} +1 -9
  30. package/dist/src/derive/senderTrust.js +19 -0
  31. package/dist/src/error.d.ts +21 -0
  32. package/dist/src/error.js +85 -0
  33. package/dist/src/handlers/account-guards.d.ts +36 -0
  34. package/dist/src/handlers/account-guards.js +107 -0
  35. package/dist/src/handlers/account-oauth.d.ts +15 -0
  36. package/dist/src/handlers/account-oauth.js +334 -0
  37. package/dist/src/handlers/account-overrides.d.ts +53 -0
  38. package/dist/src/handlers/account-overrides.js +233 -0
  39. package/dist/src/handlers/account-signature.d.ts +28 -0
  40. package/dist/src/handlers/account-signature.js +85 -0
  41. package/dist/src/handlers/account.d.ts +7 -0
  42. package/dist/src/handlers/account.js +337 -0
  43. package/dist/src/handlers/address.d.ts +35 -0
  44. package/dist/src/handlers/address.js +133 -0
  45. package/dist/src/handlers/calendar-event.d.ts +70 -0
  46. package/dist/src/handlers/calendar-event.js +417 -0
  47. package/dist/src/handlers/calendar-feed.d.ts +47 -0
  48. package/dist/src/handlers/calendar-feed.js +184 -0
  49. package/dist/src/handlers/calendar-suggestion.d.ts +47 -0
  50. package/dist/src/handlers/calendar-suggestion.js +204 -0
  51. package/dist/src/handlers/calendar.d.ts +116 -0
  52. package/dist/src/handlers/calendar.js +323 -0
  53. package/dist/src/handlers/config.d.ts +43 -0
  54. package/dist/src/handlers/config.js +164 -0
  55. package/dist/src/handlers/ensure-account-config.d.ts +9 -0
  56. package/dist/src/handlers/ensure-account-config.js +27 -0
  57. package/dist/src/handlers/filter.d.ts +3 -0
  58. package/dist/src/handlers/filter.js +88 -0
  59. package/dist/src/handlers/folder-role-appointments.d.ts +68 -0
  60. package/dist/src/handlers/folder-role-appointments.js +168 -0
  61. package/dist/src/handlers/folder-role-labels.d.ts +26 -0
  62. package/dist/src/handlers/folder-role-labels.js +40 -0
  63. package/dist/src/handlers/folder-role.d.ts +9 -0
  64. package/dist/src/handlers/folder-role.js +37 -0
  65. package/dist/src/handlers/index.d.ts +88 -0
  66. package/dist/src/handlers/index.js +62 -0
  67. package/dist/src/handlers/label.d.ts +43 -0
  68. package/dist/src/handlers/label.js +107 -0
  69. package/dist/src/handlers/mailbox-bindings.d.ts +41 -0
  70. package/dist/src/handlers/mailbox-bindings.js +61 -0
  71. package/dist/src/handlers/mailbox.d.ts +23 -0
  72. package/dist/src/handlers/mailbox.js +211 -0
  73. package/dist/src/handlers/me.d.ts +2 -0
  74. package/dist/src/handlers/me.js +117 -0
  75. package/dist/src/handlers/message.d.ts +82 -0
  76. package/dist/src/handlers/message.js +595 -0
  77. package/dist/src/handlers/organize.d.ts +10 -0
  78. package/dist/src/handlers/organize.js +103 -0
  79. package/dist/src/handlers/outbox-attachment.d.ts +25 -0
  80. package/dist/src/handlers/outbox-attachment.js +77 -0
  81. package/dist/src/handlers/outbox.d.ts +4 -0
  82. package/dist/src/handlers/outbox.js +136 -0
  83. package/dist/src/handlers/sync-progress.d.ts +46 -0
  84. package/dist/src/handlers/sync-progress.js +63 -0
  85. package/dist/src/handlers/sync.d.ts +28 -0
  86. package/dist/src/handlers/sync.js +73 -0
  87. package/dist/src/handlers/system-update.d.ts +2 -0
  88. package/dist/src/handlers/system-update.js +159 -0
  89. package/dist/src/handlers/thread.d.ts +148 -0
  90. package/dist/src/handlers/thread.js +228 -0
  91. package/dist/src/handlers/unified-threads.d.ts +247 -0
  92. package/dist/src/handlers/unified-threads.js +406 -0
  93. package/{src/handlers/vip-suggestions.ts → dist/src/handlers/vip-suggestions.d.ts} +1 -13
  94. package/dist/src/handlers/vip-suggestions.js +16 -0
  95. package/dist/src/index.d.ts +5 -0
  96. package/dist/src/index.js +53 -0
  97. package/{src/json.ts → dist/src/json.d.ts} +1 -4
  98. package/dist/src/json.js +10 -0
  99. package/dist/src/jwt-auth.d.ts +15 -0
  100. package/dist/src/jwt-auth.js +45 -0
  101. package/dist/src/lambda.d.ts +13 -0
  102. package/dist/src/lambda.js +33 -0
  103. package/dist/src/request.d.ts +9 -0
  104. package/dist/src/request.js +17 -0
  105. package/dist/src/response.d.ts +44 -0
  106. package/dist/src/response.js +80 -0
  107. package/dist/src/serve.d.ts +31 -0
  108. package/dist/src/serve.js +117 -0
  109. package/dist/src/service/account-deletion.d.ts +20 -0
  110. package/dist/src/service/account-deletion.js +33 -0
  111. package/dist/src/service/compose-sqlite.d.ts +3 -0
  112. package/dist/src/service/compose-sqlite.js +13 -0
  113. package/dist/src/service/create-remit-client.d.ts +109 -0
  114. package/dist/src/service/create-remit-client.js +188 -0
  115. package/dist/src/service/data-client.d.ts +12 -0
  116. package/dist/src/service/data-client.js +42 -0
  117. package/dist/src/service/export-identity.d.ts +4 -0
  118. package/dist/src/service/export-identity.js +33 -0
  119. package/dist/src/service/fire-and-forget.d.ts +54 -0
  120. package/dist/src/service/fire-and-forget.js +37 -0
  121. package/dist/src/service/organize.d.ts +181 -0
  122. package/dist/src/service/organize.js +367 -0
  123. package/dist/src/service/queues.d.ts +12 -0
  124. package/dist/src/service/queues.js +1 -0
  125. package/dist/src/service/refusal.d.ts +4 -0
  126. package/dist/src/service/refusal.js +20 -0
  127. package/dist/src/service/sender-category.d.ts +51 -0
  128. package/{src/service/sender-category.ts → dist/src/service/sender-category.js} +40 -81
  129. package/dist/src/service/shared-deps.d.ts +6 -0
  130. package/dist/src/service/shared-deps.js +24 -0
  131. package/dist/src/service/trigger-sync.d.ts +57 -0
  132. package/dist/src/service/trigger-sync.js +31 -0
  133. package/dist/src/types.d.ts +72 -0
  134. package/dist/src/types.js +1 -0
  135. package/package.json +125 -98
  136. package/.env.test +0 -4
  137. package/dev-server/content-auth.test.ts +0 -113
  138. package/dev-server/content-auth.ts +0 -54
  139. package/dev-server/content-handler.test.ts +0 -105
  140. package/dev-server/content-handler.ts +0 -79
  141. package/dev-server/content-path.test.ts +0 -37
  142. package/dev-server/content-path.ts +0 -27
  143. package/dev-server/cors.test.ts +0 -48
  144. package/dev-server/cors.ts +0 -25
  145. package/dev-server/keep-alive.test.ts +0 -24
  146. package/dev-server/lambda-helpers.ts +0 -69
  147. package/dev-server/log-output.test.ts +0 -173
  148. package/dev-server/oauth-callback-route.test.ts +0 -66
  149. package/dev-server/relational-health.test.ts +0 -83
  150. package/dev-server/relational-health.ts +0 -39
  151. package/dev-server/server.ts +0 -384
  152. package/dev-server/sync-age.test.ts +0 -91
  153. package/dev-server/sync-age.ts +0 -55
  154. package/dev-server/upload-handler.ts +0 -132
  155. package/dev-server/upload-route.test.ts +0 -196
  156. package/scripts/backfill-classification.ts +0 -91
  157. package/scripts/backfill-list-id.ts +0 -83
  158. package/scripts/config-save.ts +0 -128
  159. package/src/auth.test.ts +0 -12
  160. package/src/auth.ts +0 -92
  161. package/src/config/msoauth.test.ts +0 -48
  162. package/src/config/msoauth.ts +0 -48
  163. package/src/data-backend.test.ts +0 -23
  164. package/src/data-backend.ts +0 -14
  165. package/src/derive/autoMoved.test.ts +0 -104
  166. package/src/derive/contentSignature.test.ts +0 -161
  167. package/src/derive/contentUrl.test.ts +0 -172
  168. package/src/derive/contentUrl.ts +0 -86
  169. package/src/derive/deriveMuted.test.ts +0 -34
  170. package/src/derive/enrichThreadRows.test.ts +0 -360
  171. package/src/derive/enrichThreadRows.ts +0 -234
  172. package/src/derive/filterThreadCriteria.test.ts +0 -126
  173. package/src/derive/filterThreadCriteria.ts +0 -51
  174. package/src/derive/senderTrust.test.ts +0 -67
  175. package/src/error.test.ts +0 -201
  176. package/src/error.ts +0 -123
  177. package/src/handlers/account-guards.test.ts +0 -67
  178. package/src/handlers/account-guards.ts +0 -169
  179. package/src/handlers/account-oauth-callback.test.ts +0 -155
  180. package/src/handlers/account-oauth-consent.test.ts +0 -336
  181. package/src/handlers/account-oauth-start.test.ts +0 -191
  182. package/src/handlers/account-oauth.test.ts +0 -439
  183. package/src/handlers/account-oauth.ts +0 -635
  184. package/src/handlers/account-overrides.test.ts +0 -88
  185. package/src/handlers/account-overrides.ts +0 -323
  186. package/src/handlers/account-ownership.ts +0 -25
  187. package/src/handlers/account-signature.ts +0 -117
  188. package/src/handlers/account-synced-services.test.ts +0 -245
  189. package/src/handlers/account.ts +0 -552
  190. package/src/handlers/address.test.ts +0 -381
  191. package/src/handlers/address.ts +0 -200
  192. package/src/handlers/calendar-event.test.ts +0 -685
  193. package/src/handlers/calendar-event.ts +0 -738
  194. package/src/handlers/calendar-feed-validators.test.ts +0 -228
  195. package/src/handlers/calendar-feed.test.ts +0 -439
  196. package/src/handlers/calendar-feed.ts +0 -291
  197. package/src/handlers/calendar-sqlite-fixture.ts +0 -36
  198. package/src/handlers/calendar-suggestion.test.ts +0 -1269
  199. package/src/handlers/calendar-suggestion.ts +0 -425
  200. package/src/handlers/calendar.test.ts +0 -1080
  201. package/src/handlers/calendar.ts +0 -517
  202. package/src/handlers/config.test.ts +0 -245
  203. package/src/handlers/config.ts +0 -332
  204. package/src/handlers/ensure-account-config.ts +0 -30
  205. package/src/handlers/filter.test.ts +0 -644
  206. package/src/handlers/filter.ts +0 -518
  207. package/src/handlers/folder-role-appointments.test.ts +0 -438
  208. package/src/handlers/folder-role-appointments.ts +0 -249
  209. package/src/handlers/folder-role-labels.ts +0 -63
  210. package/src/handlers/folder-role.test.ts +0 -209
  211. package/src/handlers/folder-role.ts +0 -80
  212. package/src/handlers/index.ts +0 -83
  213. package/src/handlers/label.test.ts +0 -112
  214. package/src/handlers/label.ts +0 -210
  215. package/src/handlers/mailbox-bindings.ts +0 -111
  216. package/src/handlers/mailbox-rename-refusal.test.ts +0 -247
  217. package/src/handlers/mailbox-settled-target.test.ts +0 -251
  218. package/src/handlers/mailbox.test.ts +0 -280
  219. package/src/handlers/mailbox.ts +0 -581
  220. package/src/handlers/me.test.ts +0 -81
  221. package/src/handlers/me.ts +0 -203
  222. package/src/handlers/message-read-backfill.test.ts +0 -103
  223. package/src/handlers/message.test.ts +0 -131
  224. package/src/handlers/message.ts +0 -1131
  225. package/src/handlers/organize.test.ts +0 -277
  226. package/src/handlers/organize.ts +0 -197
  227. package/src/handlers/outbox-attachment.test.ts +0 -765
  228. package/src/handlers/outbox-attachment.ts +0 -126
  229. package/src/handlers/outbox-list.test.ts +0 -179
  230. package/src/handlers/outbox.test.ts +0 -772
  231. package/src/handlers/outbox.ts +0 -258
  232. package/src/handlers/search.test.ts +0 -161
  233. package/src/handlers/search.ts +0 -105
  234. package/src/handlers/sync-progress.test.ts +0 -205
  235. package/src/handlers/sync-progress.ts +0 -99
  236. package/src/handlers/sync.test.ts +0 -168
  237. package/src/handlers/sync.ts +0 -118
  238. package/src/handlers/system-update.test.ts +0 -497
  239. package/src/handlers/system-update.ts +0 -230
  240. package/src/handlers/thread.test.ts +0 -396
  241. package/src/handlers/thread.ts +0 -427
  242. package/src/handlers/unified-threads-mail-sources.sqlite.test.ts +0 -197
  243. package/src/handlers/unified-threads.test.ts +0 -785
  244. package/src/handlers/unified-threads.ts +0 -669
  245. package/src/index.test.ts +0 -83
  246. package/src/index.ts +0 -228
  247. package/src/jwt-auth.test.ts +0 -152
  248. package/src/jwt-auth.ts +0 -132
  249. package/src/log-redaction.test.ts +0 -144
  250. package/src/openapi-spec.test.ts +0 -118
  251. package/src/request-context.test.ts +0 -61
  252. package/src/request-context.ts +0 -33
  253. package/src/request-pipeline.test.ts +0 -88
  254. package/src/request.ts +0 -10
  255. package/src/response.test.ts +0 -130
  256. package/src/response.ts +0 -144
  257. package/src/service/compose-sqlite.ts +0 -98
  258. package/src/service/config-import.ts +0 -39
  259. package/src/service/create-remit-client.ts +0 -522
  260. package/src/service/data-client.test.ts +0 -97
  261. package/src/service/data-client.ts +0 -58
  262. package/src/service/export-identity.ts +0 -39
  263. package/src/service/filter.ts +0 -40
  264. package/src/service/fire-and-forget.test.ts +0 -126
  265. package/src/service/fire-and-forget.ts +0 -79
  266. package/src/service/localhost-env-config.test.ts +0 -36
  267. package/src/service/organize-queue.ts +0 -98
  268. package/src/service/organize.test.ts +0 -1451
  269. package/src/service/organize.ts +0 -1025
  270. package/src/service/read-path-filter-config.test.ts +0 -243
  271. package/src/service/semantic-capability.test.ts +0 -78
  272. package/src/service/semantic-capability.ts +0 -95
  273. package/src/service/sender-category.test.ts +0 -235
  274. package/src/service/sqs.ts +0 -4
  275. package/src/service/trigger-sync.test.ts +0 -205
  276. package/src/service/trigger-sync.ts +0 -100
  277. package/src/stdout-capture-fixture.ts +0 -40
  278. package/src/types.ts +0 -271
  279. package/tsconfig.json +0 -7
@@ -1,234 +0,0 @@
1
- import type { ThreadMessageResponse } from "@remit/api-openapi-types";
2
- import type {
3
- AddressItem,
4
- LabelItem,
5
- MessageItem,
6
- MessageLabelItem,
7
- ThreadMessageItem,
8
- } from "@remit/data-ports";
9
- import { deriveAddressId } from "@remit/data-ports/id";
10
- import {
11
- MessageMutation,
12
- MessageStatus,
13
- MessageSyncStatus,
14
- SenderTrust,
15
- StarColor,
16
- } from "@remit/domain-enums";
17
- import { deriveAutoMoved } from "./autoMoved.js";
18
- import { deriveMuted } from "./deriveMuted.js";
19
- import { deriveSenderTrust } from "./senderTrust.js";
20
-
21
- /**
22
- * Subset of the ElectroDB client surface used for batch enrichment. Declared
23
- * structurally so unit tests can pass an in-memory fake without standing up
24
- * DynamoDB.
25
- */
26
- export interface EnrichClient {
27
- message: {
28
- get(messageIds: string[]): Promise<MessageItem[]>;
29
- };
30
- address: {
31
- getAddress(
32
- accountConfigId: string,
33
- addressIds: string[],
34
- ): Promise<AddressItem[]>;
35
- };
36
- messageLabel: {
37
- listByMessageIds(messageIds: string[]): Promise<MessageLabelItem[]>;
38
- };
39
- label: {
40
- listByAccountConfig(accountConfigId: string): Promise<LabelItem[]>;
41
- };
42
- }
43
-
44
- const toResponse = (item: ThreadMessageItem): ThreadMessageResponse => ({
45
- threadMessageId: item.threadMessageId,
46
- threadId: item.threadId,
47
- messageId: item.messageId,
48
- accountConfigId: item.accountConfigId,
49
- mailboxId: item.mailboxId,
50
- fromEmail: item.fromEmail,
51
- fromName: item.fromName,
52
- subject: item.subject,
53
- sentDate: item.sentDate,
54
- isRead: item.isRead,
55
- hasAttachment: item.hasAttachment,
56
- star: item.star ?? StarColor.None,
57
- hasStars: item.hasStars,
58
- isDeleted: item.isDeleted,
59
- snippet: item.snippet,
60
- category: item.category,
61
- createdAt: item.createdAt,
62
- updatedAt: item.updatedAt,
63
- senderTrust: SenderTrust.Unknown,
64
- muted: false,
65
- status: MessageStatus.active,
66
- syncStatus: MessageSyncStatus.pending,
67
- abandonedMutation: MessageMutation.none,
68
- });
69
-
70
- /**
71
- * Plan the unique batch-fetch keys for a page of ThreadMessage rows.
72
- *
73
- * Splitting this out keeps the dedup logic testable without DynamoDB and
74
- * documents the contract: a page of N rows produces at most one BatchGet
75
- * for messages and one for addresses, no matter how many rows share the
76
- * same messageId / sender.
77
- *
78
- * `addressId` is derived deterministically from `(accountConfigId, fromEmail)`
79
- * via `deriveAddressId`, mirroring the write path in
80
- * `body-sync.ts`. Rows without a `fromEmail` (rare; sentinel/system rows)
81
- * contribute no addressId and fall back to `senderTrust: "unknown"`.
82
- */
83
- export interface BatchPlan {
84
- messageIds: string[];
85
- addressIds: string[];
86
- addressIdByRow: Map<string, string>;
87
- }
88
-
89
- export const planBatchFetch = (rows: ThreadMessageItem[]): BatchPlan => {
90
- const messageIds = new Set<string>();
91
- const addressIds = new Set<string>();
92
- const addressIdByRow = new Map<string, string>();
93
-
94
- for (const row of rows) {
95
- messageIds.add(row.messageId);
96
-
97
- if (!row.fromEmail) continue;
98
-
99
- const addressId = deriveAddressId(row.accountConfigId, row.fromEmail);
100
- addressIds.add(addressId);
101
- addressIdByRow.set(row.threadMessageId, addressId);
102
- }
103
-
104
- return {
105
- messageIds: [...messageIds],
106
- addressIds: [...addressIds],
107
- addressIdByRow,
108
- };
109
- };
110
-
111
- /**
112
- * Enrich a page of ThreadMessage rows with `senderTrust` and `muted` (both
113
- * derived from the From Address's flags map), `authenticity`, `autoMoved` and
114
- * `spamReport`, and the `status`/`syncStatus` pair an IMAP mutation leaves
115
- * behind together with the mutation an abandoned one names (all projected
116
- * straight from the Message row — no ThreadMessage
117
- * column of their own, see `deriveAutoMoved`). `toResponse` seeds that pair
118
- * with the ordinary inbound values, which the projection then overwrites; a
119
- * ThreadMessage row whose Message row is missing from the batch is broken in a
120
- * way this read path cannot report, and claiming a mutation it has no evidence
121
- * of would be worse.
122
- *
123
- * `category` is not enriched: it is denormalized onto the ThreadMessage row
124
- * (shared with `Message.category`'s write-once value, see body-sync.ts) and
125
- * carried straight through by `toResponse`, so the value a client renders is
126
- * the value the category filter matched.
127
- *
128
- * Two BatchGetItem calls per page, regardless of page size — see
129
- * `planBatchFetch` for the dedup contract.
130
- *
131
- * Missing rows fall back gracefully: `senderTrust` defaults to `"unknown"`,
132
- * `muted` defaults to `false`, and `authenticity` / `autoMoved` are omitted
133
- * whenever the Message row is absent or the move isn't a real, in-effect
134
- * auto-move.
135
- *
136
- * Not annotated `Promise<ThreadMessageResponse[]>`: `labels` is a new field on
137
- * it in this same PR, and that package publishes separately from this repo —
138
- * an explicit annotation here would contextually type the literal below
139
- * against the currently-*published* shape (which lacks `labels`) and fail
140
- * `check-consumer-typecheck`/`release:dry-run`. Callers assign the (wider,
141
- * inferred) result into an already-typed `ThreadMessageResponse[]` property,
142
- * which is a plain assignability check, not an excess-property one.
143
- */
144
- export const enrichThreadRows = async (
145
- rows: ThreadMessageItem[],
146
- client: EnrichClient,
147
- accountConfigId: string,
148
- ) => {
149
- if (rows.length === 0) return [];
150
-
151
- const plan = planBatchFetch(rows);
152
-
153
- const [messages, addresses, messageLabels, labels] = await Promise.all([
154
- plan.messageIds.length ? client.message.get(plan.messageIds) : [],
155
- plan.addressIds.length
156
- ? client.address.getAddress(accountConfigId, plan.addressIds)
157
- : [],
158
- client.messageLabel.listByMessageIds(plan.messageIds),
159
- client.label.listByAccountConfig(accountConfigId),
160
- ]);
161
-
162
- const labelById = new Map(labels.map((label) => [label.labelId, label]));
163
- const labelsByMessageId = new Map<
164
- string,
165
- { labelId: string; name: string; color: LabelItem["color"] }[]
166
- >();
167
- for (const messageLabel of messageLabels) {
168
- const label = labelById.get(messageLabel.labelId);
169
- if (!label) continue;
170
- const entry = {
171
- labelId: label.labelId,
172
- name: label.name,
173
- color: label.color,
174
- };
175
- const existing = labelsByMessageId.get(messageLabel.messageId);
176
- if (existing) {
177
- existing.push(entry);
178
- } else {
179
- labelsByMessageId.set(messageLabel.messageId, [entry]);
180
- }
181
- }
182
-
183
- const authenticityByMessageId = new Map(
184
- messages.map((m) => [m.messageId, m.authenticity]),
185
- );
186
- const autoMovedByMessageId = new Map(
187
- messages.map((m) => [m.messageId, deriveAutoMoved(m)]),
188
- );
189
- const spamReportByMessageId = new Map(
190
- messages.map((m) => [m.messageId, m.spamReport]),
191
- );
192
- const settlementByMessageId = new Map(
193
- messages.map((m) => [
194
- m.messageId,
195
- {
196
- status: m.status,
197
- syncStatus: m.syncStatus,
198
- abandonedMutation: m.abandonedMutation,
199
- },
200
- ]),
201
- );
202
- const trustByAddressId = new Map(
203
- addresses.map((a) => [a.addressId, deriveSenderTrust(a.flags)]),
204
- );
205
- const mutedByAddressId = new Map(
206
- addresses.map((a) => [a.addressId, deriveMuted(a.flags)]),
207
- );
208
-
209
- return rows.map((row) => {
210
- const base = toResponse(row);
211
- const authenticity = authenticityByMessageId.get(row.messageId);
212
- const autoMoved = autoMovedByMessageId.get(row.messageId);
213
- const spamReport = spamReportByMessageId.get(row.messageId);
214
- const addressId = plan.addressIdByRow.get(row.threadMessageId);
215
- const senderTrust = addressId
216
- ? (trustByAddressId.get(addressId) ?? SenderTrust.Unknown)
217
- : SenderTrust.Unknown;
218
- const muted = addressId
219
- ? (mutedByAddressId.get(addressId) ?? false)
220
- : false;
221
- const labels = labelsByMessageId.get(row.messageId);
222
- const settlement = settlementByMessageId.get(row.messageId);
223
- return {
224
- ...base,
225
- ...(settlement ?? {}),
226
- ...(authenticity !== undefined ? { authenticity } : {}),
227
- ...(autoMoved !== undefined ? { autoMoved } : {}),
228
- ...(labels !== undefined ? { labels } : {}),
229
- ...(spamReport !== undefined ? { spamReport } : {}),
230
- senderTrust,
231
- muted,
232
- };
233
- });
234
- };
@@ -1,126 +0,0 @@
1
- import assert from "node:assert/strict";
2
- import { describe, it } from "node:test";
3
- import type { ThreadMessageResponse } from "@remit/api-openapi-types";
4
- import {
5
- MessageCategory,
6
- MessageMutation,
7
- MessageStatus,
8
- MessageSyncStatus,
9
- SenderTrust,
10
- StarColor,
11
- } from "@remit/domain-enums";
12
- import {
13
- filterByOffRowCriteria,
14
- hasOffRowCriteria,
15
- } from "./filterThreadCriteria.js";
16
-
17
- const row = (
18
- overrides: Partial<ThreadMessageResponse>,
19
- ): ThreadMessageResponse => ({
20
- threadMessageId: "tm",
21
- threadId: "t",
22
- messageId: "m",
23
- accountConfigId: "acc",
24
- mailboxId: "mb",
25
- subject: "s",
26
- fromEmail: "a@example.com",
27
- fromName: "A",
28
- sentDate: 0,
29
- isRead: false,
30
- hasAttachment: false,
31
- hasStars: false,
32
- star: StarColor.None,
33
- isDeleted: false,
34
- snippet: "",
35
- category: MessageCategory.uncategorized,
36
- createdAt: 0,
37
- updatedAt: 0,
38
- senderTrust: SenderTrust.Unknown,
39
- muted: false,
40
- status: MessageStatus.active,
41
- syncStatus: MessageSyncStatus.pending,
42
- abandonedMutation: MessageMutation.none,
43
- ...overrides,
44
- });
45
-
46
- describe("hasOffRowCriteria", () => {
47
- it("is false for an empty criteria object", () => {
48
- assert.equal(hasOffRowCriteria({}), false);
49
- });
50
-
51
- it("is false for empty arrays", () => {
52
- assert.equal(hasOffRowCriteria({ senderTrust: [] }), false);
53
- });
54
-
55
- it("is true when any criterion is set", () => {
56
- assert.equal(hasOffRowCriteria({ senderTrust: [SenderTrust.Vip] }), true);
57
- assert.equal(hasOffRowCriteria({ dkimMismatch: false }), true);
58
- });
59
- });
60
-
61
- describe("filterByOffRowCriteria", () => {
62
- it("returns rows untouched when no criteria are active", () => {
63
- const rows = [row({}), row({})];
64
- assert.equal(filterByOffRowCriteria(rows, {}).length, 2);
65
- });
66
-
67
- it("filters by senderTrust any-of", () => {
68
- const rows = [
69
- row({ senderTrust: SenderTrust.Vip }),
70
- row({ senderTrust: SenderTrust.Wellknown }),
71
- row({ senderTrust: SenderTrust.Unknown }),
72
- ];
73
- const result = filterByOffRowCriteria(rows, {
74
- senderTrust: [SenderTrust.Vip, SenderTrust.Wellknown],
75
- });
76
- assert.equal(result.length, 2);
77
- assert.ok(result.every((r) => r.senderTrust !== SenderTrust.Unknown));
78
- });
79
-
80
- it("leaves category alone — it is a SQL predicate, not an off-row criterion", () => {
81
- const rows = [
82
- row({ category: MessageCategory.newsletter }),
83
- row({ category: MessageCategory.personal }),
84
- ];
85
- assert.equal(filterByOffRowCriteria(rows, {}).length, 2);
86
- });
87
-
88
- it("filters by dkimMismatch and never matches rows lacking an authenticity signal", () => {
89
- const rows = [
90
- row({ authenticity: { fromDomain: "x", dkimMismatch: false } }),
91
- row({ authenticity: { fromDomain: "y", dkimMismatch: true } }),
92
- row({ authenticity: undefined }),
93
- ];
94
- const aligned = filterByOffRowCriteria(rows, { dkimMismatch: false });
95
- assert.equal(aligned.length, 1);
96
- assert.equal(aligned[0].authenticity?.dkimMismatch, false);
97
-
98
- const mismatched = filterByOffRowCriteria(rows, { dkimMismatch: true });
99
- assert.equal(mismatched.length, 1);
100
- assert.equal(mismatched[0].authenticity?.dkimMismatch, true);
101
- });
102
-
103
- it("ANDs criteria together (Rescue shape: trust set + dkim aligned)", () => {
104
- const rows = [
105
- row({
106
- senderTrust: SenderTrust.Vip,
107
- authenticity: { fromDomain: "x", dkimMismatch: false },
108
- }),
109
- row({
110
- senderTrust: SenderTrust.Vip,
111
- authenticity: { fromDomain: "y", dkimMismatch: true },
112
- }),
113
- row({
114
- senderTrust: SenderTrust.Unknown,
115
- authenticity: { fromDomain: "z", dkimMismatch: false },
116
- }),
117
- ];
118
- const result = filterByOffRowCriteria(rows, {
119
- senderTrust: [SenderTrust.Vip, SenderTrust.Wellknown],
120
- dkimMismatch: false,
121
- });
122
- assert.equal(result.length, 1);
123
- assert.equal(result[0].senderTrust, SenderTrust.Vip);
124
- assert.equal(result[0].authenticity?.dkimMismatch, false);
125
- });
126
- });
@@ -1,51 +0,0 @@
1
- import type {
2
- SenderTrust,
3
- ThreadMessageResponse,
4
- } from "@remit/api-openapi-types";
5
-
6
- /**
7
- * Off-row search criteria — fields that live on the underlying Message/Address,
8
- * not on the ThreadMessage row. They are resolved by enriching the windowed
9
- * rows (see enrichThreadRows) and filtering in app code, because no index or
10
- * FilterExpression can serve them.
11
- *
12
- * `senderTrust` derives from AddressItem.flags and `dkimMismatch` from
13
- * MessageItem.authenticity. `category` is not one of these: it is denormalized
14
- * onto the ThreadMessage row and filtered in SQL, inside the window.
15
- */
16
- export interface OffRowCriteria {
17
- senderTrust?: SenderTrust[];
18
- dkimMismatch?: boolean;
19
- }
20
-
21
- export const hasOffRowCriteria = (criteria: OffRowCriteria): boolean =>
22
- Boolean(criteria.senderTrust?.length) || criteria.dkimMismatch !== undefined;
23
-
24
- /**
25
- * Filter enriched rows by the off-row criteria. Each active criterion is an
26
- * any-of set (AND across criteria, OR within a set). A row with no
27
- * `authenticity` signal never matches a `dkimMismatch` filter (absence means no
28
- * signal, not a verdict).
29
- */
30
- export const filterByOffRowCriteria = (
31
- rows: ThreadMessageResponse[],
32
- criteria: OffRowCriteria,
33
- ): ThreadMessageResponse[] => {
34
- if (!hasOffRowCriteria(criteria)) return rows;
35
-
36
- const trustSet = criteria.senderTrust?.length
37
- ? new Set(criteria.senderTrust)
38
- : undefined;
39
- const { dkimMismatch } = criteria;
40
-
41
- return rows.filter((row) => {
42
- if (trustSet && !trustSet.has(row.senderTrust)) return false;
43
- if (
44
- dkimMismatch !== undefined &&
45
- row.authenticity?.dkimMismatch !== dkimMismatch
46
- ) {
47
- return false;
48
- }
49
- return true;
50
- });
51
- };
@@ -1,67 +0,0 @@
1
- import assert from "node:assert/strict";
2
- import { describe, it } from "node:test";
3
- import type { AddressFlags } from "@remit/api-openapi-types";
4
- import { deriveSenderTrust } from "./senderTrust.js";
5
-
6
- // AddressFlagBase requires setAt; deriveSenderTrust only reads `value`, so the
7
- // timestamp value is irrelevant to these assertions.
8
- const SET_AT = 1_700_000_000_000;
9
-
10
- describe("deriveSenderTrust", () => {
11
- it("returns 'unknown' when flags is undefined", () => {
12
- assert.equal(deriveSenderTrust(undefined), "unknown");
13
- });
14
-
15
- it("returns 'unknown' for an empty flags object", () => {
16
- assert.equal(deriveSenderTrust({}), "unknown");
17
- });
18
-
19
- it("returns 'unknown' when wellknown.value is false", () => {
20
- const flags: AddressFlags = { wellknown: { value: false, setAt: SET_AT } };
21
- assert.equal(deriveSenderTrust(flags), "unknown");
22
- });
23
-
24
- it("returns 'wellknown' when wellknown.value is true", () => {
25
- const flags: AddressFlags = { wellknown: { value: true, setAt: SET_AT } };
26
- assert.equal(deriveSenderTrust(flags), "wellknown");
27
- });
28
-
29
- it("returns 'vip' when vip.value is true", () => {
30
- const flags: AddressFlags = { vip: { value: true, setAt: SET_AT } };
31
- assert.equal(deriveSenderTrust(flags), "vip");
32
- });
33
-
34
- it("returns 'unknown' when vip.value is false", () => {
35
- const flags: AddressFlags = { vip: { value: false, setAt: SET_AT } };
36
- assert.equal(deriveSenderTrust(flags), "unknown");
37
- });
38
-
39
- it("vip wins over wellknown when both are true", () => {
40
- const flags: AddressFlags = {
41
- vip: { value: true, setAt: SET_AT },
42
- wellknown: { value: true, setAt: SET_AT },
43
- };
44
- assert.equal(deriveSenderTrust(flags), "vip");
45
- });
46
-
47
- it("falls back to wellknown when vip is false but wellknown is true", () => {
48
- const flags: AddressFlags = {
49
- vip: { value: false, setAt: SET_AT },
50
- wellknown: { value: true, setAt: SET_AT },
51
- };
52
- assert.equal(deriveSenderTrust(flags), "wellknown");
53
- });
54
-
55
- it("ignores trusted flag (orthogonal axis)", () => {
56
- const flags: AddressFlags = { trusted: { value: true, setAt: SET_AT } };
57
- assert.equal(deriveSenderTrust(flags), "unknown");
58
- });
59
-
60
- it("ignores trusted even when wellknown is also set", () => {
61
- const flags: AddressFlags = {
62
- trusted: { value: true, setAt: SET_AT },
63
- wellknown: { value: true, setAt: SET_AT },
64
- };
65
- assert.equal(deriveSenderTrust(flags), "wellknown");
66
- });
67
- });
package/src/error.test.ts DELETED
@@ -1,201 +0,0 @@
1
- import assert from "node:assert/strict";
2
- import { describe, it } from "node:test";
3
- import type { ApiError, FolderRoleConflict } from "@remit/api-openapi-types";
4
- import {
5
- BadRequestError,
6
- ClientError,
7
- ConflictError,
8
- FolderRoleUnresolvedError,
9
- ForbiddenError,
10
- NotFoundError,
11
- UnhandledError,
12
- UnrecoverableBodyError,
13
- } from "@remit/data-ports/errors";
14
- import { NO_TRASH_FOLDER_REASON } from "@remit/data-ports/folder-role";
15
- import { CanonicalMailboxRole } from "@remit/domain-enums";
16
- import { NoTrashMailboxError } from "@remit/mailbox-service";
17
- import { handleError } from "./error.js";
18
-
19
- const parseBody = (body: string): Record<string, unknown> =>
20
- JSON.parse(body) as Record<string, unknown>;
21
-
22
- // One shape for every error the API answers with (issue #371): flat, always a
23
- // `code`, always a `message`. A status class that reaches a client without a
24
- // code leaves it branching on prose.
25
- describe("the wire shape of a refusal, per status class", () => {
26
- const cases: ReadonlyArray<[string, Error, number, string]> = [
27
- [
28
- "400",
29
- new BadRequestError("confirmEmail is required"),
30
- 400,
31
- "invalid_request",
32
- ],
33
- ["401", new ClientError("Session expired"), 401, "unauthorized"],
34
- ["403", new ForbiddenError("Not your account"), 403, "forbidden"],
35
- ["404", new NotFoundError("Mailbox not found: mb-1"), 404, "not_found"],
36
- [
37
- "409",
38
- new ConflictError("An update is already in progress."),
39
- 409,
40
- "conflict",
41
- ],
42
- [
43
- "422",
44
- new UnrecoverableBodyError("This message's body could not be read."),
45
- 422,
46
- "unprocessable_entity",
47
- ],
48
- ];
49
-
50
- for (const [name, error, statusCode, code] of cases) {
51
- it(`answers ${name} with a flat code and message`, async () => {
52
- const response = await handleError(error);
53
-
54
- assert.equal(response.statusCode, statusCode);
55
- assert.deepEqual(parseBody(response.body), {
56
- code,
57
- message: error.message,
58
- });
59
- });
60
- }
61
-
62
- // A 5xx is the one class whose message is not the thrower's. Those sentences
63
- // are written for a log line and name hosts, queries and ids; the correlation
64
- // id on the response is how the real one is found.
65
- it("answers 500 with one code and one sentence, never the thrower's", async () => {
66
- const response = await handleError(
67
- new UnhandledError(
68
- "pg://reader@db-3.internal:5432 timed out on SELECT * FROM message",
69
- ),
70
- );
71
-
72
- assert.equal(response.statusCode, 500);
73
- assert.deepEqual(parseBody(response.body), {
74
- code: "internal_error",
75
- message: "Internal server error",
76
- });
77
- });
78
-
79
- it("types every one of those bodies as the declared ApiError", async () => {
80
- const response = await handleError(new NotFoundError("Gone"));
81
- const body: ApiError = JSON.parse(response.body);
82
-
83
- assert.equal(body.code, "not_found");
84
- assert.equal(body.message, "Gone");
85
- });
86
- });
87
-
88
- describe("handleError coded refusals", () => {
89
- it("puts the code and every detail of a folder-role 409 on the wire", async () => {
90
- const response = await handleError(
91
- new FolderRoleUnresolvedError(
92
- "The folder you chose for Trash is gone.",
93
- CanonicalMailboxRole.Trash,
94
- "stale",
95
- "account-7",
96
- ),
97
- );
98
-
99
- assert.equal(response.statusCode, 409);
100
- assert.deepEqual(parseBody(response.body), {
101
- message: "The folder you chose for Trash is gone.",
102
- code: "folder_role_unresolved",
103
- details: { role: "Trash", reason: "stale", accountId: "account-7" },
104
- });
105
- });
106
-
107
- it("carries NoTrashMailboxError as the Trash role with reason none", async () => {
108
- const response = await handleError(new NoTrashMailboxError("account-7"));
109
-
110
- assert.equal(response.statusCode, 409);
111
- assert.deepEqual(parseBody(response.body), {
112
- message: NO_TRASH_FOLDER_REASON,
113
- code: "folder_role_unresolved",
114
- details: { role: "Trash", reason: "none", accountId: "account-7" },
115
- });
116
- });
117
-
118
- it("keeps an unhandled 500 to a code and a message — no stack, no cause, no details", async () => {
119
- const response = await handleError(
120
- new UnhandledError("Something went wrong", new Error("connection reset")),
121
- );
122
-
123
- assert.equal(response.statusCode, 500);
124
- assert.deepEqual(parseBody(response.body), {
125
- code: "internal_error",
126
- message: "Internal server error",
127
- });
128
- });
129
-
130
- it("replaces a code a 5xx should never have carried, and drops its details", async () => {
131
- const error = new UnhandledError("Something went wrong");
132
- error.publicApiError = {
133
- code: "folder_role_unresolved",
134
- details: { role: "Trash", reason: "none", accountId: "account-7" },
135
- };
136
-
137
- const response = await handleError(error);
138
-
139
- assert.equal(response.statusCode, 500);
140
- assert.deepEqual(parseBody(response.body), {
141
- code: "internal_error",
142
- message: "Internal server error",
143
- });
144
- });
145
-
146
- it("keeps an infrastructure failure to the generic message and code", async () => {
147
- const error = Object.assign(
148
- new Error("aws-error: ProvisionedThroughputExceeded on remit-main"),
149
- { name: "ElectroError" },
150
- );
151
-
152
- const response = await handleError(error);
153
-
154
- assert.equal(response.statusCode, 500);
155
- assert.deepEqual(parseBody(response.body), {
156
- code: "internal_error",
157
- message: "Database temporarily unavailable",
158
- });
159
- });
160
-
161
- it("answers a malformed query as a 400 with the query's own message", async () => {
162
- const error = Object.assign(new Error("Invalid attribute: sentDate"), {
163
- name: "ElectroError",
164
- });
165
-
166
- const response = await handleError(error);
167
-
168
- assert.equal(response.statusCode, 400);
169
- assert.deepEqual(parseBody(response.body), {
170
- code: "invalid_request",
171
- message: "Invalid attribute: sentDate",
172
- });
173
- });
174
-
175
- // The contract and the emitter cannot drift apart: this asserts the response
176
- // `handleError` actually builds against the generated model. Nesting the body
177
- // under `error` again would leave `code` off `keyof FolderRoleConflict` and
178
- // fail to compile here, long before a client reads a 409 it cannot parse.
179
- it("matches the generated FolderRoleConflict model field for field", async () => {
180
- const response = await handleError(
181
- new FolderRoleUnresolvedError(
182
- "Nobody has confirmed a Trash folder.",
183
- CanonicalMailboxRole.Trash,
184
- "unconfirmed",
185
- "account-7",
186
- ),
187
- );
188
- const body: Omit<FolderRoleConflict, "statusCode"> = JSON.parse(
189
- response.body,
190
- );
191
- const declaredFields: ReadonlyArray<keyof typeof body> = [
192
- "code",
193
- "details",
194
- "message",
195
- ];
196
-
197
- assert.equal(response.statusCode, 409);
198
- assert.deepEqual(Object.keys(body).sort(), [...declaredFields].sort());
199
- assert.equal(body.code, "folder_role_unresolved");
200
- });
201
- });