graph.test.js 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372
  1. import test from 'node:test';
  2. import assert from 'node:assert/strict';
  3. import { createHash } from 'node:crypto';
  4. import { createGraphProvider, GRAPH_SCOPES, validateGraphUrl } from '../src/graph.js';
  5. import { createStore } from '../src/store.js';
  6. const ROOT = 'https://graph.microsoft.com/v1.0';
  7. const USER = { homeAccountId: 'user.home', localAccountId: 'user', tenantId: 'tenant', username: 'user@example.test', name: 'Test User' };
  8. const ACCOUNT_ID = 'graph:user.home:tenant';
  9. const FIXED_NOW = Date.parse('2026-09-08T12:00:00Z');
  10. const response = (body, status = 200, headers = {}) => new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json', ...headers } });
  11. const tick = () => new Promise(resolve => setImmediate(resolve));
  12. function fakeMsal(account = USER) {
  13. return {
  14. authRequest: null, codeRequest: null, silentRequests: [], cleared: 0,
  15. async getAuthCodeUrl(request) { this.authRequest = request; return `https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize?state=${request.state}`; },
  16. async acquireTokenByCode(request) { this.codeRequest = request; return { account, accessToken: 'SECRET_ACCESS_TOKEN' }; },
  17. async acquireTokenSilent(request) { this.silentRequests.push(request); return { account, accessToken: 'SECRET_ACCESS_TOKEN' }; },
  18. async clearCache() { this.cleared += 1; },
  19. };
  20. }
  21. function fakeStore() {
  22. const states = new Map(), records = new Map(), logs = [];
  23. return { states, records, logs,
  24. getState: key => structuredClone(states.get(key) ?? null),
  25. setState(key, value) { states.set(key, structuredClone(value)); },
  26. upsertRecord(value) {
  27. const key = [value.source, value.accountId, value.kind, value.externalId].join('|');
  28. const changed = JSON.stringify(records.get(key)) !== JSON.stringify(value);
  29. records.set(key, structuredClone(value));
  30. return { changed, id: records.size };
  31. },
  32. addLog(level, message, details) { logs.push({ level, message, details }); },
  33. };
  34. }
  35. async function fixture(options = {}) {
  36. const store = options.store || fakeStore();
  37. const msal = options.msal || fakeMsal();
  38. const provider = createGraphProvider({ store, msalClient: msal, now: () => FIXED_NOW,
  39. config: { clientId: 'test-client', maxRetries: 0, ...(options.config || {}) }, ...options });
  40. await provider.beginLogin();
  41. await provider.completeLogin(new URLSearchParams({ state: msal.authRequest.state, code: 'one-time-code' }));
  42. return { provider, store, msal };
  43. }
  44. function emptyRoute(url) {
  45. if (new URL(url).pathname === '/v1.0/me/chats') return response({ value: [] });
  46. return response({ value: [], '@odata.deltaLink': `${ROOT}/me/calendarView/delta?$deltatoken=empty` });
  47. }
  48. test('Graph HTML messages share emoji preservation for inline and emoji-only body content', async () => {
  49. const { provider, store } = await fixture({ fetchImpl: async url => {
  50. const path = new URL(url).pathname;
  51. if (path === '/v1.0/me/chats') return response({ value: [{ id: 'fictional-emoji-chat', chatType: 'group' }] });
  52. if (path === '/v1.0/chats/fictional-emoji-chat/messages') return response({ value: [
  53. { id: 'inline', body: { contentType: 'html', content: '<p>好<img alt="&#x1F44D;">的</p>' }, createdDateTime: '2026-09-08T11:00:00Z' },
  54. { id: 'only-emoji', body: { contentType: 'html', content: '<p><img alt="👩🏽‍💻"></p>' }, createdDateTime: '2026-09-08T11:00:01Z' },
  55. { id: 'unknown-image', body: { contentType: 'html', content: '<img src="https://example.invalid/private-image">' }, createdDateTime: '2026-09-08T11:00:02Z' },
  56. ] });
  57. return emptyRoute(url);
  58. } });
  59. await provider.sync();
  60. assert.deepEqual([...store.records.values()].filter(record => record.kind === 'message').map(record => record.text), ['好👍的', '👩🏽‍💻', '[图片]']);
  61. });
  62. test('Graph is optional and startup without an app registration needs no login or network', async () => {
  63. const provider = createGraphProvider({ store: fakeStore(), config: {}, fetchImpl: () => assert.fail('Unexpected request') });
  64. assert.equal(provider.status().configured, false);
  65. assert.match(provider.status().configurationMessage, /MS_CLIENT_ID/);
  66. assert.match(provider.status().configurationMessage, /浏览器扩展/);
  67. assert.deepEqual(await provider.sync(), { skipped: true, reason: 'not_configured' });
  68. await assert.rejects(provider.beginLogin(), { code: 'not_configured' });
  69. provider.start();
  70. assert.equal(provider.status().running, true);
  71. await provider.stop();
  72. assert.equal(provider.status().running, false);
  73. });
  74. test('OAuth callback enforces PKCE, state, one-time code, expiry and keeps tokens out of status/logs', async () => {
  75. const msal = fakeMsal(), store = fakeStore();
  76. let time = FIXED_NOW;
  77. const provider = createGraphProvider({ store, config: { clientId: 'test-client' }, msalClient: msal, now: () => time });
  78. await provider.beginLogin();
  79. const auth = msal.authRequest;
  80. assert.deepEqual(auth.scopes, GRAPH_SCOPES);
  81. assert.equal(auth.codeChallengeMethod, 'S256');
  82. assert.equal(auth.prompt, 'select_account');
  83. await assert.rejects(provider.completeLogin(new URLSearchParams({ state: 'wrong', code: 'code' })), { code: 'invalid_state' });
  84. await provider.completeLogin(new URLSearchParams({ state: auth.state, code: 'code' }));
  85. assert.equal(createHash('sha256').update(msal.codeRequest.codeVerifier).digest('base64url'), auth.codeChallenge);
  86. assert.equal(provider.status().account.id, ACCOUNT_ID);
  87. assert.equal(provider.status().tokenStorage, 'memory');
  88. assert.doesNotMatch(JSON.stringify([provider.status(), store.logs]), /SECRET_ACCESS_TOKEN|one-time-code/);
  89. await assert.rejects(provider.completeLogin(new URLSearchParams({ state: auth.state, code: 'code' })), { code: 'invalid_state' });
  90. await provider.beginLogin();
  91. time += 11 * 60_000;
  92. await assert.rejects(provider.completeLogin(new URLSearchParams({ state: msal.authRequest.state, code: 'code' })), { code: 'login_expired' });
  93. await provider.logout();
  94. assert.equal(provider.status().authenticated, false);
  95. assert.ok(msal.cleared > 0);
  96. });
  97. test('logout rejects a token exchange that finishes late and clears that detached cache', async () => {
  98. const msal = fakeMsal();
  99. let release;
  100. msal.acquireTokenByCode = () => new Promise(resolve => { release = resolve; });
  101. const provider = createGraphProvider({ store: fakeStore(), config: { clientId: 'test' }, msalClient: msal });
  102. await provider.beginLogin();
  103. const completing = provider.completeLogin(new URLSearchParams({ state: msal.authRequest.state, code: 'code' }));
  104. await provider.logout();
  105. release({ account: USER, accessToken: 'SECRET_ACCESS_TOKEN' });
  106. await assert.rejects(completing, { code: 'cancelled' });
  107. assert.equal(provider.status().authenticated, false);
  108. assert.ok(msal.cleared > 0);
  109. });
  110. test('Graph continuation URLs must retain HTTPS, origin and v1.0; redirects are disabled', async () => {
  111. for (const url of ['https://evil.test/v1.0/me', 'http://graph.microsoft.com/v1.0/me',
  112. 'https://graph.microsoft.com/beta/me', 'https://user:pass@graph.microsoft.com/v1.0/me',
  113. 'https://graph.microsoft.com:444/v1.0/me', 'https://graph.microsoft.com/v1.0/../beta/me',
  114. 'https://graph.microsoft.com/v1.0/me#fragment']) {
  115. assert.throws(() => validateGraphUrl(url), { code: 'unsafe_graph_url' });
  116. }
  117. const calls = [];
  118. const { provider } = await fixture({ fetchImpl: async (url, options) => {
  119. calls.push(url);
  120. assert.equal(options.redirect, 'error');
  121. return new URL(url).pathname.endsWith('/chats') ? response({ value: [], '@odata.nextLink': 'https://evil.test/steal' }) : emptyRoute(url);
  122. } });
  123. const result = await provider.sync();
  124. assert.equal(result.chats.error.code, 'unsafe_graph_url');
  125. assert.equal(result.calendar.completed, true);
  126. assert.ok(calls.every(url => new URL(url).origin === 'https://graph.microsoft.com'));
  127. });
  128. test('all chat and message pages are read; per-chat failure keeps watermark while other areas succeed', async () => {
  129. let failSecondPage = true;
  130. const calls = [];
  131. const fetchImpl = async url => {
  132. calls.push(url);
  133. const parsed = new URL(url);
  134. if (parsed.pathname === '/v1.0/me/chats') {
  135. return parsed.searchParams.has('page') ? response({ value: [{ id: 'chat-b', topic: 'B' }] }) :
  136. response({ value: [{ id: 'chat-a', topic: 'A' }], '@odata.nextLink': `${ROOT}/me/chats?page=2` });
  137. }
  138. if (parsed.pathname === '/v1.0/chats/chat-a/messages') {
  139. if (parsed.searchParams.has('page')) return failSecondPage ? response({ error: { code: 'Forbidden', message: 'PRIVATE_ERROR_CONTENT' } }, 403) :
  140. response({ value: [{ id: 'a-old', body: { contentType: 'text', content: 'old' }, lastModifiedDateTime: '2026-09-08T10:00:00Z' }] });
  141. return response({ value: [{ id: 'a-new', body: { contentType: 'html', content: '<p>new &amp; latest</p>' }, lastModifiedDateTime: '2026-09-08T11:00:00Z' }],
  142. '@odata.nextLink': `${ROOT}/chats/chat-a/messages?page=2` });
  143. }
  144. if (parsed.pathname === '/v1.0/chats/chat-b/messages') return response({ value: [{ id: 'b', body: { contentType: 'text', content: 'B' }, lastModifiedDateTime: '2026-09-08T09:00:00Z' }] });
  145. return emptyRoute(url);
  146. };
  147. const { provider, store } = await fixture({ fetchImpl });
  148. const first = await provider.sync();
  149. assert.equal(first.chats.discovered, 2);
  150. assert.equal(first.chats.listComplete, true);
  151. assert.equal(first.chats.completed, 1);
  152. assert.equal(first.chats.failed, 1);
  153. assert.equal(first.calendar.completed, true);
  154. const chatStates = () => [...store.states.entries()].filter(([key]) => key.includes(':chat:'));
  155. assert.equal(chatStates().length, 1);
  156. assert.doesNotMatch(JSON.stringify([provider.status(), store.logs]), /PRIVATE_ERROR_CONTENT/);
  157. failSecondPage = false;
  158. const second = await provider.sync();
  159. assert.equal(second.complete, true);
  160. assert.equal(chatStates().length, 2);
  161. const firstRequests = calls.filter(url => new URL(url).pathname === '/v1.0/chats/chat-a/messages' && !new URL(url).searchParams.has('page'));
  162. assert.ok(firstRequests.every(url => !new URL(url).searchParams.has('$filter')), 'failed initial pass must replay full history');
  163. await provider.sync();
  164. const latestA = calls.filter(url => new URL(url).pathname === '/v1.0/chats/chat-a/messages' && !new URL(url).searchParams.has('page')).at(-1);
  165. assert.equal(new URL(latestA).searchParams.get('$orderby'), 'lastModifiedDateTime desc');
  166. assert.equal(new URL(latestA).searchParams.get('$filter'), 'lastModifiedDateTime gt 2026-09-08T10:58:00.000Z');
  167. assert.equal([...store.records.values()].find(value => value.externalId === 'chat-a:a-new').text, 'new & latest');
  168. });
  169. test('calendar delta pages persist final cursor, preserve original tombstones and reset expired cursor', async () => {
  170. const store = createStore(':memory:');
  171. try {
  172. store.upsertRecord({ source: 'graph', accountId: ACCOUNT_ID, kind: 'event', externalId: 'removed-event', title: 'Original title', text: 'Original body', raw: { id: 'removed-event', subject: 'Original title' } });
  173. let generation = 0;
  174. const tombstone = { id: 'removed-event', '@removed': { reason: 'deleted' } };
  175. const calls = [];
  176. const { provider } = await fixture({ store, fetchImpl: async url => {
  177. const parsed = new URL(url);
  178. if (parsed.pathname.endsWith('/chats')) return response({ value: [] });
  179. calls.push(url);
  180. if (parsed.searchParams.get('$deltatoken') === 'first') return response({ error: { code: 'syncStateNotFound', message: 'PRIVATE_CURSOR' } }, 410);
  181. if (parsed.searchParams.has('page')) return response({ value: [tombstone], '@odata.deltaLink': `${ROOT}/me/calendarView/delta?$deltatoken=first` });
  182. generation += 1;
  183. if (generation > 1) return response({ value: [{ id: 'removed-event', subject: 'Returned to view', body: { contentType: 'text', content: 'Updated body' } }],
  184. '@odata.deltaLink': `${ROOT}/me/calendarView/delta?$deltatoken=second` });
  185. return response({ value: [{ id: 'event', subject: 'Meeting', start: { dateTime: '2026-09-08T09:30:00.0000000', timeZone: 'UTC' } }],
  186. '@odata.nextLink': `${ROOT}/me/calendarView/delta?page=2` });
  187. } });
  188. const first = await provider.sync();
  189. assert.equal(first.calendar.pages, 2);
  190. assert.equal(first.calendar.completed, true);
  191. assert.deepEqual(first.calendar.window, { start: '2026-08-09T00:00:00.000Z', end: '2026-12-07T00:00:00.000Z' });
  192. const events = store.listRecords({ kind: 'event' }).items;
  193. const deleted = events.find(value => value.externalId === 'removed-event');
  194. assert.equal(Boolean(deleted.deleted), false);
  195. assert.equal(Boolean(deleted.removedFromView), true);
  196. assert.equal(deleted.title, 'Original title');
  197. assert.equal(deleted.text, 'Original body');
  198. assert.deepEqual(deleted.raw, tombstone);
  199. assert.equal(events.find(value => value.externalId === 'event').occurredAt, '2026-09-08T09:30:00.000Z');
  200. const second = await provider.sync();
  201. assert.equal(second.calendar.cursorResets, 1);
  202. assert.equal(second.calendar.completed, true);
  203. assert.ok(calls.some(url => new URL(url).searchParams.get('$deltatoken') === 'first'));
  204. const restored = store.listRecords({ kind: 'event' }).items.find(value => value.externalId === 'removed-event');
  205. assert.equal(Boolean(restored.removedFromView), false);
  206. assert.equal(Boolean(restored.deleted), false);
  207. assert.equal(restored.title, 'Returned to view');
  208. } finally { store.close(); }
  209. });
  210. test('calendar failed pagination never advances delta cursor; a date-window change triggers a full pass', async () => {
  211. let time = FIXED_NOW, phase = 0;
  212. const calls = [];
  213. const { provider, store } = await fixture({ now: () => time, fetchImpl: async url => {
  214. const parsed = new URL(url);
  215. if (parsed.pathname.endsWith('/chats')) return response({ value: [] });
  216. calls.push(url);
  217. if (phase === 1 && parsed.searchParams.has('page')) return response({ error: { code: 'Denied', message: 'PRIVATE' } }, 403);
  218. if (phase === 1) return response({ value: [], '@odata.nextLink': `${ROOT}/me/calendarView/delta?page=failed` });
  219. return response({ value: [], '@odata.deltaLink': `${ROOT}/me/calendarView/delta?$deltatoken=${phase}` });
  220. } });
  221. await provider.sync();
  222. const state = [...store.states.entries()].find(([key]) => key.endsWith(':calendar'));
  223. const saved = structuredClone(state[1]);
  224. phase = 1;
  225. const failed = await provider.sync();
  226. assert.equal(failed.calendar.completed, false);
  227. assert.deepEqual(store.states.get(state[0]), saved);
  228. phase = 2;
  229. time += 86_400_000;
  230. const moved = await provider.sync();
  231. assert.equal(moved.calendar.cursorResets, 1);
  232. assert.equal(new URL(calls.at(-1)).searchParams.get('startDateTime'), '2026-08-10T00:00:00.000Z');
  233. assert.equal(new URL(calls.at(-1)).searchParams.has('$deltatoken'), false);
  234. });
  235. test('429 uses Retry-After with bounded retries, and 401 forces silent refresh once', async () => {
  236. let attempts = 0;
  237. const waits = [];
  238. const { provider, msal } = await fixture({ config: { clientId: 'test', maxRetries: 3 }, sleep: async milliseconds => waits.push(milliseconds),
  239. fetchImpl: async url => {
  240. if (!new URL(url).pathname.endsWith('/chats')) return emptyRoute(url);
  241. attempts += 1;
  242. if (attempts === 1) return response({ error: { code: 'TooManyRequests' } }, 429, { 'retry-after': '2' });
  243. if (attempts === 2) return response({ error: { code: 'InvalidAuthenticationToken' } }, 401);
  244. return response({ value: [] });
  245. } });
  246. const result = await provider.sync();
  247. assert.equal(result.complete, true);
  248. assert.deepEqual(waits, [2000]);
  249. assert.equal(attempts, 3);
  250. assert.equal(msal.silentRequests.filter(request => request.forceRefresh).length, 1);
  251. });
  252. test('excessive Retry-After is not retried early and remote response content stays private', async () => {
  253. let attempts = 0;
  254. const { provider, store } = await fixture({ config: { clientId: 'test', maxRetries: 3, maxRetryDelayMs: 1000 },
  255. sleep: () => assert.fail('Must not shorten Retry-After'), fetchImpl: async url => {
  256. if (!new URL(url).pathname.endsWith('/chats')) return emptyRoute(url);
  257. attempts += 1;
  258. return response({ error: { code: 'SecretTenantName', message: 'SECRET_RESPONSE' } }, 429, { 'retry-after': '300' });
  259. } });
  260. const result = await provider.sync();
  261. assert.equal(result.chats.error.code, 'throttled');
  262. assert.equal(attempts, 1);
  263. assert.doesNotMatch(JSON.stringify([provider.status(), store.logs]), /SECRET_RESPONSE|SecretTenantName/);
  264. });
  265. test('sync calls share one in-flight pass and logout prevents late responses from writing records/cursors', async () => {
  266. const pending = [];
  267. const { provider, store } = await fixture({ fetchImpl: url => new Promise(resolve => pending.push({ url, resolve })) });
  268. const first = provider.sync(), second = provider.sync();
  269. assert.equal(first, second);
  270. await tick();
  271. assert.equal(pending.length, 2);
  272. await provider.logout();
  273. for (const request of pending) request.resolve(emptyRoute(request.url));
  274. assert.deepEqual(await first, { cancelled: true });
  275. assert.equal(store.records.size, 0);
  276. assert.equal(store.states.size, 0);
  277. assert.equal(provider.status().authenticated, false);
  278. assert.equal(provider.status().syncing, false);
  279. });
  280. test('switching accounts does not reuse another account message or calendar cursors', async () => {
  281. const msal = fakeMsal();
  282. const calls = [];
  283. const { provider, store } = await fixture({ msal, fetchImpl: async url => {
  284. calls.push(url);
  285. const parsed = new URL(url);
  286. if (parsed.pathname.endsWith('/chats')) return response({ value: [{ id: 'shared-chat-id' }] });
  287. if (parsed.pathname.endsWith('/messages')) return response({ value: [{ id: 'm', lastModifiedDateTime: '2026-09-08T11:00:00Z' }] });
  288. return emptyRoute(url);
  289. } });
  290. await provider.sync();
  291. await provider.logout();
  292. msal.acquireTokenByCode = async () => ({ accessToken: 'OTHER_TOKEN', account: { ...USER, homeAccountId: 'other.home' } });
  293. await provider.beginLogin();
  294. await provider.completeLogin(new URLSearchParams({ state: msal.authRequest.state, code: 'new-code' }));
  295. const callCount = calls.length;
  296. await provider.sync();
  297. assert.equal(store.states.size, 4);
  298. for (const url of calls.slice(callCount)) {
  299. assert.equal(new URL(url).searchParams.has('$filter'), false);
  300. assert.equal(new URL(url).searchParams.has('$deltatoken'), false);
  301. }
  302. });
  303. test('identical message IDs from different chats remain separate records', async () => {
  304. const { provider, store } = await fixture({ fetchImpl: async url => {
  305. const parsed = new URL(url);
  306. if (parsed.pathname.endsWith('/chats')) return response({ value: [{ id: 'chat:one' }, { id: 'chat:two' }] });
  307. if (parsed.pathname.endsWith('/messages')) return response({ value: [{ id: 'same-id', body: { content: 'message' } }] });
  308. return emptyRoute(url);
  309. } });
  310. await provider.sync();
  311. const messages = [...store.records.values()].filter(value => value.kind === 'message');
  312. assert.equal(messages.length, 2);
  313. assert.notEqual(messages[0].externalId, messages[1].externalId);
  314. assert.ok(messages.every(value => value.raw.id === 'same-id'));
  315. });
  316. test('message deletion stays a deletion while calendar removal only marks view membership', async () => {
  317. const message = { id: 'deleted-message', deletedDateTime: '2026-09-08T11:00:00Z' };
  318. const event = { id: 'removed-event', '@removed': { reason: 'deleted' } };
  319. const { provider, store } = await fixture({ fetchImpl: async url => {
  320. const parsed = new URL(url);
  321. if (parsed.pathname.endsWith('/chats')) return response({ value: [{ id: 'chat' }] });
  322. if (parsed.pathname.endsWith('/messages')) return response({ value: [message] });
  323. return response({ value: [event], '@odata.deltaLink': `${ROOT}/me/calendarView/delta?$deltatoken=final` });
  324. } });
  325. await provider.sync();
  326. const savedMessage = [...store.records.values()].find(value => value.kind === 'message');
  327. const savedEvent = [...store.records.values()].find(value => value.kind === 'event');
  328. assert.equal(savedMessage.deleted, true);
  329. assert.equal(savedMessage.removedFromView, false);
  330. assert.equal(savedEvent.deleted, false);
  331. assert.equal(savedEvent.removedFromView, true);
  332. assert.equal(savedEvent.title, undefined);
  333. assert.equal(savedEvent.text, undefined);
  334. assert.deepEqual(savedEvent.raw, event);
  335. });
  336. test('timeouts produce a content-free failure without advancing cursors', async () => {
  337. const { provider, store } = await fixture({ config: { clientId: 'test', maxRetries: 0, requestTimeoutMs: 10 },
  338. fetchImpl: async (url, options) => {
  339. if (!new URL(url).pathname.endsWith('/chats')) return emptyRoute(url);
  340. return new Promise((resolve, reject) => {
  341. options.signal.addEventListener('abort', () => reject(options.signal.reason), { once: true });
  342. });
  343. } });
  344. // AbortSignal.timeout is unref'ed; a referenced guard keeps this isolated offline test alive.
  345. const guard = setTimeout(() => assert.fail('Timeout not enforced'), 1000);
  346. try {
  347. const result = await provider.sync();
  348. assert.equal(result.chats.error.code, 'network_error');
  349. assert.equal(result.calendar.completed, true);
  350. assert.equal([...store.states.keys()].filter(key => key.includes(':chat:')).length, 0);
  351. } finally { clearTimeout(guard); }
  352. });