@fonoster/apiserver 0.27.0 → 0.31.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 (376) hide show
  1. package/dist/applications/buildService.d.ts +5 -1
  2. package/dist/applications/buildService.js +10 -7
  3. package/dist/applications/createCreateApplication.d.ts +6 -2
  4. package/dist/applications/createCreateApplication.js +24 -16
  5. package/dist/applications/createCreateTestToken.d.ts +3 -1
  6. package/dist/applications/createCreateTestToken.js +18 -13
  7. package/dist/applications/createGetApplication.js +2 -2
  8. package/dist/applications/createGetFnUtil.d.ts +22 -18
  9. package/dist/applications/createGetFnUtil.js +3 -5
  10. package/dist/applications/createListApplications.js +3 -4
  11. package/dist/applications/createRotateSigningSecret.d.ts +9 -0
  12. package/dist/{calls/createFetchSingleCall.js → applications/createRotateSigningSecret.js} +23 -20
  13. package/dist/applications/createUpdateApplication.d.ts +6 -2
  14. package/dist/applications/createUpdateApplication.js +35 -36
  15. package/dist/applications/evalKeys.d.ts +9 -0
  16. package/dist/{voice/handlers/dial/recordChannel.js → applications/evalKeys.js} +17 -12
  17. package/dist/applications/session/appModel.d.ts +225 -0
  18. package/dist/applications/session/appModel.js +331 -0
  19. package/dist/applications/types.d.ts +1 -27
  20. package/dist/billing/buildService.d.ts +24 -0
  21. package/dist/billing/buildService.js +116 -0
  22. package/dist/bin/entrypoint.d.ts +1 -0
  23. package/dist/bin/entrypoint.js +180 -0
  24. package/dist/bin/healthcheck.d.ts +2 -0
  25. package/dist/{voice/utils/VoiceServiceClientConstructor.js → bin/healthcheck.js} +24 -9
  26. package/dist/bin/regionHubSetup.d.ts +2 -0
  27. package/dist/bin/regionHubSetup.js +67 -0
  28. package/dist/bin/usage.d.ts +2 -0
  29. package/dist/bin/usage.js +119 -0
  30. package/dist/calls/buildService.d.ts +1 -20
  31. package/dist/calls/buildService.js +59 -6
  32. package/dist/calls/createCall.d.ts +17 -2
  33. package/dist/calls/createCall.js +64 -11
  34. package/dist/calls/createCallPublisher.d.ts +40 -2
  35. package/dist/calls/createCallPublisher.js +43 -9
  36. package/dist/calls/createIsWorkspaceNumber.d.ts +41 -0
  37. package/dist/calls/createIsWorkspaceNumber.js +39 -0
  38. package/dist/calls/createTrackCall.d.ts +55 -2
  39. package/dist/calls/createTrackCall.js +230 -16
  40. package/dist/calls/getCall.d.ts +4 -2
  41. package/dist/calls/getCall.js +2 -3
  42. package/dist/calls/listCalls.d.ts +4 -2
  43. package/dist/calls/listCalls.js +2 -3
  44. package/dist/calls/types.d.ts +11 -2
  45. package/dist/calls/types.js +10 -0
  46. package/dist/{core/buildWelcomeDemoService.d.ts → capabilities/buildService.d.ts} +8 -8
  47. package/dist/capabilities/buildService.js +17 -0
  48. package/dist/capabilities/createGetCapabilities.d.ts +78 -0
  49. package/dist/capabilities/createGetCapabilities.js +98 -0
  50. package/dist/{voice/handlers/utils → capabilities}/index.d.ts +2 -3
  51. package/dist/{voice/handlers/utils → capabilities}/index.js +4 -3
  52. package/dist/config/index.d.ts +23 -0
  53. package/dist/config/index.js +102 -0
  54. package/dist/config/schema.d.ts +1919 -0
  55. package/dist/config/schema.js +357 -0
  56. package/dist/core/allowList.js +2 -1
  57. package/dist/core/applyCatalog.d.ts +10 -0
  58. package/dist/{voice/client/GrpcClientHandler.js → core/applyCatalog.js} +45 -51
  59. package/dist/core/db.d.ts +3 -1
  60. package/dist/core/db.js +2 -1
  61. package/dist/core/durableConsumer.d.ts +41 -0
  62. package/dist/core/durableConsumer.js +104 -0
  63. package/dist/core/httpBridge.d.ts +24 -6
  64. package/dist/core/httpBridge.js +3 -25
  65. package/dist/core/identityConfig.d.ts +2 -35
  66. package/dist/core/identityConfig.js +3 -36
  67. package/dist/core/regionHooks.d.ts +15 -0
  68. package/dist/{calls/influxdb.js → core/regionHooks.js} +4 -8
  69. package/dist/core/runServices.js +98 -15
  70. package/dist/core/services.d.ts +96 -6
  71. package/dist/core/services.js +49 -10
  72. package/dist/{voice/errors/index.d.ts → core/telemetry.d.ts} +2 -2
  73. package/dist/core/telemetry.js +42 -0
  74. package/dist/{applications/utils/convertToApplicationData.d.ts → core/telemetryInterceptor.d.ts} +10 -4
  75. package/dist/core/telemetryInterceptor.js +57 -0
  76. package/dist/core/testTokenConfig.js +4 -1
  77. package/dist/core/upsertRoomrPeer.d.ts +6 -0
  78. package/dist/core/{upsertDefaultPeer.js → upsertRoomrPeer.js} +31 -30
  79. package/dist/envs.d.ts +136 -23
  80. package/dist/envs.js +108 -143
  81. package/dist/index.js +39 -21
  82. package/dist/outbound/createNodeDirectory.d.ts +86 -0
  83. package/dist/outbound/createNodeDirectory.js +140 -0
  84. package/dist/{voice/integrations → outbound}/index.d.ts +4 -1
  85. package/dist/{voice/errors → outbound}/index.js +4 -2
  86. package/dist/outbound/placeOutboundCall.d.ts +96 -0
  87. package/dist/outbound/placeOutboundCall.js +172 -0
  88. package/dist/outbound/placementSweep.d.ts +56 -0
  89. package/dist/outbound/placementSweep.js +127 -0
  90. package/dist/outbound/runOutboundCalls.d.ts +52 -0
  91. package/dist/outbound/runOutboundCalls.js +171 -0
  92. package/dist/providers/createProvidersHandlers.d.ts +39 -0
  93. package/dist/providers/createProvidersHandlers.js +229 -0
  94. package/dist/providers/index.d.ts +47 -0
  95. package/dist/{voice/client → providers}/index.js +15 -6
  96. package/dist/providers/registryUsage.d.ts +48 -0
  97. package/dist/providers/registryUsage.js +236 -0
  98. package/dist/records/createIndexRecord.d.ts +42 -0
  99. package/dist/records/createIndexRecord.js +185 -0
  100. package/dist/records/createRecordsRouter.d.ts +61 -0
  101. package/dist/records/createRecordsRouter.js +330 -0
  102. package/dist/records/createSearchRecords.d.ts +51 -0
  103. package/dist/records/createSearchRecords.js +134 -0
  104. package/dist/{voice/filters → records}/index.d.ts +6 -6
  105. package/dist/{voice/filters → records}/index.js +6 -6
  106. package/dist/records/maintenance.d.ts +33 -0
  107. package/dist/records/maintenance.js +166 -0
  108. package/dist/records/runCallRecords.d.ts +48 -0
  109. package/dist/records/runCallRecords.js +49 -0
  110. package/dist/{events/createPerCallCache.d.ts → records/stores.d.ts} +4 -7
  111. package/dist/{voice/handlers/utils/isDtmf.js → records/stores.js} +9 -3
  112. package/dist/records/types.d.ts +104 -0
  113. package/dist/regions/configSync.d.ts +130 -0
  114. package/dist/regions/configSync.js +316 -0
  115. package/dist/regions/createRegionsRouter.d.ts +151 -0
  116. package/dist/regions/createRegionsRouter.js +391 -0
  117. package/dist/regions/endpoints.d.ts +41 -0
  118. package/dist/regions/endpoints.js +90 -0
  119. package/dist/regions/enrollmentToken.d.ts +41 -0
  120. package/dist/regions/enrollmentToken.js +94 -0
  121. package/dist/regions/httpAuth.d.ts +39 -0
  122. package/dist/regions/httpAuth.js +78 -0
  123. package/dist/regions/ids.d.ts +15 -0
  124. package/dist/regions/ids.js +81 -0
  125. package/dist/{voice/client → regions}/index.d.ts +17 -6
  126. package/dist/regions/index.js +51 -0
  127. package/dist/regions/link.d.ts +17 -0
  128. package/dist/regions/link.js +170 -0
  129. package/dist/regions/natsAuth.d.ts +41 -0
  130. package/dist/regions/natsAuth.js +64 -0
  131. package/dist/regions/natsJwt.d.ts +23 -0
  132. package/dist/regions/natsJwt.js +26 -0
  133. package/dist/regions/relay.d.ts +45 -0
  134. package/dist/regions/relay.js +203 -0
  135. package/dist/regions/relayHttp.d.ts +7 -0
  136. package/dist/regions/relayHttp.js +107 -0
  137. package/dist/regions/relaySlots.d.ts +18 -0
  138. package/dist/regions/relaySlots.js +118 -0
  139. package/dist/regions/runRegions.d.ts +111 -0
  140. package/dist/regions/runRegions.js +235 -0
  141. package/dist/regions/service.d.ts +129 -0
  142. package/dist/regions/service.js +558 -0
  143. package/dist/regions/sources.d.ts +20 -0
  144. package/dist/regions/sources.js +191 -0
  145. package/dist/regions/status.d.ts +35 -0
  146. package/dist/regions/status.js +63 -0
  147. package/dist/regions/types.d.ts +123 -0
  148. package/dist/regions/types.js +41 -0
  149. package/dist/{voice/integrations/getSttConfig.d.ts → regions/withConfigChangeHook.d.ts} +13 -7
  150. package/dist/regions/withConfigChangeHook.js +44 -0
  151. package/dist/secrets/createGetFnUtil.d.ts +2 -2
  152. package/dist/session/createSessionRouter.d.ts +49 -0
  153. package/dist/session/createSessionRouter.js +206 -0
  154. package/dist/{voice/handlers/dial → session}/index.d.ts +1 -1
  155. package/dist/{voice/handlers/dial → session}/index.js +1 -1
  156. package/dist/usage/buildService.d.ts +16 -0
  157. package/dist/{voice/integrations/getTtsConfig.js → usage/buildService.js} +13 -7
  158. package/dist/{voice/tts/utils/convertUlawToPCM16.d.ts → usage/createGetUsage.d.ts} +7 -6
  159. package/dist/usage/createGetUsage.js +118 -0
  160. package/dist/usage/ingestUsage.d.ts +7 -0
  161. package/dist/usage/ingestUsage.js +87 -0
  162. package/dist/usage/publishRecordedUsage.d.ts +52 -0
  163. package/dist/usage/publishRecordedUsage.js +103 -0
  164. package/dist/{utils/createHandleDialEventsWithNats.d.ts → usage/publishUsage.d.ts} +10 -4
  165. package/dist/usage/publishUsage.js +50 -0
  166. package/dist/usage/rebuildUsage.d.ts +48 -0
  167. package/dist/usage/rebuildUsage.js +104 -0
  168. package/dist/usage/runUsageConsumer.d.ts +22 -0
  169. package/dist/usage/runUsageConsumer.js +78 -0
  170. package/dist/usage/snapshotStorage.d.ts +14 -0
  171. package/dist/usage/snapshotStorage.js +95 -0
  172. package/dist/{voice/integrations/getTtsConfig.d.ts → usage/types.d.ts} +17 -6
  173. package/dist/utils/createCheckNumberPreconditions.js +4 -0
  174. package/dist/utils/index.d.ts +0 -2
  175. package/dist/utils/index.js +0 -2
  176. package/dist/voice/stt/Deepgram.d.ts +4 -57
  177. package/dist/voice/stt/Deepgram.js +15 -286
  178. package/dist/voice/stt/Google.d.ts +4 -15
  179. package/dist/voice/stt/Google.js +7 -103
  180. package/dist/voice/stt/types.d.ts +2 -38
  181. package/dist/voice/stt/types.js +25 -3
  182. package/dist/voice/tts/Azure.d.ts +4 -34
  183. package/dist/voice/tts/Azure.js +25 -105
  184. package/dist/voice/tts/Deepgram.d.ts +4 -38
  185. package/dist/voice/tts/Deepgram.js +25 -82
  186. package/dist/voice/tts/ElevenLabs.d.ts +4 -18
  187. package/dist/voice/tts/ElevenLabs.js +6 -97
  188. package/dist/voice/tts/Google.d.ts +4 -38
  189. package/dist/voice/tts/Google.js +25 -91
  190. package/dist/webhooks/createWebhooksHandlers.d.ts +37 -0
  191. package/dist/webhooks/createWebhooksHandlers.js +217 -0
  192. package/dist/webhooks/index.d.ts +37 -0
  193. package/dist/webhooks/index.js +51 -0
  194. package/dist/webhooks/lostCalls.d.ts +49 -0
  195. package/dist/webhooks/lostCalls.js +147 -0
  196. package/dist/webhooks/nodeCallEvents.d.ts +73 -0
  197. package/dist/webhooks/nodeCallEvents.js +177 -0
  198. package/dist/webhooks/runWebhookFanout.d.ts +44 -0
  199. package/dist/webhooks/runWebhookFanout.js +202 -0
  200. package/package.json +21 -31
  201. package/dist/applications/utils/applicationWithEncodedStruct.d.ts +0 -3
  202. package/dist/applications/utils/applicationWithEncodedStruct.js +0 -50
  203. package/dist/applications/utils/convertToApplicationData.js +0 -37
  204. package/dist/applications/validation/assistantWithoutApiKeySchema.d.ts +0 -786
  205. package/dist/applications/validation/assistantWithoutApiKeySchema.js +0 -35
  206. package/dist/applications/validation/createValidationSchema.d.ts +0 -1474
  207. package/dist/applications/validation/createValidationSchema.js +0 -67
  208. package/dist/applications/validation/prepareForValidation.d.ts +0 -21
  209. package/dist/applications/validation/prepareForValidation.js +0 -35
  210. package/dist/applications/validation/speechValidators.d.ts +0 -47
  211. package/dist/applications/validation/speechValidators.js +0 -50
  212. package/dist/applications/validation/validOrThrow.d.ts +0 -21
  213. package/dist/applications/validation/validOrThrow.js +0 -15
  214. package/dist/calls/createFetchCalls.d.ts +0 -22
  215. package/dist/calls/createFetchCalls.js +0 -88
  216. package/dist/calls/createFetchSingleCall.d.ts +0 -22
  217. package/dist/calls/influxdb.d.ts +0 -2
  218. package/dist/calls/runCallManager.d.ts +0 -8
  219. package/dist/calls/runCallManager.js +0 -75
  220. package/dist/core/buildWelcomeDemoService.js +0 -97
  221. package/dist/core/upsertDefaultPeer.d.ts +0 -2
  222. package/dist/events/amdResultCache.d.ts +0 -23
  223. package/dist/events/amdResultCache.js +0 -35
  224. package/dist/events/createInfluxDbPub.d.ts +0 -13
  225. package/dist/events/createInfluxDbPub.js +0 -89
  226. package/dist/events/createPerCallCache.js +0 -46
  227. package/dist/events/mapCallDirectionToEnum.d.ts +0 -21
  228. package/dist/events/mapCallDirectionToEnum.js +0 -37
  229. package/dist/events/nats.d.ts +0 -10
  230. package/dist/events/nats.js +0 -82
  231. package/dist/events/transformEvent.d.ts +0 -2
  232. package/dist/events/transformEvent.js +0 -87
  233. package/dist/events/types.d.ts +0 -26
  234. package/dist/utils/createHandleDialEventsWithNats.js +0 -24
  235. package/dist/utils/createHandleDialEventsWithVoiceClient.d.ts +0 -23
  236. package/dist/utils/createHandleDialEventsWithVoiceClient.js +0 -27
  237. package/dist/utils/getIntegrationsFromFile.d.ts +0 -2
  238. package/dist/utils/getIntegrationsFromFile.js +0 -49
  239. package/dist/utils/mapDialStatus.d.ts +0 -21
  240. package/dist/utils/mapDialStatus.js +0 -38
  241. package/dist/voice/VoiceDispatcher.d.ts +0 -21
  242. package/dist/voice/VoiceDispatcher.js +0 -122
  243. package/dist/voice/amd/mapAsteriskAmd.d.ts +0 -38
  244. package/dist/voice/amd/mapAsteriskAmd.js +0 -68
  245. package/dist/voice/client/AudioSocketHandler.d.ts +0 -38
  246. package/dist/voice/client/AudioSocketHandler.js +0 -70
  247. package/dist/voice/client/AuthorizationHandler.d.ts +0 -13
  248. package/dist/voice/client/AuthorizationHandler.js +0 -78
  249. package/dist/voice/client/ExternalMediaHandler.d.ts +0 -32
  250. package/dist/voice/client/ExternalMediaHandler.js +0 -59
  251. package/dist/voice/client/GrpcClientHandler.d.ts +0 -36
  252. package/dist/voice/client/SpeechHandler.d.ts +0 -60
  253. package/dist/voice/client/SpeechHandler.js +0 -120
  254. package/dist/voice/client/VoiceClientImpl.d.ts +0 -79
  255. package/dist/voice/client/VoiceClientImpl.js +0 -198
  256. package/dist/voice/connectToAri.d.ts +0 -2
  257. package/dist/voice/connectToAri.js +0 -81
  258. package/dist/voice/createCreateVoiceClient.d.ts +0 -9
  259. package/dist/voice/createCreateVoiceClient.js +0 -97
  260. package/dist/voice/errors/ChannelVarNotFoundError.d.ts +0 -23
  261. package/dist/voice/errors/ChannelVarNotFoundError.js +0 -10
  262. package/dist/voice/errors/MethodNotImplementedError.d.ts +0 -22
  263. package/dist/voice/errors/MethodNotImplementedError.js +0 -27
  264. package/dist/voice/filters/AudioFilterFactory.d.ts +0 -35
  265. package/dist/voice/filters/AudioFilterFactory.js +0 -94
  266. package/dist/voice/filters/aiCoustics/createAiCousticsFilter.d.ts +0 -64
  267. package/dist/voice/filters/aiCoustics/createAiCousticsFilter.js +0 -252
  268. package/dist/voice/filters/aiCoustics/types.d.ts +0 -45
  269. package/dist/voice/filters/aiCoustics/types.js +0 -29
  270. package/dist/voice/filters/createAudioFilterChain.d.ts +0 -9
  271. package/dist/voice/filters/createAudioFilterChain.js +0 -171
  272. package/dist/voice/filters/createAudioFilterSession.d.ts +0 -15
  273. package/dist/voice/filters/createAudioFilterSession.js +0 -114
  274. package/dist/voice/filters/pcm.d.ts +0 -21
  275. package/dist/voice/filters/pcm.js +0 -37
  276. package/dist/voice/filters/types.d.ts +0 -61
  277. package/dist/voice/filters/types.js +0 -26
  278. package/dist/voice/handlers/createAnswerHandler.d.ts +0 -23
  279. package/dist/voice/handlers/createAnswerHandler.js +0 -24
  280. package/dist/voice/handlers/createHangupHandler.d.ts +0 -23
  281. package/dist/voice/handlers/createHangupHandler.js +0 -28
  282. package/dist/voice/handlers/createMuteHandler.d.ts +0 -4
  283. package/dist/voice/handlers/createMuteHandler.js +0 -27
  284. package/dist/voice/handlers/createPlayDtmfHandler.d.ts +0 -4
  285. package/dist/voice/handlers/createPlayDtmfHandler.js +0 -27
  286. package/dist/voice/handlers/createPlayHandler.d.ts +0 -4
  287. package/dist/voice/handlers/createPlayHandler.js +0 -33
  288. package/dist/voice/handlers/createPlaybackControlHandler.d.ts +0 -4
  289. package/dist/voice/handlers/createPlaybackControlHandler.js +0 -62
  290. package/dist/voice/handlers/createRecordHandler.d.ts +0 -4
  291. package/dist/voice/handlers/createRecordHandler.js +0 -58
  292. package/dist/voice/handlers/createSayHandler.d.ts +0 -4
  293. package/dist/voice/handlers/createSayHandler.js +0 -31
  294. package/dist/voice/handlers/createSetAudioFiltersHandler.d.ts +0 -11
  295. package/dist/voice/handlers/createSetAudioFiltersHandler.js +0 -74
  296. package/dist/voice/handlers/createStopSayHandler.d.ts +0 -3
  297. package/dist/voice/handlers/createStopSayHandler.js +0 -34
  298. package/dist/voice/handlers/createStreamGatherHandler.d.ts +0 -3
  299. package/dist/voice/handlers/createStreamGatherHandler.js +0 -74
  300. package/dist/voice/handlers/createStreamHandler.d.ts +0 -3
  301. package/dist/voice/handlers/createStreamHandler.js +0 -70
  302. package/dist/voice/handlers/createUnmuteHandler.d.ts +0 -4
  303. package/dist/voice/handlers/createUnmuteHandler.js +0 -27
  304. package/dist/voice/handlers/dial/createDialHandler.d.ts +0 -23
  305. package/dist/voice/handlers/dial/createDialHandler.js +0 -78
  306. package/dist/voice/handlers/dial/handleChannelLeftBridge.d.ts +0 -24
  307. package/dist/voice/handlers/dial/handleChannelLeftBridge.js +0 -29
  308. package/dist/voice/handlers/dial/handleStasisEnd.d.ts +0 -21
  309. package/dist/voice/handlers/dial/handleStasisEnd.js +0 -19
  310. package/dist/voice/handlers/dial/handleStasisStart.d.ts +0 -27
  311. package/dist/voice/handlers/dial/handleStasisStart.js +0 -52
  312. package/dist/voice/handlers/dial/recordChannel.d.ts +0 -22
  313. package/dist/voice/handlers/gather/createGatherHandler.d.ts +0 -3
  314. package/dist/voice/handlers/gather/createGatherHandler.js +0 -86
  315. package/dist/voice/handlers/gather/getTimeoutPromise.d.ts +0 -26
  316. package/dist/voice/handlers/gather/getTimeoutPromise.js +0 -18
  317. package/dist/voice/handlers/index.d.ts +0 -33
  318. package/dist/voice/handlers/index.js +0 -49
  319. package/dist/voice/handlers/utils/awaitForPlaybackFinished.d.ts +0 -21
  320. package/dist/voice/handlers/utils/awaitForPlaybackFinished.js +0 -25
  321. package/dist/voice/handlers/utils/awaitForRecordingFinished.d.ts +0 -5
  322. package/dist/voice/handlers/utils/awaitForRecordingFinished.js +0 -53
  323. package/dist/voice/handlers/utils/isDtmf.d.ts +0 -20
  324. package/dist/voice/handlers/utils/textChunksByClause.d.ts +0 -2
  325. package/dist/voice/handlers/utils/textChunksByClause.js +0 -41
  326. package/dist/voice/handlers/utils/textChunksByFirstNaturalPause.d.ts +0 -2
  327. package/dist/voice/handlers/utils/textChunksByFirstNaturalPause.js +0 -34
  328. package/dist/voice/handlers/utils/withErrorHandling.d.ts +0 -22
  329. package/dist/voice/handlers/utils/withErrorHandling.js +0 -38
  330. package/dist/voice/integrations/ApplicationNotFoundError.d.ts +0 -22
  331. package/dist/voice/integrations/ApplicationNotFoundError.js +0 -28
  332. package/dist/voice/integrations/createCreateContainer.d.ts +0 -4
  333. package/dist/voice/integrations/createCreateContainer.js +0 -76
  334. package/dist/voice/integrations/getSttConfig.js +0 -30
  335. package/dist/voice/integrations/index.js +0 -35
  336. package/dist/voice/integrations/types.d.ts +0 -29
  337. package/dist/voice/stt/AbstractSpeechToText.d.ts +0 -33
  338. package/dist/voice/stt/AbstractSpeechToText.js +0 -19
  339. package/dist/voice/stt/SpeechToTextFactory.d.ts +0 -9
  340. package/dist/voice/stt/SpeechToTextFactory.js +0 -43
  341. package/dist/voice/transcribeOnConnection.d.ts +0 -35
  342. package/dist/voice/transcribeOnConnection.js +0 -91
  343. package/dist/voice/tts/AbstractTextToSpeech.d.ts +0 -40
  344. package/dist/voice/tts/AbstractTextToSpeech.js +0 -50
  345. package/dist/voice/tts/TextToSpeechFactory.d.ts +0 -8
  346. package/dist/voice/tts/TextToSpeechFactory.js +0 -47
  347. package/dist/voice/tts/types.d.ts +0 -48
  348. package/dist/voice/tts/types.js +0 -2
  349. package/dist/voice/tts/utils/convertUlawToPCM16.js +0 -40
  350. package/dist/voice/tts/utils/createChunkedSynthesisStream.d.ts +0 -28
  351. package/dist/voice/tts/utils/createChunkedSynthesisStream.js +0 -78
  352. package/dist/voice/tts/utils/createErrorStream.d.ts +0 -21
  353. package/dist/voice/tts/utils/createErrorStream.js +0 -28
  354. package/dist/voice/tts/utils/index.d.ts +0 -23
  355. package/dist/voice/tts/utils/index.js +0 -39
  356. package/dist/voice/tts/utils/isSsml.d.ts +0 -20
  357. package/dist/voice/tts/utils/isSsml.js +0 -25
  358. package/dist/voice/tts/utils/streamToBuffer.d.ts +0 -20
  359. package/dist/voice/tts/utils/streamToBuffer.js +0 -60
  360. package/dist/voice/types/ari.d.ts +0 -43
  361. package/dist/voice/types/ari.js +0 -48
  362. package/dist/voice/types/index.d.ts +0 -20
  363. package/dist/voice/types/index.js +0 -36
  364. package/dist/voice/types/voice.d.ts +0 -67
  365. package/dist/voice/types/voice.js +0 -2
  366. package/dist/voice/utils/VoiceServiceClientConstructor.d.ts +0 -3
  367. package/dist/voice/utils/createExternalMediaConfig.d.ts +0 -12
  368. package/dist/voice/utils/createExternalMediaConfig.js +0 -37
  369. package/dist/voice/utils/createGetChannelVar.d.ts +0 -22
  370. package/dist/voice/utils/createGetChannelVar.js +0 -27
  371. package/dist/voice/utils/createGetChannelVarWithoutThrow.d.ts +0 -22
  372. package/dist/voice/utils/createGetChannelVarWithoutThrow.js +0 -26
  373. package/dist/voice/utils/index.d.ts +0 -22
  374. package/dist/voice/utils/index.js +0 -38
  375. /package/dist/{events → records}/types.js +0 -0
  376. /package/dist/{voice/integrations → usage}/types.js +0 -0
@@ -0,0 +1,236 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.RUNTIME_WARNING_DAYS = exports.REGISTRY_USED_SUBJECT = void 0;
13
+ exports.createRecordCatalogUse = createRecordCatalogUse;
14
+ exports.subscribeRegistryUsage = subscribeRegistryUsage;
15
+ exports.listWarnings = listWarnings;
16
+ /**
17
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
18
+ * http://github.com/fonoster/fonoster
19
+ *
20
+ * This file is part of Fonoster
21
+ *
22
+ * Licensed under the MIT License (the "License");
23
+ * you may not use this file except in compliance with
24
+ * the License. You may obtain a copy of the License at
25
+ *
26
+ * https://opensource.org/licenses/MIT
27
+ *
28
+ * Unless required by applicable law or agreed to in writing, software
29
+ * distributed under the License is distributed on an "AS IS" BASIS,
30
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
31
+ * See the License for the specific language governing permissions and
32
+ * limitations under the License.
33
+ */
34
+ const logger_1 = require("@fonoster/logger");
35
+ const nats_1 = require("nats");
36
+ // Runtime catalog use (add-provider-registry, build log LO-B11). AppBridges publish one
37
+ // `registry.used` message per session and catalog id; the control plane counts sessions per
38
+ // workspace, id and day (for `fonoster-registry usage`) and keeps one runtime notice per workspace
39
+ // and deprecated or retired id. `listWarnings` turns the catalog's state, the workspace's saved
40
+ // configs and recent runtime use into the dashboard's warnings.
41
+ const logger = (0, logger_1.getLogger)({ service: "apiserver", filePath: __filename });
42
+ const sc = (0, nats_1.StringCodec)();
43
+ exports.REGISTRY_USED_SUBJECT = "registry.used";
44
+ /** Runtime warnings stay this long after the last session that used the id. */
45
+ exports.RUNTIME_WARNING_DAYS = 7;
46
+ const ID = /^[a-z0-9][a-z0-9._-]*\/[^\s]{1,200}$/;
47
+ const RUNTIME_TYPES = ["provider.deprecated_used", "provider.retired_used"];
48
+ function valid(u) {
49
+ return (typeof (u === null || u === void 0 ? void 0 : u.workspaceRef) === "string" &&
50
+ u.workspaceRef.length > 0 &&
51
+ typeof u.appRef === "string" &&
52
+ typeof u.id === "string" &&
53
+ ID.test(u.id) &&
54
+ (u.event === undefined || RUNTIME_TYPES.includes(u.event)));
55
+ }
56
+ /** Counts one session's use of an id and, for deprecated or retired ids, updates the notice. */
57
+ function createRecordCatalogUse(db) {
58
+ return (use) => __awaiter(this, void 0, void 0, function* () {
59
+ var _a, _b, _c, _d, _e;
60
+ if (!valid(use))
61
+ return false;
62
+ const at = use.at && !isNaN(Date.parse(use.at)) ? new Date(use.at) : new Date();
63
+ const day = new Date(at.toISOString().slice(0, 10));
64
+ yield db.registryUsage.upsert({
65
+ where: {
66
+ accessKeyId_catalogId_day: {
67
+ accessKeyId: use.workspaceRef,
68
+ catalogId: use.id,
69
+ day
70
+ }
71
+ },
72
+ create: {
73
+ accessKeyId: use.workspaceRef,
74
+ catalogId: use.id,
75
+ day,
76
+ sessions: 1
77
+ },
78
+ update: { sessions: { increment: 1 } }
79
+ });
80
+ if (!use.event)
81
+ return true;
82
+ const existing = yield db.registryNotice.findFirst({
83
+ where: {
84
+ accessKeyId: use.workspaceRef,
85
+ type: use.event,
86
+ data: { path: ["id"], equals: use.id }
87
+ }
88
+ });
89
+ const previous = ((_a = existing === null || existing === void 0 ? void 0 : existing.data) !== null && _a !== void 0 ? _a : {});
90
+ const data = {
91
+ id: use.id,
92
+ replacement: (_b = use.replacement) !== null && _b !== void 0 ? _b : null,
93
+ apps: [...new Set([...((_c = previous.apps) !== null && _c !== void 0 ? _c : []), use.appRef])].slice(0, 50),
94
+ sessions: ((_d = previous.sessions) !== null && _d !== void 0 ? _d : 0) + 1,
95
+ firstSeenAt: (_e = previous.firstSeenAt) !== null && _e !== void 0 ? _e : at.toISOString(),
96
+ lastSeenAt: at.toISOString(),
97
+ lastSessionRef: use.sessionRef
98
+ };
99
+ if (existing)
100
+ yield db.registryNotice.update({
101
+ where: { ref: existing.ref },
102
+ data: { data }
103
+ });
104
+ else
105
+ yield db.registryNotice.create({
106
+ data: { accessKeyId: use.workspaceRef, type: use.event, data }
107
+ });
108
+ return true;
109
+ });
110
+ }
111
+ /** Consumes the AppBridge replicas' `registry.used` messages (one apiserver replica per message). */
112
+ function subscribeRegistryUsage(nc, db) {
113
+ const record = createRecordCatalogUse(db);
114
+ const sub = nc.subscribe(exports.REGISTRY_USED_SUBJECT, {
115
+ queue: "apiserver-registry-usage",
116
+ callback: (err, msg) => {
117
+ if (err)
118
+ return;
119
+ let use;
120
+ try {
121
+ use = JSON.parse(sc.decode(msg.data));
122
+ }
123
+ catch (_a) {
124
+ return;
125
+ }
126
+ record(use).catch((e) => logger.warn(`could not record catalog use: ${e.message}`));
127
+ }
128
+ });
129
+ return () => sub.unsubscribe();
130
+ }
131
+ /**
132
+ * The workspace's catalog warnings (add-provider-registry "Warnings appear where the item is
133
+ * used", "Switching clears the warning"): every deprecated or retired item that a saved config
134
+ * names, or that a session used in the last RUNTIME_WARNING_DAYS days. A retired item still named
135
+ * by a config is one whose usage had no compatible replacement.
136
+ */
137
+ function listWarnings(db_1, accessKeyId_1) {
138
+ return __awaiter(this, arguments, void 0, function* (db, accessKeyId, now = new Date()) {
139
+ var _a, _b, _c, _d, _e;
140
+ const notActive = { state: { not: "ACTIVE" } };
141
+ const [providers, models, voices, apps, notices] = yield Promise.all([
142
+ db.registryProvider.findMany({ where: notActive }),
143
+ db.registryModel.findMany({ where: notActive }),
144
+ db.registryVoice.findMany({
145
+ where: Object.assign(Object.assign({}, notActive), { OR: [{ ownerWorkspace: null }, { ownerWorkspace: accessKeyId }] })
146
+ }),
147
+ db.application.findMany({
148
+ where: { accessKeyId },
149
+ select: {
150
+ ref: true,
151
+ name: true,
152
+ speechVoice: true,
153
+ speechTtsModel: true,
154
+ speechSttModel: true,
155
+ intelligence: { select: { config: true } }
156
+ },
157
+ orderBy: { ref: "asc" }
158
+ }),
159
+ db.registryNotice.findMany({
160
+ where: { accessKeyId, type: { in: RUNTIME_TYPES } }
161
+ })
162
+ ]);
163
+ const entries = new Map();
164
+ const add = (kind) => (r) => {
165
+ var _a, _b;
166
+ return entries.set(r.id, {
167
+ id: r.id,
168
+ kind,
169
+ state: String(r.state).toLowerCase(),
170
+ replacement: (_a = r.replacement) !== null && _a !== void 0 ? _a : null,
171
+ retireOn: (_b = r.retireOn) !== null && _b !== void 0 ? _b : null
172
+ });
173
+ };
174
+ providers.forEach(add("provider"));
175
+ models.forEach(add("model"));
176
+ voices.forEach(add("voice"));
177
+ /** The flagged entries an id falls under: itself, and its provider. */
178
+ const flagged = (id) => [entries.get(id), entries.get(id.split("/")[0])].filter((e) => Boolean(e));
179
+ const warnings = new Map();
180
+ const warning = (e) => {
181
+ var _a, _b;
182
+ let w = warnings.get(e.id);
183
+ if (!w) {
184
+ w = {
185
+ id: e.id,
186
+ kind: e.kind,
187
+ state: e.state,
188
+ replacement: (_a = e.replacement) !== null && _a !== void 0 ? _a : "",
189
+ retireOn: (_b = e.retireOn) !== null && _b !== void 0 ? _b : "",
190
+ usedBy: [],
191
+ runtimeApps: [],
192
+ runtimeSessions: 0,
193
+ lastUsedAt: ""
194
+ };
195
+ warnings.set(e.id, w);
196
+ }
197
+ return w;
198
+ };
199
+ for (const app of apps) {
200
+ const config = app.intelligence;
201
+ const agent = config === null || config === void 0 ? void 0 : config.config;
202
+ const refs = [
203
+ [app.speechVoice, "app", "voice"],
204
+ [app.speechTtsModel, "app", "ttsModel"],
205
+ [app.speechSttModel, "app", "sttModel"],
206
+ [(_a = agent === null || agent === void 0 ? void 0 : agent.languageModel) === null || _a === void 0 ? void 0 : _a.model, "agent", "llm"],
207
+ [(_b = agent === null || agent === void 0 ? void 0 : agent.conversationSettings) === null || _b === void 0 ? void 0 : _b.voice, "agent", "voice"]
208
+ ];
209
+ for (const [id, kind, field] of refs) {
210
+ if (!id)
211
+ continue;
212
+ for (const e of flagged(id))
213
+ warning(e).usedBy.push(Object.assign({ kind, ref: app.ref, name: app.name, field }, (field === "ttsModel" && app.speechVoice
214
+ ? { voice: app.speechVoice }
215
+ : {})));
216
+ }
217
+ }
218
+ const since = now.getTime() - exports.RUNTIME_WARNING_DAYS * 24 * 3600 * 1000;
219
+ for (const n of notices) {
220
+ const d = n.data;
221
+ const last = Date.parse(String((_c = d.lastSeenAt) !== null && _c !== void 0 ? _c : ""));
222
+ if (!(last >= since))
223
+ continue;
224
+ for (const e of flagged(String(d.id))) {
225
+ const w = warning(e);
226
+ w.runtimeApps = [
227
+ ...new Set([...w.runtimeApps, ...((_d = d.apps) !== null && _d !== void 0 ? _d : [])])
228
+ ];
229
+ w.runtimeSessions += Number((_e = d.sessions) !== null && _e !== void 0 ? _e : 0);
230
+ if (!w.lastUsedAt || String(d.lastSeenAt) > w.lastUsedAt)
231
+ w.lastUsedAt = String(d.lastSeenAt);
232
+ }
233
+ }
234
+ return [...warnings.values()].sort((a, b) => a.id.localeCompare(b.id));
235
+ });
236
+ }
@@ -0,0 +1,42 @@
1
+ import { NatsConnection } from "nats";
2
+ import { UsageDirectory } from "../usage/types";
3
+ import { RecordIndexEntry, RecordsDb } from "./types";
4
+ /** Where a call's usage lines go: owners come from Identity's workspaces once attached. */
5
+ export type IndexUsageDeps = {
6
+ directory: () => UsageDirectory | undefined;
7
+ };
8
+ /** The usage events of an index entry, attributed from the entry (design D1). */
9
+ export declare function usageEvents(entry: RecordIndexEntry, workspaceRef: string): {
10
+ callRef: string;
11
+ region: string;
12
+ regionKind: string;
13
+ origin: string;
14
+ occurredAt: string;
15
+ appRef?: string;
16
+ id: string;
17
+ workspaceRef: string;
18
+ meter: string;
19
+ quantity: number;
20
+ provider?: string;
21
+ model?: string;
22
+ keySource?: "platform" | "workspace";
23
+ }[];
24
+ /**
25
+ * Upserts a record's index entry. Entries arrive at least once and possibly out of order, so a
26
+ * lower version never overwrites a higher one. An erased record keeps its row, without numbers.
27
+ * The call's usage lines are stored in the same transaction as the row (add-usage-metering D1).
28
+ */
29
+ export declare function createIndexRecord(db: RecordsDb, usage?: IndexUsageDeps): (entry: RecordIndexEntry) => Promise<boolean>;
30
+ /** The work queue that captures the AppBridge replicas' index entries and its durable consumer (ST-2). */
31
+ export declare const RECORD_INDEX_STREAM = "FONOSTER_RECORD_INDEX";
32
+ export declare const RECORD_INDEX_DURABLE = "apiserver-call-records";
33
+ /**
34
+ * Consumes the AppBridge replicas' index entries (one apiserver replica per entry) through a JetStream
35
+ * durable consumer: an entry is acknowledged once indexed, so one taken by a replica that dies is
36
+ * indexed by another (indexing is an idempotent upsert). Without JetStream (or the permission),
37
+ * a core NATS queue group, as before.
38
+ */
39
+ export declare function subscribeRecordIndex(nc: NatsConnection, db: RecordsDb, options?: {
40
+ ackWaitMs?: number;
41
+ usage?: IndexUsageDeps;
42
+ }): Promise<() => Promise<void> | void>;
@@ -0,0 +1,185 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.RECORD_INDEX_DURABLE = exports.RECORD_INDEX_STREAM = void 0;
13
+ exports.usageEvents = usageEvents;
14
+ exports.createIndexRecord = createIndexRecord;
15
+ exports.subscribeRecordIndex = subscribeRecordIndex;
16
+ /**
17
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
18
+ * http://github.com/fonoster/fonoster
19
+ *
20
+ * This file is part of Fonoster
21
+ *
22
+ * Licensed under the MIT License (the "License");
23
+ * you may not use this file except in compliance with
24
+ * the License. You may obtain a copy of the License at
25
+ *
26
+ * https://opensource.org/licenses/MIT
27
+ *
28
+ * Unless required by applicable law or agreed to in writing, software
29
+ * distributed under the License is distributed on an "AS IS" BASIS,
30
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
31
+ * See the License for the specific language governing permissions and
32
+ * limitations under the License.
33
+ */
34
+ const callrecord_1 = require("@fonoster/callrecord");
35
+ const common_1 = require("@fonoster/common");
36
+ const logger_1 = require("@fonoster/logger");
37
+ const nats_1 = require("nats");
38
+ const durableConsumer_1 = require("../core/durableConsumer");
39
+ const telemetry_1 = require("../core/telemetry");
40
+ const types_1 = require("../regions/types");
41
+ const ingestUsage_1 = require("../usage/ingestUsage");
42
+ const logger = (0, logger_1.getLogger)({ service: "apiserver", filePath: __filename });
43
+ const sc = (0, nats_1.StringCodec)();
44
+ /** The usage events of an index entry, attributed from the entry (design D1). */
45
+ function usageEvents(entry, workspaceRef) {
46
+ var _a;
47
+ const origin = entry.origin === "browser_test" ? "browser_test" : "call";
48
+ return ((_a = entry.usage) !== null && _a !== void 0 ? _a : []).map((line) => {
49
+ var _a;
50
+ return (Object.assign(Object.assign(Object.assign(Object.assign({}, line), { id: common_1.Usage.usageId(entry.callRef, line), workspaceRef }), (entry.appRef ? { appRef: entry.appRef } : {})), { callRef: entry.callRef, region: entry.region, regionKind: (0, types_1.isPrivateRegionRef)(entry.region) ? "private" : "public", origin, occurredAt: new Date((_a = entry.endedAt) !== null && _a !== void 0 ? _a : entry.startedAt).toISOString() }));
51
+ });
52
+ }
53
+ /**
54
+ * Upserts a record's index entry. Entries arrive at least once and possibly out of order, so a
55
+ * lower version never overwrites a higher one. An erased record keeps its row, without numbers.
56
+ * The call's usage lines are stored in the same transaction as the row (add-usage-metering D1).
57
+ */
58
+ function createIndexRecord(db, usage) {
59
+ return (entry) => __awaiter(this, void 0, void 0, function* () {
60
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
61
+ const existing = yield db.callRecord.findUnique({
62
+ where: { callRef: entry.callRef }
63
+ });
64
+ if (existing && existing.version > entry.version)
65
+ return false;
66
+ // A record's workspace never changes: anyone can publish on NATS today, so an entry that
67
+ // names another workspace for a known record is dropped, not applied (RV-B6).
68
+ if ((existing === null || existing === void 0 ? void 0 : existing.accessKeyId) &&
69
+ entry.workspaceRef &&
70
+ entry.workspaceRef !== existing.accessKeyId) {
71
+ logger.warn(`index entry for ${entry.callRef} names another workspace; ignored`);
72
+ return false;
73
+ }
74
+ const erased = entry.status === "erased";
75
+ const data = {
76
+ accessKeyId: (_b = (_a = existing === null || existing === void 0 ? void 0 : existing.accessKeyId) !== null && _a !== void 0 ? _a : entry.workspaceRef) !== null && _b !== void 0 ? _b : null,
77
+ appRef: erased ? ((_c = existing === null || existing === void 0 ? void 0 : existing.appRef) !== null && _c !== void 0 ? _c : null) : entry.appRef,
78
+ fromNumber: erased ? null : entry.from,
79
+ toNumber: erased ? null : entry.to,
80
+ direction: erased ? ((_d = existing === null || existing === void 0 ? void 0 : existing.direction) !== null && _d !== void 0 ? _d : null) : entry.direction,
81
+ status: entry.status,
82
+ endReason: erased ? ((_e = existing === null || existing === void 0 ? void 0 : existing.endReason) !== null && _e !== void 0 ? _e : null) : entry.endReason,
83
+ failureReason: entry.failureReason,
84
+ sipStatus: entry.sipStatus,
85
+ amdStatus: erased ? null : ((_f = entry.amdStatus) !== null && _f !== void 0 ? _f : null),
86
+ startedAt: erased && existing ? existing.startedAt : new Date(entry.startedAt),
87
+ endedAt: erased
88
+ ? ((_g = existing === null || existing === void 0 ? void 0 : existing.endedAt) !== null && _g !== void 0 ? _g : null)
89
+ : entry.endedAt
90
+ ? new Date(entry.endedAt)
91
+ : null,
92
+ durationSeconds: erased
93
+ ? ((_h = existing === null || existing === void 0 ? void 0 : existing.durationSeconds) !== null && _h !== void 0 ? _h : 0)
94
+ : entry.durationSeconds,
95
+ region: entry.region,
96
+ location: entry.location,
97
+ version: entry.version,
98
+ size: BigInt(entry.size),
99
+ parts: entry.parts,
100
+ erasedAt: erased ? new Date() : null
101
+ };
102
+ const upsert = {
103
+ where: { callRef: entry.callRef },
104
+ create: Object.assign({ callRef: entry.callRef }, data),
105
+ update: data
106
+ };
107
+ const directory = usage === null || usage === void 0 ? void 0 : usage.directory();
108
+ const workspaceRef = data.accessKeyId;
109
+ if (!erased && directory && workspaceRef && ((_j = entry.usage) === null || _j === void 0 ? void 0 : _j.length)) {
110
+ const events = usageEvents(entry, workspaceRef);
111
+ yield db.$transaction((tx) => __awaiter(this, void 0, void 0, function* () {
112
+ yield tx.callRecord.upsert(upsert);
113
+ yield (0, ingestUsage_1.ingestUsageIn)(tx, directory, events);
114
+ }));
115
+ return true;
116
+ }
117
+ if (!erased && !directory && ((_k = entry.usage) === null || _k === void 0 ? void 0 : _k.length))
118
+ logger.warn(`usage for ${entry.callRef} not stored: no workspace directory yet`);
119
+ yield db.callRecord.upsert(upsert);
120
+ return true;
121
+ });
122
+ }
123
+ /** The work queue that captures the AppBridge replicas' index entries and its durable consumer (ST-2). */
124
+ exports.RECORD_INDEX_STREAM = "FONOSTER_RECORD_INDEX";
125
+ exports.RECORD_INDEX_DURABLE = "apiserver-call-records";
126
+ /**
127
+ * Consumes the AppBridge replicas' index entries (one apiserver replica per entry) through a JetStream
128
+ * durable consumer: an entry is acknowledged once indexed, so one taken by a replica that dies is
129
+ * indexed by another (indexing is an idempotent upsert). Without JetStream (or the permission),
130
+ * a core NATS queue group, as before.
131
+ */
132
+ function subscribeRecordIndex(nc_1, db_1) {
133
+ return __awaiter(this, arguments, void 0, function* (nc, db, options = {}) {
134
+ const index = createIndexRecord(db, options.usage);
135
+ const handle = (data, headers) => __awaiter(this, void 0, void 0, function* () {
136
+ var _a;
137
+ let entry;
138
+ try {
139
+ entry = JSON.parse(sc.decode(data));
140
+ }
141
+ catch (_b) {
142
+ return;
143
+ }
144
+ // One span per entry, in AppBridge's trace when it sent a traceparent header.
145
+ const telemetry = (0, telemetry_1.apiserverTelemetry)();
146
+ const span = telemetry.startSpan("apiserver.records.index", { [common_1.CALL_REF_ATTR]: (_a = entry.callRef) !== null && _a !== void 0 ? _a : "" }, (headers === null || headers === void 0 ? void 0 : headers.get(common_1.TRACEPARENT_HEADER)) || undefined);
147
+ try {
148
+ const done = yield index(entry);
149
+ telemetry.count("fonoster.apiserver.records.indexed", 1, {
150
+ outcome: done ? "indexed" : "skipped"
151
+ });
152
+ span.end();
153
+ }
154
+ catch (e) {
155
+ telemetry.count("fonoster.apiserver.records.indexed", 1, {
156
+ outcome: "error"
157
+ });
158
+ span.end(undefined, e.message);
159
+ logger.error(`could not index ${entry.callRef}: ${e.message}`);
160
+ throw e;
161
+ }
162
+ });
163
+ try {
164
+ return yield (0, durableConsumer_1.consumeDurable)(nc, {
165
+ stream: exports.RECORD_INDEX_STREAM,
166
+ subject: callrecord_1.RECORD_SEALED_SUBJECT,
167
+ durable: exports.RECORD_INDEX_DURABLE,
168
+ ackWaitMs: options.ackWaitMs,
169
+ maxDeliver: 20
170
+ }, handle);
171
+ }
172
+ catch (e) {
173
+ logger.warn(`call records: JetStream consumer unavailable (${e.message}); falling back to a core NATS queue group`);
174
+ const sub = nc.subscribe(callrecord_1.RECORD_SEALED_SUBJECT, {
175
+ queue: "apiserver-call-records",
176
+ callback: (err, msg) => {
177
+ if (err)
178
+ return;
179
+ handle(msg.data, msg.headers).catch(() => undefined);
180
+ }
181
+ });
182
+ return () => sub.unsubscribe();
183
+ }
184
+ });
185
+ }
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
3
+ * http://github.com/fonoster/fonoster
4
+ *
5
+ * This file is part of Fonoster
6
+ *
7
+ * Licensed under the MIT License (the "License");
8
+ * you may not use this file except in compliance with
9
+ * the License. You may obtain a copy of the License at
10
+ *
11
+ * https://opensource.org/licenses/MIT
12
+ *
13
+ * Unless required by applicable law or agreed to in writing, software
14
+ * distributed under the License is distributed on an "AS IS" BASIS,
15
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ * See the License for the specific language governing permissions and
17
+ * limitations under the License.
18
+ */
19
+ import { RecordStore } from "@fonoster/callrecord";
20
+ import { TokenVerifyOptions } from "@fonoster/common";
21
+ import { Router } from "express";
22
+ import { RelayClient } from "../regions/relay";
23
+ import { MaintenanceClient, RecordsDb } from "./types";
24
+ /** Roles that may read unredacted originals and delete or erase records (V5, V3). */
25
+ export declare const UNREDACTED_ROLES: string[];
26
+ export type RecordsRouterDeps = {
27
+ db: RecordsDb;
28
+ /** Verifies access tokens (the same key the gRPC interceptor uses). */
29
+ identityPublicKey: string;
30
+ /** The token's issuer and audience must match these too (M5, like /api/regions). */
31
+ identityTokenOptions?: TokenVerifyOptions;
32
+ stores: (location: string) => RecordStore | undefined;
33
+ maintenance: MaintenanceClient;
34
+ /**
35
+ * Private regions (add-private-regions 2.5): content of a private workspace's calls is fetched
36
+ * from its cell and streamed, never read from (or written to) central storage.
37
+ */
38
+ relay?: {
39
+ regionOf(accessKeyId: string): Promise<string | undefined>;
40
+ client?: RelayClient;
41
+ };
42
+ /** Retention is part of the recording policy a private cell syncs. */
43
+ onConfigChange?: (accessKeyId: string) => void;
44
+ };
45
+ /**
46
+ * The records API (call-record "Records are available through the API and the dashboard",
47
+ * tasks 5.1 and 4.2), on the apiserver's HTTP port so recordings download as files:
48
+ *
49
+ * GET /api/records search: after, before, number, appRef, status
50
+ * GET /api/records/:callRef the record (redacted; ?original=true, ?version=n)
51
+ * GET /api/records/:callRef/recording the recording (WAV)
52
+ * GET /api/records/:callRef/audit deletions of this record (owner, admin)
53
+ * DELETE /api/records/:callRef erase the call (owner, admin)
54
+ * DELETE /api/records/:callRef/parts/:part delete one part (owner, admin)
55
+ * GET /api/records/retention the workspace's retention policies
56
+ * PUT /api/records/retention {part, days} sets one; days null removes it
57
+ *
58
+ * Every request carries `Authorization: Bearer <access token>` and the workspace in
59
+ * `x-accesskey-id`; only that workspace's records are visible.
60
+ */
61
+ export declare function createRecordsRouter(deps: RecordsRouterDeps): Router;