server-admin-api.test.js 70 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979
  1. import assert from 'node:assert/strict';
  2. import { spawn, spawnSync } from 'node:child_process';
  3. import { mkdtempSync, readdirSync } from 'node:fs';
  4. import { tmpdir } from 'node:os';
  5. import path from 'node:path';
  6. import process from 'node:process';
  7. import { test } from 'node:test';
  8. import net from 'node:net';
  9. test('admin API routes respond once and keep the server alive', async () => {
  10. const port = await freePort();
  11. const child = spawn(process.execPath, ['src/server.js'], {
  12. cwd: process.cwd(),
  13. env: {
  14. ...process.env,
  15. PORT: String(port),
  16. DATA_DIR: mkdtempSync(path.join(tmpdir(), 'mailhub-server-test-')),
  17. ADMIN_PASSWORD: 'password123',
  18. SUBMISSION_ENABLED: 'false'
  19. },
  20. stdio: ['ignore', 'pipe', 'pipe']
  21. });
  22. try {
  23. await waitForOutput(child, 'MailHub listening');
  24. const baseUrl = `http://127.0.0.1:${port}`;
  25. const login = await fetch(`${baseUrl}/api/login`, {
  26. method: 'POST',
  27. headers: { 'Content-Type': 'application/json' },
  28. body: JSON.stringify({ username: 'admin', password: 'password123' })
  29. });
  30. assert.equal(login.status, 200);
  31. const cookie = login.headers.get('set-cookie')?.split(';')[0] || '';
  32. assert.ok(cookie);
  33. const settings = await fetch(`${baseUrl}/api/admin/settings`, {
  34. headers: { Cookie: cookie }
  35. });
  36. assert.equal(settings.status, 200);
  37. const settingsPayload = await settings.json();
  38. assert.equal(settingsPayload.settings.mailHostname, 'mailhub.local');
  39. assert.equal(settingsPayload.settings.systemChecks.ptr.key, 'ptr');
  40. const exited = await waitForExit(child, 300);
  41. assert.equal(exited, false);
  42. } finally {
  43. child.kill('SIGTERM');
  44. await waitForExit(child, 1000);
  45. }
  46. });
  47. test('built auth assets are served before authentication', async () => {
  48. const assetName = readdirSync(path.join(process.cwd(), 'public', 'assets')).find((name) => /\.(js|css)$/.test(name));
  49. assert.ok(assetName, 'expected at least one built frontend asset');
  50. const port = await freePort();
  51. const child = spawn(process.execPath, ['src/server.js'], {
  52. cwd: process.cwd(),
  53. env: {
  54. ...process.env,
  55. PORT: String(port),
  56. DATA_DIR: mkdtempSync(path.join(tmpdir(), 'mailhub-server-test-')),
  57. ADMIN_PASSWORD: 'password123',
  58. SUBMISSION_ENABLED: 'false'
  59. },
  60. stdio: ['ignore', 'pipe', 'pipe']
  61. });
  62. try {
  63. await waitForOutput(child, 'MailHub listening');
  64. const baseUrl = `http://127.0.0.1:${port}`;
  65. const login = await fetch(`${baseUrl}/login`);
  66. assert.equal(login.status, 200);
  67. const asset = await fetch(`${baseUrl}/assets/${assetName}`, { redirect: 'manual' });
  68. assert.equal(asset.status, 200);
  69. assert.notEqual(asset.headers.get('location'), '/login');
  70. } finally {
  71. child.kill('SIGTERM');
  72. await waitForExit(child, 1000);
  73. }
  74. });
  75. test('auth pages preserve query messages instead of redirecting them away', async () => {
  76. const { child, baseUrl } = await startTestServer();
  77. try {
  78. for (const pathname of ['/login?error=hello', '/reset-password?token=abc123']) {
  79. const response = await fetch(`${baseUrl}${pathname}`, { redirect: 'manual' });
  80. assert.equal(response.status, 200);
  81. assert.equal(response.headers.get('location'), null);
  82. assert.match(await response.text(), /auth-root/);
  83. }
  84. } finally {
  85. child.kill('SIGTERM');
  86. await waitForExit(child, 1000);
  87. }
  88. });
  89. test('users can manage multiple smtp login credentials', async () => {
  90. const { child, baseUrl } = await startTestServer();
  91. try {
  92. const cookie = await login(baseUrl, 'admin', 'password123');
  93. const first = await createSmtpCredential(baseUrl, cookie, {
  94. username: 'admin-smtp-main',
  95. password: 'main-secret'
  96. });
  97. const second = await createSmtpCredential(baseUrl, cookie, {
  98. username: 'admin-smtp-app',
  99. password: 'app-secret'
  100. });
  101. assert.equal(first.username, 'admin-smtp-main');
  102. assert.equal(first.password, 'main-secret');
  103. assert.equal(second.username, 'admin-smtp-app');
  104. const list = await fetch(`${baseUrl}/api/smtp-credentials`, { headers: { Cookie: cookie } });
  105. assert.equal(list.status, 200);
  106. const listPayload = await list.json();
  107. assert.deepEqual(listPayload.credentials.map((credential) => credential.username), ['admin-smtp-app', 'admin-smtp-main']);
  108. assert.equal(listPayload.credentials[0].password, 'app-secret');
  109. const update = await fetch(`${baseUrl}/api/smtp-credentials/${second.id}`, {
  110. method: 'PATCH',
  111. headers: {
  112. 'Content-Type': 'application/json',
  113. Cookie: cookie
  114. },
  115. body: JSON.stringify({ username: 'admin-smtp-app-renamed' })
  116. });
  117. assert.equal(update.status, 200);
  118. assert.equal((await update.json()).credential.password, 'app-secret');
  119. const deleted = await fetch(`${baseUrl}/api/smtp-credentials/${first.id}`, {
  120. method: 'DELETE',
  121. headers: { Cookie: cookie }
  122. });
  123. assert.equal(deleted.status, 200);
  124. assert.equal((await deleted.json()).deleted, true);
  125. } finally {
  126. child.kill('SIGTERM');
  127. await waitForExit(child, 1000);
  128. }
  129. });
  130. test('users can manage inbound mailboxes and read inbound messages', async () => {
  131. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  132. try {
  133. const cookie = await login(baseUrl, 'admin', 'password123');
  134. await createSendingDomain(baseUrl, cookie, { domain: 'inbound-api.example' });
  135. const createMailbox = await fetch(`${baseUrl}/api/inbound-mailboxes`, {
  136. method: 'POST',
  137. headers: {
  138. 'Content-Type': 'application/json',
  139. Cookie: cookie
  140. },
  141. body: JSON.stringify({
  142. address: 'Support@inbound-api.example',
  143. displayName: 'Support'
  144. })
  145. });
  146. assert.equal(createMailbox.status, 201);
  147. const mailbox = (await createMailbox.json()).mailbox;
  148. assert.equal(mailbox.address, 'support@inbound-api.example');
  149. assert.equal(mailbox.displayName, 'Support');
  150. assert.equal(mailbox.unreadCount, 0);
  151. const mailboxes = await fetch(`${baseUrl}/api/inbound-mailboxes`, { headers: { Cookie: cookie } });
  152. assert.equal(mailboxes.status, 200);
  153. const mailboxesBody = await mailboxes.json();
  154. assert.deepEqual(mailboxesBody.mailboxes.map((entry) => entry.address), ['support@inbound-api.example']);
  155. const messageId = seedInboundMessage(dataDir, sessionSecret, 'support@inbound-api.example');
  156. const messages = await fetch(`${baseUrl}/api/inbound-messages?mailboxId=${mailbox.id}`, { headers: { Cookie: cookie } });
  157. assert.equal(messages.status, 200);
  158. const messagesBody = await messages.json();
  159. assert.equal(messagesBody.messages.length, 1);
  160. assert.equal(messagesBody.messages[0].id, messageId);
  161. assert.equal(messagesBody.messages[0].subject, 'Inbound API message');
  162. assert.equal(messagesBody.messages[0].textBody, undefined);
  163. const detail = await fetch(`${baseUrl}/api/inbound-messages/${messageId}`, { headers: { Cookie: cookie } });
  164. assert.equal(detail.status, 200);
  165. const detailBody = await detail.json();
  166. assert.equal(detailBody.message.textBody, 'Hello from inbound API.');
  167. assert.equal(detailBody.message.rawMessage.includes('Inbound API message'), true);
  168. const markRead = await fetch(`${baseUrl}/api/inbound-messages/${messageId}`, {
  169. method: 'PATCH',
  170. headers: {
  171. 'Content-Type': 'application/json',
  172. Cookie: cookie
  173. },
  174. body: JSON.stringify({ read: true })
  175. });
  176. assert.equal(markRead.status, 200);
  177. assert.equal((await markRead.json()).message.read, true);
  178. } finally {
  179. child.kill('SIGTERM');
  180. await waitForExit(child, 1000);
  181. }
  182. });
  183. test('users can manage outbound smtp relays with recoverable passwords and send through a selected relay', async () => {
  184. const relayServer = await startFakeSmtpServer();
  185. const { child, baseUrl } = await startTestServer();
  186. try {
  187. const cookie = await login(baseUrl, 'admin', 'password123');
  188. const domainResponse = await fetch(`${baseUrl}/api/domains`, {
  189. method: 'POST',
  190. headers: {
  191. 'Content-Type': 'application/json',
  192. Cookie: cookie
  193. },
  194. body: JSON.stringify({
  195. domain: 'relay.example',
  196. selector: 'mh',
  197. senderHost: 'mail.relay.example',
  198. sendingIp: '127.0.0.1'
  199. })
  200. });
  201. assert.equal(domainResponse.status, 201);
  202. const createRelay = await fetch(`${baseUrl}/api/smtp-relays`, {
  203. method: 'POST',
  204. headers: {
  205. 'Content-Type': 'application/json',
  206. Cookie: cookie
  207. },
  208. body: JSON.stringify({
  209. name: 'Primary outbound',
  210. host: '127.0.0.1',
  211. port: relayServer.port,
  212. secure: false,
  213. username: 'relay-user',
  214. password: 'relay-password',
  215. helo: 'helo.relay.example',
  216. isDefault: true
  217. })
  218. });
  219. assert.equal(createRelay.status, 201);
  220. const created = await createRelay.json();
  221. assert.equal(created.relay.passwordSet, true);
  222. assert.equal('password' in created.relay, false);
  223. const list = await fetch(`${baseUrl}/api/smtp-relays`, { headers: { Cookie: cookie } });
  224. assert.equal(list.status, 200);
  225. const listed = await list.json();
  226. assert.equal(listed.relays.length, 1);
  227. assert.equal('password' in listed.relays[0], false);
  228. const detail = await fetch(`${baseUrl}/api/smtp-relays/${created.relay.id}`, { headers: { Cookie: cookie } });
  229. assert.equal(detail.status, 200);
  230. const detailBody = await detail.json();
  231. assert.equal(detailBody.relay.password, 'relay-password');
  232. assert.equal('passwordSecret' in detailBody.relay, false);
  233. const missingPatch = await fetch(`${baseUrl}/api/smtp-relays/999999`, {
  234. method: 'PATCH',
  235. headers: {
  236. 'Content-Type': 'application/json',
  237. Cookie: cookie
  238. },
  239. body: JSON.stringify({
  240. name: 'Missing relay',
  241. host: '127.0.0.1',
  242. port: relayServer.port,
  243. secure: false,
  244. username: 'missing-user',
  245. password: 'missing-password'
  246. })
  247. });
  248. assert.equal(missingPatch.status, 404);
  249. const updateWithoutPassword = await fetch(`${baseUrl}/api/smtp-relays/${created.relay.id}`, {
  250. method: 'PATCH',
  251. headers: {
  252. 'Content-Type': 'application/json',
  253. Cookie: cookie
  254. },
  255. body: JSON.stringify({
  256. name: 'Primary outbound renamed',
  257. host: '127.0.0.1',
  258. port: relayServer.port,
  259. secure: false,
  260. username: 'relay-user'
  261. })
  262. });
  263. assert.equal(updateWithoutPassword.status, 200);
  264. assert.equal((await updateWithoutPassword.json()).relay.isDefault, true);
  265. const detailAfterPatch = await fetch(`${baseUrl}/api/smtp-relays/${created.relay.id}`, { headers: { Cookie: cookie } });
  266. assert.equal((await detailAfterPatch.json()).relay.password, 'relay-password');
  267. const invalidRelaySend = await fetch(`${baseUrl}/api/send`, {
  268. method: 'POST',
  269. headers: {
  270. 'Content-Type': 'application/json',
  271. Cookie: cookie
  272. },
  273. body: JSON.stringify({
  274. from: 'noreply@relay.example',
  275. to: 'user@example.com',
  276. subject: 'Invalid relay',
  277. text: 'hello',
  278. smtpRelayId: 999999
  279. })
  280. });
  281. assert.equal(invalidRelaySend.status, 400);
  282. const send = await fetch(`${baseUrl}/api/send`, {
  283. method: 'POST',
  284. headers: {
  285. 'Content-Type': 'application/json',
  286. Cookie: cookie
  287. },
  288. body: JSON.stringify({
  289. from: 'noreply@relay.example',
  290. to: 'user@example.com',
  291. subject: 'Relay send',
  292. text: 'hello',
  293. smtpRelayId: created.relay.id
  294. })
  295. });
  296. assert.equal(send.status, 202);
  297. assert.equal((await send.json()).smtpRelayId, created.relay.id);
  298. await waitForCondition(() => relayServer.messages.length === 1);
  299. const authCommand = relayServer.commands.find((command) => command.startsWith('AUTH PLAIN '));
  300. assert.ok(authCommand);
  301. assert.equal(Buffer.from(authCommand.replace('AUTH PLAIN ', ''), 'base64').toString('utf8'), '\0relay-user\0relay-password');
  302. const events = await fetch(`${baseUrl}/api/events`, { headers: { Cookie: cookie } });
  303. assert.equal(events.status, 200);
  304. const eventsBody = await events.json();
  305. assert.equal(eventsBody.events[0].smtpRelayId, created.relay.id);
  306. const eventDetail = await fetch(`${baseUrl}/api/events/${eventsBody.events[0].id}`, {
  307. headers: { Cookie: cookie }
  308. });
  309. assert.equal(eventDetail.status, 200);
  310. const eventDetailBody = await eventDetail.json();
  311. assert.equal(eventDetailBody.event.id, eventsBody.events[0].id);
  312. assert.equal(eventDetailBody.event.smtpRelayId, created.relay.id);
  313. assert.equal(Array.isArray(eventDetailBody.event.webhookDeliveries), true);
  314. } finally {
  315. child.kill('SIGTERM');
  316. await waitForExit(child, 1000);
  317. await relayServer.close();
  318. }
  319. });
  320. test('smtp relay selection prefers request relay then domain relay then user default relay', async () => {
  321. const requestRelayServer = await startFakeSmtpServer();
  322. const domainRelayServer = await startFakeSmtpServer();
  323. const defaultRelayServer = await startFakeSmtpServer();
  324. const { child, baseUrl } = await startTestServer();
  325. try {
  326. const cookie = await login(baseUrl, 'admin', 'password123');
  327. const settings = await fetch(`${baseUrl}/api/admin/settings`, {
  328. method: 'PATCH',
  329. headers: {
  330. 'Content-Type': 'application/json',
  331. Cookie: cookie
  332. },
  333. body: JSON.stringify({
  334. appBaseUrl: baseUrl,
  335. engagementTrackingEnabled: true
  336. })
  337. });
  338. assert.equal(settings.status, 200);
  339. const defaultRelay = await createSmtpRelay(baseUrl, cookie, {
  340. name: 'Default relay',
  341. host: '127.0.0.1',
  342. port: defaultRelayServer.port,
  343. username: 'default-user',
  344. password: 'default-password',
  345. isDefault: true
  346. });
  347. const domainRelay = await createSmtpRelay(baseUrl, cookie, {
  348. name: 'Domain relay',
  349. host: '127.0.0.1',
  350. port: domainRelayServer.port,
  351. username: 'domain-user',
  352. password: 'domain-password'
  353. });
  354. const requestRelay = await createSmtpRelay(baseUrl, cookie, {
  355. name: 'Request relay',
  356. host: '127.0.0.1',
  357. port: requestRelayServer.port,
  358. username: 'request-user',
  359. password: 'request-password'
  360. });
  361. const domain = await createSendingDomain(baseUrl, cookie, {
  362. domain: 'relay-order.example',
  363. smtpRelayId: domainRelay.id
  364. });
  365. assert.equal(domain.smtpRelayId, domainRelay.id);
  366. const domainSend = await sendApiMail(baseUrl, cookie, {
  367. from: 'noreply@relay-order.example',
  368. to: 'domain@example.com',
  369. subject: 'Domain relay'
  370. });
  371. assert.equal(domainSend.smtpRelayId, domainRelay.id);
  372. await waitForCondition(() => domainRelayServer.messages.length === 1);
  373. assertRelayAuth(domainRelayServer, 'domain-user', 'domain-password');
  374. const requestSend = await sendApiMail(baseUrl, cookie, {
  375. from: 'noreply@relay-order.example',
  376. to: 'request@example.com',
  377. subject: 'Request relay',
  378. smtpRelayId: requestRelay.id
  379. });
  380. assert.equal(requestSend.smtpRelayId, requestRelay.id);
  381. await waitForCondition(() => requestRelayServer.messages.length === 1);
  382. assertRelayAuth(requestRelayServer, 'request-user', 'request-password');
  383. const testSend = await fetch(`${baseUrl}/api/domains/${domain.id}/test-send`, {
  384. method: 'POST',
  385. headers: {
  386. 'Content-Type': 'application/json',
  387. Cookie: cookie
  388. },
  389. body: JSON.stringify({
  390. to: 'test-send@example.com',
  391. subject: 'Selected relay test send',
  392. text: 'Open the HTML version to verify tracking.',
  393. html: '<html><body><p>MailHub tracking test.</p><a href="https://example.net/tracked">Tracked link</a></body></html>',
  394. smtpRelayId: requestRelay.id
  395. })
  396. });
  397. assert.equal(testSend.status, 202);
  398. const testSendBody = await testSend.json();
  399. assert.equal(testSendBody.smtpRelayId, requestRelay.id);
  400. assert.deepEqual(testSendBody.tracking, { enabled: true, opens: true, clicks: true, messageLevel: false });
  401. await waitForCondition(() => requestRelayServer.messages.length === 2);
  402. const testHtml = decodeHtmlPart(requestRelayServer.messages[1]);
  403. assert.match(testHtml, new RegExp(`${escapeRegExp(baseUrl)}/t/o/[A-Za-z0-9_-]+\\.gif`));
  404. assert.match(testHtml, new RegExp(`${escapeRegExp(baseUrl)}/t/c/[A-Za-z0-9_-]+`));
  405. assert.equal(testHtml.includes('https://example.net/tracked'), false);
  406. const invalidTestSend = await fetch(`${baseUrl}/api/domains/${domain.id}/test-send`, {
  407. method: 'POST',
  408. headers: {
  409. 'Content-Type': 'application/json',
  410. Cookie: cookie
  411. },
  412. body: JSON.stringify({
  413. to: 'invalid-test-send@example.com',
  414. smtpRelayId: 999999
  415. })
  416. });
  417. assert.equal(invalidTestSend.status, 400);
  418. const defaultDomain = await createSendingDomain(baseUrl, cookie, {
  419. domain: 'default-relay.example'
  420. });
  421. assert.equal(defaultDomain.smtpRelayId, null);
  422. const defaultSend = await sendApiMail(baseUrl, cookie, {
  423. from: 'noreply@default-relay.example',
  424. to: 'default@example.com',
  425. subject: 'Default relay'
  426. });
  427. assert.equal(defaultSend.smtpRelayId, defaultRelay.id);
  428. await waitForCondition(() => defaultRelayServer.messages.length === 1);
  429. assertRelayAuth(defaultRelayServer, 'default-user', 'default-password');
  430. } finally {
  431. child.kill('SIGTERM');
  432. await waitForExit(child, 1000);
  433. await requestRelayServer.close();
  434. await domainRelayServer.close();
  435. await defaultRelayServer.close();
  436. }
  437. });
  438. test('admin users can list audit logs', async () => {
  439. const { child, baseUrl } = await startTestServer();
  440. try {
  441. const cookie = await login(baseUrl, 'admin', 'password123');
  442. const response = await fetch(`${baseUrl}/api/admin/audit-logs`, {
  443. headers: { Cookie: cookie }
  444. });
  445. assert.equal(response.status, 200);
  446. assert.deepEqual(await response.json(), { logs: [] });
  447. } finally {
  448. child.kill('SIGTERM');
  449. await waitForExit(child, 1000);
  450. }
  451. });
  452. test('admin users can list resource inventory', async () => {
  453. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  454. try {
  455. seedUsers(dataDir, sessionSecret, [{
  456. username: 'alice',
  457. email: 'alice@example.com',
  458. password: 'password123',
  459. status: 'active'
  460. }]);
  461. const adminCookie = await login(baseUrl, 'admin', 'password123');
  462. const userCookie = await login(baseUrl, 'alice', 'password123');
  463. const forbidden = await fetch(`${baseUrl}/api/admin/resources`, {
  464. headers: { Cookie: userCookie }
  465. });
  466. assert.equal(forbidden.status, 403);
  467. const response = await fetch(`${baseUrl}/api/admin/resources`, {
  468. headers: { Cookie: adminCookie }
  469. });
  470. assert.equal(response.status, 200);
  471. const body = await response.json();
  472. assert.ok(Array.isArray(body.inventory.users));
  473. assert.ok(Array.isArray(body.inventory.warnings));
  474. assert.ok(body.inventory.users.some((entry) => entry.user.username === 'alice'));
  475. } finally {
  476. child.kill('SIGTERM');
  477. await waitForExit(child, 1000);
  478. }
  479. });
  480. test('admin users can transfer individual resources', async () => {
  481. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  482. try {
  483. const seeded = seedTransferResources(dataDir, sessionSecret);
  484. const adminCookie = await login(baseUrl, 'admin', 'password123');
  485. const aliceCookie = await login(baseUrl, 'alice', 'password123');
  486. const forbidden = await fetch(`${baseUrl}/api/admin/resources/domains/${seeded.domainId}/transfer`, {
  487. method: 'POST',
  488. headers: {
  489. 'Content-Type': 'application/json',
  490. Cookie: aliceCookie
  491. },
  492. body: JSON.stringify({ targetUserId: seeded.bobId })
  493. });
  494. assert.equal(forbidden.status, 403);
  495. const domain = await fetch(`${baseUrl}/api/admin/resources/domains/${seeded.domainId}/transfer`, {
  496. method: 'POST',
  497. headers: {
  498. 'Content-Type': 'application/json',
  499. Cookie: adminCookie
  500. },
  501. body: JSON.stringify({
  502. targetUserId: seeded.bobId,
  503. dnsCredentialMode: 'with_dns_credential'
  504. })
  505. });
  506. assert.equal(domain.status, 200);
  507. const domainBody = await domain.json();
  508. assert.equal(domainBody.domain.userId, seeded.bobId);
  509. assert.equal(domainBody.domain.dnsCredentialId, seeded.credentialId);
  510. const dns = await fetch(`${baseUrl}/api/admin/resources/dns-credentials/${seeded.standaloneCredentialId}/transfer`, {
  511. method: 'POST',
  512. headers: {
  513. 'Content-Type': 'application/json',
  514. Cookie: adminCookie
  515. },
  516. body: JSON.stringify({ targetUserId: seeded.bobId })
  517. });
  518. assert.equal(dns.status, 200);
  519. assert.equal((await dns.json()).credential.userId, seeded.bobId);
  520. const tokens = await fetch(`${baseUrl}/api/admin/resources/api-tokens/transfer`, {
  521. method: 'POST',
  522. headers: {
  523. 'Content-Type': 'application/json',
  524. Cookie: adminCookie
  525. },
  526. body: JSON.stringify({
  527. targetUserId: seeded.bobId,
  528. tokenIds: [seeded.apiTokenId]
  529. })
  530. });
  531. assert.equal(tokens.status, 200);
  532. const tokensBody = await tokens.json();
  533. assert.equal(tokensBody.tokens.length, 1);
  534. assert.equal(tokensBody.tokens[0].userId, seeded.bobId);
  535. const audit = await fetch(`${baseUrl}/api/admin/audit-logs?targetUserId=${seeded.bobId}`, {
  536. headers: { Cookie: adminCookie }
  537. });
  538. const actions = (await audit.json()).logs.map((entry) => entry.action);
  539. assert.ok(actions.includes('admin.transfer_domain'));
  540. assert.ok(actions.includes('admin.transfer_dns_credential'));
  541. assert.ok(actions.includes('admin.transfer_api_tokens'));
  542. } finally {
  543. child.kill('SIGTERM');
  544. await waitForExit(child, 1000);
  545. }
  546. });
  547. test('admin users can preview and execute user merge', async () => {
  548. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  549. try {
  550. const seeded = seedMergeResources(dataDir, sessionSecret);
  551. const adminCookie = await login(baseUrl, 'admin', 'password123');
  552. const previewResponse = await fetch(`${baseUrl}/api/admin/migrations/user-merge/preview`, {
  553. method: 'POST',
  554. headers: {
  555. 'Content-Type': 'application/json',
  556. Cookie: adminCookie
  557. },
  558. body: JSON.stringify({
  559. sourceUserId: seeded.sourceId,
  560. targetUserId: seeded.targetId
  561. })
  562. });
  563. assert.equal(previewResponse.status, 200);
  564. const preview = (await previewResponse.json()).preview;
  565. assert.equal(preview.confirmationText, 'MERGE mergesource INTO mergetarget');
  566. assert.equal(preview.counts.domains, 1);
  567. const invalid = await fetch(`${baseUrl}/api/admin/migrations/user-merge/execute`, {
  568. method: 'POST',
  569. headers: {
  570. 'Content-Type': 'application/json',
  571. Cookie: adminCookie
  572. },
  573. body: JSON.stringify({
  574. sourceUserId: seeded.sourceId,
  575. targetUserId: seeded.targetId,
  576. confirmation: 'wrong'
  577. })
  578. });
  579. assert.equal(invalid.status, 400);
  580. const execute = await fetch(`${baseUrl}/api/admin/migrations/user-merge/execute`, {
  581. method: 'POST',
  582. headers: {
  583. 'Content-Type': 'application/json',
  584. Cookie: adminCookie
  585. },
  586. body: JSON.stringify({
  587. sourceUserId: seeded.sourceId,
  588. targetUserId: seeded.targetId,
  589. confirmation: preview.confirmationText
  590. })
  591. });
  592. assert.equal(execute.status, 200);
  593. const result = (await execute.json()).result;
  594. assert.equal(result.counts.domains, 1);
  595. assert.equal(result.sourceUser.status, 'disabled');
  596. const audit = await fetch(`${baseUrl}/api/admin/audit-logs?action=admin.user_merge`, {
  597. headers: { Cookie: adminCookie }
  598. });
  599. assert.equal(audit.status, 200);
  600. assert.equal((await audit.json()).logs[0].targetUserId, seeded.targetId);
  601. } finally {
  602. child.kill('SIGTERM');
  603. await waitForExit(child, 1000);
  604. }
  605. });
  606. test('admin users can manage system email settings without exposing password', async () => {
  607. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  608. try {
  609. seedUsers(dataDir, sessionSecret, [{
  610. username: 'alice',
  611. email: 'alice@example.com',
  612. password: 'password123',
  613. status: 'active'
  614. }]);
  615. const adminCookie = await login(baseUrl, 'admin', 'password123');
  616. const userCookie = await login(baseUrl, 'alice', 'password123');
  617. const forbidden = await fetch(`${baseUrl}/api/admin/system-email`, {
  618. headers: { Cookie: userCookie }
  619. });
  620. assert.equal(forbidden.status, 403);
  621. const empty = await fetch(`${baseUrl}/api/admin/system-email`, {
  622. headers: { Cookie: adminCookie }
  623. });
  624. assert.equal(empty.status, 200);
  625. assert.equal((await empty.json()).settings.passwordSet, false);
  626. const saved = await fetch(`${baseUrl}/api/admin/system-email`, {
  627. method: 'PATCH',
  628. headers: {
  629. 'Content-Type': 'application/json',
  630. Cookie: adminCookie
  631. },
  632. body: JSON.stringify({
  633. host: 'smtp.example.com',
  634. port: 587,
  635. secure: false,
  636. username: 'mailer@example.com',
  637. password: 'smtp-password-123',
  638. helo: 'mail.example.com',
  639. fromEmail: 'notify@example.com',
  640. fromName: 'MailHub Notify',
  641. testRecipient: 'admin@example.com'
  642. })
  643. });
  644. assert.equal(saved.status, 200);
  645. const savedBody = await saved.json();
  646. assert.equal(savedBody.settings.host, 'smtp.example.com');
  647. assert.equal(savedBody.settings.port, 587);
  648. assert.equal(savedBody.settings.secure, false);
  649. assert.equal(savedBody.settings.passwordSet, true);
  650. assert.equal('password' in savedBody.settings, false);
  651. assert.equal(JSON.stringify(savedBody).includes('smtp-password-123'), false);
  652. const preserved = await fetch(`${baseUrl}/api/admin/system-email`, {
  653. method: 'PATCH',
  654. headers: {
  655. 'Content-Type': 'application/json',
  656. Cookie: adminCookie
  657. },
  658. body: JSON.stringify({
  659. host: 'smtp2.example.com',
  660. password: ''
  661. })
  662. });
  663. assert.equal(preserved.status, 200);
  664. const preservedBody = await preserved.json();
  665. assert.equal(preservedBody.settings.host, 'smtp2.example.com');
  666. assert.equal(preservedBody.settings.passwordSet, true);
  667. assert.equal(JSON.stringify(preservedBody).includes('smtp-password-123'), false);
  668. const audit = await fetch(`${baseUrl}/api/admin/audit-logs?action=admin.update_system_email`, {
  669. headers: { Cookie: adminCookie }
  670. });
  671. assert.equal(audit.status, 200);
  672. const [entry] = (await audit.json()).logs;
  673. assert.equal(entry.action, 'admin.update_system_email');
  674. assert.equal(entry.targetType, 'system_email');
  675. assert.equal(entry.summary.host, 'smtp2.example.com');
  676. assert.equal(entry.summary.password, undefined);
  677. assert.equal(entry.summary.passwordSet, true);
  678. } finally {
  679. child.kill('SIGTERM');
  680. await waitForExit(child, 1000);
  681. }
  682. });
  683. test('registration and verification resend use configured system email', async () => {
  684. const smtp = await startFakeSmtpServer();
  685. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  686. try {
  687. seedUsers(dataDir, sessionSecret, [
  688. { username: 'publicpending', email: 'publicpending@example.com', password: 'password123', status: 'pending_email' },
  689. { username: 'adminpending', email: 'adminpending@example.com', password: 'password123', status: 'pending_email' }
  690. ]);
  691. const adminCookie = await login(baseUrl, 'admin', 'password123');
  692. await saveSystemEmailSettings(baseUrl, adminCookie, smtp.port);
  693. const register = await fetch(`${baseUrl}/api/register`, {
  694. method: 'POST',
  695. headers: { 'Content-Type': 'application/json' },
  696. body: JSON.stringify({
  697. username: 'mailuser',
  698. email: 'mailuser@example.com',
  699. password: 'password123'
  700. })
  701. });
  702. assert.equal(register.status, 201);
  703. const registerBody = await register.json();
  704. assert.equal(registerBody.user.status, 'pending_email');
  705. assert.equal(registerBody.verificationEmailSent, true);
  706. assert.equal(countAccountTokensForUser(dataDir, sessionSecret, 'mailuser', 'email_verification'), 1);
  707. const publicResend = await fetch(`${baseUrl}/api/auth/resend-verification`, {
  708. method: 'POST',
  709. headers: { 'Content-Type': 'application/json' },
  710. body: JSON.stringify({ email: 'publicpending@example.com' })
  711. });
  712. assert.equal(publicResend.status, 202);
  713. const publicResendBody = await publicResend.json();
  714. assert.equal(publicResendBody.message, '如果账号需要验证,我们会发送验证邮件。');
  715. assert.equal('verificationEmailSent' in publicResendBody, false);
  716. assert.equal('result' in publicResendBody, false);
  717. await waitForCondition(() => countAccountTokensForUser(dataDir, sessionSecret, 'publicpending', 'email_verification') === 1);
  718. const usersResponse = await fetch(`${baseUrl}/api/admin/users`, {
  719. headers: { Cookie: adminCookie }
  720. });
  721. const adminPending = (await usersResponse.json()).users.find((user) => user.username === 'adminpending');
  722. assert.ok(adminPending);
  723. const adminResend = await fetch(`${baseUrl}/api/admin/users/${adminPending.id}/resend-verification`, {
  724. method: 'POST',
  725. headers: { Cookie: adminCookie }
  726. });
  727. assert.equal(adminResend.status, 202);
  728. assert.equal((await adminResend.json()).verificationEmailSent, true);
  729. assert.equal(countAccountTokensForUser(dataDir, sessionSecret, 'adminpending', 'email_verification'), 1);
  730. assert.ok(smtp.commands.some((command) => command === 'MAIL FROM:<notify@example.com>'));
  731. assert.ok(smtp.commands.some((command) => command === 'RCPT TO:<mailuser@example.com>'));
  732. assert.ok(smtp.commands.some((command) => command === 'RCPT TO:<publicpending@example.com>'));
  733. assert.ok(smtp.commands.some((command) => command === 'RCPT TO:<adminpending@example.com>'));
  734. assert.equal(JSON.stringify(smtp.commands).includes('smtp-password-123'), false);
  735. } finally {
  736. child.kill('SIGTERM');
  737. await waitForExit(child, 1000);
  738. await smtp.close();
  739. }
  740. });
  741. test('public verification resend is generic and does not create tokens without mail config', async () => {
  742. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  743. try {
  744. seedUsers(dataDir, sessionSecret, [{
  745. username: 'pendingnomail',
  746. email: 'pendingnomail@example.com',
  747. password: 'password123',
  748. status: 'pending_email'
  749. }]);
  750. const response = await fetch(`${baseUrl}/api/auth/resend-verification`, {
  751. method: 'POST',
  752. headers: { 'Content-Type': 'application/json' },
  753. body: JSON.stringify({ email: 'pendingnomail@example.com' })
  754. });
  755. assert.equal(response.status, 202);
  756. assert.deepEqual(await response.json(), {
  757. message: '如果账号需要验证,我们会发送验证邮件。'
  758. });
  759. assert.equal(countAccountTokensForUser(dataDir, sessionSecret, 'pendingnomail', 'email_verification'), 0);
  760. } finally {
  761. child.kill('SIGTERM');
  762. await waitForExit(child, 1000);
  763. }
  764. });
  765. test('registration reports pending email when system email is not configured', async () => {
  766. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  767. try {
  768. const register = await fetch(`${baseUrl}/api/register`, {
  769. method: 'POST',
  770. headers: { 'Content-Type': 'application/json' },
  771. body: JSON.stringify({
  772. username: 'nomailuser',
  773. email: 'nomailuser@example.com',
  774. password: 'password123'
  775. })
  776. });
  777. assert.equal(register.status, 201);
  778. const body = await register.json();
  779. assert.equal(body.user.status, 'pending_email');
  780. assert.equal(body.verificationEmailSent, false);
  781. assert.match(body.message, /验证邮件暂未发送/);
  782. assert.equal(countAccountTokensForUser(dataDir, sessionSecret, 'nomailuser', 'email_verification'), 1);
  783. } finally {
  784. child.kill('SIGTERM');
  785. await waitForExit(child, 1000);
  786. }
  787. });
  788. test('admin users can send system email test messages', async () => {
  789. const smtp = await startFakeSmtpServer();
  790. const { child, baseUrl } = await startTestServer();
  791. try {
  792. const adminCookie = await login(baseUrl, 'admin', 'password123');
  793. await saveSystemEmailSettings(baseUrl, adminCookie, smtp.port);
  794. const response = await fetch(`${baseUrl}/api/admin/system-email/test`, {
  795. method: 'POST',
  796. headers: {
  797. 'Content-Type': 'application/json',
  798. Cookie: adminCookie
  799. },
  800. body: JSON.stringify({ to: 'operator@example.com' })
  801. });
  802. assert.equal(response.status, 202);
  803. const body = await response.json();
  804. assert.equal(body.result.ok, true);
  805. assert.equal(body.result.queueId, 'SYS123');
  806. assert.equal(JSON.stringify(body).includes('smtp-password-123'), false);
  807. assert.ok(smtp.commands.some((command) => command === 'RCPT TO:<operator@example.com>'));
  808. const audit = await fetch(`${baseUrl}/api/admin/audit-logs?action=admin.test_system_email`, {
  809. headers: { Cookie: adminCookie }
  810. });
  811. assert.equal(audit.status, 200);
  812. const [entry] = (await audit.json()).logs;
  813. assert.equal(entry.targetType, 'system_email');
  814. assert.equal(entry.summary.to, 'operator@example.com');
  815. assert.equal(entry.summary.ok, true);
  816. } finally {
  817. child.kill('SIGTERM');
  818. await waitForExit(child, 1000);
  819. await smtp.close();
  820. }
  821. });
  822. test('public forgot password is generic and sends reset email when configured', async () => {
  823. const smtp = await startFakeSmtpServer({ responseDelayMs: 700 });
  824. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  825. try {
  826. seedUsers(dataDir, sessionSecret, [{
  827. username: 'resetme',
  828. email: 'resetme@example.com',
  829. password: 'password123',
  830. status: 'active'
  831. }]);
  832. const adminCookie = await login(baseUrl, 'admin', 'password123');
  833. await saveSystemEmailSettings(baseUrl, adminCookie, smtp.port);
  834. const startedAt = Date.now();
  835. const existing = await fetch(`${baseUrl}/api/auth/forgot-password`, {
  836. method: 'POST',
  837. headers: { 'Content-Type': 'application/json' },
  838. body: JSON.stringify({ email: 'resetme@example.com' })
  839. });
  840. const elapsedMs = Date.now() - startedAt;
  841. assert.equal(existing.status, 202);
  842. assert.equal(elapsedMs < 500, true);
  843. assert.deepEqual(await existing.json(), {
  844. message: '如果邮箱存在,我们会发送密码重置邮件。'
  845. });
  846. await waitForCondition(() => countAccountTokensForUser(dataDir, sessionSecret, 'resetme', 'password_reset') === 1);
  847. const missing = await fetch(`${baseUrl}/api/auth/forgot-password`, {
  848. method: 'POST',
  849. headers: { 'Content-Type': 'application/json' },
  850. body: JSON.stringify({ email: 'missing@example.com' })
  851. });
  852. assert.equal(missing.status, 202);
  853. assert.deepEqual(await missing.json(), {
  854. message: '如果邮箱存在,我们会发送密码重置邮件。'
  855. });
  856. await waitForCondition(() => smtp.commands.some((command) => command === 'RCPT TO:<resetme@example.com>'));
  857. } finally {
  858. child.kill('SIGTERM');
  859. await waitForExit(child, 1000);
  860. await smtp.close();
  861. }
  862. });
  863. test('public reset password consumes token and updates password', async () => {
  864. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  865. try {
  866. seedUsers(dataDir, sessionSecret, [{
  867. username: 'tokenreset',
  868. email: 'tokenreset@example.com',
  869. password: 'password123',
  870. status: 'active'
  871. }]);
  872. const token = createPasswordResetToken(dataDir, sessionSecret, 'tokenreset');
  873. const response = await fetch(`${baseUrl}/api/auth/reset-password`, {
  874. method: 'POST',
  875. headers: { 'Content-Type': 'application/json' },
  876. body: JSON.stringify({
  877. token,
  878. password: 'new-password-123'
  879. })
  880. });
  881. assert.equal(response.status, 200);
  882. assert.deepEqual(await response.json(), {
  883. message: '密码已重置,请使用新密码登录。'
  884. });
  885. const oldLogin = await loginResponse(baseUrl, 'tokenreset', 'password123');
  886. assert.equal(oldLogin.status, 401);
  887. const newLogin = await loginResponse(baseUrl, 'tokenreset', 'new-password-123');
  888. assert.equal(newLogin.status, 200);
  889. const reused = await fetch(`${baseUrl}/api/auth/reset-password`, {
  890. method: 'POST',
  891. headers: { 'Content-Type': 'application/json' },
  892. body: JSON.stringify({
  893. token,
  894. password: 'another-password-123'
  895. })
  896. });
  897. assert.equal(reused.status, 400);
  898. } finally {
  899. child.kill('SIGTERM');
  900. await waitForExit(child, 1000);
  901. }
  902. });
  903. test('admin users can trigger password reset email and set temporary password', async () => {
  904. const smtp = await startFakeSmtpServer();
  905. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  906. try {
  907. seedUsers(dataDir, sessionSecret, [
  908. { username: 'targetuser', email: 'targetuser@example.com', password: 'password123', status: 'active' },
  909. { username: 'member2', email: 'member2@example.com', password: 'password123', status: 'active' }
  910. ]);
  911. const adminCookie = await login(baseUrl, 'admin', 'password123');
  912. const memberCookie = await login(baseUrl, 'member2', 'password123');
  913. await saveSystemEmailSettings(baseUrl, adminCookie, smtp.port);
  914. const usersResponse = await fetch(`${baseUrl}/api/admin/users`, {
  915. headers: { Cookie: adminCookie }
  916. });
  917. const target = (await usersResponse.json()).users.find((user) => user.username === 'targetuser');
  918. assert.ok(target);
  919. const forbiddenReset = await fetch(`${baseUrl}/api/admin/users/${target.id}/password-reset`, {
  920. method: 'POST',
  921. headers: { Cookie: memberCookie }
  922. });
  923. assert.equal(forbiddenReset.status, 403);
  924. const reset = await fetch(`${baseUrl}/api/admin/users/${target.id}/password-reset`, {
  925. method: 'POST',
  926. headers: { Cookie: adminCookie }
  927. });
  928. assert.equal(reset.status, 202);
  929. assert.equal((await reset.json()).result.ok, true);
  930. assert.equal(countAccountTokensForUser(dataDir, sessionSecret, 'targetuser', 'password_reset'), 1);
  931. assert.ok(smtp.commands.some((command) => command === 'RCPT TO:<targetuser@example.com>'));
  932. const forbiddenTemporary = await fetch(`${baseUrl}/api/admin/users/${target.id}/temporary-password`, {
  933. method: 'POST',
  934. headers: {
  935. 'Content-Type': 'application/json',
  936. Cookie: memberCookie
  937. },
  938. body: JSON.stringify({ password: 'temporary-123' })
  939. });
  940. assert.equal(forbiddenTemporary.status, 403);
  941. const temporary = await fetch(`${baseUrl}/api/admin/users/${target.id}/temporary-password`, {
  942. method: 'POST',
  943. headers: {
  944. 'Content-Type': 'application/json',
  945. Cookie: adminCookie
  946. },
  947. body: JSON.stringify({ password: 'temporary-123' })
  948. });
  949. assert.equal(temporary.status, 200);
  950. assert.equal((await temporary.json()).user.id, target.id);
  951. assert.equal(countUnusedAccountTokensForUser(dataDir, sessionSecret, 'targetuser', 'password_reset'), 0);
  952. const oldLogin = await loginResponse(baseUrl, 'targetuser', 'password123');
  953. assert.equal(oldLogin.status, 401);
  954. const tempLogin = await loginResponse(baseUrl, 'targetuser', 'temporary-123');
  955. assert.equal(tempLogin.status, 200);
  956. const audit = await fetch(`${baseUrl}/api/admin/audit-logs?targetUserId=${target.id}`, {
  957. headers: { Cookie: adminCookie }
  958. });
  959. assert.equal(audit.status, 200);
  960. const logs = (await audit.json()).logs;
  961. assert.ok(logs.some((entry) => entry.action === 'admin.password_reset'));
  962. const temporaryLog = logs.find((entry) => entry.action === 'admin.temporary_password');
  963. assert.ok(temporaryLog);
  964. assert.equal(temporaryLog.summary.username, 'targetuser');
  965. assert.equal(temporaryLog.summary.password, undefined);
  966. assert.equal(JSON.stringify(temporaryLog).includes('temporary-123'), false);
  967. } finally {
  968. child.kill('SIGTERM');
  969. await waitForExit(child, 1000);
  970. await smtp.close();
  971. }
  972. });
  973. test('non-admin users cannot list audit logs', async () => {
  974. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  975. try {
  976. seedUsers(dataDir, sessionSecret, [{
  977. username: 'alice',
  978. email: 'alice@example.com',
  979. password: 'password123',
  980. status: 'active'
  981. }]);
  982. const cookie = await login(baseUrl, 'alice', 'password123');
  983. const response = await fetch(`${baseUrl}/api/admin/audit-logs`, {
  984. headers: { Cookie: cookie }
  985. });
  986. assert.equal(response.status, 403);
  987. } finally {
  988. child.kill('SIGTERM');
  989. await waitForExit(child, 1000);
  990. }
  991. });
  992. test('admin user patch rejects invalid status with a bad request', async () => {
  993. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  994. try {
  995. seedUsers(dataDir, sessionSecret, [{
  996. username: 'badstatus',
  997. email: 'badstatus@example.com',
  998. password: 'password123',
  999. status: 'active'
  1000. }]);
  1001. const cookie = await login(baseUrl, 'admin', 'password123');
  1002. const usersResponse = await fetch(`${baseUrl}/api/admin/users`, {
  1003. headers: { Cookie: cookie }
  1004. });
  1005. assert.equal(usersResponse.status, 200);
  1006. const usersBody = await usersResponse.json();
  1007. const target = usersBody.users.find((user) => user.username === 'badstatus');
  1008. assert.ok(target);
  1009. const response = await fetch(`${baseUrl}/api/admin/users/${target.id}`, {
  1010. method: 'PATCH',
  1011. headers: {
  1012. 'Content-Type': 'application/json',
  1013. Cookie: cookie
  1014. },
  1015. body: JSON.stringify({ status: 'archived' })
  1016. });
  1017. assert.equal(response.status, 400);
  1018. assert.equal((await response.json()).error, '用户状态不正确。');
  1019. const shortPassword = await fetch(`${baseUrl}/api/admin/users/${target.id}`, {
  1020. method: 'PATCH',
  1021. headers: {
  1022. 'Content-Type': 'application/json',
  1023. Cookie: cookie
  1024. },
  1025. body: JSON.stringify({ password: 'short' })
  1026. });
  1027. assert.equal(shortPassword.status, 400);
  1028. assert.equal((await shortPassword.json()).error, '密码至少需要 8 位。');
  1029. } finally {
  1030. child.kill('SIGTERM');
  1031. await waitForExit(child, 1000);
  1032. }
  1033. });
  1034. test('self registration creates a pending email user and verification token without a session', async () => {
  1035. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  1036. try {
  1037. const register = await fetch(`${baseUrl}/api/register`, {
  1038. method: 'POST',
  1039. headers: { 'Content-Type': 'application/json' },
  1040. body: JSON.stringify({
  1041. username: 'newuser',
  1042. email: 'newuser@example.com',
  1043. password: 'password123'
  1044. })
  1045. });
  1046. assert.equal(register.status, 201);
  1047. assert.equal(sessionCookieFrom(register), '');
  1048. const text = await register.text();
  1049. assert.doesNotMatch(text, /token/i);
  1050. const body = JSON.parse(text);
  1051. assert.equal('token' in body, false);
  1052. assert.equal('token' in body.user, false);
  1053. assert.equal('tokenHash' in body.user, false);
  1054. assert.equal(body.user.status, 'pending_email');
  1055. assert.match(body.message, /验证邮箱/);
  1056. assert.equal(countAccountTokensForUser(dataDir, sessionSecret, 'newuser', 'email_verification'), 1);
  1057. const login = await loginResponse(baseUrl, 'newuser', 'password123');
  1058. assert.equal(login.status, 403);
  1059. assert.equal(sessionCookieFrom(login), '');
  1060. assert.equal((await login.json()).error, '请先验证邮箱。');
  1061. } finally {
  1062. child.kill('SIGTERM');
  1063. await waitForExit(child, 1000);
  1064. }
  1065. });
  1066. test('email verification route consumes token and moves user to admin review', async () => {
  1067. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  1068. try {
  1069. const created = createPendingEmailUserWithVerificationToken(dataDir, sessionSecret, {
  1070. username: 'verifyme',
  1071. email: 'verifyme@example.com',
  1072. password: 'password123',
  1073. status: 'pending_email'
  1074. });
  1075. const missing = await fetch(`${baseUrl}/api/auth/verify-email`);
  1076. assert.equal(missing.status, 400);
  1077. assert.equal(sessionCookieFrom(missing), '');
  1078. const invalid = await fetch(`${baseUrl}/api/auth/verify-email?token=not-a-real-token`);
  1079. assert.equal(invalid.status, 400);
  1080. assert.equal(sessionCookieFrom(invalid), '');
  1081. const response = await fetch(`${baseUrl}/api/auth/verify-email?token=${encodeURIComponent(created.token)}`);
  1082. assert.equal(response.status, 200);
  1083. assert.equal(sessionCookieFrom(response), '');
  1084. const body = await response.json();
  1085. assert.equal(body.user.id, created.user.id);
  1086. assert.equal(body.user.status, 'pending_review');
  1087. assert.match(body.message, /管理员审核/);
  1088. const reused = await fetch(`${baseUrl}/api/auth/verify-email?token=${encodeURIComponent(created.token)}`);
  1089. assert.equal(reused.status, 400);
  1090. assert.equal(sessionCookieFrom(reused), '');
  1091. const login = await loginResponse(baseUrl, 'verifyme', 'password123');
  1092. assert.equal(login.status, 403);
  1093. assert.equal(sessionCookieFrom(login), '');
  1094. assert.equal((await login.json()).error, '账号正在等待管理员审核。');
  1095. } finally {
  1096. child.kill('SIGTERM');
  1097. await waitForExit(child, 1000);
  1098. }
  1099. });
  1100. test('admin users can approve pending review users with an audit log', async () => {
  1101. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  1102. try {
  1103. seedUsers(dataDir, sessionSecret, [
  1104. { username: 'reviewme', email: 'reviewme@example.com', password: 'password123', status: 'pending_review' },
  1105. { username: 'emailonly', email: 'emailonly@example.com', password: 'password123', status: 'pending_email' },
  1106. { username: 'disabledreview', email: 'disabledreview@example.com', password: 'password123', status: 'disabled' },
  1107. { username: 'member', email: 'member@example.com', password: 'password123', status: 'active' }
  1108. ]);
  1109. const adminCookie = await login(baseUrl, 'admin', 'password123');
  1110. const usersResponse = await fetch(`${baseUrl}/api/admin/users`, {
  1111. headers: { Cookie: adminCookie }
  1112. });
  1113. assert.equal(usersResponse.status, 200);
  1114. const users = (await usersResponse.json()).users;
  1115. const target = users.find((user) => user.username === 'reviewme');
  1116. const pendingEmail = users.find((user) => user.username === 'emailonly');
  1117. const disabled = users.find((user) => user.username === 'disabledreview');
  1118. assert.ok(target);
  1119. assert.ok(pendingEmail);
  1120. assert.ok(disabled);
  1121. const memberCookie = await login(baseUrl, 'member', 'password123');
  1122. const nonAdmin = await fetch(`${baseUrl}/api/admin/users/${target.id}/approve`, {
  1123. method: 'POST',
  1124. headers: { Cookie: memberCookie }
  1125. });
  1126. assert.equal(nonAdmin.status, 403);
  1127. const missing = await fetch(`${baseUrl}/api/admin/users/999999/approve`, {
  1128. method: 'POST',
  1129. headers: { Cookie: adminCookie }
  1130. });
  1131. assert.equal(missing.status, 404);
  1132. const pendingEmailResponse = await fetch(`${baseUrl}/api/admin/users/${pendingEmail.id}/approve`, {
  1133. method: 'POST',
  1134. headers: { Cookie: adminCookie }
  1135. });
  1136. assert.equal(pendingEmailResponse.status, 400);
  1137. assert.match((await pendingEmailResponse.json()).error, /验证邮箱|等待审核/);
  1138. const disabledResponse = await fetch(`${baseUrl}/api/admin/users/${disabled.id}/approve`, {
  1139. method: 'POST',
  1140. headers: { Cookie: adminCookie }
  1141. });
  1142. assert.equal(disabledResponse.status, 400);
  1143. assert.match((await disabledResponse.json()).error, /等待审核|只能审批/);
  1144. const response = await fetch(`${baseUrl}/api/admin/users/${target.id}/approve`, {
  1145. method: 'POST',
  1146. headers: { Cookie: adminCookie }
  1147. });
  1148. assert.equal(response.status, 200);
  1149. const body = await response.json();
  1150. assert.equal(body.user.id, target.id);
  1151. assert.equal(body.user.status, 'active');
  1152. const approvedCookie = await login(baseUrl, 'reviewme', 'password123');
  1153. assert.ok(approvedCookie);
  1154. const auditResponse = await fetch(`${baseUrl}/api/admin/audit-logs?action=admin.approve_user`, {
  1155. headers: { Cookie: adminCookie }
  1156. });
  1157. assert.equal(auditResponse.status, 200);
  1158. const [entry] = (await auditResponse.json()).logs;
  1159. assert.equal(entry.action, 'admin.approve_user');
  1160. assert.equal(entry.targetType, 'user');
  1161. assert.equal(entry.targetId, String(target.id));
  1162. assert.equal(entry.targetUserId, target.id);
  1163. assert.equal(entry.summary.username, 'reviewme');
  1164. assert.equal(entry.summary.status, 'active');
  1165. assert.equal(entry.summary.password, undefined);
  1166. assert.equal(entry.summary.token, undefined);
  1167. } finally {
  1168. child.kill('SIGTERM');
  1169. await waitForExit(child, 1000);
  1170. }
  1171. });
  1172. test('login returns account status restrictions only after password verification', async () => {
  1173. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  1174. try {
  1175. seedUsers(dataDir, sessionSecret, [
  1176. { username: 'pendingemail', email: 'pendingemail@example.com', password: 'password123', status: 'pending_email' },
  1177. { username: 'pendingreview', email: 'pendingreview@example.com', password: 'password123', status: 'pending_review' },
  1178. { username: 'disableduser', email: 'disableduser@example.com', password: 'password123', status: 'disabled' },
  1179. { username: 'activeuser', email: 'activeuser@example.com', password: 'password123', status: 'active' }
  1180. ]);
  1181. await assertLoginDeniedByStatus(baseUrl, 'pendingemail', '请先验证邮箱。');
  1182. await assertLoginDeniedByStatus(baseUrl, 'pendingreview', '账号正在等待管理员审核。');
  1183. await assertLoginDeniedByStatus(baseUrl, 'disableduser', '账号已被禁用。');
  1184. const active = await loginResponse(baseUrl, 'activeuser', 'password123');
  1185. assert.equal(active.status, 200);
  1186. assert.ok(sessionCookieFrom(active));
  1187. } finally {
  1188. child.kill('SIGTERM');
  1189. await waitForExit(child, 1000);
  1190. }
  1191. });
  1192. test('admin audit log actor filter rejects non-decimal user ids', async () => {
  1193. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  1194. try {
  1195. seedAuditLogs(dataDir, sessionSecret);
  1196. const cookie = await login(baseUrl, 'admin', 'password123');
  1197. assert.deepEqual(
  1198. await auditLogActions(baseUrl, cookie, 'actorUserId=1'),
  1199. ['audit.actor-one']
  1200. );
  1201. assert.deepEqual(
  1202. await auditLogActions(baseUrl, cookie, 'actorUserId=1e2'),
  1203. ['audit.actor-one-hundred', 'audit.actor-one']
  1204. );
  1205. } finally {
  1206. child.kill('SIGTERM');
  1207. await waitForExit(child, 1000);
  1208. }
  1209. });
  1210. test('admin audit log date filter ignores invalid dates', async () => {
  1211. const { child, baseUrl, dataDir, sessionSecret } = await startTestServer();
  1212. try {
  1213. seedAuditLogs(dataDir, sessionSecret);
  1214. const cookie = await login(baseUrl, 'admin', 'password123');
  1215. assert.deepEqual(await auditLogActions(baseUrl, cookie, 'from=2999-01-01T00%3A00%3A00.000Z'), []);
  1216. assert.deepEqual(
  1217. await auditLogActions(baseUrl, cookie, 'from=2026-02-31'),
  1218. ['audit.actor-one-hundred', 'audit.actor-one']
  1219. );
  1220. } finally {
  1221. child.kill('SIGTERM');
  1222. await waitForExit(child, 1000);
  1223. }
  1224. });
  1225. async function startTestServer() {
  1226. const port = await freePort();
  1227. const dataDir = mkdtempSync(path.join(tmpdir(), 'mailhub-server-test-'));
  1228. const sessionSecret = 'test-session-secret';
  1229. const child = spawn(process.execPath, ['src/server.js'], {
  1230. cwd: process.cwd(),
  1231. env: {
  1232. ...process.env,
  1233. PORT: String(port),
  1234. DATA_DIR: dataDir,
  1235. ADMIN_PASSWORD: 'password123',
  1236. SESSION_SECRET: sessionSecret,
  1237. DNS_AUTO_CHECK_ENABLED: 'false',
  1238. SUBMISSION_ENABLED: 'false'
  1239. },
  1240. stdio: ['ignore', 'pipe', 'pipe']
  1241. });
  1242. await waitForOutput(child, 'MailHub listening');
  1243. return { child, baseUrl: `http://127.0.0.1:${port}`, dataDir, sessionSecret };
  1244. }
  1245. async function login(baseUrl, username, password) {
  1246. const response = await loginResponse(baseUrl, username, password);
  1247. assert.equal(response.status, 200);
  1248. const cookie = sessionCookieFrom(response);
  1249. assert.ok(cookie);
  1250. return cookie;
  1251. }
  1252. function loginResponse(baseUrl, username, password) {
  1253. return fetch(`${baseUrl}/api/login`, {
  1254. method: 'POST',
  1255. headers: { 'Content-Type': 'application/json' },
  1256. body: JSON.stringify({ username, password })
  1257. });
  1258. }
  1259. async function assertLoginDeniedByStatus(baseUrl, username, message) {
  1260. const wrongPassword = await loginResponse(baseUrl, username, 'wrong-password');
  1261. assert.equal(wrongPassword.status, 401);
  1262. assert.equal((await wrongPassword.json()).error, '账号或密码不正确。');
  1263. assert.equal(sessionCookieFrom(wrongPassword), '');
  1264. const correctPassword = await loginResponse(baseUrl, username, 'password123');
  1265. assert.equal(correctPassword.status, 403);
  1266. assert.equal((await correctPassword.json()).error, message);
  1267. assert.equal(sessionCookieFrom(correctPassword), '');
  1268. }
  1269. function sessionCookieFrom(response) {
  1270. return response.headers.get('set-cookie')?.split(';')[0] || '';
  1271. }
  1272. function seedUsers(dataDir, sessionSecret, users) {
  1273. const script = `
  1274. import { initDatabase, createUser } from './src/db.js';
  1275. initDatabase(process.env.DATA_DIR, process.env.SESSION_SECRET);
  1276. for (const user of JSON.parse(process.env.SEED_USERS)) {
  1277. createUser(user);
  1278. }
  1279. `;
  1280. const result = spawnSync(process.execPath, ['--input-type=module', '-e', script], {
  1281. cwd: process.cwd(),
  1282. env: {
  1283. ...process.env,
  1284. DATA_DIR: dataDir,
  1285. SESSION_SECRET: sessionSecret,
  1286. SEED_USERS: JSON.stringify(users)
  1287. },
  1288. encoding: 'utf8'
  1289. });
  1290. assert.equal(result.status, 0, result.stderr || result.stdout);
  1291. }
  1292. function seedInboundMessage(dataDir, sessionSecret, address) {
  1293. const script = `
  1294. import {
  1295. createInboundMessage,
  1296. getInboundMailboxByAddress,
  1297. initDatabase
  1298. } from './src/db.js';
  1299. initDatabase(process.env.DATA_DIR, process.env.SESSION_SECRET);
  1300. const mailbox = getInboundMailboxByAddress(process.env.INBOUND_ADDRESS);
  1301. const message = createInboundMessage(mailbox, {
  1302. sender: 'alice@example.net',
  1303. recipients: [process.env.INBOUND_ADDRESS],
  1304. subject: 'Inbound API message',
  1305. messageId: '<inbound-api@example.net>',
  1306. rawMessage: [
  1307. 'From: Alice <alice@example.net>',
  1308. 'To: Support <' + process.env.INBOUND_ADDRESS + '>',
  1309. 'Subject: Inbound API message',
  1310. '',
  1311. 'Hello from inbound API.'
  1312. ].join('\\r\\n'),
  1313. textBody: 'Hello from inbound API.'
  1314. });
  1315. console.log(String(message.id));
  1316. `;
  1317. const result = spawnSync(process.execPath, ['--input-type=module', '-e', script], {
  1318. cwd: process.cwd(),
  1319. env: {
  1320. ...process.env,
  1321. DATA_DIR: dataDir,
  1322. SESSION_SECRET: sessionSecret,
  1323. INBOUND_ADDRESS: address
  1324. },
  1325. encoding: 'utf8'
  1326. });
  1327. assert.equal(result.status, 0, result.stderr || result.stdout);
  1328. return Number(result.stdout.trim());
  1329. }
  1330. function seedTransferResources(dataDir, sessionSecret) {
  1331. const script = `
  1332. import {
  1333. initDatabase,
  1334. createApiToken,
  1335. createDomain,
  1336. createUser,
  1337. saveDnsCredential
  1338. } from './src/db.js';
  1339. initDatabase(process.env.DATA_DIR, process.env.SESSION_SECRET);
  1340. const alice = createUser({ username: 'alice', email: 'alice@example.com', password: 'password123', status: 'active' });
  1341. const bob = createUser({ username: 'bob', email: 'bob@example.com', password: 'password123', status: 'active' });
  1342. const credential = saveDnsCredential(alice.id, {
  1343. name: 'Alice DNS',
  1344. provider: 'cloudflare',
  1345. zoneName: 'alice.example',
  1346. credentials: { apiToken: 'secret-token' }
  1347. });
  1348. const standaloneCredential = saveDnsCredential(alice.id, {
  1349. name: 'Standalone DNS',
  1350. provider: 'cloudflare',
  1351. zoneName: 'standalone.example',
  1352. credentials: { apiToken: 'standalone-secret-token' }
  1353. });
  1354. const domain = createDomain(alice.id, {
  1355. dnsCredentialId: credential.id,
  1356. domain: 'alice.example',
  1357. selector: 'mh202607',
  1358. verificationToken: 'token',
  1359. dkimPublic: 'public',
  1360. dkimPrivate: 'private',
  1361. senderHost: 'mail.alice.example',
  1362. sendingIp: '127.0.0.1',
  1363. spfExtra: '',
  1364. dmarcPolicy: 'none',
  1365. dmarcRua: ''
  1366. });
  1367. const apiToken = createApiToken(alice.id, 'primary');
  1368. console.log(JSON.stringify({
  1369. aliceId: alice.id,
  1370. bobId: bob.id,
  1371. domainId: domain.id,
  1372. credentialId: credential.id,
  1373. standaloneCredentialId: standaloneCredential.id,
  1374. apiTokenId: apiToken.id
  1375. }));
  1376. `;
  1377. const result = spawnSync(process.execPath, ['--input-type=module', '-e', script], {
  1378. cwd: process.cwd(),
  1379. env: {
  1380. ...process.env,
  1381. DATA_DIR: dataDir,
  1382. SESSION_SECRET: sessionSecret
  1383. },
  1384. encoding: 'utf8'
  1385. });
  1386. assert.equal(result.status, 0, result.stderr || result.stdout);
  1387. return JSON.parse(result.stdout);
  1388. }
  1389. function seedMergeResources(dataDir, sessionSecret) {
  1390. const script = `
  1391. import {
  1392. initDatabase,
  1393. createApiToken,
  1394. createDomain,
  1395. createUser,
  1396. logSendEvent,
  1397. saveDnsCredential
  1398. } from './src/db.js';
  1399. initDatabase(process.env.DATA_DIR, process.env.SESSION_SECRET);
  1400. const source = createUser({ username: 'mergesource', email: 'mergesource@example.com', password: 'password123', status: 'active' });
  1401. const target = createUser({ username: 'mergetarget', email: 'mergetarget@example.com', password: 'password123', status: 'active' });
  1402. const credential = saveDnsCredential(source.id, {
  1403. name: 'Merge DNS',
  1404. provider: 'cloudflare',
  1405. zoneName: 'merge.example',
  1406. credentials: { apiToken: 'merge-secret-token' }
  1407. });
  1408. const domain = createDomain(source.id, {
  1409. dnsCredentialId: credential.id,
  1410. domain: 'merge.example',
  1411. selector: 'mh202607',
  1412. verificationToken: 'token',
  1413. dkimPublic: 'public',
  1414. dkimPrivate: 'private',
  1415. senderHost: 'mail.merge.example',
  1416. sendingIp: '127.0.0.1',
  1417. spfExtra: '',
  1418. dmarcPolicy: 'none',
  1419. dmarcRua: ''
  1420. });
  1421. createApiToken(source.id, 'primary');
  1422. logSendEvent({
  1423. userId: source.id,
  1424. domainId: domain.id,
  1425. sender: 'noreply@merge.example',
  1426. recipients: ['a@example.com'],
  1427. subject: 'Queued',
  1428. status: 'queued'
  1429. });
  1430. console.log(JSON.stringify({ sourceId: source.id, targetId: target.id }));
  1431. `;
  1432. const result = spawnSync(process.execPath, ['--input-type=module', '-e', script], {
  1433. cwd: process.cwd(),
  1434. env: {
  1435. ...process.env,
  1436. DATA_DIR: dataDir,
  1437. SESSION_SECRET: sessionSecret
  1438. },
  1439. encoding: 'utf8'
  1440. });
  1441. assert.equal(result.status, 0, result.stderr || result.stdout);
  1442. return JSON.parse(result.stdout);
  1443. }
  1444. function createPendingEmailUserWithVerificationToken(dataDir, sessionSecret, user) {
  1445. const script = `
  1446. import { initDatabase, createUser, createAccountToken } from './src/db.js';
  1447. initDatabase(process.env.DATA_DIR, process.env.SESSION_SECRET);
  1448. const user = createUser(JSON.parse(process.env.SEED_USER));
  1449. const token = createAccountToken(user.id, 'email_verification', { ttlMinutes: 24 * 60 });
  1450. console.log(JSON.stringify({ user, token: token.token }));
  1451. `;
  1452. const result = spawnSync(process.execPath, ['--input-type=module', '-e', script], {
  1453. cwd: process.cwd(),
  1454. env: {
  1455. ...process.env,
  1456. DATA_DIR: dataDir,
  1457. SESSION_SECRET: sessionSecret,
  1458. SEED_USER: JSON.stringify(user)
  1459. },
  1460. encoding: 'utf8'
  1461. });
  1462. assert.equal(result.status, 0, result.stderr || result.stdout);
  1463. return JSON.parse(result.stdout);
  1464. }
  1465. function createPasswordResetToken(dataDir, sessionSecret, username) {
  1466. const script = `
  1467. import { initDatabase, getUserByLogin, createAccountToken } from './src/db.js';
  1468. initDatabase(process.env.DATA_DIR, process.env.SESSION_SECRET);
  1469. const user = getUserByLogin(process.env.TOKEN_USERNAME);
  1470. const token = createAccountToken(user.id, 'password_reset', { ttlMinutes: 60 });
  1471. console.log(token.token);
  1472. `;
  1473. const result = spawnSync(process.execPath, ['--input-type=module', '-e', script], {
  1474. cwd: process.cwd(),
  1475. env: {
  1476. ...process.env,
  1477. DATA_DIR: dataDir,
  1478. SESSION_SECRET: sessionSecret,
  1479. TOKEN_USERNAME: username
  1480. },
  1481. encoding: 'utf8'
  1482. });
  1483. assert.equal(result.status, 0, result.stderr || result.stdout);
  1484. return result.stdout.trim();
  1485. }
  1486. function countAccountTokensForUser(dataDir, sessionSecret, username, purpose) {
  1487. return countAccountTokens(dataDir, sessionSecret, username, purpose, false);
  1488. }
  1489. function countUnusedAccountTokensForUser(dataDir, sessionSecret, username, purpose) {
  1490. return countAccountTokens(dataDir, sessionSecret, username, purpose, true);
  1491. }
  1492. function countAccountTokens(dataDir, sessionSecret, username, purpose, unusedOnly) {
  1493. const script = `
  1494. import path from 'node:path';
  1495. import { DatabaseSync } from 'node:sqlite';
  1496. import { initDatabase, getUserByLogin } from './src/db.js';
  1497. initDatabase(process.env.DATA_DIR, process.env.SESSION_SECRET);
  1498. const user = getUserByLogin(process.env.TOKEN_USERNAME);
  1499. const database = new DatabaseSync(path.join(process.env.DATA_DIR, 'mailhub.sqlite'));
  1500. database.exec('PRAGMA journal_mode = WAL; PRAGMA foreign_keys = ON;');
  1501. const unusedFilter = process.env.TOKEN_UNUSED_ONLY === 'true' ? ' AND used_at IS NULL' : '';
  1502. const row = user
  1503. ? database
  1504. .prepare('SELECT COUNT(*) AS count FROM account_tokens WHERE user_id = ? AND purpose = ?' + unusedFilter)
  1505. .get(user.id, process.env.TOKEN_PURPOSE)
  1506. : { count: 0 };
  1507. console.log(String(row.count));
  1508. `;
  1509. const result = spawnSync(process.execPath, ['--input-type=module', '-e', script], {
  1510. cwd: process.cwd(),
  1511. env: {
  1512. ...process.env,
  1513. DATA_DIR: dataDir,
  1514. SESSION_SECRET: sessionSecret,
  1515. TOKEN_USERNAME: username,
  1516. TOKEN_PURPOSE: purpose,
  1517. TOKEN_UNUSED_ONLY: String(unusedOnly)
  1518. },
  1519. encoding: 'utf8'
  1520. });
  1521. assert.equal(result.status, 0, result.stderr || result.stdout);
  1522. return Number(result.stdout.trim());
  1523. }
  1524. function seedAuditLogs(dataDir, sessionSecret) {
  1525. const script = `
  1526. import path from 'node:path';
  1527. import { DatabaseSync } from 'node:sqlite';
  1528. import { initDatabase, logAudit } from './src/db.js';
  1529. initDatabase(process.env.DATA_DIR, process.env.SESSION_SECRET);
  1530. const actorOneId = logAudit({
  1531. actorUserId: 1,
  1532. action: 'audit.actor-one',
  1533. targetType: 'system',
  1534. summary: { label: 'actor-one' }
  1535. });
  1536. const actorOneHundredId = logAudit({
  1537. actorUserId: 100,
  1538. action: 'audit.actor-one-hundred',
  1539. targetType: 'system',
  1540. summary: { label: 'actor-one-hundred' }
  1541. });
  1542. const db = new DatabaseSync(path.join(process.env.DATA_DIR, 'mailhub.sqlite'));
  1543. db.exec('PRAGMA journal_mode = WAL; PRAGMA foreign_keys = ON;');
  1544. const update = db.prepare('UPDATE audit_logs SET created_at = ? WHERE id = ?');
  1545. update.run('2026-02-01T00:00:00.000Z', actorOneId);
  1546. update.run('2026-02-02T00:00:00.000Z', actorOneHundredId);
  1547. `;
  1548. const result = spawnSync(process.execPath, ['--input-type=module', '-e', script], {
  1549. cwd: process.cwd(),
  1550. env: {
  1551. ...process.env,
  1552. DATA_DIR: dataDir,
  1553. SESSION_SECRET: sessionSecret
  1554. },
  1555. encoding: 'utf8'
  1556. });
  1557. assert.equal(result.status, 0, result.stderr || result.stdout);
  1558. }
  1559. async function auditLogActions(baseUrl, cookie, query) {
  1560. const response = await fetch(`${baseUrl}/api/admin/audit-logs?${query}`, {
  1561. headers: { Cookie: cookie }
  1562. });
  1563. assert.equal(response.status, 200);
  1564. const body = await response.json();
  1565. return body.logs.map((log) => log.action);
  1566. }
  1567. async function saveSystemEmailSettings(baseUrl, cookie, smtpPort) {
  1568. const response = await fetch(`${baseUrl}/api/admin/system-email`, {
  1569. method: 'PATCH',
  1570. headers: {
  1571. 'Content-Type': 'application/json',
  1572. Cookie: cookie
  1573. },
  1574. body: JSON.stringify({
  1575. host: '127.0.0.1',
  1576. port: smtpPort,
  1577. secure: false,
  1578. username: 'mailer@example.com',
  1579. password: 'smtp-password-123',
  1580. helo: 'mail.example.com',
  1581. fromEmail: 'notify@example.com',
  1582. fromName: 'MailHub Notify',
  1583. testRecipient: 'admin@example.com'
  1584. })
  1585. });
  1586. assert.equal(response.status, 200);
  1587. }
  1588. async function createSendingDomain(baseUrl, cookie, data = {}) {
  1589. const domain = data.domain || 'send.example';
  1590. const response = await fetch(`${baseUrl}/api/domains`, {
  1591. method: 'POST',
  1592. headers: {
  1593. 'Content-Type': 'application/json',
  1594. Cookie: cookie
  1595. },
  1596. body: JSON.stringify({
  1597. domain,
  1598. selector: data.selector || 'mh',
  1599. senderHost: data.senderHost || `mail.${domain}`,
  1600. sendingIp: data.sendingIp || '127.0.0.1',
  1601. smtpRelayId: data.smtpRelayId
  1602. })
  1603. });
  1604. assert.equal(response.status, 201);
  1605. return (await response.json()).domain;
  1606. }
  1607. async function createSmtpRelay(baseUrl, cookie, data = {}) {
  1608. const response = await fetch(`${baseUrl}/api/smtp-relays`, {
  1609. method: 'POST',
  1610. headers: {
  1611. 'Content-Type': 'application/json',
  1612. Cookie: cookie
  1613. },
  1614. body: JSON.stringify({
  1615. name: data.name || 'Relay',
  1616. host: data.host || '127.0.0.1',
  1617. port: data.port,
  1618. secure: data.secure || false,
  1619. username: data.username || '',
  1620. password: data.password || '',
  1621. helo: data.helo || '',
  1622. isDefault: data.isDefault || false
  1623. })
  1624. });
  1625. assert.equal(response.status, 201);
  1626. return (await response.json()).relay;
  1627. }
  1628. async function createSmtpCredential(baseUrl, cookie, data = {}) {
  1629. const response = await fetch(`${baseUrl}/api/smtp-credentials`, {
  1630. method: 'POST',
  1631. headers: {
  1632. 'Content-Type': 'application/json',
  1633. Cookie: cookie
  1634. },
  1635. body: JSON.stringify(data)
  1636. });
  1637. assert.equal(response.status, 201);
  1638. return (await response.json()).credential;
  1639. }
  1640. async function sendApiMail(baseUrl, cookie, data) {
  1641. const response = await fetch(`${baseUrl}/api/send`, {
  1642. method: 'POST',
  1643. headers: {
  1644. 'Content-Type': 'application/json',
  1645. Cookie: cookie
  1646. },
  1647. body: JSON.stringify({
  1648. from: data.from,
  1649. to: data.to,
  1650. subject: data.subject,
  1651. text: data.text || 'hello',
  1652. smtpRelayId: data.smtpRelayId
  1653. })
  1654. });
  1655. assert.equal(response.status, 202);
  1656. return response.json();
  1657. }
  1658. function assertRelayAuth(relayServer, username, password) {
  1659. const authCommand = relayServer.commands.find((command) => command.startsWith('AUTH PLAIN '));
  1660. assert.ok(authCommand);
  1661. assert.equal(Buffer.from(authCommand.replace('AUTH PLAIN ', ''), 'base64').toString('utf8'), `\0${username}\0${password}`);
  1662. }
  1663. function decodeHtmlPart(rawMessage) {
  1664. const match = rawMessage.match(/Content-Type: text\/html[^]*?\n\n([A-Za-z0-9+/=\n]+?)(?:\n--|$)/i);
  1665. assert.ok(match, 'expected an HTML MIME part');
  1666. return Buffer.from(match[1].replace(/\s+/g, ''), 'base64').toString('utf8');
  1667. }
  1668. function escapeRegExp(value) {
  1669. return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
  1670. }
  1671. function startFakeSmtpServer({ responseDelayMs = 0 } = {}) {
  1672. const commands = [];
  1673. const messages = [];
  1674. const server = net.createServer((socket) => {
  1675. socket.setEncoding('utf8');
  1676. writeSmtpResponse(socket, '220 relay.test ESMTP ready', responseDelayMs);
  1677. let buffer = '';
  1678. let dataMode = false;
  1679. let messageLines = [];
  1680. socket.on('data', (chunk) => {
  1681. buffer += chunk;
  1682. let index;
  1683. while ((index = buffer.indexOf('\n')) !== -1) {
  1684. const line = buffer.slice(0, index).replace(/\r$/, '');
  1685. buffer = buffer.slice(index + 1);
  1686. if (dataMode) {
  1687. if (line === '.') {
  1688. dataMode = false;
  1689. messages.push(messageLines.join('\n'));
  1690. messageLines = [];
  1691. writeSmtpResponse(socket, '250 2.0.0 queued as SYS123', responseDelayMs);
  1692. } else {
  1693. messageLines.push(line);
  1694. }
  1695. continue;
  1696. }
  1697. commands.push(line);
  1698. if (line.startsWith('EHLO')) {
  1699. writeSmtpResponse(socket, '250-relay.test\r\n250 AUTH PLAIN', responseDelayMs);
  1700. } else if (line.startsWith('AUTH PLAIN')) {
  1701. writeSmtpResponse(socket, '235 2.7.0 authentication successful', responseDelayMs);
  1702. } else if (line.startsWith('MAIL FROM')) {
  1703. writeSmtpResponse(socket, '250 2.1.0 sender ok', responseDelayMs);
  1704. } else if (line.startsWith('RCPT TO')) {
  1705. writeSmtpResponse(socket, '250 2.1.5 recipient ok', responseDelayMs);
  1706. } else if (line === 'DATA') {
  1707. dataMode = true;
  1708. writeSmtpResponse(socket, '354 end with dot', responseDelayMs);
  1709. } else if (line === 'QUIT') {
  1710. writeSmtpResponse(socket, '221 bye', responseDelayMs);
  1711. socket.end();
  1712. }
  1713. }
  1714. });
  1715. });
  1716. return new Promise((resolve, reject) => {
  1717. server.once('error', reject);
  1718. server.listen(0, '127.0.0.1', () => {
  1719. server.off('error', reject);
  1720. resolve({
  1721. port: server.address().port,
  1722. commands,
  1723. messages,
  1724. close: () => new Promise((closeResolve) => server.close(closeResolve))
  1725. });
  1726. });
  1727. });
  1728. }
  1729. function writeSmtpResponse(socket, response, delayMs) {
  1730. const write = () => socket.write(`${response}\r\n`);
  1731. if (delayMs > 0) setTimeout(write, delayMs);
  1732. else write();
  1733. }
  1734. async function waitForCondition(predicate, { timeoutMs = 7000, intervalMs = 50 } = {}) {
  1735. const startedAt = Date.now();
  1736. while (Date.now() - startedAt < timeoutMs) {
  1737. if (predicate()) return;
  1738. await new Promise((resolve) => setTimeout(resolve, intervalMs));
  1739. }
  1740. assert.fail('Timed out waiting for condition.');
  1741. }
  1742. function freePort() {
  1743. return new Promise((resolve, reject) => {
  1744. const server = net.createServer();
  1745. server.listen(0, '127.0.0.1', () => {
  1746. const address = server.address();
  1747. server.close(() => {
  1748. if (address && typeof address === 'object') resolve(address.port);
  1749. else reject(new Error('Unable to allocate a test port.'));
  1750. });
  1751. });
  1752. });
  1753. }
  1754. function waitForOutput(child, text) {
  1755. return new Promise((resolve, reject) => {
  1756. const timeout = setTimeout(() => reject(new Error(`Timed out waiting for ${text}`)), 5000);
  1757. const chunks = [];
  1758. const onData = (chunk) => {
  1759. chunks.push(String(chunk));
  1760. if (chunks.join('').includes(text)) {
  1761. clearTimeout(timeout);
  1762. child.stdout.off('data', onData);
  1763. child.stderr.off('data', onData);
  1764. resolve();
  1765. }
  1766. };
  1767. child.stdout.on('data', onData);
  1768. child.stderr.on('data', onData);
  1769. child.once('exit', (code) => {
  1770. clearTimeout(timeout);
  1771. reject(new Error(`Server exited early with code ${code}: ${chunks.join('')}`));
  1772. });
  1773. });
  1774. }
  1775. function waitForExit(child, timeoutMs) {
  1776. if (child.exitCode !== null) return Promise.resolve(true);
  1777. return new Promise((resolve) => {
  1778. const timeout = setTimeout(() => {
  1779. child.off('exit', onExit);
  1780. resolve(false);
  1781. }, timeoutMs);
  1782. const onExit = () => {
  1783. clearTimeout(timeout);
  1784. resolve(true);
  1785. };
  1786. child.once('exit', onExit);
  1787. });
  1788. }