@twentyhq/call-recorder 1.0.1 → 1.0.2

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 (237) hide show
  1. package/manifest.json +297 -0
  2. package/package.json +2 -2
  3. package/src/front-components/calendar-event-recording.front-component.mjs +269 -0
  4. package/src/front-components/calendar-event-recording.front-component.mjs.map +7 -0
  5. package/src/logic-functions/process-recall-webhook.mjs +1744 -0
  6. package/src/logic-functions/process-recall-webhook.mjs.map +7 -0
  7. package/src/logic-functions/recall-webhook.mjs +391 -0
  8. package/src/logic-functions/recall-webhook.mjs.map +7 -0
  9. package/src/logic-functions/reconcile-call-recorder-calendar-event.mjs +1602 -0
  10. package/src/logic-functions/reconcile-call-recorder-calendar-event.mjs.map +7 -0
  11. package/src/logic-functions/reconcile-stale-bot-state.mjs +2268 -0
  12. package/src/logic-functions/reconcile-stale-bot-state.mjs.map +7 -0
  13. package/.env.example +0 -5
  14. package/.nvmrc +0 -1
  15. package/.oxlintrc.json +0 -20
  16. package/AGENTS.md +0 -67
  17. package/CLAUDE.md +0 -67
  18. package/README.md +0 -24
  19. package/SETUP.md +0 -95
  20. package/src/__tests__/global-setup.ts +0 -100
  21. package/src/__tests__/schema.integration-test.ts +0 -104
  22. package/src/application-config.ts +0 -96
  23. package/src/constants/__tests__/call-recording-field-universal-identifiers.test.ts +0 -19
  24. package/src/constants/app-description.ts +0 -2
  25. package/src/constants/app-display-name.ts +0 -1
  26. package/src/constants/application-universal-identifier.ts +0 -2
  27. package/src/constants/calendar-event-reconciliation-logic-function-universal-identifier.ts +0 -2
  28. package/src/constants/calendar-event-record-page-layout-universal-identifier.ts +0 -2
  29. package/src/constants/calendar-event-recording-front-component-universal-identifier.ts +0 -2
  30. package/src/constants/calendar-event-recording-page-layout-tab-universal-identifier.ts +0 -2
  31. package/src/constants/calendar-event-recording-page-layout-widget-universal-identifier.ts +0 -2
  32. package/src/constants/call-recorder-everyone-left-timeout-seconds-app-variable-universal-identifier.ts +0 -2
  33. package/src/constants/call-recorder-failure-reason-on-call-recording-field-universal-identifier.ts +0 -2
  34. package/src/constants/call-recorder-join-early-minutes-app-variable-universal-identifier.ts +0 -2
  35. package/src/constants/call-recorder-name-app-variable-universal-identifier.ts +0 -2
  36. package/src/constants/call-recorder-noone-joined-timeout-seconds-app-variable-universal-identifier.ts +0 -2
  37. package/src/constants/call-recorder-preference-off-option-id.ts +0 -2
  38. package/src/constants/call-recorder-preference-on-calendar-event-field-universal-identifier.ts +0 -2
  39. package/src/constants/call-recorder-preference-on-calendar-event-view-field-universal-identifier.ts +0 -2
  40. package/src/constants/call-recorder-preference-on-option-id.ts +0 -2
  41. package/src/constants/call-recorder-preference.ts +0 -4
  42. package/src/constants/call-recorder-waiting-room-timeout-seconds-app-variable-universal-identifier.ts +0 -2
  43. package/src/constants/call-recording-audio-field-universal-identifier.ts +0 -2
  44. package/src/constants/call-recording-video-field-universal-identifier.ts +0 -2
  45. package/src/constants/default-role-universal-identifier.ts +0 -2
  46. package/src/constants/process-recall-webhook-logic-function-universal-identifier.ts +0 -2
  47. package/src/constants/recall-webhook-logic-function-universal-identifier.ts +0 -2
  48. package/src/constants/stale-bot-state-logic-function-universal-identifier.ts +0 -2
  49. package/src/default-role.ts +0 -69
  50. package/src/fields/call-recorder-failure-reason-on-call-recording.field.ts +0 -22
  51. package/src/fields/call-recorder-preference-on-calendar-event.field.ts +0 -41
  52. package/src/front-components/calendar-event-recording.front-component.tsx +0 -13
  53. package/src/front-components/components/CalendarEventRecording.tsx +0 -39
  54. package/src/front-components/components/CalendarEventRecordingBody.tsx +0 -96
  55. package/src/front-components/components/CalendarEventRecordingContent.tsx +0 -111
  56. package/src/front-components/components/RecordingTranscript.tsx +0 -92
  57. package/src/front-components/components/RecordingVideoPlayer.tsx +0 -52
  58. package/src/front-components/components/TranscriptEntryList.tsx +0 -61
  59. package/src/front-components/components/TranscriptEntryListItem.tsx +0 -115
  60. package/src/front-components/components/TranscriptErrorBox.tsx +0 -48
  61. package/src/front-components/components/TranscriptSpeakerAvatar.tsx +0 -141
  62. package/src/front-components/components/TranscriptSpeakerChip.tsx +0 -51
  63. package/src/front-components/constants/recording-theme-css-variables.ts +0 -40
  64. package/src/front-components/hooks/use-calendar-event-participants.ts +0 -172
  65. package/src/front-components/hooks/use-calendar-event-recording.ts +0 -155
  66. package/src/front-components/types/calendar-event-participant-by-speaker-name.type.ts +0 -6
  67. package/src/front-components/types/calendar-event-recording-participant.type.ts +0 -7
  68. package/src/front-components/types/transcript-entry.type.ts +0 -13
  69. package/src/front-components/utils/__tests__/find-active-transcript-entry-index.test.ts +0 -66
  70. package/src/front-components/utils/__tests__/format-transcript-timestamp.test.ts +0 -29
  71. package/src/front-components/utils/__tests__/get-speaker-name-match-keys.test.ts +0 -22
  72. package/src/front-components/utils/__tests__/parse-transcript-entries.test.ts +0 -162
  73. package/src/front-components/utils/build-calendar-event-participant-by-speaker-name.util.ts +0 -45
  74. package/src/front-components/utils/find-active-transcript-entry-index.util.ts +0 -77
  75. package/src/front-components/utils/format-transcript-timestamp.util.ts +0 -16
  76. package/src/front-components/utils/get-absolute-avatar-url.util.ts +0 -48
  77. package/src/front-components/utils/get-calendar-event-participant-for-speaker-name.util.ts +0 -24
  78. package/src/front-components/utils/get-speaker-name-match-keys.util.ts +0 -64
  79. package/src/front-components/utils/get-video-file-extension.util.ts +0 -23
  80. package/src/front-components/utils/parse-transcript-entries.util.ts +0 -85
  81. package/src/logic-functions/__tests__/process-recall-webhook.test.ts +0 -62
  82. package/src/logic-functions/__tests__/recall-webhook.test.ts +0 -180
  83. package/src/logic-functions/constants/call-recorder-everyone-left-timeout-seconds-env-var-name.ts +0 -2
  84. package/src/logic-functions/constants/call-recorder-everyone-left-timeout-seconds.ts +0 -1
  85. package/src/logic-functions/constants/call-recorder-join-early-minutes-env-var-name.ts +0 -2
  86. package/src/logic-functions/constants/call-recorder-name-env-var-name.ts +0 -1
  87. package/src/logic-functions/constants/call-recorder-noone-joined-timeout-seconds-env-var-name.ts +0 -2
  88. package/src/logic-functions/constants/call-recorder-noone-joined-timeout-seconds.ts +0 -1
  89. package/src/logic-functions/constants/call-recorder-recording-retention-hours-env-var-name.ts +0 -2
  90. package/src/logic-functions/constants/call-recorder-waiting-room-timeout-seconds-env-var-name.ts +0 -2
  91. package/src/logic-functions/constants/call-recorder-waiting-room-timeout-seconds.ts +0 -1
  92. package/src/logic-functions/constants/call-recording-micro-credits-per-hour.ts +0 -1
  93. package/src/logic-functions/constants/call-recording-request-status.ts +0 -5
  94. package/src/logic-functions/constants/call-recording-status.ts +0 -9
  95. package/src/logic-functions/constants/default-call-recorder-join-early-minutes.ts +0 -1
  96. package/src/logic-functions/constants/default-call-recorder-name.ts +0 -1
  97. package/src/logic-functions/constants/default-call-recorder-recording-retention-hours.ts +0 -2
  98. package/src/logic-functions/constants/default-recall-region.ts +0 -1
  99. package/src/logic-functions/constants/milliseconds-per-minute.ts +0 -1
  100. package/src/logic-functions/constants/non-terminal-call-recording-statuses.ts +0 -8
  101. package/src/logic-functions/constants/recall-api-key-env-var-name.ts +0 -1
  102. package/src/logic-functions/constants/recall-api-max-attempts.ts +0 -1
  103. package/src/logic-functions/constants/recall-api-retry-delay-ms.ts +0 -1
  104. package/src/logic-functions/constants/recall-bot-automatic-leave.ts +0 -74
  105. package/src/logic-functions/constants/recall-bot-everyone-left-min-activate-after-seconds.ts +0 -1
  106. package/src/logic-functions/constants/recall-bot-recording-config.ts +0 -34
  107. package/src/logic-functions/constants/recall-region-env-var-name.ts +0 -1
  108. package/src/logic-functions/constants/recall-webhook-secret-env-var-name.ts +0 -1
  109. package/src/logic-functions/constants/restricted-field-placeholder.ts +0 -3
  110. package/src/logic-functions/constants/stale-bot-state-cron-pattern.ts +0 -1
  111. package/src/logic-functions/constants/twenty-page-size.ts +0 -1
  112. package/src/logic-functions/data/__tests__/complete-call-recording-ingestion.test.ts +0 -55
  113. package/src/logic-functions/data/__tests__/fetch-all-nodes.test.ts +0 -43
  114. package/src/logic-functions/data/__tests__/get-current-workspace-id.test.ts +0 -38
  115. package/src/logic-functions/data/__tests__/strip-restricted-field-value.test.ts +0 -22
  116. package/src/logic-functions/data/complete-call-recording-ingestion.util.ts +0 -24
  117. package/src/logic-functions/data/create-call-recording.util.ts +0 -41
  118. package/src/logic-functions/data/fetch-all-nodes.util.ts +0 -44
  119. package/src/logic-functions/data/fetch-calendar-events-by-filter.util.ts +0 -80
  120. package/src/logic-functions/data/fetch-calendar-events-by-ids.util.ts +0 -20
  121. package/src/logic-functions/data/fetch-calendar-events-by-starts-at-values.util.ts +0 -19
  122. package/src/logic-functions/data/find-call-recordings-by-calendar-event-ids.util.ts +0 -17
  123. package/src/logic-functions/data/find-call-recordings-by-filter.util.ts +0 -102
  124. package/src/logic-functions/data/find-call-recordings-by-ids.util.ts +0 -17
  125. package/src/logic-functions/data/find-open-scheduled-call-recordings.util.ts +0 -14
  126. package/src/logic-functions/data/get-current-workspace-id.util.ts +0 -36
  127. package/src/logic-functions/data/strip-restricted-field-value.util.ts +0 -6
  128. package/src/logic-functions/data/update-call-recording.util.ts +0 -24
  129. package/src/logic-functions/domain/__tests__/build-call-recorder-policy-result.test.ts +0 -47
  130. package/src/logic-functions/domain/__tests__/compute-call-recording-charge.test.ts +0 -71
  131. package/src/logic-functions/domain/__tests__/compute-call-recording-id-for-meeting.test.ts +0 -37
  132. package/src/logic-functions/domain/__tests__/compute-real-meeting-key.test.ts +0 -88
  133. package/src/logic-functions/domain/__tests__/is-call-recording-ingestion-complete.test.ts +0 -59
  134. package/src/logic-functions/domain/__tests__/is-call-recording-status-downgrade.test.ts +0 -37
  135. package/src/logic-functions/domain/__tests__/resolve-call-recorder-policy-result.test.ts +0 -120
  136. package/src/logic-functions/domain/__tests__/should-complete-call-recording-ingestion.test.ts +0 -102
  137. package/src/logic-functions/domain/aggregate-call-recorder-policy-results-by-meeting.util.ts +0 -42
  138. package/src/logic-functions/domain/build-call-recorder-policy-result.util.ts +0 -53
  139. package/src/logic-functions/domain/build-failed-transcript-marker.util.ts +0 -13
  140. package/src/logic-functions/domain/build-pending-transcript-marker.util.ts +0 -13
  141. package/src/logic-functions/domain/build-recall-routing-metadata.util.ts +0 -12
  142. package/src/logic-functions/domain/build-transcript-failure-reason.util.ts +0 -7
  143. package/src/logic-functions/domain/compute-call-recording-charge.util.ts +0 -41
  144. package/src/logic-functions/domain/compute-call-recording-id-for-meeting.util.ts +0 -16
  145. package/src/logic-functions/domain/compute-real-meeting-key.util.ts +0 -48
  146. package/src/logic-functions/domain/compute-recall-bot-join-at.util.ts +0 -34
  147. package/src/logic-functions/domain/is-call-recording-ingestion-complete.util.ts +0 -19
  148. package/src/logic-functions/domain/is-call-recording-status-downgrade.util.ts +0 -37
  149. package/src/logic-functions/domain/is-recall-recording-done-signal.util.ts +0 -13
  150. package/src/logic-functions/domain/map-recall-status-code-to-call-recording-status.util.ts +0 -26
  151. package/src/logic-functions/domain/parse-transcript-marker.util.ts +0 -29
  152. package/src/logic-functions/domain/resolve-call-recorder-policy-result.util.ts +0 -72
  153. package/src/logic-functions/domain/should-complete-call-recording-ingestion.util.ts +0 -32
  154. package/src/logic-functions/flows/__tests__/charge-completed-call-recording.test.ts +0 -45
  155. package/src/logic-functions/flows/__tests__/complete-and-charge-call-recording.test.ts +0 -61
  156. package/src/logic-functions/flows/__tests__/converge-diverged-call-recordings.test.ts +0 -727
  157. package/src/logic-functions/flows/__tests__/download-transcript.test.ts +0 -74
  158. package/src/logic-functions/flows/__tests__/handle-recall-webhook.test.ts +0 -1301
  159. package/src/logic-functions/flows/__tests__/heal-call-recordings-missing-bot.test.ts +0 -225
  160. package/src/logic-functions/flows/__tests__/ingest-call-recording-media.test.ts +0 -153
  161. package/src/logic-functions/flows/__tests__/reap-orphaned-call-recorders.test.ts +0 -425
  162. package/src/logic-functions/flows/__tests__/reconcile-call-recorder.test.ts +0 -1007
  163. package/src/logic-functions/flows/cancel-call-recording-request.util.ts +0 -46
  164. package/src/logic-functions/flows/charge-completed-call-recording.util.ts +0 -31
  165. package/src/logic-functions/flows/complete-and-charge-call-recording.util.ts +0 -29
  166. package/src/logic-functions/flows/converge-diverged-call-recordings-result.type.ts +0 -8
  167. package/src/logic-functions/flows/converge-diverged-call-recordings.util.ts +0 -447
  168. package/src/logic-functions/flows/download-transcript.util.ts +0 -67
  169. package/src/logic-functions/flows/ensure-call-recorder.util.ts +0 -73
  170. package/src/logic-functions/flows/handle-recall-webhook.util.ts +0 -672
  171. package/src/logic-functions/flows/heal-call-recordings-missing-bot.util.ts +0 -82
  172. package/src/logic-functions/flows/ingest-call-recording-media.util.ts +0 -128
  173. package/src/logic-functions/flows/persist-call-recording-progress.util.ts +0 -58
  174. package/src/logic-functions/flows/reap-orphaned-call-recorders.util.ts +0 -183
  175. package/src/logic-functions/flows/reconcile-call-recorder.util.ts +0 -495
  176. package/src/logic-functions/flows/reconcile-call-recording-transcript-artifact-result.type.ts +0 -11
  177. package/src/logic-functions/flows/reconcile-call-recording-transcript-artifact.util.ts +0 -182
  178. package/src/logic-functions/flows/reschedule-call-recording-bot.util.ts +0 -69
  179. package/src/logic-functions/process-recall-webhook.ts +0 -23
  180. package/src/logic-functions/recall-api/__tests__/extract-recall-bot-convergence.test.ts +0 -153
  181. package/src/logic-functions/recall-api/__tests__/extract-recall-media-urls.test.ts +0 -67
  182. package/src/logic-functions/recall-api/__tests__/recall-bot-api.test.ts +0 -744
  183. package/src/logic-functions/recall-api/__tests__/verify-recall-webhook-signature.test.ts +0 -122
  184. package/src/logic-functions/recall-api/cancel-recall-bot.util.ts +0 -28
  185. package/src/logic-functions/recall-api/create-async-recall-transcript.util.ts +0 -47
  186. package/src/logic-functions/recall-api/eject-recall-bot.util.ts +0 -28
  187. package/src/logic-functions/recall-api/extract-recall-bot-convergence.util.ts +0 -149
  188. package/src/logic-functions/recall-api/extract-recall-bot-id.util.ts +0 -10
  189. package/src/logic-functions/recall-api/extract-recall-media-urls.util.ts +0 -30
  190. package/src/logic-functions/recall-api/extract-twenty-workspace-id-from-recall-webhook.util.ts +0 -8
  191. package/src/logic-functions/recall-api/get-recall-api-config.util.ts +0 -59
  192. package/src/logic-functions/recall-api/get-recall-bot.util.ts +0 -42
  193. package/src/logic-functions/recall-api/get-recall-recording.util.ts +0 -31
  194. package/src/logic-functions/recall-api/get-recall-webhook-bot-metadata.util.ts +0 -18
  195. package/src/logic-functions/recall-api/list-recall-transcripts.util.ts +0 -141
  196. package/src/logic-functions/recall-api/list-scheduled-recall-bots.util.ts +0 -106
  197. package/src/logic-functions/recall-api/normalize-recall-timestamp.util.ts +0 -14
  198. package/src/logic-functions/recall-api/parse-recall-webhook-event.util.ts +0 -88
  199. package/src/logic-functions/recall-api/recall-bot-api-request.util.ts +0 -165
  200. package/src/logic-functions/recall-api/recall-transcript-summary.type.ts +0 -5
  201. package/src/logic-functions/recall-api/reschedule-recall-bot.util.ts +0 -56
  202. package/src/logic-functions/recall-api/retrieve-recall-transcript.util.ts +0 -71
  203. package/src/logic-functions/recall-api/schedule-recall-bot.util.ts +0 -68
  204. package/src/logic-functions/recall-api/verify-recall-webhook-signature.util.ts +0 -109
  205. package/src/logic-functions/recall-webhook.ts +0 -90
  206. package/src/logic-functions/reconcile-call-recorder-calendar-event.ts +0 -178
  207. package/src/logic-functions/reconcile-stale-bot-state.ts +0 -106
  208. package/src/logic-functions/types/calendar-event-record.type.ts +0 -5
  209. package/src/logic-functions/types/call-recorder-policy-calendar-event-input.type.ts +0 -10
  210. package/src/logic-functions/types/call-recorder-policy-input.type.ts +0 -9
  211. package/src/logic-functions/types/call-recorder-policy-not-required-reason.type.ts +0 -5
  212. package/src/logic-functions/types/call-recorder-policy-required-reason.type.ts +0 -1
  213. package/src/logic-functions/types/call-recorder-policy-result-for-calendar-event.type.ts +0 -9
  214. package/src/logic-functions/types/call-recorder-policy-result-for-meeting.type.ts +0 -6
  215. package/src/logic-functions/types/call-recorder-policy-result.type.ts +0 -12
  216. package/src/logic-functions/types/call-recorder-reconciliation-result.type.ts +0 -16
  217. package/src/logic-functions/types/call-recording-media-file.type.ts +0 -1
  218. package/src/logic-functions/types/call-recording-record.type.ts +0 -15
  219. package/src/logic-functions/types/call-recording-update-fields.type.ts +0 -20
  220. package/src/logic-functions/types/files-field-value.type.ts +0 -1
  221. package/src/logic-functions/types/meeting-recording.type.ts +0 -7
  222. package/src/logic-functions/types/recall-bot-operation-result.type.ts +0 -19
  223. package/src/logic-functions/types/recall-routing-metadata.type.ts +0 -4
  224. package/src/logic-functions/types/removed-call-recorder-occurrence.type.ts +0 -6
  225. package/src/logic-functions/types/transcript-marker.type.ts +0 -6
  226. package/src/logic-functions/utils/as-record.util.ts +0 -6
  227. package/src/logic-functions/utils/get-application-variable-value.util.ts +0 -3
  228. package/src/logic-functions/utils/get-record-at-path.util.ts +0 -10
  229. package/src/logic-functions/utils/get-string.util.ts +0 -4
  230. package/src/logic-functions/utils/get-unique-sorted-ids.util.ts +0 -8
  231. package/src/logic-functions/utils/is-non-empty-string.util.ts +0 -5
  232. package/src/page-layouts/calendar-event-recording-tab.ts +0 -33
  233. package/src/view-fields/call-recorder-preference-on-calendar-event.view-field.ts +0 -27
  234. package/tsconfig.json +0 -42
  235. package/tsconfig.spec.json +0 -9
  236. package/vitest.config.ts +0 -31
  237. package/vitest.unit.config.ts +0 -14
@@ -1,69 +0,0 @@
1
- import { isUndefined } from '@sniptt/guards';
2
- import { type CoreApiClient } from 'twenty-client-sdk/core';
3
-
4
- import { type MeetingRecording } from 'src/logic-functions/types/meeting-recording.type';
5
- import { buildRecallRoutingMetadata } from 'src/logic-functions/domain/build-recall-routing-metadata.util';
6
- import { computeRecallBotJoinAt } from 'src/logic-functions/domain/compute-recall-bot-join-at.util';
7
- import { getCurrentWorkspaceId } from 'src/logic-functions/data/get-current-workspace-id.util';
8
- import { rescheduleRecallBot } from 'src/logic-functions/recall-api/reschedule-recall-bot.util';
9
- import { updateCallRecording } from 'src/logic-functions/data/update-call-recording.util';
10
-
11
- const RECALL_BOT_NOT_FOUND_STATUS = 404;
12
-
13
- export const rescheduleCallRecordingBot = async (
14
- client: CoreApiClient,
15
- { callRecording, calendarEvent }: MeetingRecording,
16
- ): Promise<void> => {
17
- const externalBotId = callRecording.externalBotId;
18
-
19
- if (isUndefined(externalBotId)) {
20
- return;
21
- }
22
-
23
- const meetingUrl = calendarEvent.conferenceLinkUrl;
24
- const meetingStartsAt = calendarEvent.startsAt;
25
-
26
- if (isUndefined(meetingUrl) || isUndefined(meetingStartsAt)) {
27
- return;
28
- }
29
-
30
- const joinAt = computeRecallBotJoinAt(meetingStartsAt);
31
-
32
- const workspaceId = getCurrentWorkspaceId();
33
-
34
- if (isUndefined(workspaceId)) {
35
- console.warn(
36
- `[call-recorder] cannot reschedule Recall bot for callRecording ${callRecording.id}: workspace id unavailable`,
37
- );
38
-
39
- return;
40
- }
41
-
42
- const rescheduleResult = await rescheduleRecallBot({
43
- externalBotId,
44
- meetingUrl,
45
- joinAt,
46
- metadata: buildRecallRoutingMetadata({
47
- callRecordingId: callRecording.id,
48
- workspaceId,
49
- }),
50
- });
51
-
52
- if (rescheduleResult.ok) {
53
- return;
54
- }
55
-
56
- // The bot vanished externally; drop the id so the stale-state cron re-creates it as the single writer.
57
- if (rescheduleResult.status === RECALL_BOT_NOT_FOUND_STATUS) {
58
- await updateCallRecording(client, {
59
- id: callRecording.id,
60
- data: { externalBotId: null },
61
- });
62
-
63
- return;
64
- }
65
-
66
- console.warn(
67
- `[call-recorder] failed to update Recall bot for callRecording ${callRecording.id}: ${rescheduleResult.errorMessage}`,
68
- );
69
- };
@@ -1,23 +0,0 @@
1
- import { CoreApiClient } from 'twenty-client-sdk/core';
2
- import { defineLogicFunction } from 'twenty-sdk/define';
3
-
4
- import { PROCESS_RECALL_WEBHOOK_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/constants/process-recall-webhook-logic-function-universal-identifier';
5
- import { handleRecallWebhook } from 'src/logic-functions/flows/handle-recall-webhook.util';
6
- import { type RecallWebhookBody } from 'src/logic-functions/recall-api/parse-recall-webhook-event.util';
7
-
8
- // Dispatched by the recall-webhook resolver; runs in the resolved workspace so the client is workspace-scoped.
9
- export const processRecallWebhookHandler = (body: RecallWebhookBody) =>
10
- handleRecallWebhook({
11
- client: new CoreApiClient(),
12
- body,
13
- });
14
-
15
- export default defineLogicFunction({
16
- universalIdentifier:
17
- PROCESS_RECALL_WEBHOOK_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,
18
- name: 'process-recall-webhook',
19
- description:
20
- 'Updates the matching CallRecording lifecycle status from a verified Recall.ai webhook event.',
21
- timeoutSeconds: 30,
22
- handler: processRecallWebhookHandler,
23
- });
@@ -1,153 +0,0 @@
1
- import { describe, expect, it } from 'vitest';
2
-
3
- import { extractRecallBotConvergence } from 'src/logic-functions/recall-api/extract-recall-bot-convergence.util';
4
-
5
- describe('extractRecallBotConvergence', () => {
6
- it('maps the latest status change code to a call recording status', () => {
7
- const convergence = extractRecallBotConvergence({
8
- status_changes: [
9
- { code: 'joining_call', created_at: '2026-01-01T12:58:00.000Z' },
10
- { code: 'in_call_recording', created_at: '2026-01-01T13:02:00.000Z' },
11
- { code: 'call_ended', created_at: '2026-01-01T14:00:00.000Z' },
12
- { code: 'done', created_at: '2026-01-01T14:05:00.000Z' },
13
- ],
14
- });
15
-
16
- // COMPLETED is reserved for full artifact ingestion, never bot state.
17
- expect(convergence.status).toBe('PROCESSING');
18
- expect(convergence.isRecallRecordingDone).toBe(true);
19
- });
20
-
21
- it('uses created_at to find the latest status when Recall returns status changes out of order', () => {
22
- const convergence = extractRecallBotConvergence({
23
- status_changes: [
24
- { code: 'done', created_at: '2026-01-01T14:05:00.000Z' },
25
- { code: 'joining_call', created_at: '2026-01-01T12:58:00.000Z' },
26
- { code: 'in_call_recording', created_at: '2026-01-01T13:02:00.000Z' },
27
- ],
28
- });
29
-
30
- expect(convergence.status).toBe('PROCESSING');
31
- });
32
-
33
- it('prefers recording-object timestamps over status change entries', () => {
34
- const convergence = extractRecallBotConvergence({
35
- status_changes: [
36
- { code: 'in_call_recording', created_at: '2026-01-01T13:02:30.000Z' },
37
- { code: 'call_ended', created_at: '2026-01-01T14:00:30.000Z' },
38
- ],
39
- recordings: [
40
- {
41
- id: 'recall-recording-1',
42
- started_at: '2026-01-01T13:02:00.000Z',
43
- completed_at: '2026-01-01T14:00:00.000Z',
44
- },
45
- ],
46
- });
47
-
48
- expect(convergence).toEqual({
49
- status: 'PROCESSING',
50
- failureReason: undefined,
51
- startedAt: '2026-01-01T13:02:00.000Z',
52
- endedAt: '2026-01-01T14:00:00.000Z',
53
- externalRecordingId: 'recall-recording-1',
54
- isRecallRecordingDone: true,
55
- });
56
- });
57
-
58
- it('falls back to status change timestamps when recordings carry none', () => {
59
- const convergence = extractRecallBotConvergence({
60
- status_changes: [
61
- { code: 'in_call_recording', created_at: '2026-01-01T13:02:00.000Z' },
62
- { code: 'call_ended', created_at: '2026-01-01T14:00:00.000Z' },
63
- ],
64
- recordings: [{ id: 'recall-recording-1' }],
65
- });
66
-
67
- expect(convergence).toEqual({
68
- status: 'PROCESSING',
69
- failureReason: undefined,
70
- startedAt: '2026-01-01T13:02:00.000Z',
71
- endedAt: '2026-01-01T14:00:00.000Z',
72
- externalRecordingId: 'recall-recording-1',
73
- isRecallRecordingDone: false,
74
- });
75
- });
76
-
77
- it('normalizes microsecond-precision Recall timestamps to millisecond ISO', () => {
78
- const convergence = extractRecallBotConvergence({
79
- status_changes: [
80
- { code: 'done', created_at: '2026-06-10T12:20:00.123456+00:00' },
81
- ],
82
- recordings: [
83
- {
84
- id: 'recall-recording-1',
85
- started_at: '2026-06-10T11:02:28.281597+00:00',
86
- completed_at: '2026-06-10T12:17:28.281597+00:00',
87
- },
88
- ],
89
- });
90
-
91
- expect(convergence.startedAt).toBe('2026-06-10T11:02:28.281Z');
92
- expect(convergence.endedAt).toBe('2026-06-10T12:17:28.281Z');
93
- });
94
-
95
- it('returns nothing derivable from an empty bot response', () => {
96
- expect(extractRecallBotConvergence({})).toEqual({
97
- status: undefined,
98
- failureReason: undefined,
99
- startedAt: undefined,
100
- endedAt: undefined,
101
- externalRecordingId: undefined,
102
- isRecallRecordingDone: false,
103
- });
104
- });
105
-
106
- it('skips malformed status change entries', () => {
107
- const convergence = extractRecallBotConvergence({
108
- status_changes: [
109
- null,
110
- 'not-an-object',
111
- { created_at: '2026-01-01T13:00:00.000Z' },
112
- { code: 'in_call_recording', created_at: '2026-01-01T13:02:00.000Z' },
113
- ],
114
- recordings: 'not-an-array',
115
- });
116
-
117
- expect(convergence).toEqual({
118
- status: 'RECORDING',
119
- failureReason: undefined,
120
- startedAt: '2026-01-01T13:02:00.000Z',
121
- endedAt: undefined,
122
- externalRecordingId: undefined,
123
- isRecallRecordingDone: false,
124
- });
125
- });
126
-
127
- it('carries the failing Recall status code as the failure reason', () => {
128
- const convergence = extractRecallBotConvergence({
129
- status_changes: [
130
- { code: 'joining_call', created_at: '2026-01-01T12:58:00.000Z' },
131
- {
132
- code: 'recording_permission_denied',
133
- created_at: '2026-01-01T13:02:00.000Z',
134
- },
135
- ],
136
- });
137
-
138
- expect(convergence.status).toBe('FAILED');
139
- expect(convergence.failureReason).toBe('recording_permission_denied');
140
- });
141
-
142
- it('leaves the status undefined for unknown latest codes', () => {
143
- const convergence = extractRecallBotConvergence({
144
- status_changes: [
145
- { code: 'in_call_recording', created_at: '2026-01-01T13:02:00.000Z' },
146
- { code: 'some_future_code', created_at: '2026-01-01T13:30:00.000Z' },
147
- ],
148
- });
149
-
150
- expect(convergence.status).toBeUndefined();
151
- expect(convergence.startedAt).toBe('2026-01-01T13:02:00.000Z');
152
- });
153
- });
@@ -1,67 +0,0 @@
1
- import { describe, expect, it } from 'vitest';
2
-
3
- import { extractRecallMediaUrls } from 'src/logic-functions/recall-api/extract-recall-media-urls.util';
4
-
5
- describe('extractRecallMediaUrls', () => {
6
- it('reads both download urls flat from the v1.11 media shortcuts', () => {
7
- expect(
8
- extractRecallMediaUrls({
9
- id: 'recall-recording-1',
10
- media_shortcuts: {
11
- video_mixed: {
12
- download_url: 'https://media.example.com/video.mp4',
13
- },
14
- audio_mixed: {
15
- download_url: 'https://media.example.com/audio.mp3',
16
- },
17
- },
18
- }),
19
- ).toEqual({
20
- videoUrl: 'https://media.example.com/video.mp4',
21
- audioUrl: 'https://media.example.com/audio.mp3',
22
- });
23
- });
24
-
25
- it('falls back to the nested data.download_url shape', () => {
26
- expect(
27
- extractRecallMediaUrls({
28
- id: 'recall-recording-1',
29
- media_shortcuts: {
30
- video_mixed: {
31
- data: { download_url: 'https://media.example.com/video.mp4' },
32
- },
33
- audio_mixed: {
34
- data: { download_url: 'https://media.example.com/audio.mp3' },
35
- },
36
- },
37
- }),
38
- ).toEqual({
39
- videoUrl: 'https://media.example.com/video.mp4',
40
- audioUrl: 'https://media.example.com/audio.mp3',
41
- });
42
- });
43
-
44
- it('returns undefined urls when artifacts are absent', () => {
45
- expect(
46
- extractRecallMediaUrls({
47
- id: 'recall-recording-1',
48
- media_shortcuts: {
49
- video_mixed: {},
50
- },
51
- }),
52
- ).toEqual({ videoUrl: undefined, audioUrl: undefined });
53
- });
54
-
55
- it('tolerates malformed recording payloads', () => {
56
- expect(extractRecallMediaUrls({})).toEqual({
57
- videoUrl: undefined,
58
- audioUrl: undefined,
59
- });
60
- expect(extractRecallMediaUrls({ media_shortcuts: 'not-a-record' })).toEqual(
61
- {
62
- videoUrl: undefined,
63
- audioUrl: undefined,
64
- },
65
- );
66
- });
67
- });