@remit/backend 0.0.142 → 0.0.144

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 (269) 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 +7 -0
  4. package/dist/src/api.js +144 -0
  5. package/dist/src/auth.d.ts +30 -0
  6. package/dist/src/auth.js +73 -0
  7. package/dist/src/config/msoauth.d.ts +30 -0
  8. package/dist/src/config/msoauth.js +30 -0
  9. package/{src/data-backend.ts → dist/src/data-backend.d.ts} +2 -4
  10. package/dist/src/data-backend.js +12 -0
  11. package/{src/derive/autoMoved.ts → dist/src/derive/autoMoved.d.ts} +1 -29
  12. package/dist/src/derive/autoMoved.js +49 -0
  13. package/dist/src/derive/contentSignature.d.ts +41 -0
  14. package/{src/derive/contentSignature.ts → dist/src/derive/contentSignature.js} +27 -72
  15. package/dist/src/derive/contentUrl.d.ts +46 -0
  16. package/dist/src/derive/contentUrl.js +46 -0
  17. package/{src/derive/deriveMuted.ts → dist/src/derive/deriveMuted.d.ts} +1 -3
  18. package/dist/src/derive/deriveMuted.js +7 -0
  19. package/dist/src/derive/enrichThreadRows.d.ts +118 -0
  20. package/dist/src/derive/enrichThreadRows.js +151 -0
  21. package/dist/src/derive/filterThreadCriteria.d.ts +23 -0
  22. package/dist/src/derive/filterThreadCriteria.js +24 -0
  23. package/{src/derive/pendingMoveCounts.ts → dist/src/derive/pendingMoveCounts.d.ts} +5 -53
  24. package/dist/src/derive/pendingMoveCounts.js +53 -0
  25. package/{src/derive/senderTrust.ts → dist/src/derive/senderTrust.d.ts} +1 -9
  26. package/dist/src/derive/senderTrust.js +19 -0
  27. package/dist/src/error.d.ts +21 -0
  28. package/dist/src/error.js +85 -0
  29. package/dist/src/handlers/account-guards.d.ts +36 -0
  30. package/dist/src/handlers/account-guards.js +107 -0
  31. package/dist/src/handlers/account-oauth.d.ts +14 -0
  32. package/dist/src/handlers/account-oauth.js +387 -0
  33. package/dist/src/handlers/account-overrides.d.ts +53 -0
  34. package/dist/src/handlers/account-overrides.js +233 -0
  35. package/dist/src/handlers/account-signature.d.ts +28 -0
  36. package/dist/src/handlers/account-signature.js +85 -0
  37. package/dist/src/handlers/account.d.ts +6 -0
  38. package/dist/src/handlers/account.js +350 -0
  39. package/dist/src/handlers/address.d.ts +35 -0
  40. package/dist/src/handlers/address.js +141 -0
  41. package/dist/src/handlers/calendar-event.d.ts +70 -0
  42. package/dist/src/handlers/calendar-event.js +425 -0
  43. package/dist/src/handlers/calendar-feed.d.ts +47 -0
  44. package/dist/src/handlers/calendar-feed.js +192 -0
  45. package/dist/src/handlers/calendar-suggestion.d.ts +47 -0
  46. package/dist/src/handlers/calendar-suggestion.js +212 -0
  47. package/dist/src/handlers/calendar.d.ts +116 -0
  48. package/dist/src/handlers/calendar.js +330 -0
  49. package/dist/src/handlers/config.d.ts +43 -0
  50. package/dist/src/handlers/config.js +176 -0
  51. package/dist/src/handlers/ensure-account-config.d.ts +9 -0
  52. package/dist/src/handlers/ensure-account-config.js +27 -0
  53. package/dist/src/handlers/filter.d.ts +3 -0
  54. package/dist/src/handlers/filter.js +103 -0
  55. package/dist/src/handlers/folder-role-appointments.d.ts +68 -0
  56. package/dist/src/handlers/folder-role-appointments.js +168 -0
  57. package/dist/src/handlers/folder-role-labels.d.ts +26 -0
  58. package/dist/src/handlers/folder-role-labels.js +40 -0
  59. package/dist/src/handlers/folder-role.d.ts +9 -0
  60. package/dist/src/handlers/folder-role.js +40 -0
  61. package/dist/src/handlers/index.d.ts +2 -0
  62. package/dist/src/handlers/index.js +60 -0
  63. package/dist/src/handlers/label.d.ts +43 -0
  64. package/dist/src/handlers/label.js +114 -0
  65. package/dist/src/handlers/mailbox-bindings.d.ts +41 -0
  66. package/dist/src/handlers/mailbox-bindings.js +61 -0
  67. package/dist/src/handlers/mailbox.d.ts +23 -0
  68. package/dist/src/handlers/mailbox.js +219 -0
  69. package/dist/src/handlers/me.d.ts +2 -0
  70. package/dist/src/handlers/me.js +138 -0
  71. package/dist/src/handlers/message.d.ts +84 -0
  72. package/dist/src/handlers/message.js +607 -0
  73. package/dist/src/handlers/organize.d.ts +10 -0
  74. package/dist/src/handlers/organize.js +112 -0
  75. package/dist/src/handlers/outbox-attachment.d.ts +23 -0
  76. package/dist/src/handlers/outbox-attachment.js +81 -0
  77. package/dist/src/handlers/outbox.d.ts +4 -0
  78. package/dist/src/handlers/outbox.js +144 -0
  79. package/dist/src/handlers/sync-progress.d.ts +46 -0
  80. package/dist/src/handlers/sync-progress.js +63 -0
  81. package/dist/src/handlers/sync.d.ts +28 -0
  82. package/dist/src/handlers/sync.js +82 -0
  83. package/dist/src/handlers/system-update.d.ts +2 -0
  84. package/dist/src/handlers/system-update.js +172 -0
  85. package/dist/src/handlers/thread.d.ts +148 -0
  86. package/dist/src/handlers/thread.js +233 -0
  87. package/dist/src/handlers/unified-threads.d.ts +247 -0
  88. package/dist/src/handlers/unified-threads.js +409 -0
  89. package/{src/handlers/vip-suggestions.ts → dist/src/handlers/vip-suggestions.d.ts} +1 -13
  90. package/dist/src/handlers/vip-suggestions.js +16 -0
  91. package/dist/src/index.d.ts +2 -0
  92. package/dist/src/index.js +37 -0
  93. package/{src/json.ts → dist/src/json.d.ts} +1 -4
  94. package/dist/src/json.js +10 -0
  95. package/dist/src/jwt-auth.d.ts +18 -0
  96. package/dist/src/jwt-auth.js +97 -0
  97. package/dist/src/request-context.d.ts +9 -0
  98. package/dist/src/request-context.js +22 -0
  99. package/dist/src/request.d.ts +3 -0
  100. package/dist/src/request.js +7 -0
  101. package/dist/src/response.d.ts +27 -0
  102. package/dist/src/response.js +87 -0
  103. package/dist/src/service/account-deletion.d.ts +22 -0
  104. package/dist/src/service/account-deletion.js +39 -0
  105. package/dist/src/service/compose-sqlite.d.ts +2 -0
  106. package/dist/src/service/compose-sqlite.js +11 -0
  107. package/dist/src/service/create-remit-client.d.ts +95 -0
  108. package/dist/src/service/create-remit-client.js +207 -0
  109. package/dist/src/service/data-client.d.ts +12 -0
  110. package/dist/src/service/data-client.js +44 -0
  111. package/dist/src/service/export-identity.d.ts +3 -0
  112. package/dist/src/service/export-identity.js +35 -0
  113. package/dist/src/service/fire-and-forget.d.ts +54 -0
  114. package/dist/src/service/fire-and-forget.js +38 -0
  115. package/dist/src/service/organize.d.ts +184 -0
  116. package/dist/src/service/organize.js +384 -0
  117. package/dist/src/service/refusal.d.ts +4 -0
  118. package/dist/src/service/refusal.js +20 -0
  119. package/dist/src/service/sender-category.d.ts +51 -0
  120. package/{src/service/sender-category.ts → dist/src/service/sender-category.js} +40 -81
  121. package/dist/src/service/sqs.d.ts +1 -0
  122. package/{src/service/sqs.ts → dist/src/service/sqs.js} +0 -1
  123. package/dist/src/service/trigger-sync.d.ts +51 -0
  124. package/dist/src/service/trigger-sync.js +39 -0
  125. package/dist/src/types.d.ts +49 -0
  126. package/dist/src/types.js +1 -0
  127. package/package.json +113 -98
  128. package/.env.test +0 -4
  129. package/dev-server/content-auth.test.ts +0 -113
  130. package/dev-server/content-auth.ts +0 -54
  131. package/dev-server/content-handler.test.ts +0 -105
  132. package/dev-server/content-handler.ts +0 -79
  133. package/dev-server/content-path.test.ts +0 -37
  134. package/dev-server/content-path.ts +0 -27
  135. package/dev-server/cors.test.ts +0 -48
  136. package/dev-server/cors.ts +0 -25
  137. package/dev-server/keep-alive.test.ts +0 -24
  138. package/dev-server/lambda-helpers.ts +0 -69
  139. package/dev-server/log-output.test.ts +0 -173
  140. package/dev-server/oauth-callback-route.test.ts +0 -66
  141. package/dev-server/relational-health.test.ts +0 -83
  142. package/dev-server/relational-health.ts +0 -39
  143. package/dev-server/server.ts +0 -384
  144. package/dev-server/sync-age.test.ts +0 -91
  145. package/dev-server/sync-age.ts +0 -55
  146. package/dev-server/upload-handler.ts +0 -132
  147. package/dev-server/upload-route.test.ts +0 -196
  148. package/scripts/backfill-classification.ts +0 -91
  149. package/scripts/backfill-list-id.ts +0 -83
  150. package/scripts/config-save.ts +0 -128
  151. package/src/auth.test.ts +0 -12
  152. package/src/auth.ts +0 -92
  153. package/src/config/msoauth.test.ts +0 -48
  154. package/src/config/msoauth.ts +0 -48
  155. package/src/data-backend.test.ts +0 -23
  156. package/src/derive/autoMoved.test.ts +0 -104
  157. package/src/derive/contentSignature.test.ts +0 -161
  158. package/src/derive/contentUrl.test.ts +0 -172
  159. package/src/derive/contentUrl.ts +0 -86
  160. package/src/derive/deriveMuted.test.ts +0 -34
  161. package/src/derive/enrichThreadRows.test.ts +0 -360
  162. package/src/derive/enrichThreadRows.ts +0 -234
  163. package/src/derive/filterThreadCriteria.test.ts +0 -126
  164. package/src/derive/filterThreadCriteria.ts +0 -51
  165. package/src/derive/senderTrust.test.ts +0 -67
  166. package/src/error.test.ts +0 -201
  167. package/src/error.ts +0 -123
  168. package/src/handlers/account-guards.test.ts +0 -67
  169. package/src/handlers/account-guards.ts +0 -169
  170. package/src/handlers/account-oauth-callback.test.ts +0 -155
  171. package/src/handlers/account-oauth-consent.test.ts +0 -336
  172. package/src/handlers/account-oauth-start.test.ts +0 -191
  173. package/src/handlers/account-oauth.test.ts +0 -439
  174. package/src/handlers/account-oauth.ts +0 -635
  175. package/src/handlers/account-overrides.test.ts +0 -88
  176. package/src/handlers/account-overrides.ts +0 -323
  177. package/src/handlers/account-ownership.ts +0 -25
  178. package/src/handlers/account-signature.ts +0 -117
  179. package/src/handlers/account-synced-services.test.ts +0 -245
  180. package/src/handlers/account.ts +0 -552
  181. package/src/handlers/address.test.ts +0 -381
  182. package/src/handlers/address.ts +0 -200
  183. package/src/handlers/calendar-event.test.ts +0 -685
  184. package/src/handlers/calendar-event.ts +0 -738
  185. package/src/handlers/calendar-feed-validators.test.ts +0 -228
  186. package/src/handlers/calendar-feed.test.ts +0 -439
  187. package/src/handlers/calendar-feed.ts +0 -291
  188. package/src/handlers/calendar-sqlite-fixture.ts +0 -36
  189. package/src/handlers/calendar-suggestion.test.ts +0 -1269
  190. package/src/handlers/calendar-suggestion.ts +0 -425
  191. package/src/handlers/calendar.test.ts +0 -1080
  192. package/src/handlers/calendar.ts +0 -517
  193. package/src/handlers/config.test.ts +0 -245
  194. package/src/handlers/config.ts +0 -332
  195. package/src/handlers/ensure-account-config.ts +0 -30
  196. package/src/handlers/filter.test.ts +0 -644
  197. package/src/handlers/filter.ts +0 -518
  198. package/src/handlers/folder-role-appointments.test.ts +0 -438
  199. package/src/handlers/folder-role-appointments.ts +0 -249
  200. package/src/handlers/folder-role-labels.ts +0 -63
  201. package/src/handlers/folder-role.test.ts +0 -209
  202. package/src/handlers/folder-role.ts +0 -80
  203. package/src/handlers/index.ts +0 -83
  204. package/src/handlers/label.test.ts +0 -112
  205. package/src/handlers/label.ts +0 -210
  206. package/src/handlers/mailbox-bindings.ts +0 -111
  207. package/src/handlers/mailbox-rename-refusal.test.ts +0 -247
  208. package/src/handlers/mailbox-settled-target.test.ts +0 -251
  209. package/src/handlers/mailbox.test.ts +0 -280
  210. package/src/handlers/mailbox.ts +0 -581
  211. package/src/handlers/me.test.ts +0 -81
  212. package/src/handlers/me.ts +0 -203
  213. package/src/handlers/message-read-backfill.test.ts +0 -103
  214. package/src/handlers/message.test.ts +0 -131
  215. package/src/handlers/message.ts +0 -1131
  216. package/src/handlers/organize.test.ts +0 -277
  217. package/src/handlers/organize.ts +0 -197
  218. package/src/handlers/outbox-attachment.test.ts +0 -765
  219. package/src/handlers/outbox-attachment.ts +0 -126
  220. package/src/handlers/outbox-list.test.ts +0 -179
  221. package/src/handlers/outbox.test.ts +0 -772
  222. package/src/handlers/outbox.ts +0 -258
  223. package/src/handlers/search.test.ts +0 -161
  224. package/src/handlers/search.ts +0 -105
  225. package/src/handlers/sync-progress.test.ts +0 -205
  226. package/src/handlers/sync-progress.ts +0 -99
  227. package/src/handlers/sync.test.ts +0 -168
  228. package/src/handlers/sync.ts +0 -118
  229. package/src/handlers/system-update.test.ts +0 -497
  230. package/src/handlers/system-update.ts +0 -230
  231. package/src/handlers/thread.test.ts +0 -396
  232. package/src/handlers/thread.ts +0 -427
  233. package/src/handlers/unified-threads-mail-sources.sqlite.test.ts +0 -197
  234. package/src/handlers/unified-threads.test.ts +0 -785
  235. package/src/handlers/unified-threads.ts +0 -669
  236. package/src/index.test.ts +0 -83
  237. package/src/index.ts +0 -228
  238. package/src/jwt-auth.test.ts +0 -152
  239. package/src/jwt-auth.ts +0 -132
  240. package/src/log-redaction.test.ts +0 -144
  241. package/src/openapi-spec.test.ts +0 -118
  242. package/src/request-context.test.ts +0 -61
  243. package/src/request-context.ts +0 -33
  244. package/src/request-pipeline.test.ts +0 -88
  245. package/src/request.ts +0 -10
  246. package/src/response.test.ts +0 -130
  247. package/src/response.ts +0 -144
  248. package/src/service/compose-sqlite.ts +0 -98
  249. package/src/service/config-import.ts +0 -39
  250. package/src/service/create-remit-client.ts +0 -521
  251. package/src/service/data-client.test.ts +0 -97
  252. package/src/service/data-client.ts +0 -58
  253. package/src/service/export-identity.ts +0 -39
  254. package/src/service/filter.ts +0 -40
  255. package/src/service/fire-and-forget.test.ts +0 -126
  256. package/src/service/fire-and-forget.ts +0 -79
  257. package/src/service/localhost-env-config.test.ts +0 -36
  258. package/src/service/organize-queue.ts +0 -98
  259. package/src/service/organize.test.ts +0 -1451
  260. package/src/service/organize.ts +0 -1025
  261. package/src/service/read-path-filter-config.test.ts +0 -243
  262. package/src/service/semantic-capability.test.ts +0 -78
  263. package/src/service/semantic-capability.ts +0 -95
  264. package/src/service/sender-category.test.ts +0 -235
  265. package/src/service/trigger-sync.test.ts +0 -205
  266. package/src/service/trigger-sync.ts +0 -100
  267. package/src/stdout-capture-fixture.ts +0 -40
  268. package/src/types.ts +0 -271
  269. package/tsconfig.json +0 -7
@@ -1,169 +0,0 @@
1
- import type {
2
- AccountResponse,
3
- AccountService as AccountServiceName,
4
- FolderAppointment,
5
- } from "@remit/api-openapi-types";
6
- import type { AccountItem } from "@remit/data-ports";
7
- import { BadRequestError, ConflictError } from "@remit/data-ports/errors";
8
- import { AccountAuthType, AccountService } from "@remit/domain-enums";
9
- import {
10
- microsoftServicesGranted,
11
- orderServices,
12
- } from "@remit/mail-oauth-service";
13
- import type { AccountOverrides } from "./account-overrides.js";
14
- import type { AccountSignature } from "./account-signature.js";
15
-
16
- /**
17
- * Natural key identifying "the same mailbox in the same place" within an
18
- * account config. IMAP host and login username are both case-insensitive, so we
19
- * fold to lowercase before comparing. Used as the explicit server-side
20
- * uniqueness key now that message identity is account-scoped (entropy per
21
- * onboard) and no longer incidentally dedups duplicate onboards (#633/#635).
22
- */
23
- export interface MailboxNaturalKey {
24
- imapHost: string;
25
- username: string;
26
- }
27
-
28
- const mailboxKeyOf = (key: MailboxNaturalKey): string =>
29
- `${key.imapHost.toLowerCase()}\u0000${key.username.toLowerCase()}`;
30
-
31
- /**
32
- * Find an existing ACTIVE (non-deleted) account that occupies the same
33
- * mailbox-in-the-same-place as `key`. Soft-deleted accounts are ignored so a
34
- * re-onboard after delete still succeeds.
35
- *
36
- * Callers pass the accounts already scoped to one account config (the natural
37
- * key's accountConfigId component), so this only matches on host + username.
38
- */
39
- export const findActiveDuplicateMailbox = (
40
- existing: AccountItem[],
41
- key: MailboxNaturalKey,
42
- ): AccountItem | undefined => {
43
- const target = mailboxKeyOf(key);
44
- return existing.find(
45
- (account) =>
46
- !account.deletedAt &&
47
- mailboxKeyOf({
48
- imapHost: account.imapHost,
49
- username: account.username,
50
- }) === target,
51
- );
52
- };
53
-
54
- /**
55
- * Reject the create when an active account already onboards the same mailbox in
56
- * the same place. Surfaces as a typed 409 ConflictError so the web-client can
57
- * show a "already added" message instead of silently creating a duplicate.
58
- */
59
- export const assertNoDuplicateMailbox = (
60
- existing: AccountItem[],
61
- key: MailboxNaturalKey,
62
- ): void => {
63
- const duplicate = findActiveDuplicateMailbox(existing, key);
64
- if (!duplicate) return;
65
- throw new ConflictError(
66
- `An account for ${key.username} on ${key.imapHost} already exists`,
67
- );
68
- };
69
-
70
- /** Rejects OAuth accounts that must go through the dedicated connect flow. */
71
- export const assertNotOAuthCreate = (authType: string | undefined): void => {
72
- if (authType === AccountAuthType.OauthMicrosoft) {
73
- throw new BadRequestError(
74
- "OAuth accounts must be created via the OAuth connect flow (POST /accounts/oauth/microsoft/start)",
75
- );
76
- }
77
- };
78
-
79
- /** Rejects password-auth account creation when no password is supplied. */
80
- export const assertPasswordProvided = (
81
- authType: string | undefined,
82
- password: string | undefined,
83
- ): void => {
84
- const isPasswordAuth = authType === AccountAuthType.Password || !authType;
85
- if (isPasswordAuth && !password) {
86
- throw new BadRequestError(
87
- "password is required when authType is 'password' (or when authType is omitted)",
88
- );
89
- }
90
- };
91
-
92
- export const resolveSyncedServices = (
93
- account: Pick<AccountItem, "authType" | "grantedScopes">,
94
- requested: readonly AccountServiceName[],
95
- ): AccountServiceName[] => {
96
- const services = orderServices(requested);
97
- if (services.length === 0) {
98
- throw new BadRequestError(
99
- "syncedServices must name at least one service. To stop syncing an account entirely, delete it with DELETE /accounts/{accountId}.",
100
- );
101
- }
102
- if (account.authType !== AccountAuthType.OauthMicrosoft) {
103
- if (services.some((service) => service !== AccountService.Mail)) {
104
- throw new BadRequestError(
105
- `A password account syncs mail only, so syncedServices must be ["${AccountService.Mail}"].`,
106
- );
107
- }
108
- return services;
109
- }
110
- const granted = microsoftServicesGranted(account.grantedScopes);
111
- const uncovered = services.filter((service) => !granted.includes(service));
112
- if (uncovered.length > 0) {
113
- throw new BadRequestError(
114
- `This account's granted scopes lack ${uncovered.join(", ")}. Consent to them through POST /accounts/oauth/microsoft/start with services ${JSON.stringify(services)}, then sign in to Microsoft again.`,
115
- );
116
- }
117
- return services;
118
- };
119
-
120
- // SECURITY: passwordHash, oauthRefreshTokenHash, and smtpPasswordHash are
121
- // intentionally omitted — never expose token material in API responses.
122
- // Display name, mute flag, and signatures live in per-account AccountSetting
123
- // rows (RFC 032); the caller resolves them and passes them in. Absent means the
124
- // override is unset. `folderAppointments` (RFC 032 exclusive-folder-appointment,
125
- // #976) is resolved the same way — persisted rows merged with server-proposed
126
- // defaults for any unfilled role — via `resolveFolderAppointments`.
127
- export const toAccountResponse = (
128
- account: AccountItem,
129
- signature: AccountSignature = {},
130
- overrides: AccountOverrides = {},
131
- folderAppointments: FolderAppointment[] = [],
132
- ): AccountResponse => ({
133
- accountId: account.accountId,
134
- accountConfigId: account.accountConfigId,
135
- displayName: overrides.displayName,
136
- username: account.username,
137
- email: account.email,
138
- authType: account.authType ?? AccountAuthType.Password,
139
- syncedServices: account.syncedServices,
140
- grantedScopes: account.grantedScopes,
141
- imapHost: account.imapHost,
142
- imapPort: account.imapPort,
143
- imapTls: account.imapTls,
144
- imapStartTls: account.imapStartTls,
145
- // RFC 032 Tier 2: SMTP config is total. ElectroDB `default` applies on write
146
- // only, so rows written before this change still lack these attributes —
147
- // coalesce to the schema defaults on read so the response is always complete.
148
- smtpEnabled: account.smtpEnabled ?? false,
149
- smtpHost: account.smtpHost ?? "",
150
- smtpPort: account.smtpPort ?? 587,
151
- smtpTls: account.smtpTls ?? false,
152
- smtpStartTls: account.smtpStartTls ?? true,
153
- smtpUsername: account.smtpUsername ?? "",
154
- signaturePlainText: signature.plainText,
155
- signatureHtml: signature.html,
156
- composeLanguages: overrides.composeLanguages,
157
- isActive: account.isActive,
158
- connectionState: account.connectionState,
159
- lastConnectedAt: account.lastConnectedAt,
160
- lastSyncAt: account.lastSyncAt,
161
- lastError: account.lastError,
162
- syncPhase: account.syncPhase,
163
- mailboxCountTotal: account.mailboxCountTotal,
164
- mailboxCountSynced: account.mailboxCountSynced,
165
- muted: overrides.muted,
166
- createdAt: account.createdAt,
167
- updatedAt: account.updatedAt,
168
- folderAppointments,
169
- });
@@ -1,155 +0,0 @@
1
- /**
2
- * The browser Microsoft sends back, and where it ends up.
3
- *
4
- * The callback answers a redirect, so the whole response is its Location
5
- * header: an answer that arrives without it is a blank page with the account
6
- * either connected or not and no way to tell. Driven through the real OpenAPI
7
- * document and the self-host request path, so what is asserted is what a
8
- * self-hosted deployment writes onto the wire — the header included, which a
9
- * handler returning a bare `{statusCode, headers}` shape lost on the way out.
10
- */
11
-
12
- import assert from "node:assert/strict";
13
- import { randomUUID } from "node:crypto";
14
- import { createServer, type Server } from "node:http";
15
- import type { AddressInfo } from "node:net";
16
- import { after, before, describe, it } from "node:test";
17
- import { AccountService } from "@remit/domain-enums";
18
- import type { APIGatewayProxyEvent, APIGatewayProxyResult } from "aws-lambda";
19
- import {
20
- _resetForTest,
21
- type RemitClient,
22
- setClient,
23
- } from "../service/data-client.js";
24
- import { signState } from "./account-oauth.js";
25
- import { createCalendarSqliteClient } from "./calendar-sqlite-fixture.js";
26
-
27
- const CLIENT_SECRET = "callback-test-client-secret";
28
- const WEB_ORIGIN = "https://mail.example.com";
29
- const CALLBACK_PATH = "/accounts/oauth/microsoft/callback";
30
-
31
- let handler: (
32
- event: APIGatewayProxyEvent,
33
- context: unknown,
34
- ) => Promise<APIGatewayProxyResult>;
35
- let client: RemitClient;
36
- let cleanup: () => void;
37
- let tokenEndpoint: Server;
38
-
39
- const jwt = (claims: Record<string, unknown>): string =>
40
- [
41
- Buffer.from(JSON.stringify({ alg: "RS256" })).toString("base64url"),
42
- Buffer.from(JSON.stringify(claims), "utf8").toString("base64url"),
43
- "signature-not-checked-here",
44
- ].join(".");
45
-
46
- /** Microsoft's token endpoint, close enough for the one call the callback makes. */
47
- const startTokenEndpoint = async (): Promise<string> => {
48
- tokenEndpoint = createServer((_request, response) => {
49
- response.writeHead(200, { "Content-Type": "application/json" });
50
- response.end(
51
- JSON.stringify({
52
- access_token: "access-token",
53
- refresh_token: "refresh-token",
54
- id_token: jwt({ preferred_username: "matthijs@example.com" }),
55
- scope:
56
- "https://outlook.office.com/IMAP.AccessAsUser.All https://outlook.office.com/SMTP.Send",
57
- expires_in: 3600,
58
- }),
59
- );
60
- });
61
- await new Promise<void>((resolve) => tokenEndpoint.listen(0, resolve));
62
- const { port } = tokenEndpoint.address() as AddressInfo;
63
- return `http://127.0.0.1:${port}/token`;
64
- };
65
-
66
- const callback = (
67
- query: Record<string, string>,
68
- ): Promise<APIGatewayProxyResult> =>
69
- handler(
70
- {
71
- httpMethod: "GET",
72
- path: CALLBACK_PATH,
73
- headers: {},
74
- queryStringParameters: query,
75
- body: null,
76
- requestContext: {},
77
- } as unknown as APIGatewayProxyEvent,
78
- { awsRequestId: `req-${randomUUID()}`, functionName: "test" },
79
- );
80
-
81
- const headerOf = (
82
- response: APIGatewayProxyResult,
83
- name: string,
84
- ): string | undefined => {
85
- for (const [key, value] of Object.entries(response.headers ?? {})) {
86
- if (key.toLowerCase() === name) return String(value);
87
- }
88
- return undefined;
89
- };
90
-
91
- before(async () => {
92
- _resetForTest();
93
- process.env.DATA_BACKEND = "sqlite";
94
- process.env.CORS_ALLOWED_ORIGINS = WEB_ORIGIN;
95
- process.env.MSOAUTH_REDIRECT_URI = `${WEB_ORIGIN}${CALLBACK_PATH}`;
96
- process.env.MSOAUTH_CLIENT_ID = "callback-test-client-id";
97
- process.env.MSOAUTH_CLIENT_SECRET = CLIENT_SECRET;
98
- process.env.MSOAUTH_TOKEN_ENDPOINT = await startTokenEndpoint();
99
- // The self-host key that encrypts the stored refresh token.
100
- process.env.FAKE_KMS_DATAKEY = "0".repeat(64);
101
- // Static credentials so the best-effort sync enqueue fails against the local
102
- // queue instead of walking the instance-metadata chain for a minute.
103
- process.env.AWS_REGION = "eu-west-1";
104
- process.env.AWS_ACCESS_KEY_ID = "test";
105
- process.env.AWS_SECRET_ACCESS_KEY = "test";
106
- ({ client, cleanup } = await createCalendarSqliteClient());
107
- setClient(client);
108
- ({ handler } = (await import("../index.js")) as unknown as {
109
- handler: typeof handler;
110
- });
111
- });
112
-
113
- after(async () => {
114
- _resetForTest();
115
- cleanup();
116
- await new Promise<void>((resolve) => tokenEndpoint.close(() => resolve()));
117
- });
118
-
119
- describe("the Microsoft OAuth callback", () => {
120
- it("sends the consenting browser on to the connected account", async () => {
121
- const accountConfigId = randomUUID();
122
- const state = await signState(
123
- {
124
- accountConfigId,
125
- nonce: "nonce",
126
- timestamp: Date.now(),
127
- services: [AccountService.Mail],
128
- },
129
- CLIENT_SECRET,
130
- );
131
-
132
- const response = await callback({ code: "auth-code", state });
133
-
134
- assert.equal(response.statusCode, 302, response.body);
135
- const location = headerOf(response, "location");
136
- assert.ok(location, "a redirect without a Location header is a blank page");
137
- const [connected] =
138
- await client.account.listAllByAccountConfig(accountConfigId);
139
- assert.ok(connected, "the callback stored the account it redirects to");
140
- assert.equal(
141
- location,
142
- `${WEB_ORIGIN}/settings/accounts?connected=${encodeURIComponent(connected.accountId)}`,
143
- );
144
- });
145
-
146
- it("sends a refused consent back with the reason Microsoft gave", async () => {
147
- const response = await callback({ error: "access_denied" });
148
-
149
- assert.equal(response.statusCode, 302, response.body);
150
- assert.equal(
151
- headerOf(response, "location"),
152
- `${WEB_ORIGIN}/settings/accounts?oauthError=access_denied`,
153
- );
154
- });
155
- });
@@ -1,336 +0,0 @@
1
- import assert from "node:assert/strict";
2
- import { randomUUID } from "node:crypto";
3
- import { createServer, type Server } from "node:http";
4
- import type { AddressInfo } from "node:net";
5
- import { after, before, beforeEach, describe, it } from "node:test";
6
- import type {
7
- AccountResponse,
8
- AccountService as AccountServiceName,
9
- } from "@remit/api-openapi-types";
10
- import { AccountService } from "@remit/domain-enums";
11
- import { MICROSOFT_SERVICE_SCOPES } from "@remit/mail-oauth-service";
12
- import type { APIGatewayProxyEvent, APIGatewayProxyResult } from "aws-lambda";
13
- import { deriveAccountConfigId } from "../auth.js";
14
- import {
15
- _resetForTest,
16
- type RemitClient,
17
- setClient,
18
- } from "../service/data-client.js";
19
- import { createCalendarSqliteClient } from "./calendar-sqlite-fixture.js";
20
-
21
- const CLIENT_SECRET = "consent-test-client-secret";
22
- const WEB_ORIGIN = "https://mail.example.com";
23
- const GRAPH = "https://graph.microsoft.com/";
24
- const MAIL_SCOPES = [...MICROSOFT_SERVICE_SCOPES[AccountService.Mail]];
25
- const CALENDAR_SCOPES = [...MICROSOFT_SERVICE_SCOPES[AccountService.Calendar]];
26
-
27
- let handler: (
28
- event: APIGatewayProxyEvent,
29
- context: unknown,
30
- ) => Promise<APIGatewayProxyResult>;
31
- let client: RemitClient;
32
- let cleanup: () => void;
33
- let tokenEndpoint: Server;
34
- let withheld: Set<string>;
35
- let redemptions: string[][];
36
-
37
- const jwt = (claims: Record<string, unknown>): string =>
38
- [
39
- Buffer.from(JSON.stringify({ alg: "RS256" })).toString("base64url"),
40
- Buffer.from(JSON.stringify(claims), "utf8").toString("base64url"),
41
- "signature-not-checked-here",
42
- ].join(".");
43
-
44
- const readBody = async (request: AsyncIterable<Buffer>): Promise<string> => {
45
- const chunks: Buffer[] = [];
46
- for await (const chunk of request) chunks.push(chunk);
47
- return Buffer.concat(chunks).toString("utf8");
48
- };
49
-
50
- const startTokenEndpoint = async (): Promise<string> => {
51
- tokenEndpoint = createServer(async (request, response) => {
52
- const form = new URLSearchParams(await readBody(request));
53
- const requested = (form.get("scope") ?? "").split(" ").filter(Boolean);
54
- redemptions.push(requested);
55
- const granted = requested.filter((scope) => !withheld.has(scope));
56
- const resourceScopes = granted.filter((scope) => scope.includes("://"));
57
- if (resourceScopes.length === 0) {
58
- response.writeHead(400, { "Content-Type": "application/json" });
59
- response.end(
60
- JSON.stringify({ error: "invalid_grant", error_codes: [65001] }),
61
- );
62
- return;
63
- }
64
- response.writeHead(200, { "Content-Type": "application/json" });
65
- response.end(
66
- JSON.stringify({
67
- access_token: "access-token",
68
- refresh_token: `refresh-token-${redemptions.length}`,
69
- id_token: jwt({ preferred_username: "person@example.com" }),
70
- expires_in: 3600,
71
- scope: granted
72
- .map((scope) =>
73
- scope.startsWith(GRAPH) ? scope.slice(GRAPH.length) : scope,
74
- )
75
- .join(" "),
76
- }),
77
- );
78
- });
79
- await new Promise<void>((resolve) => tokenEndpoint.listen(0, resolve));
80
- const { port } = tokenEndpoint.address() as AddressInfo;
81
- return `http://127.0.0.1:${port}/token`;
82
- };
83
-
84
- const headerOf = (
85
- response: APIGatewayProxyResult,
86
- name: string,
87
- ): string | undefined => {
88
- for (const [key, value] of Object.entries(response.headers ?? {})) {
89
- if (key.toLowerCase() === name) return String(value);
90
- }
91
- return undefined;
92
- };
93
-
94
- const request = (
95
- sub: string,
96
- httpMethod: string,
97
- path: string,
98
- body: unknown,
99
- queryStringParameters: Record<string, string> | null = null,
100
- ): Promise<APIGatewayProxyResult> =>
101
- handler(
102
- {
103
- httpMethod,
104
- path,
105
- headers: { "content-type": "application/json" },
106
- queryStringParameters,
107
- body: body === null ? null : JSON.stringify(body),
108
- requestContext: { authorizer: { claims: { sub } } },
109
- } as unknown as APIGatewayProxyEvent,
110
- { awsRequestId: `req-${randomUUID()}`, functionName: "test" },
111
- );
112
-
113
- const startConsent = async (
114
- sub: string,
115
- services: AccountServiceName[] | undefined,
116
- ): Promise<URL> => {
117
- const response = await request(
118
- sub,
119
- "POST",
120
- "/accounts/oauth/microsoft/start",
121
- {
122
- email: "person@example.com",
123
- services,
124
- },
125
- );
126
- assert.equal(response.statusCode, 200, response.body);
127
- return new URL(
128
- (JSON.parse(response.body) as { authorizationUrl: string })
129
- .authorizationUrl,
130
- );
131
- };
132
-
133
- const consent = async (
134
- sub: string,
135
- services: AccountServiceName[] | undefined,
136
- ): Promise<string> => {
137
- const authorizationUrl = await startConsent(sub, services);
138
- const state = authorizationUrl.searchParams.get("state");
139
- assert.ok(state, "the authorization URL carries the signed state");
140
- const response = await request(
141
- sub,
142
- "GET",
143
- "/accounts/oauth/microsoft/callback",
144
- null,
145
- { code: "auth-code", state },
146
- );
147
- assert.equal(response.statusCode, 302, response.body);
148
- const location = headerOf(response, "location");
149
- assert.ok(location, "the callback answers with a Location");
150
- return location;
151
- };
152
-
153
- const onlyAccount = async (sub: string) => {
154
- const accounts = await client.account.listAllByAccountConfig(
155
- deriveAccountConfigId(sub),
156
- );
157
- assert.equal(accounts.length, 1, "the consent wrote exactly one account");
158
- return accounts[0];
159
- };
160
-
161
- const patchServices = (
162
- sub: string,
163
- accountId: string,
164
- syncedServices: AccountServiceName[],
165
- ): Promise<APIGatewayProxyResult> =>
166
- request(sub, "PATCH", `/accounts/${accountId}`, { syncedServices });
167
-
168
- before(async () => {
169
- _resetForTest();
170
- process.env.DATA_BACKEND = "sqlite";
171
- process.env.CORS_ALLOWED_ORIGINS = WEB_ORIGIN;
172
- process.env.MSOAUTH_REDIRECT_URI = `${WEB_ORIGIN}/accounts/oauth/microsoft/callback`;
173
- process.env.MSOAUTH_CLIENT_ID = "consent-test-client-id";
174
- process.env.MSOAUTH_CLIENT_SECRET = CLIENT_SECRET;
175
- process.env.MSOAUTH_TOKEN_ENDPOINT = await startTokenEndpoint();
176
- process.env.FAKE_KMS_DATAKEY = "0".repeat(64);
177
- process.env.AWS_REGION = "eu-west-1";
178
- process.env.AWS_ACCESS_KEY_ID = "test";
179
- process.env.AWS_SECRET_ACCESS_KEY = "test";
180
- ({ client, cleanup } = await createCalendarSqliteClient());
181
- setClient(client);
182
- ({ handler } = (await import("../index.js")) as unknown as {
183
- handler: typeof handler;
184
- });
185
- });
186
-
187
- beforeEach(() => {
188
- withheld = new Set();
189
- redemptions = [];
190
- });
191
-
192
- after(async () => {
193
- _resetForTest();
194
- cleanup();
195
- await new Promise<void>((resolve) => tokenEndpoint.close(() => resolve()));
196
- });
197
-
198
- describe("the Microsoft consent for the services an account syncs", () => {
199
- it("asks for the calendar scope only when the start names Calendar", async () => {
200
- const sub = randomUUID();
201
-
202
- const mailOnly = (
203
- await startConsent(sub, [AccountService.Mail])
204
- ).searchParams
205
- .get("scope")
206
- ?.split(" ");
207
- const calendarOnly = (
208
- await startConsent(sub, [AccountService.Calendar])
209
- ).searchParams
210
- .get("scope")
211
- ?.split(" ");
212
-
213
- assert.ok(mailOnly);
214
- assert.ok(calendarOnly);
215
- assert.deepEqual(
216
- mailOnly.filter((scope) => scope.includes("://")),
217
- MAIL_SCOPES,
218
- );
219
- assert.deepEqual(
220
- calendarOnly.filter((scope) => scope.includes("://")),
221
- CALENDAR_SCOPES,
222
- );
223
- assert.ok(calendarOnly.includes("offline_access"));
224
- });
225
-
226
- it("creates a calendar-only account holding the calendar grant", async () => {
227
- const sub = randomUUID();
228
-
229
- const location = await consent(sub, [AccountService.Calendar]);
230
-
231
- const account = await onlyAccount(sub);
232
- assert.equal(
233
- location,
234
- `${WEB_ORIGIN}/settings/accounts?connected=${encodeURIComponent(account.accountId)}`,
235
- );
236
- assert.deepEqual(account.syncedServices, [AccountService.Calendar]);
237
- assert.deepEqual(account.grantedScopes, CALENDAR_SCOPES);
238
- assert.deepEqual(redemptions, [
239
- [...CALENDAR_SCOPES, "offline_access", "openid", "email"],
240
- ]);
241
- });
242
-
243
- it("refuses a consent that comes back without the calendar scope and writes nothing", async () => {
244
- const sub = randomUUID();
245
- withheld = new Set(CALENDAR_SCOPES);
246
-
247
- const location = await consent(sub, [
248
- AccountService.Mail,
249
- AccountService.Calendar,
250
- ]);
251
-
252
- assert.equal(
253
- location,
254
- `${WEB_ORIGIN}/settings/accounts?oauthError=scope_not_granted&oauthEmail=person%40example.com&missingServices=Calendar`,
255
- );
256
- assert.deepEqual(
257
- await client.account.listAllByAccountConfig(deriveAccountConfigId(sub)),
258
- [],
259
- );
260
- });
261
-
262
- it("keeps calendar when a mail and calendar account reconnects naming only its email", async () => {
263
- const sub = randomUUID();
264
- await consent(sub, [AccountService.Mail, AccountService.Calendar]);
265
- const connected = await onlyAccount(sub);
266
-
267
- redemptions = [];
268
- const location = await consent(sub, undefined);
269
-
270
- const reconnected = await onlyAccount(sub);
271
- assert.equal(
272
- location,
273
- `${WEB_ORIGIN}/settings/accounts?connected=${encodeURIComponent(connected.accountId)}`,
274
- );
275
- assert.deepEqual(reconnected.syncedServices, [
276
- AccountService.Mail,
277
- AccountService.Calendar,
278
- ]);
279
- assert.deepEqual(reconnected.grantedScopes, [
280
- ...MAIL_SCOPES,
281
- ...CALENDAR_SCOPES,
282
- ]);
283
- assert.deepEqual(
284
- redemptions.map((scopes) => scopes.filter((s) => s.includes("://"))),
285
- [MAIL_SCOPES, CALENDAR_SCOPES],
286
- );
287
- });
288
-
289
- it("adds calendar to a mail account through a second consent", async () => {
290
- const sub = randomUUID();
291
- await consent(sub, [AccountService.Mail]);
292
- const mailAccount = await onlyAccount(sub);
293
- assert.deepEqual(mailAccount.grantedScopes, MAIL_SCOPES);
294
-
295
- const refused = await patchServices(sub, mailAccount.accountId, [
296
- AccountService.Mail,
297
- AccountService.Calendar,
298
- ]);
299
- assert.equal(refused.statusCode, 400, refused.body);
300
- const { message } = JSON.parse(refused.body) as { message: string };
301
- assert.match(message, /granted scopes lack Calendar/);
302
- assert.match(message, /POST \/accounts\/oauth\/microsoft\/start/);
303
-
304
- redemptions = [];
305
- await consent(sub, [AccountService.Mail, AccountService.Calendar]);
306
-
307
- const reconnected = await onlyAccount(sub);
308
- assert.equal(reconnected.accountId, mailAccount.accountId);
309
- assert.deepEqual(reconnected.syncedServices, [
310
- AccountService.Mail,
311
- AccountService.Calendar,
312
- ]);
313
- assert.deepEqual(reconnected.grantedScopes, [
314
- ...MAIL_SCOPES,
315
- ...CALENDAR_SCOPES,
316
- ]);
317
- assert.deepEqual(
318
- redemptions.map((scopes) => scopes.filter((s) => s.includes("://"))),
319
- [MAIL_SCOPES, CALENDAR_SCOPES],
320
- );
321
-
322
- const mailAgain = await patchServices(sub, mailAccount.accountId, [
323
- AccountService.Mail,
324
- ]);
325
- assert.equal(mailAgain.statusCode, 200, mailAgain.body);
326
- const both = await patchServices(sub, mailAccount.accountId, [
327
- AccountService.Calendar,
328
- AccountService.Mail,
329
- ]);
330
- assert.equal(both.statusCode, 200, both.body);
331
- assert.deepEqual(
332
- (JSON.parse(both.body) as AccountResponse).syncedServices,
333
- [AccountService.Mail, AccountService.Calendar],
334
- );
335
- });
336
- });