@rapidmx/restapi 0.1.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 (435) hide show
  1. package/LICENSE +382 -0
  2. package/README.md +50 -0
  3. package/dist/lib/blob/BlobStore.js +6 -0
  4. package/dist/lib/blob/BlobStore.js.map +1 -0
  5. package/dist/lib/blob/LocalFsBlobStore.js +101 -0
  6. package/dist/lib/blob/LocalFsBlobStore.js.map +1 -0
  7. package/dist/lib/blob/index.js +7 -0
  8. package/dist/lib/blob/index.js.map +1 -0
  9. package/dist/lib/index.js +12 -0
  10. package/dist/lib/index.js.map +1 -0
  11. package/dist/lib/jobs/AttachmentExtractionJob.js +124 -0
  12. package/dist/lib/jobs/AttachmentExtractionJob.js.map +1 -0
  13. package/dist/lib/jobs/CalendarReminderJob.js +132 -0
  14. package/dist/lib/jobs/CalendarReminderJob.js.map +1 -0
  15. package/dist/lib/jobs/EasDeviceStateCleanupJob.js +101 -0
  16. package/dist/lib/jobs/EasDeviceStateCleanupJob.js.map +1 -0
  17. package/dist/lib/jobs/ExternalShareExpirationJob.js +117 -0
  18. package/dist/lib/jobs/ExternalShareExpirationJob.js.map +1 -0
  19. package/dist/lib/jobs/MailboxQuotaRecalcJob.js +163 -0
  20. package/dist/lib/jobs/MailboxQuotaRecalcJob.js.map +1 -0
  21. package/dist/lib/jobs/MeetingSchedulingJob.js +106 -0
  22. package/dist/lib/jobs/MeetingSchedulingJob.js.map +1 -0
  23. package/dist/lib/jobs/QuarantineRetentionJob.js +97 -0
  24. package/dist/lib/jobs/QuarantineRetentionJob.js.map +1 -0
  25. package/dist/lib/jobs/ScanQueueJob.js +223 -0
  26. package/dist/lib/jobs/ScanQueueJob.js.map +1 -0
  27. package/dist/lib/jobs/SearchIndexJob.js +146 -0
  28. package/dist/lib/jobs/SearchIndexJob.js.map +1 -0
  29. package/dist/lib/jobs/index.js +10 -0
  30. package/dist/lib/jobs/index.js.map +1 -0
  31. package/dist/lib/jobs/mongo/AttachmentExtractionJobMongo.js +14 -0
  32. package/dist/lib/jobs/mongo/AttachmentExtractionJobMongo.js.map +1 -0
  33. package/dist/lib/jobs/mongo/CalendarReminderJobMongo.js +13 -0
  34. package/dist/lib/jobs/mongo/CalendarReminderJobMongo.js.map +1 -0
  35. package/dist/lib/jobs/mongo/EasDeviceStateCleanupJobMongo.js +13 -0
  36. package/dist/lib/jobs/mongo/EasDeviceStateCleanupJobMongo.js.map +1 -0
  37. package/dist/lib/jobs/mongo/ExternalShareExpirationJobMongo.js +13 -0
  38. package/dist/lib/jobs/mongo/ExternalShareExpirationJobMongo.js.map +1 -0
  39. package/dist/lib/jobs/mongo/MailboxQuotaRecalcJobMongo.js +15 -0
  40. package/dist/lib/jobs/mongo/MailboxQuotaRecalcJobMongo.js.map +1 -0
  41. package/dist/lib/jobs/mongo/MeetingSchedulingJobMongo.js +13 -0
  42. package/dist/lib/jobs/mongo/MeetingSchedulingJobMongo.js.map +1 -0
  43. package/dist/lib/jobs/mongo/QuarantineRetentionJobMongo.js +13 -0
  44. package/dist/lib/jobs/mongo/QuarantineRetentionJobMongo.js.map +1 -0
  45. package/dist/lib/jobs/mongo/ScanQueueJobMongo.js +18 -0
  46. package/dist/lib/jobs/mongo/ScanQueueJobMongo.js.map +1 -0
  47. package/dist/lib/jobs/mongo/SearchIndexJobMongo.js +14 -0
  48. package/dist/lib/jobs/mongo/SearchIndexJobMongo.js.map +1 -0
  49. package/dist/lib/jobs/mongo/index.js +10 -0
  50. package/dist/lib/jobs/mongo/index.js.map +1 -0
  51. package/dist/lib/jobs/mongo.js +2 -0
  52. package/dist/lib/jobs/mongo.js.map +1 -0
  53. package/dist/lib/jobs/sql/AttachmentExtractionJobSQL.js +14 -0
  54. package/dist/lib/jobs/sql/AttachmentExtractionJobSQL.js.map +1 -0
  55. package/dist/lib/jobs/sql/CalendarReminderJobSQL.js +13 -0
  56. package/dist/lib/jobs/sql/CalendarReminderJobSQL.js.map +1 -0
  57. package/dist/lib/jobs/sql/EasDeviceStateCleanupJobSQL.js +13 -0
  58. package/dist/lib/jobs/sql/EasDeviceStateCleanupJobSQL.js.map +1 -0
  59. package/dist/lib/jobs/sql/ExternalShareExpirationJobSQL.js +13 -0
  60. package/dist/lib/jobs/sql/ExternalShareExpirationJobSQL.js.map +1 -0
  61. package/dist/lib/jobs/sql/MailboxQuotaRecalcJobSQL.js +15 -0
  62. package/dist/lib/jobs/sql/MailboxQuotaRecalcJobSQL.js.map +1 -0
  63. package/dist/lib/jobs/sql/MeetingSchedulingJobSQL.js +13 -0
  64. package/dist/lib/jobs/sql/MeetingSchedulingJobSQL.js.map +1 -0
  65. package/dist/lib/jobs/sql/QuarantineRetentionJobSQL.js +13 -0
  66. package/dist/lib/jobs/sql/QuarantineRetentionJobSQL.js.map +1 -0
  67. package/dist/lib/jobs/sql/ScanQueueJobSQL.js +18 -0
  68. package/dist/lib/jobs/sql/ScanQueueJobSQL.js.map +1 -0
  69. package/dist/lib/jobs/sql/SearchIndexJobSQL.js +14 -0
  70. package/dist/lib/jobs/sql/SearchIndexJobSQL.js.map +1 -0
  71. package/dist/lib/jobs/sql/index.js +10 -0
  72. package/dist/lib/jobs/sql/index.js.map +1 -0
  73. package/dist/lib/jobs/sql.js +2 -0
  74. package/dist/lib/jobs/sql.js.map +1 -0
  75. package/dist/lib/models/index.js +2 -0
  76. package/dist/lib/models/index.js.map +1 -0
  77. package/dist/lib/models/mongo/AttachmentMongo.js +129 -0
  78. package/dist/lib/models/mongo/AttachmentMongo.js.map +1 -0
  79. package/dist/lib/models/mongo/CalendarEventMongo.js +172 -0
  80. package/dist/lib/models/mongo/CalendarEventMongo.js.map +1 -0
  81. package/dist/lib/models/mongo/CalendarShareLinkMongo.js +85 -0
  82. package/dist/lib/models/mongo/CalendarShareLinkMongo.js.map +1 -0
  83. package/dist/lib/models/mongo/ContactListMongo.js +60 -0
  84. package/dist/lib/models/mongo/ContactListMongo.js.map +1 -0
  85. package/dist/lib/models/mongo/ContactMongo.js +148 -0
  86. package/dist/lib/models/mongo/ContactMongo.js.map +1 -0
  87. package/dist/lib/models/mongo/DeviceSyncStateMongo.js +97 -0
  88. package/dist/lib/models/mongo/DeviceSyncStateMongo.js.map +1 -0
  89. package/dist/lib/models/mongo/FolderMongo.js +102 -0
  90. package/dist/lib/models/mongo/FolderMongo.js.map +1 -0
  91. package/dist/lib/models/mongo/IngestQueueEntryMongo.js +93 -0
  92. package/dist/lib/models/mongo/IngestQueueEntryMongo.js.map +1 -0
  93. package/dist/lib/models/mongo/MailboxMongo.js +105 -0
  94. package/dist/lib/models/mongo/MailboxMongo.js.map +1 -0
  95. package/dist/lib/models/mongo/MessageMongo.js +180 -0
  96. package/dist/lib/models/mongo/MessageMongo.js.map +1 -0
  97. package/dist/lib/models/mongo/NoteMongo.js +83 -0
  98. package/dist/lib/models/mongo/NoteMongo.js.map +1 -0
  99. package/dist/lib/models/mongo/QuarantineEntryMongo.js +99 -0
  100. package/dist/lib/models/mongo/QuarantineEntryMongo.js.map +1 -0
  101. package/dist/lib/models/mongo/ScanResultMongo.js +112 -0
  102. package/dist/lib/models/mongo/ScanResultMongo.js.map +1 -0
  103. package/dist/lib/models/mongo/SearchIndexStateMongo.js +83 -0
  104. package/dist/lib/models/mongo/SearchIndexStateMongo.js.map +1 -0
  105. package/dist/lib/models/mongo/TaskMongo.js +105 -0
  106. package/dist/lib/models/mongo/TaskMongo.js.map +1 -0
  107. package/dist/lib/models/mongo/index.js +16 -0
  108. package/dist/lib/models/mongo/index.js.map +1 -0
  109. package/dist/lib/models/mongo.js +2 -0
  110. package/dist/lib/models/mongo.js.map +1 -0
  111. package/dist/lib/models/sql/AttachmentSQL.js +129 -0
  112. package/dist/lib/models/sql/AttachmentSQL.js.map +1 -0
  113. package/dist/lib/models/sql/CalendarEventSQL.js +176 -0
  114. package/dist/lib/models/sql/CalendarEventSQL.js.map +1 -0
  115. package/dist/lib/models/sql/CalendarShareLinkSQL.js +85 -0
  116. package/dist/lib/models/sql/CalendarShareLinkSQL.js.map +1 -0
  117. package/dist/lib/models/sql/ContactListSQL.js +60 -0
  118. package/dist/lib/models/sql/ContactListSQL.js.map +1 -0
  119. package/dist/lib/models/sql/ContactSQL.js +148 -0
  120. package/dist/lib/models/sql/ContactSQL.js.map +1 -0
  121. package/dist/lib/models/sql/DeviceSyncStateSQL.js +97 -0
  122. package/dist/lib/models/sql/DeviceSyncStateSQL.js.map +1 -0
  123. package/dist/lib/models/sql/FolderSQL.js +106 -0
  124. package/dist/lib/models/sql/FolderSQL.js.map +1 -0
  125. package/dist/lib/models/sql/IngestQueueEntrySQL.js +97 -0
  126. package/dist/lib/models/sql/IngestQueueEntrySQL.js.map +1 -0
  127. package/dist/lib/models/sql/MailboxSQL.js +105 -0
  128. package/dist/lib/models/sql/MailboxSQL.js.map +1 -0
  129. package/dist/lib/models/sql/MessageSQL.js +184 -0
  130. package/dist/lib/models/sql/MessageSQL.js.map +1 -0
  131. package/dist/lib/models/sql/NoteSQL.js +83 -0
  132. package/dist/lib/models/sql/NoteSQL.js.map +1 -0
  133. package/dist/lib/models/sql/QuarantineEntrySQL.js +103 -0
  134. package/dist/lib/models/sql/QuarantineEntrySQL.js.map +1 -0
  135. package/dist/lib/models/sql/ScanResultSQL.js +116 -0
  136. package/dist/lib/models/sql/ScanResultSQL.js.map +1 -0
  137. package/dist/lib/models/sql/SearchIndexStateSQL.js +83 -0
  138. package/dist/lib/models/sql/SearchIndexStateSQL.js.map +1 -0
  139. package/dist/lib/models/sql/TaskSQL.js +109 -0
  140. package/dist/lib/models/sql/TaskSQL.js.map +1 -0
  141. package/dist/lib/models/sql/index.js +16 -0
  142. package/dist/lib/models/sql/index.js.map +1 -0
  143. package/dist/lib/models/sql.js +2 -0
  144. package/dist/lib/models/sql.js.map +1 -0
  145. package/dist/lib/models/types.js +108 -0
  146. package/dist/lib/models/types.js.map +1 -0
  147. package/dist/lib/mongo.js +8 -0
  148. package/dist/lib/mongo.js.map +1 -0
  149. package/dist/lib/push/MailPushRoute.js +42 -0
  150. package/dist/lib/push/MailPushRoute.js.map +1 -0
  151. package/dist/lib/push/index.js +6 -0
  152. package/dist/lib/push/index.js.map +1 -0
  153. package/dist/lib/routes/BaseAttachmentRoute.js +142 -0
  154. package/dist/lib/routes/BaseAttachmentRoute.js.map +1 -0
  155. package/dist/lib/routes/BaseCalendarShareLinkRoute.js +123 -0
  156. package/dist/lib/routes/BaseCalendarShareLinkRoute.js.map +1 -0
  157. package/dist/lib/routes/BaseFolderRoute.js +192 -0
  158. package/dist/lib/routes/BaseFolderRoute.js.map +1 -0
  159. package/dist/lib/routes/BaseMailIngestRoute.js +179 -0
  160. package/dist/lib/routes/BaseMailIngestRoute.js.map +1 -0
  161. package/dist/lib/routes/BaseMailboxRoute.js +187 -0
  162. package/dist/lib/routes/BaseMailboxRoute.js.map +1 -0
  163. package/dist/lib/routes/BaseMessageRoute.js +142 -0
  164. package/dist/lib/routes/BaseMessageRoute.js.map +1 -0
  165. package/dist/lib/routes/BaseScopedChildRoute.js +348 -0
  166. package/dist/lib/routes/BaseScopedChildRoute.js.map +1 -0
  167. package/dist/lib/routes/BaseSearchRoute.js +91 -0
  168. package/dist/lib/routes/BaseSearchRoute.js.map +1 -0
  169. package/dist/lib/routes/index.js +13 -0
  170. package/dist/lib/routes/index.js.map +1 -0
  171. package/dist/lib/routes/mongo/AttachmentRouteMongo.js +26 -0
  172. package/dist/lib/routes/mongo/AttachmentRouteMongo.js.map +1 -0
  173. package/dist/lib/routes/mongo/CalendarEventRouteMongo.js +27 -0
  174. package/dist/lib/routes/mongo/CalendarEventRouteMongo.js.map +1 -0
  175. package/dist/lib/routes/mongo/CalendarShareLinkRouteMongo.js +26 -0
  176. package/dist/lib/routes/mongo/CalendarShareLinkRouteMongo.js.map +1 -0
  177. package/dist/lib/routes/mongo/ContactListRouteMongo.js +26 -0
  178. package/dist/lib/routes/mongo/ContactListRouteMongo.js.map +1 -0
  179. package/dist/lib/routes/mongo/ContactRouteMongo.js +27 -0
  180. package/dist/lib/routes/mongo/ContactRouteMongo.js.map +1 -0
  181. package/dist/lib/routes/mongo/FolderRouteMongo.js +26 -0
  182. package/dist/lib/routes/mongo/FolderRouteMongo.js.map +1 -0
  183. package/dist/lib/routes/mongo/IngestQueueRouteMongo.js +33 -0
  184. package/dist/lib/routes/mongo/IngestQueueRouteMongo.js.map +1 -0
  185. package/dist/lib/routes/mongo/MailIngestRouteMongo.js +14 -0
  186. package/dist/lib/routes/mongo/MailIngestRouteMongo.js.map +1 -0
  187. package/dist/lib/routes/mongo/MailboxRouteMongo.js +39 -0
  188. package/dist/lib/routes/mongo/MailboxRouteMongo.js.map +1 -0
  189. package/dist/lib/routes/mongo/MessageRouteMongo.js +27 -0
  190. package/dist/lib/routes/mongo/MessageRouteMongo.js.map +1 -0
  191. package/dist/lib/routes/mongo/NoteRouteMongo.js +26 -0
  192. package/dist/lib/routes/mongo/NoteRouteMongo.js.map +1 -0
  193. package/dist/lib/routes/mongo/QuarantineRouteMongo.js +35 -0
  194. package/dist/lib/routes/mongo/QuarantineRouteMongo.js.map +1 -0
  195. package/dist/lib/routes/mongo/SearchRouteMongo.js +13 -0
  196. package/dist/lib/routes/mongo/SearchRouteMongo.js.map +1 -0
  197. package/dist/lib/routes/mongo/TaskRouteMongo.js +27 -0
  198. package/dist/lib/routes/mongo/TaskRouteMongo.js.map +1 -0
  199. package/dist/lib/routes/mongo/index.js +15 -0
  200. package/dist/lib/routes/mongo/index.js.map +1 -0
  201. package/dist/lib/routes/mongo.js +2 -0
  202. package/dist/lib/routes/mongo.js.map +1 -0
  203. package/dist/lib/routes/sql/AttachmentRouteSQL.js +26 -0
  204. package/dist/lib/routes/sql/AttachmentRouteSQL.js.map +1 -0
  205. package/dist/lib/routes/sql/CalendarEventRouteSQL.js +27 -0
  206. package/dist/lib/routes/sql/CalendarEventRouteSQL.js.map +1 -0
  207. package/dist/lib/routes/sql/CalendarShareLinkRouteSQL.js +26 -0
  208. package/dist/lib/routes/sql/CalendarShareLinkRouteSQL.js.map +1 -0
  209. package/dist/lib/routes/sql/ContactListRouteSQL.js +26 -0
  210. package/dist/lib/routes/sql/ContactListRouteSQL.js.map +1 -0
  211. package/dist/lib/routes/sql/ContactRouteSQL.js +27 -0
  212. package/dist/lib/routes/sql/ContactRouteSQL.js.map +1 -0
  213. package/dist/lib/routes/sql/FolderRouteSQL.js +26 -0
  214. package/dist/lib/routes/sql/FolderRouteSQL.js.map +1 -0
  215. package/dist/lib/routes/sql/IngestQueueRouteSQL.js +29 -0
  216. package/dist/lib/routes/sql/IngestQueueRouteSQL.js.map +1 -0
  217. package/dist/lib/routes/sql/MailIngestRouteSQL.js +35 -0
  218. package/dist/lib/routes/sql/MailIngestRouteSQL.js.map +1 -0
  219. package/dist/lib/routes/sql/MailboxRouteSQL.js +64 -0
  220. package/dist/lib/routes/sql/MailboxRouteSQL.js.map +1 -0
  221. package/dist/lib/routes/sql/MessageRouteSQL.js +27 -0
  222. package/dist/lib/routes/sql/MessageRouteSQL.js.map +1 -0
  223. package/dist/lib/routes/sql/NoteRouteSQL.js +26 -0
  224. package/dist/lib/routes/sql/NoteRouteSQL.js.map +1 -0
  225. package/dist/lib/routes/sql/QuarantineRouteSQL.js +29 -0
  226. package/dist/lib/routes/sql/QuarantineRouteSQL.js.map +1 -0
  227. package/dist/lib/routes/sql/SearchRouteSQL.js +13 -0
  228. package/dist/lib/routes/sql/SearchRouteSQL.js.map +1 -0
  229. package/dist/lib/routes/sql/TaskRouteSQL.js +27 -0
  230. package/dist/lib/routes/sql/TaskRouteSQL.js.map +1 -0
  231. package/dist/lib/routes/sql/index.js +15 -0
  232. package/dist/lib/routes/sql/index.js.map +1 -0
  233. package/dist/lib/routes/sql.js +2 -0
  234. package/dist/lib/routes/sql.js.map +1 -0
  235. package/dist/lib/scan/AvScanProvider.js +2 -0
  236. package/dist/lib/scan/AvScanProvider.js.map +1 -0
  237. package/dist/lib/scan/ClamAvScanProvider.js +112 -0
  238. package/dist/lib/scan/ClamAvScanProvider.js.map +1 -0
  239. package/dist/lib/scan/RspamdSpamScanProvider.js +100 -0
  240. package/dist/lib/scan/RspamdSpamScanProvider.js.map +1 -0
  241. package/dist/lib/scan/ScanPipeline.js +118 -0
  242. package/dist/lib/scan/ScanPipeline.js.map +1 -0
  243. package/dist/lib/scan/SpamScanProvider.js +2 -0
  244. package/dist/lib/scan/SpamScanProvider.js.map +1 -0
  245. package/dist/lib/scan/index.js +10 -0
  246. package/dist/lib/scan/index.js.map +1 -0
  247. package/dist/lib/search/MongoTextSearchProvider.js +116 -0
  248. package/dist/lib/search/MongoTextSearchProvider.js.map +1 -0
  249. package/dist/lib/search/OpenSearchProvider.js +156 -0
  250. package/dist/lib/search/OpenSearchProvider.js.map +1 -0
  251. package/dist/lib/search/PostgresFullTextSearchProvider.js +139 -0
  252. package/dist/lib/search/PostgresFullTextSearchProvider.js.map +1 -0
  253. package/dist/lib/search/SearchProvider.js +6 -0
  254. package/dist/lib/search/SearchProvider.js.map +1 -0
  255. package/dist/lib/search/extraction/DocxTextExtractor.js +27 -0
  256. package/dist/lib/search/extraction/DocxTextExtractor.js.map +1 -0
  257. package/dist/lib/search/extraction/ExtractorRegistry.js +82 -0
  258. package/dist/lib/search/extraction/ExtractorRegistry.js.map +1 -0
  259. package/dist/lib/search/extraction/HtmlTextExtractor.js +20 -0
  260. package/dist/lib/search/extraction/HtmlTextExtractor.js.map +1 -0
  261. package/dist/lib/search/extraction/PdfTextExtractor.js +22 -0
  262. package/dist/lib/search/extraction/PdfTextExtractor.js.map +1 -0
  263. package/dist/lib/search/extraction/PlainTextExtractor.js +14 -0
  264. package/dist/lib/search/extraction/PlainTextExtractor.js.map +1 -0
  265. package/dist/lib/search/extraction/TextExtractor.js +6 -0
  266. package/dist/lib/search/extraction/TextExtractor.js.map +1 -0
  267. package/dist/lib/search/index.js +15 -0
  268. package/dist/lib/search/index.js.map +1 -0
  269. package/dist/lib/sql.js +8 -0
  270. package/dist/lib/sql.js.map +1 -0
  271. package/dist/lib/transport/MTAIngestAdapter.js +30 -0
  272. package/dist/lib/transport/MTAIngestAdapter.js.map +1 -0
  273. package/dist/lib/transport/MailTransport.js +6 -0
  274. package/dist/lib/transport/MailTransport.js.map +1 -0
  275. package/dist/lib/transport/PostfixSendmailTransport.js +61 -0
  276. package/dist/lib/transport/PostfixSendmailTransport.js.map +1 -0
  277. package/dist/lib/transport/index.js +8 -0
  278. package/dist/lib/transport/index.js.map +1 -0
  279. package/dist/lib/util/FolderUtils.js +50 -0
  280. package/dist/lib/util/FolderUtils.js.map +1 -0
  281. package/dist/lib/util/MailSendUtils.js +36 -0
  282. package/dist/lib/util/MailSendUtils.js.map +1 -0
  283. package/dist/lib/util/MailboxScopeUtils.js +23 -0
  284. package/dist/lib/util/MailboxScopeUtils.js.map +1 -0
  285. package/dist/lib/util/OptionalDeps.js +23 -0
  286. package/dist/lib/util/OptionalDeps.js.map +1 -0
  287. package/dist/lib/util/RecoverableRepoUtils.js +42 -0
  288. package/dist/lib/util/RecoverableRepoUtils.js.map +1 -0
  289. package/dist/lib/util/index.js +17 -0
  290. package/dist/lib/util/index.js.map +1 -0
  291. package/dist/types/blob/BlobStore.d.ts +54 -0
  292. package/dist/types/blob/LocalFsBlobStore.d.ts +23 -0
  293. package/dist/types/blob/index.d.ts +2 -0
  294. package/dist/types/index.d.ts +7 -0
  295. package/dist/types/jobs/AttachmentExtractionJob.d.ts +34 -0
  296. package/dist/types/jobs/CalendarReminderJob.d.ts +37 -0
  297. package/dist/types/jobs/EasDeviceStateCleanupJob.d.ts +26 -0
  298. package/dist/types/jobs/ExternalShareExpirationJob.d.ts +34 -0
  299. package/dist/types/jobs/MailboxQuotaRecalcJob.d.ts +44 -0
  300. package/dist/types/jobs/MeetingSchedulingJob.d.ts +32 -0
  301. package/dist/types/jobs/QuarantineRetentionJob.d.ts +27 -0
  302. package/dist/types/jobs/ScanQueueJob.d.ts +41 -0
  303. package/dist/types/jobs/SearchIndexJob.d.ts +37 -0
  304. package/dist/types/jobs/index.d.ts +9 -0
  305. package/dist/types/jobs/mongo/AttachmentExtractionJobMongo.d.ts +6 -0
  306. package/dist/types/jobs/mongo/CalendarReminderJobMongo.d.ts +5 -0
  307. package/dist/types/jobs/mongo/EasDeviceStateCleanupJobMongo.d.ts +5 -0
  308. package/dist/types/jobs/mongo/ExternalShareExpirationJobMongo.d.ts +5 -0
  309. package/dist/types/jobs/mongo/MailboxQuotaRecalcJobMongo.d.ts +7 -0
  310. package/dist/types/jobs/mongo/MeetingSchedulingJobMongo.d.ts +5 -0
  311. package/dist/types/jobs/mongo/QuarantineRetentionJobMongo.d.ts +5 -0
  312. package/dist/types/jobs/mongo/ScanQueueJobMongo.d.ts +10 -0
  313. package/dist/types/jobs/mongo/SearchIndexJobMongo.d.ts +6 -0
  314. package/dist/types/jobs/mongo/index.d.ts +9 -0
  315. package/dist/types/jobs/mongo.d.ts +1 -0
  316. package/dist/types/jobs/sql/AttachmentExtractionJobSQL.d.ts +6 -0
  317. package/dist/types/jobs/sql/CalendarReminderJobSQL.d.ts +5 -0
  318. package/dist/types/jobs/sql/EasDeviceStateCleanupJobSQL.d.ts +5 -0
  319. package/dist/types/jobs/sql/ExternalShareExpirationJobSQL.d.ts +5 -0
  320. package/dist/types/jobs/sql/MailboxQuotaRecalcJobSQL.d.ts +7 -0
  321. package/dist/types/jobs/sql/MeetingSchedulingJobSQL.d.ts +5 -0
  322. package/dist/types/jobs/sql/QuarantineRetentionJobSQL.d.ts +5 -0
  323. package/dist/types/jobs/sql/ScanQueueJobSQL.d.ts +10 -0
  324. package/dist/types/jobs/sql/SearchIndexJobSQL.d.ts +6 -0
  325. package/dist/types/jobs/sql/index.d.ts +9 -0
  326. package/dist/types/jobs/sql.d.ts +1 -0
  327. package/dist/types/models/index.d.ts +1 -0
  328. package/dist/types/models/mongo/AttachmentMongo.d.ts +22 -0
  329. package/dist/types/models/mongo/CalendarEventMongo.d.ts +28 -0
  330. package/dist/types/models/mongo/CalendarShareLinkMongo.d.ts +16 -0
  331. package/dist/types/models/mongo/ContactListMongo.d.ts +13 -0
  332. package/dist/types/models/mongo/ContactMongo.d.ts +25 -0
  333. package/dist/types/models/mongo/DeviceSyncStateMongo.d.ts +18 -0
  334. package/dist/types/models/mongo/FolderMongo.d.ts +18 -0
  335. package/dist/types/models/mongo/IngestQueueEntryMongo.d.ts +17 -0
  336. package/dist/types/models/mongo/MailboxMongo.d.ts +18 -0
  337. package/dist/types/models/mongo/MessageMongo.d.ts +29 -0
  338. package/dist/types/models/mongo/NoteMongo.d.ts +16 -0
  339. package/dist/types/models/mongo/QuarantineEntryMongo.d.ts +18 -0
  340. package/dist/types/models/mongo/ScanResultMongo.d.ts +23 -0
  341. package/dist/types/models/mongo/SearchIndexStateMongo.d.ts +16 -0
  342. package/dist/types/models/mongo/TaskMongo.d.ts +19 -0
  343. package/dist/types/models/mongo/index.d.ts +15 -0
  344. package/dist/types/models/mongo.d.ts +1 -0
  345. package/dist/types/models/sql/AttachmentSQL.d.ts +22 -0
  346. package/dist/types/models/sql/CalendarEventSQL.d.ts +28 -0
  347. package/dist/types/models/sql/CalendarShareLinkSQL.d.ts +16 -0
  348. package/dist/types/models/sql/ContactListSQL.d.ts +13 -0
  349. package/dist/types/models/sql/ContactSQL.d.ts +25 -0
  350. package/dist/types/models/sql/DeviceSyncStateSQL.d.ts +18 -0
  351. package/dist/types/models/sql/FolderSQL.d.ts +18 -0
  352. package/dist/types/models/sql/IngestQueueEntrySQL.d.ts +17 -0
  353. package/dist/types/models/sql/MailboxSQL.d.ts +18 -0
  354. package/dist/types/models/sql/MessageSQL.d.ts +29 -0
  355. package/dist/types/models/sql/NoteSQL.d.ts +16 -0
  356. package/dist/types/models/sql/QuarantineEntrySQL.d.ts +18 -0
  357. package/dist/types/models/sql/ScanResultSQL.d.ts +23 -0
  358. package/dist/types/models/sql/SearchIndexStateSQL.d.ts +16 -0
  359. package/dist/types/models/sql/TaskSQL.d.ts +19 -0
  360. package/dist/types/models/sql/index.d.ts +15 -0
  361. package/dist/types/models/sql.d.ts +1 -0
  362. package/dist/types/models/types.d.ts +541 -0
  363. package/dist/types/mongo.d.ts +3 -0
  364. package/dist/types/push/MailPushRoute.d.ts +37 -0
  365. package/dist/types/push/index.d.ts +1 -0
  366. package/dist/types/routes/BaseAttachmentRoute.d.ts +24 -0
  367. package/dist/types/routes/BaseCalendarShareLinkRoute.d.ts +35 -0
  368. package/dist/types/routes/BaseFolderRoute.d.ts +58 -0
  369. package/dist/types/routes/BaseMailIngestRoute.d.ts +47 -0
  370. package/dist/types/routes/BaseMailboxRoute.d.ts +60 -0
  371. package/dist/types/routes/BaseMessageRoute.d.ts +27 -0
  372. package/dist/types/routes/BaseScopedChildRoute.d.ts +61 -0
  373. package/dist/types/routes/BaseSearchRoute.d.ts +23 -0
  374. package/dist/types/routes/index.d.ts +8 -0
  375. package/dist/types/routes/mongo/AttachmentRouteMongo.d.ts +6 -0
  376. package/dist/types/routes/mongo/CalendarEventRouteMongo.d.ts +6 -0
  377. package/dist/types/routes/mongo/CalendarShareLinkRouteMongo.d.ts +6 -0
  378. package/dist/types/routes/mongo/ContactListRouteMongo.d.ts +6 -0
  379. package/dist/types/routes/mongo/ContactRouteMongo.d.ts +6 -0
  380. package/dist/types/routes/mongo/FolderRouteMongo.d.ts +5 -0
  381. package/dist/types/routes/mongo/IngestQueueRouteMongo.d.ts +13 -0
  382. package/dist/types/routes/mongo/MailIngestRouteMongo.d.ts +6 -0
  383. package/dist/types/routes/mongo/MailboxRouteMongo.d.ts +8 -0
  384. package/dist/types/routes/mongo/MessageRouteMongo.d.ts +6 -0
  385. package/dist/types/routes/mongo/NoteRouteMongo.d.ts +6 -0
  386. package/dist/types/routes/mongo/QuarantineRouteMongo.d.ts +15 -0
  387. package/dist/types/routes/mongo/SearchRouteMongo.d.ts +5 -0
  388. package/dist/types/routes/mongo/TaskRouteMongo.d.ts +6 -0
  389. package/dist/types/routes/mongo/index.d.ts +14 -0
  390. package/dist/types/routes/mongo.d.ts +1 -0
  391. package/dist/types/routes/sql/AttachmentRouteSQL.d.ts +6 -0
  392. package/dist/types/routes/sql/CalendarEventRouteSQL.d.ts +6 -0
  393. package/dist/types/routes/sql/CalendarShareLinkRouteSQL.d.ts +6 -0
  394. package/dist/types/routes/sql/ContactListRouteSQL.d.ts +6 -0
  395. package/dist/types/routes/sql/ContactRouteSQL.d.ts +6 -0
  396. package/dist/types/routes/sql/FolderRouteSQL.d.ts +5 -0
  397. package/dist/types/routes/sql/IngestQueueRouteSQL.d.ts +9 -0
  398. package/dist/types/routes/sql/MailIngestRouteSQL.d.ts +23 -0
  399. package/dist/types/routes/sql/MailboxRouteSQL.d.ts +22 -0
  400. package/dist/types/routes/sql/MessageRouteSQL.d.ts +6 -0
  401. package/dist/types/routes/sql/NoteRouteSQL.d.ts +6 -0
  402. package/dist/types/routes/sql/QuarantineRouteSQL.d.ts +9 -0
  403. package/dist/types/routes/sql/SearchRouteSQL.d.ts +5 -0
  404. package/dist/types/routes/sql/TaskRouteSQL.d.ts +6 -0
  405. package/dist/types/routes/sql/index.d.ts +14 -0
  406. package/dist/types/routes/sql.d.ts +1 -0
  407. package/dist/types/scan/AvScanProvider.d.ts +22 -0
  408. package/dist/types/scan/ClamAvScanProvider.d.ts +17 -0
  409. package/dist/types/scan/RspamdSpamScanProvider.d.ts +16 -0
  410. package/dist/types/scan/ScanPipeline.d.ts +53 -0
  411. package/dist/types/scan/SpamScanProvider.d.ts +29 -0
  412. package/dist/types/scan/index.d.ts +5 -0
  413. package/dist/types/search/MongoTextSearchProvider.d.ts +22 -0
  414. package/dist/types/search/OpenSearchProvider.d.ts +24 -0
  415. package/dist/types/search/PostgresFullTextSearchProvider.d.ts +21 -0
  416. package/dist/types/search/SearchProvider.d.ts +62 -0
  417. package/dist/types/search/extraction/DocxTextExtractor.d.ts +14 -0
  418. package/dist/types/search/extraction/ExtractorRegistry.d.ts +19 -0
  419. package/dist/types/search/extraction/HtmlTextExtractor.d.ts +11 -0
  420. package/dist/types/search/extraction/PdfTextExtractor.d.ts +10 -0
  421. package/dist/types/search/extraction/PlainTextExtractor.d.ts +10 -0
  422. package/dist/types/search/extraction/TextExtractor.d.ts +17 -0
  423. package/dist/types/search/index.d.ts +10 -0
  424. package/dist/types/sql.d.ts +3 -0
  425. package/dist/types/transport/MTAIngestAdapter.d.ts +25 -0
  426. package/dist/types/transport/MailTransport.d.ts +29 -0
  427. package/dist/types/transport/PostfixSendmailTransport.d.ts +15 -0
  428. package/dist/types/transport/index.d.ts +3 -0
  429. package/dist/types/util/FolderUtils.d.ts +15 -0
  430. package/dist/types/util/MailSendUtils.d.ts +19 -0
  431. package/dist/types/util/MailboxScopeUtils.d.ts +19 -0
  432. package/dist/types/util/OptionalDeps.d.ts +9 -0
  433. package/dist/types/util/RecoverableRepoUtils.d.ts +24 -0
  434. package/dist/types/util/index.d.ts +12 -0
  435. package/package.json +122 -0
@@ -0,0 +1,100 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ ///////////////////////////////////////////////////////////////////////////////
11
+ // Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
12
+ // SPDX-License-Identifier: MPL-2.0
13
+ ///////////////////////////////////////////////////////////////////////////////
14
+ import { ObjectDecorators } from "@rapidrest/core";
15
+ import { SpamVerdict } from "../models/types.js";
16
+ const { Config, Logger } = ObjectDecorators;
17
+ /**
18
+ * `SpamScanProvider` adapter for rspamd, talking to its HTTP controller `checkv2` endpoint. Chosen over
19
+ * SpamAssassin's `spamc`/`spamd` line protocol for HTTP-native integration matching this library's HTTP-first
20
+ * design — a `SpamAssassinScanProvider` implementing the same interface via `spamc` is a straightforward
21
+ * drop-in alternative for a deployment that already runs SpamAssassin instead.
22
+ *
23
+ * @author Jean-Philippe Steinmetz
24
+ */
25
+ export class RspamdSpamScanProvider {
26
+ constructor() {
27
+ this.name = "rspamd";
28
+ this.url = "http://127.0.0.1:11333";
29
+ this.timeoutMs = 15000;
30
+ }
31
+ async scoreMessage(raw, envelope) {
32
+ const headers = {
33
+ "Content-Type": "application/octet-stream",
34
+ From: envelope.from,
35
+ };
36
+ if (envelope.to.length > 0) {
37
+ headers["Rcpt"] = envelope.to.join(",");
38
+ }
39
+ if (envelope.remoteIp) {
40
+ headers["IP"] = envelope.remoteIp;
41
+ }
42
+ if (envelope.helo) {
43
+ headers["Helo"] = envelope.helo;
44
+ }
45
+ const controller = new AbortController();
46
+ const timeoutHandle = setTimeout(() => controller.abort(), this.timeoutMs);
47
+ try {
48
+ const response = await fetch(`${this.url}/checkv2`, {
49
+ method: "POST",
50
+ headers,
51
+ body: new Uint8Array(raw),
52
+ signal: controller.signal,
53
+ });
54
+ if (!response.ok) {
55
+ throw new Error(`rspamd returned HTTP ${response.status}`);
56
+ }
57
+ const body = (await response.json());
58
+ return {
59
+ score: body.score,
60
+ verdict: mapAction(body.action),
61
+ symbols: Object.keys(body.symbols ?? {}),
62
+ };
63
+ }
64
+ catch (err) {
65
+ // A scan-engine outage must not silently pass every message through as clean — fail closed to
66
+ // `SUSPECT` so it's routed for human review/Junk rather than blind delivery to the inbox.
67
+ this.logger?.error(`rspamd scan failed: ${err.message}`);
68
+ return { score: 0, verdict: SpamVerdict.SUSPECT, symbols: ["SCAN_ENGINE_UNAVAILABLE"] };
69
+ }
70
+ finally {
71
+ clearTimeout(timeoutHandle);
72
+ }
73
+ }
74
+ }
75
+ __decorate([
76
+ Config("mail:scan:spam:rspamd:url", "http://127.0.0.1:11333"),
77
+ __metadata("design:type", String)
78
+ ], RspamdSpamScanProvider.prototype, "url", void 0);
79
+ __decorate([
80
+ Config("mail:scan:spam:rspamd:timeout_ms", 15000),
81
+ __metadata("design:type", Number)
82
+ ], RspamdSpamScanProvider.prototype, "timeoutMs", void 0);
83
+ __decorate([
84
+ Logger,
85
+ __metadata("design:type", Object)
86
+ ], RspamdSpamScanProvider.prototype, "logger", void 0);
87
+ function mapAction(action) {
88
+ switch (action) {
89
+ case "reject":
90
+ case "soft reject":
91
+ return SpamVerdict.SPAM;
92
+ case "add header":
93
+ case "rewrite subject":
94
+ case "greylist":
95
+ return SpamVerdict.SUSPECT;
96
+ default:
97
+ return SpamVerdict.CLEAN;
98
+ }
99
+ }
100
+ //# sourceMappingURL=RspamdSpamScanProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RspamdSpamScanProvider.js","sourceRoot":"","sources":["../../../src/scan/RspamdSpamScanProvider.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,118 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ ///////////////////////////////////////////////////////////////////////////////
11
+ // Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
12
+ // SPDX-License-Identifier: MPL-2.0
13
+ ///////////////////////////////////////////////////////////////////////////////
14
+ import sanitizeHtml from "sanitize-html";
15
+ import { simpleParser } from "mailparser";
16
+ import { ObjectDecorators } from "@rapidrest/core";
17
+ import { AvVerdict, SpamVerdict } from "../models/types.js";
18
+ const { Config, Inject, Logger } = ObjectDecorators;
19
+ /** Verdicts ranked worst-to-best, used to combine the raw-message and per-attachment AV results. */
20
+ const AV_SEVERITY = {
21
+ [AvVerdict.INFECTED]: 2,
22
+ [AvVerdict.ERROR]: 1,
23
+ [AvVerdict.CLEAN]: 0,
24
+ };
25
+ /**
26
+ * Orchestrates SPAM scoring, AV scanning, and HTML sanitization for a single raw RFC 5322 message — the
27
+ * ingestion-time gate that every inbound message (via `MailIngestRoute`) and outbound send (via the webmail/
28
+ * EAS/MAPI "send" routes) passes through before delivery/relay. AV scanning covers the full raw message buffer
29
+ * *and* each decoded attachment (not just attachments), which is what catches embedded/malicious HTML.
30
+ *
31
+ * @author Jean-Philippe Steinmetz
32
+ */
33
+ export class ScanPipeline {
34
+ async run(raw, envelope) {
35
+ if (!this.spamScanProvider || !this.avScanProvider) {
36
+ throw new Error("ScanPipeline requires both a SpamScanProvider and an AvScanProvider to be registered. " +
37
+ "Configure `scan:spam:provider`/`scan:av:provider`.");
38
+ }
39
+ const parsed = await simpleParser(raw);
40
+ const [spam, rawAv, attachmentResults] = await Promise.all([
41
+ this.spamScanProvider.scoreMessage(raw, envelope),
42
+ this.avScanProvider.scanBuffer(raw),
43
+ this.scanAttachments(parsed.attachments ?? []),
44
+ ]);
45
+ let worstAv = rawAv;
46
+ for (const attachment of attachmentResults) {
47
+ if (AV_SEVERITY[attachment.av.verdict] > AV_SEVERITY[worstAv.verdict]) {
48
+ worstAv = attachment.av;
49
+ }
50
+ }
51
+ const sanitizedHtml = typeof parsed.html === "string" ? this.sanitize(parsed.html) : undefined;
52
+ return { spam, av: worstAv, attachments: attachmentResults, sanitizedHtml };
53
+ }
54
+ async scanAttachments(attachments) {
55
+ const results = [];
56
+ for (const attachment of attachments) {
57
+ const av = await this.avScanProvider.scanBuffer(attachment.content, attachment.filename);
58
+ results.push({
59
+ filename: attachment.filename,
60
+ contentType: attachment.contentType,
61
+ content: attachment.content,
62
+ contentId: attachment.contentId,
63
+ isInline: attachment.contentDisposition === "inline",
64
+ av,
65
+ });
66
+ }
67
+ return results;
68
+ }
69
+ /**
70
+ * Strips `<script>` tags and other active/executable content from an HTML body. Defense in depth alongside
71
+ * clamd's own HTML/JS signature detection (run against the raw message above) and whatever sandboxing the
72
+ * eventual client renderer applies.
73
+ */
74
+ sanitize(html) {
75
+ return sanitizeHtml(html, {
76
+ allowedTags: this.allowedTags ?? sanitizeHtml.defaults.allowedTags.filter((tag) => tag !== "script"),
77
+ allowVulnerableTags: false,
78
+ disallowedTagsMode: "discard",
79
+ allowedSchemes: ["http", "https", "mailto", "cid"],
80
+ });
81
+ }
82
+ }
83
+ __decorate([
84
+ Inject("SpamScanProvider"),
85
+ __metadata("design:type", Object)
86
+ ], ScanPipeline.prototype, "spamScanProvider", void 0);
87
+ __decorate([
88
+ Inject("AvScanProvider"),
89
+ __metadata("design:type", Object)
90
+ ], ScanPipeline.prototype, "avScanProvider", void 0);
91
+ __decorate([
92
+ Config("mail:scan:sanitize:allowed_tags"),
93
+ __metadata("design:type", Array)
94
+ ], ScanPipeline.prototype, "allowedTags", void 0);
95
+ __decorate([
96
+ Logger,
97
+ __metadata("design:type", Object)
98
+ ], ScanPipeline.prototype, "logger", void 0);
99
+ /**
100
+ * Combines a spam verdict and an AV verdict into where the message should be routed on ingestion.
101
+ *
102
+ * `AvVerdict.ERROR` and `SpamVerdict.SUSPECT` are the providers' own documented fail-closed outcomes for a
103
+ * scan-engine outage (see `ClamAvScanProvider.scanBuffer()`/`RspamdSpamScanProvider.scoreMessage()`) - treating
104
+ * them as equivalent to a clean/normal verdict here would silently deliver every message straight to the
105
+ * inbox, completely unscanned, for the entire duration of an AV/spam engine outage. `ERROR` quarantines
106
+ * (matching AV's own "treat like infected" intent); `SUSPECT` routes to Junk for human review rather than
107
+ * blind inbox delivery.
108
+ */
109
+ export function resolveDeliveryVerdict(result) {
110
+ if (result.av.verdict === AvVerdict.INFECTED || result.av.verdict === AvVerdict.ERROR) {
111
+ return "quarantine";
112
+ }
113
+ if (result.spam.verdict === SpamVerdict.SPAM || result.spam.verdict === SpamVerdict.SUSPECT) {
114
+ return "junk";
115
+ }
116
+ return "deliver";
117
+ }
118
+ //# sourceMappingURL=ScanPipeline.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ScanPipeline.js","sourceRoot":"","sources":["../../../src/scan/ScanPipeline.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=SpamScanProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SpamScanProvider.js","sourceRoot":"","sources":["../../../src/scan/SpamScanProvider.ts"],"names":[],"mappings":""}
@@ -0,0 +1,10 @@
1
+ ///////////////////////////////////////////////////////////////////////////////
2
+ // Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
3
+ // SPDX-License-Identifier: MPL-2.0
4
+ ///////////////////////////////////////////////////////////////////////////////
5
+ export * from "./SpamScanProvider.js";
6
+ export * from "./AvScanProvider.js";
7
+ export * from "./RspamdSpamScanProvider.js";
8
+ export * from "./ClamAvScanProvider.js";
9
+ export * from "./ScanPipeline.js";
10
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scan/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC"}
@@ -0,0 +1,116 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ import { ObjectDecorators } from "@rapidrest/core";
11
+ import { ConnectionManager } from "@rapidrest/service-core";
12
+ const { Config, Init, Inject, Logger } = ObjectDecorators;
13
+ const COLLECTION_NAME = "mail_search_index";
14
+ /**
15
+ * `SearchProvider` backed by MongoDB's native `$text` index — the embedded default for a Mongo-backed
16
+ * deployment that hasn't opted into a dedicated search engine. Documents are stored in a collection separate
17
+ * from the entities they're derived from (`mail_search_index`), keyed by `<entityType>:<entityUid>`.
18
+ *
19
+ * @author Jean-Philippe Steinmetz
20
+ */
21
+ export class MongoTextSearchProvider {
22
+ constructor() {
23
+ this.name = "mongo";
24
+ this.datasourceName = "mongo";
25
+ }
26
+ async init() {
27
+ const conn = this.connectionManager?.connections.get(this.datasourceName);
28
+ const db = conn?.db;
29
+ if (!db) {
30
+ throw new Error(`MongoTextSearchProvider: no MongoDB connection found for datasource '${this.datasourceName}'.`);
31
+ }
32
+ this.collection = db.collection(COLLECTION_NAME);
33
+ await this.collection.createIndex({ subject: "text", body: "text", attachmentText: "text", participants: "text" }, { name: "mail_search_text" });
34
+ await this.collection.createIndex({ mailboxUid: 1, entityType: 1 });
35
+ }
36
+ docId(entityType, entityUid) {
37
+ return `${entityType}:${entityUid}`;
38
+ }
39
+ toStoredDoc(doc) {
40
+ return {
41
+ _id: this.docId(doc.entityType, doc.entityUid),
42
+ entityType: doc.entityType,
43
+ entityUid: doc.entityUid,
44
+ mailboxUid: doc.mailboxUid,
45
+ subject: doc.subject,
46
+ body: doc.body,
47
+ attachmentText: doc.attachmentText?.join("\n"),
48
+ participants: doc.participants?.join(" "),
49
+ dateForSort: doc.dateForSort,
50
+ };
51
+ }
52
+ async index(doc) {
53
+ await this.bulkIndex([doc]);
54
+ }
55
+ async bulkIndex(docs) {
56
+ if (!this.collection || docs.length === 0) {
57
+ return;
58
+ }
59
+ await this.collection.bulkWrite(docs.map((doc) => ({
60
+ replaceOne: {
61
+ filter: { _id: this.docId(doc.entityType, doc.entityUid) },
62
+ replacement: this.toStoredDoc(doc),
63
+ upsert: true,
64
+ },
65
+ })));
66
+ }
67
+ async remove(entityType, entityUid) {
68
+ await this.collection?.deleteOne({ _id: this.docId(entityType, entityUid) });
69
+ }
70
+ async search(query) {
71
+ if (!this.collection) {
72
+ return { results: [] };
73
+ }
74
+ const limit = Math.min(query.limit ?? 25, 200);
75
+ const skip = query.cursor ? Math.max(0, parseInt(query.cursor, 10) || 0) : 0;
76
+ const filter = { mailboxUid: query.mailboxUid, $text: { $search: query.text } };
77
+ if (query.entityTypes && query.entityTypes.length > 0) {
78
+ filter.entityType = { $in: query.entityTypes };
79
+ }
80
+ const cursor = this.collection
81
+ .find(filter, { projection: { score: { $meta: "textScore" } } })
82
+ .sort({ score: { $meta: "textScore" } })
83
+ .skip(skip)
84
+ .limit(limit + 1);
85
+ const rows = await cursor.toArray();
86
+ const hasMore = rows.length > limit;
87
+ const page = hasMore ? rows.slice(0, limit) : rows;
88
+ return {
89
+ results: page.map((row) => ({
90
+ entityType: row.entityType,
91
+ entityUid: row.entityUid,
92
+ score: row.score ?? 0,
93
+ })),
94
+ nextCursor: hasMore ? String(skip + limit) : undefined,
95
+ };
96
+ }
97
+ }
98
+ __decorate([
99
+ Inject(ConnectionManager),
100
+ __metadata("design:type", ConnectionManager)
101
+ ], MongoTextSearchProvider.prototype, "connectionManager", void 0);
102
+ __decorate([
103
+ Config("mail:search:mongo:datasource", "mongo"),
104
+ __metadata("design:type", String)
105
+ ], MongoTextSearchProvider.prototype, "datasourceName", void 0);
106
+ __decorate([
107
+ Logger,
108
+ __metadata("design:type", Object)
109
+ ], MongoTextSearchProvider.prototype, "logger", void 0);
110
+ __decorate([
111
+ Init,
112
+ __metadata("design:type", Function),
113
+ __metadata("design:paramtypes", []),
114
+ __metadata("design:returntype", Promise)
115
+ ], MongoTextSearchProvider.prototype, "init", null);
116
+ //# sourceMappingURL=MongoTextSearchProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MongoTextSearchProvider.js","sourceRoot":"","sources":["../../../src/search/MongoTextSearchProvider.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,156 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ ///////////////////////////////////////////////////////////////////////////////
11
+ // Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
12
+ // SPDX-License-Identifier: MPL-2.0
13
+ ///////////////////////////////////////////////////////////////////////////////
14
+ import { ObjectDecorators } from "@rapidrest/core";
15
+ import { importOptional } from "../util/OptionalDeps.js";
16
+ const { Config, Init, Logger } = ObjectDecorators;
17
+ /**
18
+ * `SearchProvider` adapter for a dedicated OpenSearch cluster, via the optional peer dependency
19
+ * `@opensearch-project/opensearch` — the recommended provider for larger deployments where the embedded
20
+ * Mongo/Postgres default's relevance ranking and indexing throughput become a bottleneck. Selected via the
21
+ * `search:provider: "opensearch"` config key.
22
+ *
23
+ * @author Jean-Philippe Steinmetz
24
+ */
25
+ export class OpenSearchProvider {
26
+ constructor() {
27
+ this.name = "opensearch";
28
+ this.url = "https://localhost:9200";
29
+ this.index_ = "mail_search_index";
30
+ }
31
+ async init() {
32
+ const { Client } = await importOptional("@opensearch-project/opensearch");
33
+ this.client = new Client({
34
+ node: this.url,
35
+ auth: this.username ? { username: this.username, password: this.password } : undefined,
36
+ });
37
+ const exists = await this.client.indices.exists({ index: this.index_ });
38
+ if (!exists.body) {
39
+ await this.client.indices.create({
40
+ index: this.index_,
41
+ body: {
42
+ mappings: {
43
+ properties: {
44
+ entityType: { type: "keyword" },
45
+ entityUid: { type: "keyword" },
46
+ mailboxUid: { type: "keyword" },
47
+ subject: { type: "text" },
48
+ body: { type: "text" },
49
+ attachmentText: { type: "text" },
50
+ participants: { type: "text" },
51
+ dateForSort: { type: "date" },
52
+ },
53
+ },
54
+ },
55
+ });
56
+ }
57
+ }
58
+ docId(entityType, entityUid) {
59
+ return `${entityType}:${entityUid}`;
60
+ }
61
+ async index(doc) {
62
+ await this.client.index({
63
+ index: this.index_,
64
+ id: this.docId(doc.entityType, doc.entityUid),
65
+ body: doc,
66
+ refresh: false,
67
+ });
68
+ }
69
+ async bulkIndex(docs) {
70
+ if (docs.length === 0) {
71
+ return;
72
+ }
73
+ const body = docs.flatMap((doc) => [
74
+ { index: { _index: this.index_, _id: this.docId(doc.entityType, doc.entityUid) } },
75
+ doc,
76
+ ]);
77
+ await this.client.bulk({ body });
78
+ }
79
+ async remove(entityType, entityUid) {
80
+ try {
81
+ await this.client.delete({ index: this.index_, id: this.docId(entityType, entityUid) });
82
+ }
83
+ catch (err) {
84
+ // A 404 (already absent) is not an error for a remove() call — every other status is.
85
+ if (err?.meta?.statusCode !== 404) {
86
+ throw err;
87
+ }
88
+ }
89
+ }
90
+ async search(query) {
91
+ const limit = Math.min(query.limit ?? 25, 200);
92
+ const from = query.cursor ? Math.max(0, parseInt(query.cursor, 10) || 0) : 0;
93
+ const filter = [{ term: { mailboxUid: query.mailboxUid } }];
94
+ if (query.entityTypes && query.entityTypes.length > 0) {
95
+ filter.push({ terms: { entityType: query.entityTypes } });
96
+ }
97
+ const response = await this.client.search({
98
+ index: this.index_,
99
+ body: {
100
+ query: {
101
+ bool: {
102
+ must: [
103
+ {
104
+ multi_match: {
105
+ query: query.text,
106
+ fields: ["subject^3", "body", "attachmentText", "participants^2"],
107
+ },
108
+ },
109
+ ],
110
+ filter,
111
+ },
112
+ },
113
+ from,
114
+ size: limit + 1,
115
+ },
116
+ });
117
+ const hits = response.body.hits.hits;
118
+ const hasMore = hits.length > limit;
119
+ const page = hasMore ? hits.slice(0, limit) : hits;
120
+ return {
121
+ results: page.map((hit) => ({
122
+ entityType: hit._source.entityType,
123
+ entityUid: hit._source.entityUid,
124
+ score: hit._score,
125
+ })),
126
+ nextCursor: hasMore ? String(from + limit) : undefined,
127
+ };
128
+ }
129
+ }
130
+ __decorate([
131
+ Config("mail:search:opensearch:url", "https://localhost:9200"),
132
+ __metadata("design:type", String)
133
+ ], OpenSearchProvider.prototype, "url", void 0);
134
+ __decorate([
135
+ Config("mail:search:opensearch:index", "mail_search_index"),
136
+ __metadata("design:type", String)
137
+ ], OpenSearchProvider.prototype, "index_", void 0);
138
+ __decorate([
139
+ Config("mail:search:opensearch:username"),
140
+ __metadata("design:type", String)
141
+ ], OpenSearchProvider.prototype, "username", void 0);
142
+ __decorate([
143
+ Config("mail:search:opensearch:password"),
144
+ __metadata("design:type", String)
145
+ ], OpenSearchProvider.prototype, "password", void 0);
146
+ __decorate([
147
+ Logger,
148
+ __metadata("design:type", Object)
149
+ ], OpenSearchProvider.prototype, "logger", void 0);
150
+ __decorate([
151
+ Init,
152
+ __metadata("design:type", Function),
153
+ __metadata("design:paramtypes", []),
154
+ __metadata("design:returntype", Promise)
155
+ ], OpenSearchProvider.prototype, "init", null);
156
+ //# sourceMappingURL=OpenSearchProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OpenSearchProvider.js","sourceRoot":"","sources":["../../../src/search/OpenSearchProvider.ts"],"names":[],"mappings":"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"}