meetings.ts

packages/fathom-client/src/resources/meetings.ts

1. /**
2. * Meetings, and the action items inside them.
3. *
4. * The unit of work is the action item, but the unit of access is the meeting:
5. * who was invited decides who may see anything about it, so the two travel
6. * together and this resource never returns items detached from their meeting.
7. */
9. import { FATHOM_PAGE_SIZE } from '../constants.js'
10. import type { FathomClient } from '../http.js'
11. import type { FathomMeeting, MeetingWindow } from '../types.js'
13. interface ListResponse {
14. items?: FathomMeeting[]
15. /**
16. * The end sentinel is an empty string, not null and not absent (verified
17. * live). A loop written as `while (cursor !== undefined)` never terminates.
18. * Same family as the Plinth unassigned sentinel: trust the wire over the
19. * docs.
20. */
21. next_cursor?: string | null
22. limit?: number
23. }
25. export class MeetingsResource {
26. constructor(private readonly client: FathomClient) {}
28. /**
29. * Meetings created since `sinceIso`, newest first, with their action items.
30. *
31. * `include_action_items` is deliberately the only include set. It is not in
32. * Fathom's "heavy request" list, so this stays on the 60-calls/60s global
33. * bucket; adding include_summary or include_transcript would move every call
34. * into the bucket that can be squeezed to five a minute.
35. *
36. * A page cap that is hit returns `truncated: true` with everything fetched so
37. * far. Never throw away fetched data to guard against a hypothetical.
38. */
39. async listSince(sinceIso: string, maxPages = 20): Promise<MeetingWindow> {
40. const meetings: FathomMeeting[] = []
41. let cursor: string | undefined
42. let pages = 0
43. let truncated = true
45. for (let page = 0; page < maxPages; page++) {
46. const body = await this.client.get<ListResponse>('/meetings', {
47. created_after: sinceIso,
48. include_action_items: true,
49. limit: FATHOM_PAGE_SIZE,
50. cursor,
51. })
52. pages = page + 1
53. meetings.push(...(body.items ?? []))
55. // Empty string, null and undefined all mean "no more pages". Only a
56. // non-empty cursor continues the sweep.
57. const next = body.next_cursor
58. if (!next) {
59. truncated = false
60. break
61. }
62. cursor = next
63. }
65. return { meetings, truncated, pages }
66. }
67. }