@twentyhq/call-recorder 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (229) hide show
  1. package/.env.example +5 -0
  2. package/.nvmrc +1 -0
  3. package/.oxlintrc.json +20 -0
  4. package/.yarnrc.yml +1 -0
  5. package/AGENTS.md +67 -0
  6. package/CLAUDE.md +67 -0
  7. package/README.md +24 -0
  8. package/SETUP.md +95 -0
  9. package/package.json +42 -0
  10. package/public/gallery/call-recorder-cover.png +0 -0
  11. package/public/logo.svg +5 -0
  12. package/src/__tests__/global-setup.ts +100 -0
  13. package/src/__tests__/schema.integration-test.ts +104 -0
  14. package/src/application-config.ts +96 -0
  15. package/src/constants/__tests__/call-recording-field-universal-identifiers.test.ts +19 -0
  16. package/src/constants/app-description.ts +2 -0
  17. package/src/constants/app-display-name.ts +1 -0
  18. package/src/constants/application-universal-identifier.ts +2 -0
  19. package/src/constants/calendar-event-reconciliation-logic-function-universal-identifier.ts +2 -0
  20. package/src/constants/calendar-event-record-page-layout-universal-identifier.ts +2 -0
  21. package/src/constants/calendar-event-recording-front-component-universal-identifier.ts +2 -0
  22. package/src/constants/calendar-event-recording-page-layout-tab-universal-identifier.ts +2 -0
  23. package/src/constants/calendar-event-recording-page-layout-widget-universal-identifier.ts +2 -0
  24. package/src/constants/call-recorder-everyone-left-timeout-seconds-app-variable-universal-identifier.ts +2 -0
  25. package/src/constants/call-recorder-failure-reason-on-call-recording-field-universal-identifier.ts +2 -0
  26. package/src/constants/call-recorder-join-early-minutes-app-variable-universal-identifier.ts +2 -0
  27. package/src/constants/call-recorder-name-app-variable-universal-identifier.ts +2 -0
  28. package/src/constants/call-recorder-noone-joined-timeout-seconds-app-variable-universal-identifier.ts +2 -0
  29. package/src/constants/call-recorder-preference-off-option-id.ts +2 -0
  30. package/src/constants/call-recorder-preference-on-calendar-event-field-universal-identifier.ts +2 -0
  31. package/src/constants/call-recorder-preference-on-calendar-event-view-field-universal-identifier.ts +2 -0
  32. package/src/constants/call-recorder-preference-on-option-id.ts +2 -0
  33. package/src/constants/call-recorder-preference.ts +4 -0
  34. package/src/constants/call-recorder-waiting-room-timeout-seconds-app-variable-universal-identifier.ts +2 -0
  35. package/src/constants/call-recording-audio-field-universal-identifier.ts +2 -0
  36. package/src/constants/call-recording-video-field-universal-identifier.ts +2 -0
  37. package/src/constants/default-role-universal-identifier.ts +2 -0
  38. package/src/constants/process-recall-webhook-logic-function-universal-identifier.ts +2 -0
  39. package/src/constants/recall-webhook-logic-function-universal-identifier.ts +2 -0
  40. package/src/constants/stale-bot-state-logic-function-universal-identifier.ts +2 -0
  41. package/src/default-role.ts +69 -0
  42. package/src/fields/call-recorder-failure-reason-on-call-recording.field.ts +22 -0
  43. package/src/fields/call-recorder-preference-on-calendar-event.field.ts +41 -0
  44. package/src/front-components/calendar-event-recording.front-component.tsx +13 -0
  45. package/src/front-components/components/CalendarEventRecording.tsx +39 -0
  46. package/src/front-components/components/CalendarEventRecordingBody.tsx +96 -0
  47. package/src/front-components/components/CalendarEventRecordingContent.tsx +111 -0
  48. package/src/front-components/components/RecordingTranscript.tsx +92 -0
  49. package/src/front-components/components/RecordingVideoPlayer.tsx +52 -0
  50. package/src/front-components/components/TranscriptEntryList.tsx +61 -0
  51. package/src/front-components/components/TranscriptEntryListItem.tsx +115 -0
  52. package/src/front-components/components/TranscriptErrorBox.tsx +48 -0
  53. package/src/front-components/components/TranscriptSpeakerAvatar.tsx +141 -0
  54. package/src/front-components/components/TranscriptSpeakerChip.tsx +51 -0
  55. package/src/front-components/constants/recording-theme-css-variables.ts +40 -0
  56. package/src/front-components/hooks/use-calendar-event-participants.ts +172 -0
  57. package/src/front-components/hooks/use-calendar-event-recording.ts +155 -0
  58. package/src/front-components/types/calendar-event-participant-by-speaker-name.type.ts +6 -0
  59. package/src/front-components/types/calendar-event-recording-participant.type.ts +7 -0
  60. package/src/front-components/types/transcript-entry.type.ts +13 -0
  61. package/src/front-components/utils/__tests__/find-active-transcript-entry-index.test.ts +66 -0
  62. package/src/front-components/utils/__tests__/format-transcript-timestamp.test.ts +29 -0
  63. package/src/front-components/utils/__tests__/get-speaker-name-match-keys.test.ts +22 -0
  64. package/src/front-components/utils/__tests__/parse-transcript-entries.test.ts +162 -0
  65. package/src/front-components/utils/build-calendar-event-participant-by-speaker-name.util.ts +45 -0
  66. package/src/front-components/utils/find-active-transcript-entry-index.util.ts +77 -0
  67. package/src/front-components/utils/format-transcript-timestamp.util.ts +16 -0
  68. package/src/front-components/utils/get-absolute-avatar-url.util.ts +48 -0
  69. package/src/front-components/utils/get-calendar-event-participant-for-speaker-name.util.ts +24 -0
  70. package/src/front-components/utils/get-speaker-name-match-keys.util.ts +64 -0
  71. package/src/front-components/utils/get-video-file-extension.util.ts +23 -0
  72. package/src/front-components/utils/parse-transcript-entries.util.ts +85 -0
  73. package/src/logic-functions/__tests__/process-recall-webhook.test.ts +62 -0
  74. package/src/logic-functions/__tests__/recall-webhook.test.ts +180 -0
  75. package/src/logic-functions/constants/call-recorder-everyone-left-timeout-seconds-env-var-name.ts +2 -0
  76. package/src/logic-functions/constants/call-recorder-everyone-left-timeout-seconds.ts +1 -0
  77. package/src/logic-functions/constants/call-recorder-join-early-minutes-env-var-name.ts +2 -0
  78. package/src/logic-functions/constants/call-recorder-name-env-var-name.ts +1 -0
  79. package/src/logic-functions/constants/call-recorder-noone-joined-timeout-seconds-env-var-name.ts +2 -0
  80. package/src/logic-functions/constants/call-recorder-noone-joined-timeout-seconds.ts +1 -0
  81. package/src/logic-functions/constants/call-recorder-recording-retention-hours-env-var-name.ts +2 -0
  82. package/src/logic-functions/constants/call-recorder-waiting-room-timeout-seconds-env-var-name.ts +2 -0
  83. package/src/logic-functions/constants/call-recorder-waiting-room-timeout-seconds.ts +1 -0
  84. package/src/logic-functions/constants/call-recording-micro-credits-per-hour.ts +1 -0
  85. package/src/logic-functions/constants/call-recording-request-status.ts +5 -0
  86. package/src/logic-functions/constants/call-recording-status.ts +9 -0
  87. package/src/logic-functions/constants/default-call-recorder-join-early-minutes.ts +1 -0
  88. package/src/logic-functions/constants/default-call-recorder-name.ts +1 -0
  89. package/src/logic-functions/constants/default-call-recorder-recording-retention-hours.ts +2 -0
  90. package/src/logic-functions/constants/default-recall-region.ts +1 -0
  91. package/src/logic-functions/constants/milliseconds-per-minute.ts +1 -0
  92. package/src/logic-functions/constants/non-terminal-call-recording-statuses.ts +8 -0
  93. package/src/logic-functions/constants/recall-api-key-env-var-name.ts +1 -0
  94. package/src/logic-functions/constants/recall-api-max-attempts.ts +1 -0
  95. package/src/logic-functions/constants/recall-api-retry-delay-ms.ts +1 -0
  96. package/src/logic-functions/constants/recall-bot-automatic-leave.ts +74 -0
  97. package/src/logic-functions/constants/recall-bot-everyone-left-min-activate-after-seconds.ts +1 -0
  98. package/src/logic-functions/constants/recall-bot-recording-config.ts +34 -0
  99. package/src/logic-functions/constants/recall-region-env-var-name.ts +1 -0
  100. package/src/logic-functions/constants/recall-webhook-secret-env-var-name.ts +1 -0
  101. package/src/logic-functions/constants/restricted-field-placeholder.ts +3 -0
  102. package/src/logic-functions/constants/stale-bot-state-cron-pattern.ts +1 -0
  103. package/src/logic-functions/constants/twenty-page-size.ts +1 -0
  104. package/src/logic-functions/data/__tests__/complete-call-recording-ingestion.test.ts +55 -0
  105. package/src/logic-functions/data/__tests__/fetch-all-nodes.test.ts +43 -0
  106. package/src/logic-functions/data/__tests__/get-current-workspace-id.test.ts +38 -0
  107. package/src/logic-functions/data/__tests__/strip-restricted-field-value.test.ts +22 -0
  108. package/src/logic-functions/data/complete-call-recording-ingestion.util.ts +24 -0
  109. package/src/logic-functions/data/create-call-recording.util.ts +41 -0
  110. package/src/logic-functions/data/fetch-all-nodes.util.ts +44 -0
  111. package/src/logic-functions/data/fetch-calendar-events-by-filter.util.ts +80 -0
  112. package/src/logic-functions/data/fetch-calendar-events-by-ids.util.ts +20 -0
  113. package/src/logic-functions/data/fetch-calendar-events-by-starts-at-values.util.ts +19 -0
  114. package/src/logic-functions/data/find-call-recordings-by-calendar-event-ids.util.ts +17 -0
  115. package/src/logic-functions/data/find-call-recordings-by-filter.util.ts +102 -0
  116. package/src/logic-functions/data/find-call-recordings-by-ids.util.ts +17 -0
  117. package/src/logic-functions/data/find-open-scheduled-call-recordings.util.ts +14 -0
  118. package/src/logic-functions/data/get-current-workspace-id.util.ts +36 -0
  119. package/src/logic-functions/data/strip-restricted-field-value.util.ts +6 -0
  120. package/src/logic-functions/data/update-call-recording.util.ts +24 -0
  121. package/src/logic-functions/domain/__tests__/build-call-recorder-policy-result.test.ts +47 -0
  122. package/src/logic-functions/domain/__tests__/compute-call-recording-charge.test.ts +71 -0
  123. package/src/logic-functions/domain/__tests__/compute-call-recording-id-for-meeting.test.ts +37 -0
  124. package/src/logic-functions/domain/__tests__/compute-real-meeting-key.test.ts +88 -0
  125. package/src/logic-functions/domain/__tests__/is-call-recording-ingestion-complete.test.ts +59 -0
  126. package/src/logic-functions/domain/__tests__/is-call-recording-status-downgrade.test.ts +37 -0
  127. package/src/logic-functions/domain/__tests__/resolve-call-recorder-policy-result.test.ts +120 -0
  128. package/src/logic-functions/domain/__tests__/should-complete-call-recording-ingestion.test.ts +102 -0
  129. package/src/logic-functions/domain/aggregate-call-recorder-policy-results-by-meeting.util.ts +42 -0
  130. package/src/logic-functions/domain/build-call-recorder-policy-result.util.ts +53 -0
  131. package/src/logic-functions/domain/build-failed-transcript-marker.util.ts +13 -0
  132. package/src/logic-functions/domain/build-pending-transcript-marker.util.ts +13 -0
  133. package/src/logic-functions/domain/build-recall-routing-metadata.util.ts +12 -0
  134. package/src/logic-functions/domain/build-transcript-failure-reason.util.ts +7 -0
  135. package/src/logic-functions/domain/compute-call-recording-charge.util.ts +41 -0
  136. package/src/logic-functions/domain/compute-call-recording-id-for-meeting.util.ts +16 -0
  137. package/src/logic-functions/domain/compute-real-meeting-key.util.ts +48 -0
  138. package/src/logic-functions/domain/compute-recall-bot-join-at.util.ts +34 -0
  139. package/src/logic-functions/domain/is-call-recording-ingestion-complete.util.ts +19 -0
  140. package/src/logic-functions/domain/is-call-recording-status-downgrade.util.ts +37 -0
  141. package/src/logic-functions/domain/is-recall-recording-done-signal.util.ts +13 -0
  142. package/src/logic-functions/domain/map-recall-status-code-to-call-recording-status.util.ts +26 -0
  143. package/src/logic-functions/domain/parse-transcript-marker.util.ts +29 -0
  144. package/src/logic-functions/domain/resolve-call-recorder-policy-result.util.ts +72 -0
  145. package/src/logic-functions/domain/should-complete-call-recording-ingestion.util.ts +32 -0
  146. package/src/logic-functions/flows/__tests__/charge-completed-call-recording.test.ts +45 -0
  147. package/src/logic-functions/flows/__tests__/complete-and-charge-call-recording.test.ts +61 -0
  148. package/src/logic-functions/flows/__tests__/converge-diverged-call-recordings.test.ts +727 -0
  149. package/src/logic-functions/flows/__tests__/download-transcript.test.ts +74 -0
  150. package/src/logic-functions/flows/__tests__/handle-recall-webhook.test.ts +1301 -0
  151. package/src/logic-functions/flows/__tests__/heal-call-recordings-missing-bot.test.ts +225 -0
  152. package/src/logic-functions/flows/__tests__/ingest-call-recording-media.test.ts +153 -0
  153. package/src/logic-functions/flows/__tests__/reap-orphaned-call-recorders.test.ts +425 -0
  154. package/src/logic-functions/flows/__tests__/reconcile-call-recorder.test.ts +1007 -0
  155. package/src/logic-functions/flows/cancel-call-recording-request.util.ts +46 -0
  156. package/src/logic-functions/flows/charge-completed-call-recording.util.ts +31 -0
  157. package/src/logic-functions/flows/complete-and-charge-call-recording.util.ts +29 -0
  158. package/src/logic-functions/flows/converge-diverged-call-recordings-result.type.ts +8 -0
  159. package/src/logic-functions/flows/converge-diverged-call-recordings.util.ts +447 -0
  160. package/src/logic-functions/flows/download-transcript.util.ts +67 -0
  161. package/src/logic-functions/flows/ensure-call-recorder.util.ts +73 -0
  162. package/src/logic-functions/flows/handle-recall-webhook.util.ts +672 -0
  163. package/src/logic-functions/flows/heal-call-recordings-missing-bot.util.ts +82 -0
  164. package/src/logic-functions/flows/ingest-call-recording-media.util.ts +128 -0
  165. package/src/logic-functions/flows/persist-call-recording-progress.util.ts +58 -0
  166. package/src/logic-functions/flows/reap-orphaned-call-recorders.util.ts +183 -0
  167. package/src/logic-functions/flows/reconcile-call-recorder.util.ts +495 -0
  168. package/src/logic-functions/flows/reconcile-call-recording-transcript-artifact-result.type.ts +11 -0
  169. package/src/logic-functions/flows/reconcile-call-recording-transcript-artifact.util.ts +182 -0
  170. package/src/logic-functions/flows/reschedule-call-recording-bot.util.ts +69 -0
  171. package/src/logic-functions/process-recall-webhook.ts +23 -0
  172. package/src/logic-functions/recall-api/__tests__/extract-recall-bot-convergence.test.ts +153 -0
  173. package/src/logic-functions/recall-api/__tests__/extract-recall-media-urls.test.ts +67 -0
  174. package/src/logic-functions/recall-api/__tests__/recall-bot-api.test.ts +744 -0
  175. package/src/logic-functions/recall-api/__tests__/verify-recall-webhook-signature.test.ts +122 -0
  176. package/src/logic-functions/recall-api/cancel-recall-bot.util.ts +28 -0
  177. package/src/logic-functions/recall-api/create-async-recall-transcript.util.ts +47 -0
  178. package/src/logic-functions/recall-api/eject-recall-bot.util.ts +28 -0
  179. package/src/logic-functions/recall-api/extract-recall-bot-convergence.util.ts +149 -0
  180. package/src/logic-functions/recall-api/extract-recall-bot-id.util.ts +10 -0
  181. package/src/logic-functions/recall-api/extract-recall-media-urls.util.ts +30 -0
  182. package/src/logic-functions/recall-api/extract-twenty-workspace-id-from-recall-webhook.util.ts +8 -0
  183. package/src/logic-functions/recall-api/get-recall-api-config.util.ts +59 -0
  184. package/src/logic-functions/recall-api/get-recall-bot.util.ts +42 -0
  185. package/src/logic-functions/recall-api/get-recall-recording.util.ts +31 -0
  186. package/src/logic-functions/recall-api/get-recall-webhook-bot-metadata.util.ts +18 -0
  187. package/src/logic-functions/recall-api/list-recall-transcripts.util.ts +141 -0
  188. package/src/logic-functions/recall-api/list-scheduled-recall-bots.util.ts +106 -0
  189. package/src/logic-functions/recall-api/normalize-recall-timestamp.util.ts +14 -0
  190. package/src/logic-functions/recall-api/parse-recall-webhook-event.util.ts +88 -0
  191. package/src/logic-functions/recall-api/recall-bot-api-request.util.ts +165 -0
  192. package/src/logic-functions/recall-api/recall-transcript-summary.type.ts +5 -0
  193. package/src/logic-functions/recall-api/reschedule-recall-bot.util.ts +56 -0
  194. package/src/logic-functions/recall-api/retrieve-recall-transcript.util.ts +71 -0
  195. package/src/logic-functions/recall-api/schedule-recall-bot.util.ts +68 -0
  196. package/src/logic-functions/recall-api/verify-recall-webhook-signature.util.ts +109 -0
  197. package/src/logic-functions/recall-webhook.ts +90 -0
  198. package/src/logic-functions/reconcile-call-recorder-calendar-event.ts +178 -0
  199. package/src/logic-functions/reconcile-stale-bot-state.ts +106 -0
  200. package/src/logic-functions/types/calendar-event-record.type.ts +5 -0
  201. package/src/logic-functions/types/call-recorder-policy-calendar-event-input.type.ts +10 -0
  202. package/src/logic-functions/types/call-recorder-policy-input.type.ts +9 -0
  203. package/src/logic-functions/types/call-recorder-policy-not-required-reason.type.ts +5 -0
  204. package/src/logic-functions/types/call-recorder-policy-required-reason.type.ts +1 -0
  205. package/src/logic-functions/types/call-recorder-policy-result-for-calendar-event.type.ts +9 -0
  206. package/src/logic-functions/types/call-recorder-policy-result-for-meeting.type.ts +6 -0
  207. package/src/logic-functions/types/call-recorder-policy-result.type.ts +12 -0
  208. package/src/logic-functions/types/call-recorder-reconciliation-result.type.ts +16 -0
  209. package/src/logic-functions/types/call-recording-media-file.type.ts +1 -0
  210. package/src/logic-functions/types/call-recording-record.type.ts +15 -0
  211. package/src/logic-functions/types/call-recording-update-fields.type.ts +20 -0
  212. package/src/logic-functions/types/files-field-value.type.ts +1 -0
  213. package/src/logic-functions/types/meeting-recording.type.ts +7 -0
  214. package/src/logic-functions/types/recall-bot-operation-result.type.ts +19 -0
  215. package/src/logic-functions/types/recall-routing-metadata.type.ts +4 -0
  216. package/src/logic-functions/types/removed-call-recorder-occurrence.type.ts +6 -0
  217. package/src/logic-functions/types/transcript-marker.type.ts +6 -0
  218. package/src/logic-functions/utils/as-record.util.ts +6 -0
  219. package/src/logic-functions/utils/get-application-variable-value.util.ts +3 -0
  220. package/src/logic-functions/utils/get-record-at-path.util.ts +10 -0
  221. package/src/logic-functions/utils/get-string.util.ts +4 -0
  222. package/src/logic-functions/utils/get-unique-sorted-ids.util.ts +8 -0
  223. package/src/logic-functions/utils/is-non-empty-string.util.ts +5 -0
  224. package/src/page-layouts/calendar-event-recording-tab.ts +33 -0
  225. package/src/view-fields/call-recorder-preference-on-calendar-event.view-field.ts +27 -0
  226. package/tsconfig.json +42 -0
  227. package/tsconfig.spec.json +9 -0
  228. package/vitest.config.ts +31 -0
  229. package/vitest.unit.config.ts +14 -0
@@ -0,0 +1,71 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { computeCallRecordingCharge } from 'src/logic-functions/domain/compute-call-recording-charge.util';
4
+
5
+ describe('computeCallRecordingCharge', () => {
6
+ it('charges one credit for a one-hour recording', () => {
7
+ expect(
8
+ computeCallRecordingCharge({
9
+ startedAt: '2026-06-10T09:00:00.000Z',
10
+ endedAt: '2026-06-10T10:00:00.000Z',
11
+ }),
12
+ ).toEqual({
13
+ creditsUsedMicro: 1_000_000,
14
+ quantityMinutes: 60,
15
+ });
16
+ });
17
+
18
+ it('prorates partial hours by duration', () => {
19
+ expect(
20
+ computeCallRecordingCharge({
21
+ startedAt: '2026-06-10T09:00:00.000Z',
22
+ endedAt: '2026-06-10T09:45:00.000Z',
23
+ }),
24
+ ).toEqual({
25
+ creditsUsedMicro: 750_000,
26
+ quantityMinutes: 45,
27
+ });
28
+ });
29
+
30
+ it('reports at least one minute for very short recordings', () => {
31
+ expect(
32
+ computeCallRecordingCharge({
33
+ startedAt: '2026-06-10T09:00:00.000Z',
34
+ endedAt: '2026-06-10T09:00:30.000Z',
35
+ }),
36
+ ).toEqual({
37
+ creditsUsedMicro: 8_333,
38
+ quantityMinutes: 1,
39
+ });
40
+ });
41
+
42
+ it('returns undefined when either timestamp is missing', () => {
43
+ expect(
44
+ computeCallRecordingCharge({
45
+ startedAt: undefined,
46
+ endedAt: '2026-06-10T10:00:00.000Z',
47
+ }),
48
+ ).toBeUndefined();
49
+ expect(
50
+ computeCallRecordingCharge({
51
+ startedAt: '2026-06-10T09:00:00.000Z',
52
+ endedAt: undefined,
53
+ }),
54
+ ).toBeUndefined();
55
+ });
56
+
57
+ it('returns undefined for non-positive or unparseable durations', () => {
58
+ expect(
59
+ computeCallRecordingCharge({
60
+ startedAt: '2026-06-10T10:00:00.000Z',
61
+ endedAt: '2026-06-10T09:00:00.000Z',
62
+ }),
63
+ ).toBeUndefined();
64
+ expect(
65
+ computeCallRecordingCharge({
66
+ startedAt: 'not-a-date',
67
+ endedAt: '2026-06-10T10:00:00.000Z',
68
+ }),
69
+ ).toBeUndefined();
70
+ });
71
+ });
@@ -0,0 +1,37 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { computeCallRecordingIdForMeeting } from 'src/logic-functions/domain/compute-call-recording-id-for-meeting.util';
4
+
5
+ const UUID_V4_PATTERN =
6
+ /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
7
+
8
+ describe('computeCallRecordingIdForMeeting', () => {
9
+ it('returns the same id for the same real meeting key', () => {
10
+ const realMeetingKey =
11
+ 'link:meet.example.com/sync:2026-01-01T13:00:00.000Z';
12
+
13
+ expect(computeCallRecordingIdForMeeting(realMeetingKey)).toBe(
14
+ computeCallRecordingIdForMeeting(realMeetingKey),
15
+ );
16
+ });
17
+
18
+ it('returns different ids for different real meeting keys', () => {
19
+ expect(
20
+ computeCallRecordingIdForMeeting(
21
+ 'link:meet.example.com/sync:2026-01-01T13:00:00.000Z',
22
+ ),
23
+ ).not.toBe(
24
+ computeCallRecordingIdForMeeting(
25
+ 'link:meet.example.com/sync:2026-01-02T13:00:00.000Z',
26
+ ),
27
+ );
28
+ });
29
+
30
+ it('returns a v4-shaped uuid', () => {
31
+ expect(
32
+ computeCallRecordingIdForMeeting(
33
+ 'ical:some-uid:2026-01-01T13:00:00.000Z',
34
+ ),
35
+ ).toMatch(UUID_V4_PATTERN);
36
+ });
37
+ });
@@ -0,0 +1,88 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { computeRealMeetingKey } from 'src/logic-functions/domain/compute-real-meeting-key.util';
4
+
5
+ const STARTS_AT = '2026-01-01T13:00:00.000Z';
6
+
7
+ const buildInput = (
8
+ overrides: Partial<Parameters<typeof computeRealMeetingKey>[0]> = {},
9
+ ) => ({
10
+ calendarEventId: 'calendar-event-1',
11
+ conferenceLinkUrl: 'https://meet.example.com/customer-sync',
12
+ iCalUid: 'calendar-event-uid',
13
+ startsAt: STARTS_AT,
14
+ ...overrides,
15
+ });
16
+
17
+ describe('computeRealMeetingKey', () => {
18
+ it.each([
19
+ [
20
+ 'strips protocol, query, and fragment',
21
+ 'https://zoom.us/j/123?pwd=abc#section',
22
+ `link:zoom.us/j/123:${STARTS_AT}`,
23
+ ],
24
+ [
25
+ 'strips www and lowercases',
26
+ 'HTTPS://WWW.Meet.Example.com/Customer-Sync',
27
+ `link:meet.example.com/customer-sync:${STARTS_AT}`,
28
+ ],
29
+ [
30
+ 'strips trailing slashes',
31
+ 'https://meet.example.com/customer-sync///',
32
+ `link:meet.example.com/customer-sync:${STARTS_AT}`,
33
+ ],
34
+ [
35
+ 'supports plain http links',
36
+ 'http://meet.example.com/customer-sync',
37
+ `link:meet.example.com/customer-sync:${STARTS_AT}`,
38
+ ],
39
+ ])('%s', (_label, conferenceLinkUrl, expectedKey) => {
40
+ expect(computeRealMeetingKey(buildInput({ conferenceLinkUrl }))).toBe(
41
+ expectedKey,
42
+ );
43
+ });
44
+
45
+ it('produces the same key for the same meeting synced from two calendars', () => {
46
+ const fromFirstAttendee = computeRealMeetingKey(
47
+ buildInput({
48
+ calendarEventId: 'calendar-event-1',
49
+ conferenceLinkUrl: 'https://zoom.us/j/123?pwd=first-attendee-token',
50
+ }),
51
+ );
52
+ const fromSecondAttendee = computeRealMeetingKey(
53
+ buildInput({
54
+ calendarEventId: 'calendar-event-2',
55
+ conferenceLinkUrl:
56
+ 'https://www.zoom.us/j/123?pwd=second-attendee-token',
57
+ }),
58
+ );
59
+
60
+ expect(fromFirstAttendee).toBe(fromSecondAttendee);
61
+ });
62
+
63
+ it('falls back to the iCal uid when the link is blank', () => {
64
+ expect(
65
+ computeRealMeetingKey(buildInput({ conferenceLinkUrl: ' ' })),
66
+ ).toBe(`ical:calendar-event-uid:${STARTS_AT}`);
67
+ });
68
+
69
+ it('falls back to the iCal uid when the link is not a string', () => {
70
+ expect(computeRealMeetingKey(buildInput({ conferenceLinkUrl: 42 }))).toBe(
71
+ `ical:calendar-event-uid:${STARTS_AT}`,
72
+ );
73
+ });
74
+
75
+ it('falls back to the calendar event id when link and iCal uid are missing', () => {
76
+ expect(
77
+ computeRealMeetingKey(
78
+ buildInput({ conferenceLinkUrl: undefined, iCalUid: '' }),
79
+ ),
80
+ ).toBe('event:calendar-event-1');
81
+ });
82
+
83
+ it('keeps link keys distinct across start times', () => {
84
+ expect(computeRealMeetingKey(buildInput({ startsAt: undefined }))).toBe(
85
+ 'link:meet.example.com/customer-sync:',
86
+ );
87
+ });
88
+ });
@@ -0,0 +1,59 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { isCallRecordingIngestionComplete } from 'src/logic-functions/domain/is-call-recording-ingestion-complete.util';
4
+
5
+ const AUDIO_VALUE = [{ fileId: 'file-audio-1', label: 'audio.mp3' }];
6
+ const VIDEO_VALUE = [{ fileId: 'file-video-1', label: 'video.mp4' }];
7
+ const TRANSCRIPT_CONTENT = [{ participant: { id: 1 }, words: [] }];
8
+
9
+ describe('isCallRecordingIngestionComplete', () => {
10
+ it('is complete when transcript content and both media files are present', () => {
11
+ expect(
12
+ isCallRecordingIngestionComplete({
13
+ transcript: TRANSCRIPT_CONTENT,
14
+ audio: AUDIO_VALUE,
15
+ video: VIDEO_VALUE,
16
+ }),
17
+ ).toBe(true);
18
+ });
19
+
20
+ it('is incomplete while the transcript holds a marker', () => {
21
+ expect(
22
+ isCallRecordingIngestionComplete({
23
+ transcript: {
24
+ recallTranscriptId: 'recall-transcript-1',
25
+ status: 'PENDING',
26
+ },
27
+ audio: AUDIO_VALUE,
28
+ video: VIDEO_VALUE,
29
+ }),
30
+ ).toBe(false);
31
+ });
32
+
33
+ it('is incomplete when the transcript is unset', () => {
34
+ expect(
35
+ isCallRecordingIngestionComplete({
36
+ transcript: null,
37
+ audio: AUDIO_VALUE,
38
+ video: VIDEO_VALUE,
39
+ }),
40
+ ).toBe(false);
41
+ });
42
+
43
+ it('is incomplete while any media field is empty', () => {
44
+ expect(
45
+ isCallRecordingIngestionComplete({
46
+ transcript: TRANSCRIPT_CONTENT,
47
+ audio: undefined,
48
+ video: VIDEO_VALUE,
49
+ }),
50
+ ).toBe(false);
51
+ expect(
52
+ isCallRecordingIngestionComplete({
53
+ transcript: TRANSCRIPT_CONTENT,
54
+ audio: AUDIO_VALUE,
55
+ video: [],
56
+ }),
57
+ ).toBe(false);
58
+ });
59
+ });
@@ -0,0 +1,37 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { isCallRecordingStatusDowngrade } from 'src/logic-functions/domain/is-call-recording-status-downgrade.util';
4
+
5
+ describe('isCallRecordingStatusDowngrade', () => {
6
+ it.each([
7
+ ['SCHEDULED', 'JOINING', false],
8
+ ['JOINING', 'RECORDING', false],
9
+ ['RECORDING', 'PROCESSING', false],
10
+ ['PROCESSING', 'FAILED', false],
11
+ ['PROCESSING', 'COMPLETED', false],
12
+ ['RECORDING', 'RECORDING', false],
13
+ ['COMPLETED', 'RECORDING', true],
14
+ ['PROCESSING', 'JOINING', true],
15
+ ['FAILED', 'RECORDING', true],
16
+ ['JOINING', 'SCHEDULED', true],
17
+ ])('from %s to %s -> %s', (fromStatus, toStatus, expected) => {
18
+ expect(isCallRecordingStatusDowngrade({ fromStatus, toStatus })).toBe(
19
+ expected,
20
+ );
21
+ });
22
+
23
+ it('never treats transitions from unknown statuses as downgrades', () => {
24
+ expect(
25
+ isCallRecordingStatusDowngrade({
26
+ fromStatus: undefined,
27
+ toStatus: 'COMPLETED',
28
+ }),
29
+ ).toBe(false);
30
+ expect(
31
+ isCallRecordingStatusDowngrade({
32
+ fromStatus: 'NOT_A_STATUS',
33
+ toStatus: 'SCHEDULED',
34
+ }),
35
+ ).toBe(false);
36
+ });
37
+ });
@@ -0,0 +1,120 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { CallRecorderPreference } from 'src/constants/call-recorder-preference';
4
+ import { resolveCallRecorderPolicyResult } from 'src/logic-functions/domain/resolve-call-recorder-policy-result.util';
5
+
6
+ const NOW = new Date('2026-01-01T12:00:00.000Z');
7
+ const FUTURE_STARTS_AT = '2026-01-01T13:00:00.000Z';
8
+ const FUTURE_ENDS_AT = '2026-01-01T14:00:00.000Z';
9
+ const PAST_STARTS_AT = '2026-01-01T09:00:00.000Z';
10
+ const PAST_ENDS_AT = '2026-01-01T10:00:00.000Z';
11
+
12
+ describe('resolveCallRecorderPolicyResult', () => {
13
+ it('requires a bot when preference is ON and the event is upcoming', () => {
14
+ expect(
15
+ resolveCallRecorderPolicyResult({
16
+ input: {
17
+ callRecorderPreference: CallRecorderPreference.ON,
18
+ isCanceled: false,
19
+ startsAt: FUTURE_STARTS_AT,
20
+ endsAt: FUTURE_ENDS_AT,
21
+ conferenceLinkUrl: 'https://meet.example.com/team-sync',
22
+ },
23
+ now: NOW,
24
+ }),
25
+ ).toEqual({
26
+ shouldRequestBot: true,
27
+ reason: 'RECORDING_ENABLED',
28
+ });
29
+ });
30
+
31
+ it('does not request a bot for ON when the meeting has no conference link', () => {
32
+ expect(
33
+ resolveCallRecorderPolicyResult({
34
+ input: {
35
+ callRecorderPreference: CallRecorderPreference.ON,
36
+ isCanceled: false,
37
+ startsAt: FUTURE_STARTS_AT,
38
+ endsAt: FUTURE_ENDS_AT,
39
+ conferenceLinkUrl: undefined,
40
+ },
41
+ now: NOW,
42
+ }),
43
+ ).toEqual({
44
+ shouldRequestBot: false,
45
+ reason: 'MISSING_CONFERENCE_LINK',
46
+ });
47
+ });
48
+
49
+ it('requires a bot without an event preference override', () => {
50
+ expect(
51
+ resolveCallRecorderPolicyResult({
52
+ input: {
53
+ callRecorderPreference: undefined,
54
+ isCanceled: false,
55
+ startsAt: FUTURE_STARTS_AT,
56
+ endsAt: FUTURE_ENDS_AT,
57
+ conferenceLinkUrl: 'https://meet.example.com/team-sync',
58
+ },
59
+ now: NOW,
60
+ }),
61
+ ).toEqual({
62
+ shouldRequestBot: true,
63
+ reason: 'RECORDING_ENABLED',
64
+ });
65
+ });
66
+
67
+ it('lets an OFF event preference opt out of workspace auto-recording', () => {
68
+ expect(
69
+ resolveCallRecorderPolicyResult({
70
+ input: {
71
+ callRecorderPreference: CallRecorderPreference.OFF,
72
+ isCanceled: false,
73
+ startsAt: FUTURE_STARTS_AT,
74
+ endsAt: FUTURE_ENDS_AT,
75
+ conferenceLinkUrl: 'https://meet.example.com/team-sync',
76
+ },
77
+ now: NOW,
78
+ }),
79
+ ).toEqual({
80
+ shouldRequestBot: false,
81
+ reason: 'PREFERENCE_OFF',
82
+ });
83
+ });
84
+
85
+ it('does not request a bot for a meeting that already ended', () => {
86
+ expect(
87
+ resolveCallRecorderPolicyResult({
88
+ input: {
89
+ callRecorderPreference: undefined,
90
+ isCanceled: false,
91
+ startsAt: PAST_STARTS_AT,
92
+ endsAt: PAST_ENDS_AT,
93
+ conferenceLinkUrl: 'https://meet.example.com/team-sync',
94
+ },
95
+ now: NOW,
96
+ }),
97
+ ).toEqual({
98
+ shouldRequestBot: false,
99
+ reason: 'EVENT_NOT_UPCOMING',
100
+ });
101
+ });
102
+
103
+ it('does not request a bot for a canceled meeting', () => {
104
+ expect(
105
+ resolveCallRecorderPolicyResult({
106
+ input: {
107
+ callRecorderPreference: undefined,
108
+ isCanceled: true,
109
+ startsAt: FUTURE_STARTS_AT,
110
+ endsAt: FUTURE_ENDS_AT,
111
+ conferenceLinkUrl: 'https://meet.example.com/team-sync',
112
+ },
113
+ now: NOW,
114
+ }),
115
+ ).toEqual({
116
+ shouldRequestBot: false,
117
+ reason: 'EVENT_CANCELED',
118
+ });
119
+ });
120
+ });
@@ -0,0 +1,102 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { CallRecordingStatus } from 'src/logic-functions/constants/call-recording-status';
4
+ import { shouldCompleteCallRecordingIngestion } from 'src/logic-functions/domain/should-complete-call-recording-ingestion.util';
5
+
6
+ const filledTranscript = [{ participant: { id: 1 }, words: [] }];
7
+ const filledAudio = [{ fileId: 'file-audio-1', label: 'audio.mp3' }];
8
+ const filledVideo = [{ fileId: 'file-video-1', label: 'video.mp4' }];
9
+
10
+ describe('shouldCompleteCallRecordingIngestion', () => {
11
+ it('requires complete artifacts and billable timestamps before completion', () => {
12
+ expect(
13
+ shouldCompleteCallRecordingIngestion({
14
+ current: {
15
+ status: CallRecordingStatus.PROCESSING,
16
+ startedAt: '2026-06-10T09:00:00.000Z',
17
+ endedAt: '2026-06-10T10:00:00.000Z',
18
+ transcript: filledTranscript,
19
+ audio: filledAudio,
20
+ video: filledVideo,
21
+ },
22
+ updateData: {},
23
+ }),
24
+ ).toBe(true);
25
+
26
+ expect(
27
+ shouldCompleteCallRecordingIngestion({
28
+ current: {
29
+ status: CallRecordingStatus.PROCESSING,
30
+ endedAt: '2026-06-10T10:00:00.000Z',
31
+ transcript: filledTranscript,
32
+ audio: filledAudio,
33
+ video: filledVideo,
34
+ },
35
+ updateData: {},
36
+ }),
37
+ ).toBe(false);
38
+
39
+ expect(
40
+ shouldCompleteCallRecordingIngestion({
41
+ current: {
42
+ status: CallRecordingStatus.PROCESSING,
43
+ transcript: filledTranscript,
44
+ audio: filledAudio,
45
+ video: filledVideo,
46
+ },
47
+ updateData: {
48
+ startedAt: '2026-06-10T09:00:00.000Z',
49
+ endedAt: '2026-06-10T10:00:00.000Z',
50
+ },
51
+ }),
52
+ ).toBe(true);
53
+
54
+ expect(
55
+ shouldCompleteCallRecordingIngestion({
56
+ current: {
57
+ status: CallRecordingStatus.PROCESSING,
58
+ startedAt: '2026-06-10T10:00:00.000Z',
59
+ endedAt: '2026-06-10T09:00:00.000Z',
60
+ transcript: filledTranscript,
61
+ audio: filledAudio,
62
+ video: filledVideo,
63
+ },
64
+ updateData: {},
65
+ }),
66
+ ).toBe(false);
67
+ });
68
+
69
+ it('does not complete a persisted failed recording', () => {
70
+ expect(
71
+ shouldCompleteCallRecordingIngestion({
72
+ current: {
73
+ status: CallRecordingStatus.FAILED,
74
+ startedAt: '2026-06-10T09:00:00.000Z',
75
+ endedAt: '2026-06-10T10:00:00.000Z',
76
+ transcript: filledTranscript,
77
+ audio: filledAudio,
78
+ video: filledVideo,
79
+ },
80
+ updateData: {},
81
+ }),
82
+ ).toBe(false);
83
+ });
84
+
85
+ it('does not complete when the incoming update marks the recording as failed', () => {
86
+ expect(
87
+ shouldCompleteCallRecordingIngestion({
88
+ current: {
89
+ status: CallRecordingStatus.PROCESSING,
90
+ startedAt: '2026-06-10T09:00:00.000Z',
91
+ endedAt: '2026-06-10T10:00:00.000Z',
92
+ transcript: filledTranscript,
93
+ audio: filledAudio,
94
+ video: filledVideo,
95
+ },
96
+ updateData: {
97
+ status: CallRecordingStatus.FAILED,
98
+ },
99
+ }),
100
+ ).toBe(false);
101
+ });
102
+ });
@@ -0,0 +1,42 @@
1
+ import { type CallRecorderPolicyResultForCalendarEvent } from 'src/logic-functions/types/call-recorder-policy-result-for-calendar-event.type';
2
+ import { type CallRecorderPolicyResultForMeeting } from 'src/logic-functions/types/call-recorder-policy-result-for-meeting.type';
3
+
4
+ type CallRecorderPolicyResultForMeetingInput = Pick<
5
+ CallRecorderPolicyResultForCalendarEvent,
6
+ 'calendarEventId' | 'realMeetingKey' | 'shouldRequestBot'
7
+ >;
8
+
9
+ export const aggregateCallRecorderPolicyResultsByMeeting = (
10
+ perCalendarEventPolicyResults: CallRecorderPolicyResultForMeetingInput[],
11
+ ): CallRecorderPolicyResultForMeeting[] => {
12
+ const meetingPolicyResultsByMeetingKey = new Map<
13
+ string,
14
+ CallRecorderPolicyResultForMeeting
15
+ >();
16
+
17
+ for (const {
18
+ calendarEventId,
19
+ realMeetingKey,
20
+ shouldRequestBot,
21
+ } of perCalendarEventPolicyResults) {
22
+ const meetingPolicyResult = meetingPolicyResultsByMeetingKey.get(
23
+ realMeetingKey,
24
+ ) ?? {
25
+ realMeetingKey,
26
+ shouldRequestBot: false,
27
+ calendarEventIds: [],
28
+ requestingCalendarEventIds: [],
29
+ };
30
+
31
+ meetingPolicyResult.calendarEventIds.push(calendarEventId);
32
+
33
+ if (shouldRequestBot) {
34
+ meetingPolicyResult.shouldRequestBot = true;
35
+ meetingPolicyResult.requestingCalendarEventIds.push(calendarEventId);
36
+ }
37
+
38
+ meetingPolicyResultsByMeetingKey.set(realMeetingKey, meetingPolicyResult);
39
+ }
40
+
41
+ return [...meetingPolicyResultsByMeetingKey.values()];
42
+ };
@@ -0,0 +1,53 @@
1
+ import { CallRecorderPreference } from 'src/constants/call-recorder-preference';
2
+ import { type CallRecorderPolicyCalendarEventInput } from 'src/logic-functions/types/call-recorder-policy-calendar-event-input.type';
3
+ import { type CallRecorderPolicyResultForCalendarEvent } from 'src/logic-functions/types/call-recorder-policy-result-for-calendar-event.type';
4
+ import { computeRealMeetingKey } from 'src/logic-functions/domain/compute-real-meeting-key.util';
5
+ import { resolveCallRecorderPolicyResult } from 'src/logic-functions/domain/resolve-call-recorder-policy-result.util';
6
+
7
+ export const buildCallRecorderPolicyResult = (
8
+ calendarEvent: CallRecorderPolicyCalendarEventInput,
9
+ now: Date,
10
+ ): CallRecorderPolicyResultForCalendarEvent => {
11
+ const realMeetingKey = computeRealMeetingKey({
12
+ calendarEventId: calendarEvent.id,
13
+ conferenceLinkUrl: calendarEvent.conferenceLinkUrl,
14
+ iCalUid: calendarEvent.iCalUid,
15
+ startsAt: calendarEvent.startsAt,
16
+ });
17
+
18
+ const callRecorderPreference = normalizeCallRecorderPreference(
19
+ calendarEvent.callRecorderPreference,
20
+ );
21
+
22
+ const policyResult = resolveCallRecorderPolicyResult({
23
+ input: {
24
+ callRecorderPreference,
25
+ isCanceled: calendarEvent.isCanceled,
26
+ startsAt: calendarEvent.startsAt,
27
+ endsAt: calendarEvent.endsAt,
28
+ conferenceLinkUrl: calendarEvent.conferenceLinkUrl,
29
+ },
30
+ now,
31
+ });
32
+
33
+ return {
34
+ calendarEventId: calendarEvent.id,
35
+ callRecorderPreference,
36
+ realMeetingKey,
37
+ ...policyResult,
38
+ };
39
+ };
40
+
41
+ const normalizeCallRecorderPreference = (
42
+ callRecorderPreference: string | undefined,
43
+ ): CallRecorderPreference | undefined =>
44
+ isCallRecorderPreference(callRecorderPreference)
45
+ ? callRecorderPreference
46
+ : undefined;
47
+
48
+ const isCallRecorderPreference = (
49
+ callRecorderPreference: string | undefined,
50
+ ): callRecorderPreference is CallRecorderPreference =>
51
+ Object.values(CallRecorderPreference).some(
52
+ (preference) => preference === callRecorderPreference,
53
+ );
@@ -0,0 +1,13 @@
1
+ import { type TranscriptMarker } from 'src/logic-functions/types/transcript-marker.type';
2
+
3
+ export const buildFailedTranscriptMarker = ({
4
+ recallTranscriptId,
5
+ subCode,
6
+ }: {
7
+ recallTranscriptId: string | null;
8
+ subCode: string | null;
9
+ }): TranscriptMarker => ({
10
+ recallTranscriptId,
11
+ status: 'FAILED',
12
+ subCode,
13
+ });
@@ -0,0 +1,13 @@
1
+ import { type TranscriptMarker } from 'src/logic-functions/types/transcript-marker.type';
2
+
3
+ export const buildPendingTranscriptMarker = ({
4
+ recallTranscriptId,
5
+ requestedAt,
6
+ }: {
7
+ recallTranscriptId: string;
8
+ requestedAt: string;
9
+ }): TranscriptMarker => ({
10
+ recallTranscriptId,
11
+ status: 'PENDING',
12
+ requestedAt,
13
+ });
@@ -0,0 +1,12 @@
1
+ import { type RecallRoutingMetadata } from 'src/logic-functions/types/recall-routing-metadata.type';
2
+
3
+ export const buildRecallRoutingMetadata = ({
4
+ callRecordingId,
5
+ workspaceId,
6
+ }: {
7
+ callRecordingId: string;
8
+ workspaceId: string;
9
+ }): RecallRoutingMetadata => ({
10
+ twentyWorkspaceId: workspaceId,
11
+ twentyCallRecordingId: callRecordingId,
12
+ });
@@ -0,0 +1,7 @@
1
+ import { isNull } from '@sniptt/guards';
2
+
3
+ export const buildTranscriptFailureReason = (
4
+ subCode: string | null,
5
+ ): string => {
6
+ return isNull(subCode) ? 'transcript_failed' : `transcript_failed:${subCode}`;
7
+ };