imap-wizard 0.0.0-stage → 0.3.1

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 (404) hide show
  1. package/COPYING +674 -0
  2. package/LICENSE +155 -0
  3. package/README.md +498 -2
  4. package/dist/app.d.ts +61 -0
  5. package/dist/app.d.ts.map +1 -0
  6. package/dist/app.js +201 -0
  7. package/dist/app.js.map +1 -0
  8. package/dist/cache/body-cache.d.ts +29 -0
  9. package/dist/cache/body-cache.d.ts.map +1 -0
  10. package/dist/cache/body-cache.js +95 -0
  11. package/dist/cache/body-cache.js.map +1 -0
  12. package/dist/cache/schema.d.ts +40 -0
  13. package/dist/cache/schema.d.ts.map +1 -0
  14. package/dist/cache/schema.js +160 -0
  15. package/dist/cache/schema.js.map +1 -0
  16. package/dist/cache/store.d.ts +233 -0
  17. package/dist/cache/store.d.ts.map +1 -0
  18. package/dist/cache/store.js +556 -0
  19. package/dist/cache/store.js.map +1 -0
  20. package/dist/cache/sync-engine.d.ts +140 -0
  21. package/dist/cache/sync-engine.d.ts.map +1 -0
  22. package/dist/cache/sync-engine.js +477 -0
  23. package/dist/cache/sync-engine.js.map +1 -0
  24. package/dist/cli/account-commands.d.ts +51 -0
  25. package/dist/cli/account-commands.d.ts.map +1 -0
  26. package/dist/cli/account-commands.js +767 -0
  27. package/dist/cli/account-commands.js.map +1 -0
  28. package/dist/cli/config-commands.d.ts +9 -0
  29. package/dist/cli/config-commands.d.ts.map +1 -0
  30. package/dist/cli/config-commands.js +293 -0
  31. package/dist/cli/config-commands.js.map +1 -0
  32. package/dist/cli/email-commands.d.ts +18 -0
  33. package/dist/cli/email-commands.d.ts.map +1 -0
  34. package/dist/cli/email-commands.js +447 -0
  35. package/dist/cli/email-commands.js.map +1 -0
  36. package/dist/cli/guard.d.ts +11 -0
  37. package/dist/cli/guard.d.ts.map +1 -0
  38. package/dist/cli/guard.js +18 -0
  39. package/dist/cli/guard.js.map +1 -0
  40. package/dist/cli/http.d.ts +15 -0
  41. package/dist/cli/http.d.ts.map +1 -0
  42. package/dist/cli/http.js +263 -0
  43. package/dist/cli/http.js.map +1 -0
  44. package/dist/cli/install-commands.d.ts +18 -0
  45. package/dist/cli/install-commands.d.ts.map +1 -0
  46. package/dist/cli/install-commands.js +323 -0
  47. package/dist/cli/install-commands.js.map +1 -0
  48. package/dist/cli/keychain-commands.d.ts +9 -0
  49. package/dist/cli/keychain-commands.d.ts.map +1 -0
  50. package/dist/cli/keychain-commands.js +243 -0
  51. package/dist/cli/keychain-commands.js.map +1 -0
  52. package/dist/cli/notify.d.ts +8 -0
  53. package/dist/cli/notify.d.ts.map +1 -0
  54. package/dist/cli/notify.js +143 -0
  55. package/dist/cli/notify.js.map +1 -0
  56. package/dist/cli/providers.d.ts +13 -0
  57. package/dist/cli/providers.d.ts.map +1 -0
  58. package/dist/cli/providers.js +180 -0
  59. package/dist/cli/providers.js.map +1 -0
  60. package/dist/cli/scheduler.d.ts +8 -0
  61. package/dist/cli/scheduler.d.ts.map +1 -0
  62. package/dist/cli/scheduler.js +268 -0
  63. package/dist/cli/scheduler.js.map +1 -0
  64. package/dist/cli/setup.d.ts +12 -0
  65. package/dist/cli/setup.d.ts.map +1 -0
  66. package/dist/cli/setup.js +15 -0
  67. package/dist/cli/setup.js.map +1 -0
  68. package/dist/cli/test.d.ts +7 -0
  69. package/dist/cli/test.d.ts.map +1 -0
  70. package/dist/cli/test.js +67 -0
  71. package/dist/cli/test.js.map +1 -0
  72. package/dist/config/loader.d.ts +45 -0
  73. package/dist/config/loader.d.ts.map +1 -0
  74. package/dist/config/loader.js +487 -0
  75. package/dist/config/loader.js.map +1 -0
  76. package/dist/config/password-command.d.ts +14 -0
  77. package/dist/config/password-command.d.ts.map +1 -0
  78. package/dist/config/password-command.js +74 -0
  79. package/dist/config/password-command.js.map +1 -0
  80. package/dist/config/schema.d.ts +416 -0
  81. package/dist/config/schema.d.ts.map +1 -0
  82. package/dist/config/schema.js +260 -0
  83. package/dist/config/schema.js.map +1 -0
  84. package/dist/config/send-limit.d.ts +18 -0
  85. package/dist/config/send-limit.d.ts.map +1 -0
  86. package/dist/config/send-limit.js +64 -0
  87. package/dist/config/send-limit.js.map +1 -0
  88. package/dist/config/validate.d.ts +30 -0
  89. package/dist/config/validate.d.ts.map +1 -0
  90. package/dist/config/validate.js +120 -0
  91. package/dist/config/validate.js.map +1 -0
  92. package/dist/config/xdg.d.ts +44 -0
  93. package/dist/config/xdg.d.ts.map +1 -0
  94. package/dist/config/xdg.js +49 -0
  95. package/dist/config/xdg.js.map +1 -0
  96. package/dist/connections/manager.d.ts +53 -0
  97. package/dist/connections/manager.d.ts.map +1 -0
  98. package/dist/connections/manager.js +376 -0
  99. package/dist/connections/manager.js.map +1 -0
  100. package/dist/connections/types.d.ts +15 -0
  101. package/dist/connections/types.d.ts.map +1 -0
  102. package/dist/connections/types.js +2 -0
  103. package/dist/connections/types.js.map +1 -0
  104. package/dist/logging.d.ts +22 -0
  105. package/dist/logging.d.ts.map +1 -0
  106. package/dist/logging.js +33 -0
  107. package/dist/logging.js.map +1 -0
  108. package/dist/main.d.ts +15 -0
  109. package/dist/main.d.ts.map +1 -0
  110. package/dist/main.js +276 -0
  111. package/dist/main.js.map +1 -0
  112. package/dist/prompts/actions.prompt.d.ts +9 -0
  113. package/dist/prompts/actions.prompt.d.ts.map +1 -0
  114. package/dist/prompts/actions.prompt.js +70 -0
  115. package/dist/prompts/actions.prompt.js.map +1 -0
  116. package/dist/prompts/calendar.prompt.d.ts +9 -0
  117. package/dist/prompts/calendar.prompt.d.ts.map +1 -0
  118. package/dist/prompts/calendar.prompt.js +59 -0
  119. package/dist/prompts/calendar.prompt.js.map +1 -0
  120. package/dist/prompts/cleanup.prompt.d.ts +9 -0
  121. package/dist/prompts/cleanup.prompt.d.ts.map +1 -0
  122. package/dist/prompts/cleanup.prompt.js +82 -0
  123. package/dist/prompts/cleanup.prompt.js.map +1 -0
  124. package/dist/prompts/compose.prompt.d.ts +8 -0
  125. package/dist/prompts/compose.prompt.d.ts.map +1 -0
  126. package/dist/prompts/compose.prompt.js +124 -0
  127. package/dist/prompts/compose.prompt.js.map +1 -0
  128. package/dist/prompts/register.d.ts +8 -0
  129. package/dist/prompts/register.d.ts.map +1 -0
  130. package/dist/prompts/register.js +20 -0
  131. package/dist/prompts/register.js.map +1 -0
  132. package/dist/prompts/thread.prompt.d.ts +9 -0
  133. package/dist/prompts/thread.prompt.d.ts.map +1 -0
  134. package/dist/prompts/thread.prompt.js +62 -0
  135. package/dist/prompts/thread.prompt.js.map +1 -0
  136. package/dist/prompts/triage.prompt.d.ts +9 -0
  137. package/dist/prompts/triage.prompt.d.ts.map +1 -0
  138. package/dist/prompts/triage.prompt.js +71 -0
  139. package/dist/prompts/triage.prompt.js.map +1 -0
  140. package/dist/resources/accounts.resource.d.ts +9 -0
  141. package/dist/resources/accounts.resource.d.ts.map +1 -0
  142. package/dist/resources/accounts.resource.js +26 -0
  143. package/dist/resources/accounts.resource.js.map +1 -0
  144. package/dist/resources/mailboxes.resource.d.ts +10 -0
  145. package/dist/resources/mailboxes.resource.d.ts.map +1 -0
  146. package/dist/resources/mailboxes.resource.js +33 -0
  147. package/dist/resources/mailboxes.resource.js.map +1 -0
  148. package/dist/resources/register.d.ts +12 -0
  149. package/dist/resources/register.d.ts.map +1 -0
  150. package/dist/resources/register.js +20 -0
  151. package/dist/resources/register.js.map +1 -0
  152. package/dist/resources/scheduled.resource.d.ts +9 -0
  153. package/dist/resources/scheduled.resource.d.ts.map +1 -0
  154. package/dist/resources/scheduled.resource.js +31 -0
  155. package/dist/resources/scheduled.resource.js.map +1 -0
  156. package/dist/resources/stats.resource.d.ts +10 -0
  157. package/dist/resources/stats.resource.d.ts.map +1 -0
  158. package/dist/resources/stats.resource.js +50 -0
  159. package/dist/resources/stats.resource.js.map +1 -0
  160. package/dist/resources/templates.resource.d.ts +9 -0
  161. package/dist/resources/templates.resource.d.ts.map +1 -0
  162. package/dist/resources/templates.resource.js +34 -0
  163. package/dist/resources/templates.resource.js.map +1 -0
  164. package/dist/resources/unread.resource.d.ts +11 -0
  165. package/dist/resources/unread.resource.d.ts.map +1 -0
  166. package/dist/resources/unread.resource.js +53 -0
  167. package/dist/resources/unread.resource.js.map +1 -0
  168. package/dist/safety/audit.d.ts +17 -0
  169. package/dist/safety/audit.d.ts.map +1 -0
  170. package/dist/safety/audit.js +50 -0
  171. package/dist/safety/audit.js.map +1 -0
  172. package/dist/safety/rate-limiter.d.ts +22 -0
  173. package/dist/safety/rate-limiter.d.ts.map +1 -0
  174. package/dist/safety/rate-limiter.js +52 -0
  175. package/dist/safety/rate-limiter.js.map +1 -0
  176. package/dist/safety/validation.d.ts +46 -0
  177. package/dist/safety/validation.d.ts.map +1 -0
  178. package/dist/safety/validation.js +114 -0
  179. package/dist/safety/validation.js.map +1 -0
  180. package/dist/safety/webhook-guard.d.ts +33 -0
  181. package/dist/safety/webhook-guard.d.ts.map +1 -0
  182. package/dist/safety/webhook-guard.js +154 -0
  183. package/dist/safety/webhook-guard.js.map +1 -0
  184. package/dist/security/keychain.d.ts +31 -0
  185. package/dist/security/keychain.d.ts.map +1 -0
  186. package/dist/security/keychain.js +217 -0
  187. package/dist/security/keychain.js.map +1 -0
  188. package/dist/server.d.ts +13 -0
  189. package/dist/server.d.ts.map +1 -0
  190. package/dist/server.js +35 -0
  191. package/dist/server.js.map +1 -0
  192. package/dist/services/calendar.service.d.ts +22 -0
  193. package/dist/services/calendar.service.d.ts.map +1 -0
  194. package/dist/services/calendar.service.js +115 -0
  195. package/dist/services/calendar.service.js.map +1 -0
  196. package/dist/services/clipboard.service.d.ts +16 -0
  197. package/dist/services/clipboard.service.d.ts.map +1 -0
  198. package/dist/services/clipboard.service.js +92 -0
  199. package/dist/services/clipboard.service.js.map +1 -0
  200. package/dist/services/event-bus.d.ts +62 -0
  201. package/dist/services/event-bus.d.ts.map +1 -0
  202. package/dist/services/event-bus.js +16 -0
  203. package/dist/services/event-bus.js.map +1 -0
  204. package/dist/services/hooks.service.d.ts +88 -0
  205. package/dist/services/hooks.service.d.ts.map +1 -0
  206. package/dist/services/hooks.service.js +539 -0
  207. package/dist/services/hooks.service.js.map +1 -0
  208. package/dist/services/imap.service.d.ts +301 -0
  209. package/dist/services/imap.service.d.ts.map +1 -0
  210. package/dist/services/imap.service.js +2135 -0
  211. package/dist/services/imap.service.js.map +1 -0
  212. package/dist/services/label-strategy.d.ts +20 -0
  213. package/dist/services/label-strategy.d.ts.map +1 -0
  214. package/dist/services/label-strategy.js +247 -0
  215. package/dist/services/label-strategy.js.map +1 -0
  216. package/dist/services/local-calendar.service.d.ts +127 -0
  217. package/dist/services/local-calendar.service.d.ts.map +1 -0
  218. package/dist/services/local-calendar.service.js +537 -0
  219. package/dist/services/local-calendar.service.js.map +1 -0
  220. package/dist/services/notifier.service.d.ts +91 -0
  221. package/dist/services/notifier.service.d.ts.map +1 -0
  222. package/dist/services/notifier.service.js +381 -0
  223. package/dist/services/notifier.service.js.map +1 -0
  224. package/dist/services/oauth.service.d.ts +47 -0
  225. package/dist/services/oauth.service.d.ts.map +1 -0
  226. package/dist/services/oauth.service.js +140 -0
  227. package/dist/services/oauth.service.js.map +1 -0
  228. package/dist/services/presets.d.ts +36 -0
  229. package/dist/services/presets.d.ts.map +1 -0
  230. package/dist/services/presets.js +175 -0
  231. package/dist/services/presets.js.map +1 -0
  232. package/dist/services/reminders.service.d.ts +63 -0
  233. package/dist/services/reminders.service.d.ts.map +1 -0
  234. package/dist/services/reminders.service.js +305 -0
  235. package/dist/services/reminders.service.js.map +1 -0
  236. package/dist/services/scheduler.service.d.ts +42 -0
  237. package/dist/services/scheduler.service.d.ts.map +1 -0
  238. package/dist/services/scheduler.service.js +294 -0
  239. package/dist/services/scheduler.service.js.map +1 -0
  240. package/dist/services/smtp.service.d.ts +97 -0
  241. package/dist/services/smtp.service.d.ts.map +1 -0
  242. package/dist/services/smtp.service.js +339 -0
  243. package/dist/services/smtp.service.js.map +1 -0
  244. package/dist/services/template.service.d.ts +33 -0
  245. package/dist/services/template.service.d.ts.map +1 -0
  246. package/dist/services/template.service.js +123 -0
  247. package/dist/services/template.service.js.map +1 -0
  248. package/dist/services/verification.service.d.ts +26 -0
  249. package/dist/services/verification.service.d.ts.map +1 -0
  250. package/dist/services/verification.service.js +94 -0
  251. package/dist/services/verification.service.js.map +1 -0
  252. package/dist/services/watcher.service.d.ts +36 -0
  253. package/dist/services/watcher.service.d.ts.map +1 -0
  254. package/dist/services/watcher.service.js +238 -0
  255. package/dist/services/watcher.service.js.map +1 -0
  256. package/dist/tools/accounts.tool.d.ts +7 -0
  257. package/dist/tools/accounts.tool.d.ts.map +1 -0
  258. package/dist/tools/accounts.tool.js +33 -0
  259. package/dist/tools/accounts.tool.js.map +1 -0
  260. package/dist/tools/analytics.tool.d.ts +9 -0
  261. package/dist/tools/analytics.tool.d.ts.map +1 -0
  262. package/dist/tools/analytics.tool.js +32 -0
  263. package/dist/tools/analytics.tool.js.map +1 -0
  264. package/dist/tools/attachments.tool.d.ts +7 -0
  265. package/dist/tools/attachments.tool.d.ts.map +1 -0
  266. package/dist/tools/attachments.tool.js +93 -0
  267. package/dist/tools/attachments.tool.js.map +1 -0
  268. package/dist/tools/bulk.tool.d.ts +7 -0
  269. package/dist/tools/bulk.tool.d.ts.map +1 -0
  270. package/dist/tools/bulk.tool.js +80 -0
  271. package/dist/tools/bulk.tool.js.map +1 -0
  272. package/dist/tools/calendar.tool.d.ts +19 -0
  273. package/dist/tools/calendar.tool.d.ts.map +1 -0
  274. package/dist/tools/calendar.tool.js +576 -0
  275. package/dist/tools/calendar.tool.js.map +1 -0
  276. package/dist/tools/contacts.tool.d.ts +7 -0
  277. package/dist/tools/contacts.tool.d.ts.map +1 -0
  278. package/dist/tools/contacts.tool.js +49 -0
  279. package/dist/tools/contacts.tool.js.map +1 -0
  280. package/dist/tools/drafts.tool.d.ts +8 -0
  281. package/dist/tools/drafts.tool.d.ts.map +1 -0
  282. package/dist/tools/drafts.tool.js +110 -0
  283. package/dist/tools/drafts.tool.js.map +1 -0
  284. package/dist/tools/emails.tool.d.ts +17 -0
  285. package/dist/tools/emails.tool.d.ts.map +1 -0
  286. package/dist/tools/emails.tool.js +508 -0
  287. package/dist/tools/emails.tool.js.map +1 -0
  288. package/dist/tools/folders.tool.d.ts +7 -0
  289. package/dist/tools/folders.tool.d.ts.map +1 -0
  290. package/dist/tools/folders.tool.js +129 -0
  291. package/dist/tools/folders.tool.js.map +1 -0
  292. package/dist/tools/health.tool.d.ts +10 -0
  293. package/dist/tools/health.tool.d.ts.map +1 -0
  294. package/dist/tools/health.tool.js +106 -0
  295. package/dist/tools/health.tool.js.map +1 -0
  296. package/dist/tools/label.tool.d.ts +11 -0
  297. package/dist/tools/label.tool.d.ts.map +1 -0
  298. package/dist/tools/label.tool.js +190 -0
  299. package/dist/tools/label.tool.js.map +1 -0
  300. package/dist/tools/locate.tool.d.ts +11 -0
  301. package/dist/tools/locate.tool.d.ts.map +1 -0
  302. package/dist/tools/locate.tool.js +65 -0
  303. package/dist/tools/locate.tool.js.map +1 -0
  304. package/dist/tools/mailboxes.tool.d.ts +7 -0
  305. package/dist/tools/mailboxes.tool.d.ts.map +1 -0
  306. package/dist/tools/mailboxes.tool.js +49 -0
  307. package/dist/tools/mailboxes.tool.js.map +1 -0
  308. package/dist/tools/manage.tool.d.ts +7 -0
  309. package/dist/tools/manage.tool.d.ts.map +1 -0
  310. package/dist/tools/manage.tool.js +140 -0
  311. package/dist/tools/manage.tool.js.map +1 -0
  312. package/dist/tools/register.d.ts +20 -0
  313. package/dist/tools/register.d.ts.map +1 -0
  314. package/dist/tools/register.js +60 -0
  315. package/dist/tools/register.js.map +1 -0
  316. package/dist/tools/scheduler.tool.d.ts +9 -0
  317. package/dist/tools/scheduler.tool.d.ts.map +1 -0
  318. package/dist/tools/scheduler.tool.js +130 -0
  319. package/dist/tools/scheduler.tool.js.map +1 -0
  320. package/dist/tools/schemas.d.ts +146 -0
  321. package/dist/tools/schemas.d.ts.map +1 -0
  322. package/dist/tools/schemas.js +89 -0
  323. package/dist/tools/schemas.js.map +1 -0
  324. package/dist/tools/security.tool.d.ts +11 -0
  325. package/dist/tools/security.tool.d.ts.map +1 -0
  326. package/dist/tools/security.tool.js +49 -0
  327. package/dist/tools/security.tool.js.map +1 -0
  328. package/dist/tools/send.tool.d.ts +7 -0
  329. package/dist/tools/send.tool.d.ts.map +1 -0
  330. package/dist/tools/send.tool.js +196 -0
  331. package/dist/tools/send.tool.js.map +1 -0
  332. package/dist/tools/templates.tool.d.ts +12 -0
  333. package/dist/tools/templates.tool.d.ts.map +1 -0
  334. package/dist/tools/templates.tool.js +149 -0
  335. package/dist/tools/templates.tool.js.map +1 -0
  336. package/dist/tools/thread.tool.d.ts +10 -0
  337. package/dist/tools/thread.tool.d.ts.map +1 -0
  338. package/dist/tools/thread.tool.js +140 -0
  339. package/dist/tools/thread.tool.js.map +1 -0
  340. package/dist/tools/verification.tool.d.ts +5 -0
  341. package/dist/tools/verification.tool.d.ts.map +1 -0
  342. package/dist/tools/verification.tool.js +125 -0
  343. package/dist/tools/verification.tool.js.map +1 -0
  344. package/dist/tools/watcher.tool.d.ts +19 -0
  345. package/dist/tools/watcher.tool.d.ts.map +1 -0
  346. package/dist/tools/watcher.tool.js +319 -0
  347. package/dist/tools/watcher.tool.js.map +1 -0
  348. package/dist/types/index.d.ts +329 -0
  349. package/dist/types/index.d.ts.map +1 -0
  350. package/dist/types/index.js +5 -0
  351. package/dist/types/index.js.map +1 -0
  352. package/dist/utils/auth-results.d.ts +24 -0
  353. package/dist/utils/auth-results.d.ts.map +1 -0
  354. package/dist/utils/auth-results.js +71 -0
  355. package/dist/utils/auth-results.js.map +1 -0
  356. package/dist/utils/bulk-headers.d.ts +34 -0
  357. package/dist/utils/bulk-headers.d.ts.map +1 -0
  358. package/dist/utils/bulk-headers.js +112 -0
  359. package/dist/utils/bulk-headers.js.map +1 -0
  360. package/dist/utils/calendar-notes.d.ts +31 -0
  361. package/dist/utils/calendar-notes.d.ts.map +1 -0
  362. package/dist/utils/calendar-notes.js +83 -0
  363. package/dist/utils/calendar-notes.js.map +1 -0
  364. package/dist/utils/calendar-state.d.ts +27 -0
  365. package/dist/utils/calendar-state.d.ts.map +1 -0
  366. package/dist/utils/calendar-state.js +85 -0
  367. package/dist/utils/calendar-state.js.map +1 -0
  368. package/dist/utils/conference-details.d.ts +12 -0
  369. package/dist/utils/conference-details.d.ts.map +1 -0
  370. package/dist/utils/conference-details.js +71 -0
  371. package/dist/utils/conference-details.js.map +1 -0
  372. package/dist/utils/html.d.ts +24 -0
  373. package/dist/utils/html.d.ts.map +1 -0
  374. package/dist/utils/html.js +162 -0
  375. package/dist/utils/html.js.map +1 -0
  376. package/dist/utils/imap-client.d.ts +22 -0
  377. package/dist/utils/imap-client.d.ts.map +1 -0
  378. package/dist/utils/imap-client.js +26 -0
  379. package/dist/utils/imap-client.js.map +1 -0
  380. package/dist/utils/imap-error.d.ts +28 -0
  381. package/dist/utils/imap-error.d.ts.map +1 -0
  382. package/dist/utils/imap-error.js +82 -0
  383. package/dist/utils/imap-error.js.map +1 -0
  384. package/dist/utils/meeting-url.d.ts +10 -0
  385. package/dist/utils/meeting-url.d.ts.map +1 -0
  386. package/dist/utils/meeting-url.js +30 -0
  387. package/dist/utils/meeting-url.js.map +1 -0
  388. package/dist/utils/offline-notice.d.ts +10 -0
  389. package/dist/utils/offline-notice.d.ts.map +1 -0
  390. package/dist/utils/offline-notice.js +10 -0
  391. package/dist/utils/offline-notice.js.map +1 -0
  392. package/dist/utils/reply-chain.d.ts +6 -0
  393. package/dist/utils/reply-chain.d.ts.map +1 -0
  394. package/dist/utils/reply-chain.js +15 -0
  395. package/dist/utils/reply-chain.js.map +1 -0
  396. package/dist/utils/verification-code.d.ts +29 -0
  397. package/dist/utils/verification-code.d.ts.map +1 -0
  398. package/dist/utils/verification-code.js +305 -0
  399. package/dist/utils/verification-code.js.map +1 -0
  400. package/dist/utils/verification-link.d.ts +26 -0
  401. package/dist/utils/verification-link.d.ts.map +1 -0
  402. package/dist/utils/verification-link.js +197 -0
  403. package/dist/utils/verification-link.js.map +1 -0
  404. package/package.json +106 -4
package/dist/app.d.ts ADDED
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Application composition root.
3
+ *
4
+ * Builds the service graph (`buildServices`) and a fully-registered McpServer
5
+ * (`buildServer`) from it. Shared by every transport entry point (stdio and
6
+ * Streamable HTTP) so tools/resources/prompts are wired in exactly one place.
7
+ */
8
+ import type { McpServer, Server } from '@modelcontextprotocol/server';
9
+ import CacheStore from './cache/store.js';
10
+ import SyncEngine from './cache/sync-engine.js';
11
+ import ConnectionManager from './connections/manager.js';
12
+ import CalendarService from './services/calendar.service.js';
13
+ import HooksService from './services/hooks.service.js';
14
+ import ImapService from './services/imap.service.js';
15
+ import LocalCalendarService from './services/local-calendar.service.js';
16
+ import RemindersService from './services/reminders.service.js';
17
+ import SchedulerService from './services/scheduler.service.js';
18
+ import SmtpService from './services/smtp.service.js';
19
+ import TemplateService from './services/template.service.js';
20
+ import WatcherService from './services/watcher.service.js';
21
+ import type { AppConfig } from './types/index.js';
22
+ /** The full, shared service graph for one server process. */
23
+ export interface AppServices {
24
+ config: AppConfig;
25
+ connections: ConnectionManager;
26
+ imapService: ImapService;
27
+ smtpService: SmtpService;
28
+ templateService: TemplateService;
29
+ calendarService: CalendarService;
30
+ localCalendarService: LocalCalendarService;
31
+ remindersService: RemindersService;
32
+ schedulerService: SchedulerService;
33
+ watcherService: WatcherService;
34
+ hooksService: HooksService;
35
+ /** Absent when the local mirror is disabled in config. */
36
+ cacheStore?: CacheStore;
37
+ syncEngine?: SyncEngine;
38
+ }
39
+ /** Construct the full service graph from persisted configuration. */
40
+ export declare function buildServices(): Promise<AppServices>;
41
+ /**
42
+ * Build a fresh, fully-registered McpServer from an existing service graph.
43
+ *
44
+ * Safe to call per connection (stdio) or per request (stateless HTTP): the
45
+ * services are shared singletons, only the thin protocol wrapper is new.
46
+ */
47
+ export declare function buildServer(services: AppServices): McpServer;
48
+ /** Handle for tearing down the process-level background services. */
49
+ export interface BackgroundHandle {
50
+ stop: () => Promise<void>;
51
+ }
52
+ /**
53
+ * Start the process-level background services: the new-mail watcher (feeding
54
+ * AI hooks + resource-update notifications) and the periodic scheduled-email
55
+ * check. These are process-scoped, not per-connection or per-request.
56
+ *
57
+ * @param lowLevelServer the connected low-level `Server` for notifications /
58
+ * opportunistic sampling, or `null` when no persistent connection applies.
59
+ */
60
+ export declare function startBackgroundServices(services: AppServices, lowLevelServer: Server | null): BackgroundHandle;
61
+ //# sourceMappingURL=app.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGtE,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,UAAU,MAAM,wBAAwB,CAAC;AAGhD,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AAMzD,OAAO,eAAe,MAAM,gCAAgC,CAAC;AAC7D,OAAO,YAAY,MAAM,6BAA6B,CAAC;AACvD,OAAO,WAAW,MAAM,4BAA4B,CAAC;AACrD,OAAO,oBAAoB,MAAM,sCAAsC,CAAC;AAExE,OAAO,gBAAgB,MAAM,iCAAiC,CAAC;AAC/D,OAAO,gBAAgB,MAAM,iCAAiC,CAAC;AAC/D,OAAO,WAAW,MAAM,4BAA4B,CAAC;AACrD,OAAO,eAAe,MAAM,gCAAgC,CAAC;AAC7D,OAAO,cAAc,MAAM,+BAA+B,CAAC;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,EAAE,eAAe,CAAC;IACjC,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,qEAAqE;AACrE,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAwE1D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,CA2B5D;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,WAAW,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,gBAAgB,CA8FlB"}
package/dist/app.js ADDED
@@ -0,0 +1,201 @@
1
+ /**
2
+ * Application composition root.
3
+ *
4
+ * Builds the service graph (`buildServices`) and a fully-registered McpServer
5
+ * (`buildServer`) from it. Shared by every transport entry point (stdio and
6
+ * Streamable HTTP) so tools/resources/prompts are wired in exactly one place.
7
+ */
8
+ import BodyCache from './cache/body-cache.js';
9
+ import CacheStore from './cache/store.js';
10
+ import SyncEngine from './cache/sync-engine.js';
11
+ import { loadConfig } from './config/loader.js';
12
+ import { CACHE_DB } from './config/xdg.js';
13
+ import ConnectionManager from './connections/manager.js';
14
+ import { mcpLog } from './logging.js';
15
+ import registerAllPrompts from './prompts/register.js';
16
+ import registerAllResources from './resources/register.js';
17
+ import RateLimiter from './safety/rate-limiter.js';
18
+ import createServer from './server.js';
19
+ import CalendarService from './services/calendar.service.js';
20
+ import HooksService from './services/hooks.service.js';
21
+ import ImapService from './services/imap.service.js';
22
+ import LocalCalendarService from './services/local-calendar.service.js';
23
+ import OAuthService from './services/oauth.service.js';
24
+ import RemindersService from './services/reminders.service.js';
25
+ import SchedulerService from './services/scheduler.service.js';
26
+ import SmtpService from './services/smtp.service.js';
27
+ import TemplateService from './services/template.service.js';
28
+ import WatcherService from './services/watcher.service.js';
29
+ import registerAllTools from './tools/register.js';
30
+ /** Construct the full service graph from persisted configuration. */
31
+ export async function buildServices() {
32
+ const config = await loadConfig();
33
+ const oauthService = new OAuthService();
34
+ const connections = new ConnectionManager(config.accounts, oauthService);
35
+ const rateLimiter = new RateLimiter(config.settings.rateLimit);
36
+ const imapService = new ImapService(connections);
37
+ const smtpService = new SmtpService(connections, rateLimiter, imapService, config.settings.send.maxAttachmentMb);
38
+ const templateService = new TemplateService();
39
+ const calendarService = new CalendarService();
40
+ const localCalendarService = new LocalCalendarService();
41
+ const remindersService = new RemindersService();
42
+ const schedulerService = new SchedulerService(smtpService, imapService);
43
+ const watcherService = new WatcherService(config.settings.watcher, config.accounts, oauthService);
44
+ const hooksService = new HooksService(config.settings.hooks, imapService);
45
+ // The mirror is optional and must never block startup: if SQLite cannot be
46
+ // opened (read-only volume, corrupt file, unwritable XDG dir) the server
47
+ // still serves every tool live.
48
+ let cacheStore;
49
+ let syncEngine;
50
+ if (config.settings.cache.enabled) {
51
+ try {
52
+ cacheStore = new CacheStore(CACHE_DB);
53
+ // Read-through is opt-in. Without it the service has no port attached,
54
+ // the engine does no backfill, and every read takes the live path it
55
+ // always did.
56
+ const { readThrough, bodyMaxMb, bodyMessages, offlineReads } = config.settings.cache;
57
+ const bodyCache = readThrough ? new BodyCache(cacheStore, bodyMaxMb) : undefined;
58
+ syncEngine = new SyncEngine(connections, cacheStore, {
59
+ windowDays: config.settings.cache.windowDays,
60
+ maxSizeMb: config.settings.cache.maxSizeMb,
61
+ }, bodyCache ? { cache: bodyCache, bodyMessages, bodyMaxMb } : undefined);
62
+ if (bodyCache)
63
+ imapService.attachBodyCache(bodyCache, { offlineReads });
64
+ }
65
+ catch (err) {
66
+ cacheStore = undefined;
67
+ syncEngine = undefined;
68
+ await mcpLog('warning', 'cache', `Local mirror disabled — could not open ${CACHE_DB}: ${err instanceof Error ? err.message : String(err)}`);
69
+ }
70
+ }
71
+ return {
72
+ config,
73
+ connections,
74
+ imapService,
75
+ smtpService,
76
+ templateService,
77
+ calendarService,
78
+ localCalendarService,
79
+ remindersService,
80
+ schedulerService,
81
+ watcherService,
82
+ hooksService,
83
+ cacheStore,
84
+ syncEngine,
85
+ };
86
+ }
87
+ /**
88
+ * Build a fresh, fully-registered McpServer from an existing service graph.
89
+ *
90
+ * Safe to call per connection (stdio) or per request (stateless HTTP): the
91
+ * services are shared singletons, only the thin protocol wrapper is new.
92
+ */
93
+ export function buildServer(services) {
94
+ const server = createServer();
95
+ registerAllTools(server, services.connections, services.imapService, services.smtpService, services.config, services.templateService, services.calendarService, services.localCalendarService, services.remindersService, services.schedulerService, services.watcherService, services.hooksService);
96
+ registerAllResources(server, services.connections, services.imapService, services.templateService, services.schedulerService);
97
+ registerAllPrompts(server);
98
+ return server;
99
+ }
100
+ /**
101
+ * Start the process-level background services: the new-mail watcher (feeding
102
+ * AI hooks + resource-update notifications) and the periodic scheduled-email
103
+ * check. These are process-scoped, not per-connection or per-request.
104
+ *
105
+ * @param lowLevelServer the connected low-level `Server` for notifications /
106
+ * opportunistic sampling, or `null` when no persistent connection applies.
107
+ */
108
+ export function startBackgroundServices(services, lowLevelServer) {
109
+ const { hooksService, watcherService, schedulerService, imapService, syncEngine, config } = services;
110
+ let stopped = false;
111
+ let schedulerInterval;
112
+ let cacheInterval;
113
+ if (config.settings.readOnly) {
114
+ return {
115
+ stop: async () => {
116
+ stopped = true;
117
+ if (schedulerInterval)
118
+ clearInterval(schedulerInterval);
119
+ if (cacheInterval)
120
+ clearInterval(cacheInterval);
121
+ syncEngine?.stop();
122
+ },
123
+ };
124
+ }
125
+ hooksService.start(lowLevelServer);
126
+ syncEngine?.start();
127
+ void (async () => {
128
+ try {
129
+ await watcherService.start();
130
+ // A fast shutdown can run stop() while this startup block is still
131
+ // awaiting. Every handle armed below must be re-checked against the
132
+ // stopped flag at each resume point, or it outlives its own teardown
133
+ // and keeps the event loop alive forever.
134
+ if (stopped)
135
+ return;
136
+ await mcpLog('info', 'server', 'IMAP Wizard background services started');
137
+ // Check for overdue scheduled emails on startup.
138
+ try {
139
+ const result = await schedulerService.checkAndSend();
140
+ if (result.sent > 0) {
141
+ await mcpLog('info', 'scheduler', `Sent ${result.sent} overdue email(s) on startup`);
142
+ }
143
+ }
144
+ catch {
145
+ // Non-fatal: a scheduler check failure shouldn't prevent startup.
146
+ }
147
+ // Periodic scheduler check every 60 seconds.
148
+ if (stopped)
149
+ return;
150
+ schedulerInterval = setInterval(async () => {
151
+ try {
152
+ await schedulerService.checkAndSend();
153
+ }
154
+ catch {
155
+ // Silent — don't spam logs.
156
+ }
157
+ }, 60_000);
158
+ // Reconcile the local mirror: once at startup, then on an interval.
159
+ // syncMailbox never throws and never blocks a tool call, so this can
160
+ // stay fire-and-forget.
161
+ if (syncEngine) {
162
+ const { mailboxes, syncInterval } = config.settings.cache;
163
+ const reconcile = async () => {
164
+ const work = services.connections
165
+ .getAccountNames()
166
+ .flatMap((account) => mailboxes.map((mailbox) => syncEngine.syncMailbox(account, mailbox)));
167
+ await Promise.allSettled(work);
168
+ };
169
+ if (stopped)
170
+ return;
171
+ await reconcile();
172
+ if (stopped)
173
+ return;
174
+ cacheInterval = setInterval(() => {
175
+ void reconcile();
176
+ }, syncInterval * 1000);
177
+ }
178
+ }
179
+ catch (err) {
180
+ process.stderr.write(`[imap-wizard] background start error: ${err instanceof Error ? err.message : String(err)}\n`);
181
+ }
182
+ })();
183
+ return {
184
+ stop: async () => {
185
+ stopped = true;
186
+ if (schedulerInterval)
187
+ clearInterval(schedulerInterval);
188
+ if (cacheInterval)
189
+ clearInterval(cacheInterval);
190
+ hooksService.stop();
191
+ await watcherService.stop();
192
+ syncEngine?.stop();
193
+ imapService.dispose();
194
+ // The mirror commits incrementally under WAL, so closing here is tidy
195
+ // rather than load-bearing — neither shutdown handler is guaranteed to
196
+ // run to completion (main.ts:85, cli/http.ts:175).
197
+ services.cacheStore?.close();
198
+ },
199
+ };
200
+ }
201
+ //# sourceMappingURL=app.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Adapter between ImapService's `BodyCachePort` and the SQLite store.
3
+ *
4
+ * Every method swallows its own errors and degrades to a miss or a no-op. The
5
+ * cache is an optimization over a working live path, so a corrupt file, a full
6
+ * disk or a closed database must never turn a read that would have succeeded
7
+ * into a failure.
8
+ */
9
+ import type { BodyBundle, BodyCachePort } from '../services/imap.service.js';
10
+ import type CacheStore from './store.js';
11
+ export default class BodyCache implements BodyCachePort {
12
+ private store;
13
+ /** LRU budget for cached bodies in megabytes; 0 or less disables the budget. */
14
+ private bodyMaxMb;
15
+ constructor(store: CacheStore,
16
+ /** LRU budget for cached bodies in megabytes; 0 or less disables the budget. */
17
+ bodyMaxMb?: number);
18
+ get(account: string, mailbox: string, uid: number, uidValidity: string): BodyBundle | undefined;
19
+ put(account: string, mailbox: string, uid: number, uidValidity: string, bundle: BodyBundle): void;
20
+ getOffline(account: string, mailbox: string, uid: number): {
21
+ bundle: BodyBundle;
22
+ flags: string[];
23
+ cachedAt: number;
24
+ } | undefined;
25
+ forget(account: string, mailbox: string, uids: number[]): void;
26
+ /** Evict least-recently-read bodies until under budget, in bounded rounds. */
27
+ enforceBudget(): void;
28
+ }
29
+ //# sourceMappingURL=body-cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"body-cache.d.ts","sourceRoot":"","sources":["../../src/cache/body-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE7E,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AAMzC,MAAM,CAAC,OAAO,OAAO,SAAU,YAAW,aAAa;IAEnD,OAAO,CAAC,KAAK;IACb,gFAAgF;IAChF,OAAO,CAAC,SAAS;IAHnB,YACU,KAAK,EAAE,UAAU;IACzB,gFAAgF;IACxE,SAAS,SAAI,EACnB;IAEJ,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAa9F;IAED,GAAG,CACD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GACjB,IAAI,CAuCN;IAED,UAAU,CACR,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAYvE;IAED,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAM7D;IAED,8EAA8E;IAC9E,aAAa,IAAI,IAAI,CAMpB;CACF"}
@@ -0,0 +1,95 @@
1
+ /**
2
+ * Adapter between ImapService's `BodyCachePort` and the SQLite store.
3
+ *
4
+ * Every method swallows its own errors and degrades to a miss or a no-op. The
5
+ * cache is an optimization over a working live path, so a corrupt file, a full
6
+ * disk or a closed database must never turn a read that would have succeeded
7
+ * into a failure.
8
+ */
9
+ import { BODY_EXTRACTOR_VERSION, MAX_CACHED_BODY_BYTES } from '../services/imap.service.js';
10
+ /** At most this many eviction rounds per call, so one write cannot stall a read. */
11
+ const MAX_EVICT_ROUNDS = 10;
12
+ const EVICT_BATCH = 500;
13
+ export default class BodyCache {
14
+ store;
15
+ bodyMaxMb;
16
+ constructor(store,
17
+ /** LRU budget for cached bodies in megabytes; 0 or less disables the budget. */
18
+ bodyMaxMb = 0) {
19
+ this.store = store;
20
+ this.bodyMaxMb = bodyMaxMb;
21
+ }
22
+ get(account, mailbox, uid, uidValidity) {
23
+ try {
24
+ const row = this.store.getBody(account, mailbox, uid, uidValidity);
25
+ // Skipped rows and rows from an older extractor are misses, so a decoding
26
+ // fix is never shadowed by a stale cached body.
27
+ if (row?.status !== 'ok' || !row.bundle || row.extractorVersion !== BODY_EXTRACTOR_VERSION) {
28
+ return undefined;
29
+ }
30
+ this.store.touchBody(account, mailbox, uid, uidValidity);
31
+ return { ...row.bundle, complete: true };
32
+ }
33
+ catch {
34
+ return undefined;
35
+ }
36
+ }
37
+ put(account, mailbox, uid, uidValidity, bundle) {
38
+ try {
39
+ if (!bundle.complete) {
40
+ // A transient download failure must not be served forever: the read
41
+ // path treats skipped rows as misses and retries live.
42
+ this.store.markBodySkipped(account, mailbox, uid, uidValidity, 'incomplete', BODY_EXTRACTOR_VERSION);
43
+ return;
44
+ }
45
+ const bytes = Buffer.byteLength(bundle.headersRaw, 'utf-8') +
46
+ Buffer.byteLength(bundle.bodyText ?? '', 'utf-8') +
47
+ Buffer.byteLength(bundle.bodyHtml ?? '', 'utf-8');
48
+ if (bytes > MAX_CACHED_BODY_BYTES) {
49
+ // Never truncate: a shortened body would differ from the live answer.
50
+ this.store.markBodySkipped(account, mailbox, uid, uidValidity, 'oversize', BODY_EXTRACTOR_VERSION);
51
+ return;
52
+ }
53
+ const { complete: _complete, ...data } = bundle;
54
+ this.store.putBodyBundle(account, mailbox, uid, uidValidity, data, BODY_EXTRACTOR_VERSION);
55
+ this.enforceBudget();
56
+ }
57
+ catch {
58
+ // No-op: see file header.
59
+ }
60
+ }
61
+ getOffline(account, mailbox, uid) {
62
+ try {
63
+ const row = this.store.findBodyAnyGeneration(account, mailbox, uid);
64
+ if (!row?.bundle || row.extractorVersion !== BODY_EXTRACTOR_VERSION)
65
+ return undefined;
66
+ // Flags only exist in the mirror, and only for mirrored mailboxes. They
67
+ // may be stale, which the offline notice says; an empty set is the
68
+ // honest answer when nothing is known.
69
+ const flags = this.store.getMessage(account, mailbox, uid, row.uidValidity)?.flags ?? [];
70
+ return { bundle: { ...row.bundle, complete: true }, flags, cachedAt: row.fetchedAt };
71
+ }
72
+ catch {
73
+ return undefined;
74
+ }
75
+ }
76
+ forget(account, mailbox, uids) {
77
+ try {
78
+ this.store.forgetBodies(account, mailbox, uids);
79
+ }
80
+ catch {
81
+ // No-op: see file header.
82
+ }
83
+ }
84
+ /** Evict least-recently-read bodies until under budget, in bounded rounds. */
85
+ enforceBudget() {
86
+ if (this.bodyMaxMb <= 0)
87
+ return;
88
+ const limit = this.bodyMaxMb * 1024 * 1024;
89
+ for (let round = 0; round < MAX_EVICT_ROUNDS && this.store.bodyBytes() > limit; round += 1) {
90
+ if (this.store.evictBodiesLru(EVICT_BATCH) === 0)
91
+ break;
92
+ }
93
+ }
94
+ }
95
+ //# sourceMappingURL=body-cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"body-cache.js","sourceRoot":"","sources":["../../src/cache/body-cache.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Local mirror schema.
3
+ *
4
+ * Two conventions run through this file and both matter:
5
+ *
6
+ * 1. **UIDVALIDITY is the cache epoch.** IMAP guarantees a UID is stable only
7
+ * for as long as a mailbox's UIDVALIDITY is unchanged. It is denormalized
8
+ * onto every message row so that invalidating a generation is a single
9
+ * DELETE rather than a join.
10
+ *
11
+ * 2. **64-bit IMAP counters are stored as TEXT.** `uidValidity` and
12
+ * `highestModseq` are `bigint` in ImapFlow. SQLite INTEGER would hold them,
13
+ * but `JSON.stringify` throws on BigInt and `node:sqlite` returns INTEGER as
14
+ * a JS number by default — which silently loses precision past 2^53. TEXT
15
+ * round-trips exactly, and these values are only ever compared for equality
16
+ * or passed back to the server verbatim.
17
+ */
18
+ /** Bumped when the statements below change shape. */
19
+ export declare const SCHEMA_VERSION = 2;
20
+ /**
21
+ * Reindex only when an indexed column actually changes.
22
+ *
23
+ * Without the column list and WHEN guard this fired on every UPDATE, so a
24
+ * flag-only resync rewrote the FTS entry for subject, sender and body. The
25
+ * WHEN clause matters as well as the column list: the sync upsert names
26
+ * subject and from_text in its SET list on every run, and SQLite's
27
+ * `UPDATE OF` fires on membership in that list, not on a changed value.
28
+ */
29
+ export declare const FTS_UPDATE_TRIGGER_SQL = "CREATE TRIGGER message_fts_update\nAFTER UPDATE OF subject, from_text, body_text ON message\nWHEN old.subject IS NOT new.subject\n OR old.from_text IS NOT new.from_text\n OR old.body_text IS NOT new.body_text\nBEGIN\n INSERT INTO message_fts (message_fts, rowid, subject, from_text, body_text)\n VALUES ('delete', old.rowid, old.subject, old.from_text, old.body_text);\n INSERT INTO message_fts (rowid, subject, from_text, body_text)\n VALUES (new.rowid, new.subject, new.from_text, new.body_text);\nEND;";
30
+ /**
31
+ * Ordered upgrade steps for databases older than `to`. New tables, indexes
32
+ * and triggers need no step: SCHEMA_SQL is all IF NOT EXISTS and runs on every
33
+ * open. A step is only for changing something that already exists.
34
+ */
35
+ export declare const MIGRATIONS: Array<{
36
+ to: number;
37
+ sql: string;
38
+ }>;
39
+ export declare const SCHEMA_SQL: string;
40
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/cache/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,qDAAqD;AACrD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,mgBAU9B,CAAC;AAEN;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAKzD,CAAC;AAEF,eAAO,MAAM,UAAU,QA4GtB,CAAC"}
@@ -0,0 +1,160 @@
1
+ /**
2
+ * Local mirror schema.
3
+ *
4
+ * Two conventions run through this file and both matter:
5
+ *
6
+ * 1. **UIDVALIDITY is the cache epoch.** IMAP guarantees a UID is stable only
7
+ * for as long as a mailbox's UIDVALIDITY is unchanged. It is denormalized
8
+ * onto every message row so that invalidating a generation is a single
9
+ * DELETE rather than a join.
10
+ *
11
+ * 2. **64-bit IMAP counters are stored as TEXT.** `uidValidity` and
12
+ * `highestModseq` are `bigint` in ImapFlow. SQLite INTEGER would hold them,
13
+ * but `JSON.stringify` throws on BigInt and `node:sqlite` returns INTEGER as
14
+ * a JS number by default — which silently loses precision past 2^53. TEXT
15
+ * round-trips exactly, and these values are only ever compared for equality
16
+ * or passed back to the server verbatim.
17
+ */
18
+ /** Bumped when the statements below change shape. */
19
+ export const SCHEMA_VERSION = 2;
20
+ /**
21
+ * Reindex only when an indexed column actually changes.
22
+ *
23
+ * Without the column list and WHEN guard this fired on every UPDATE, so a
24
+ * flag-only resync rewrote the FTS entry for subject, sender and body. The
25
+ * WHEN clause matters as well as the column list: the sync upsert names
26
+ * subject and from_text in its SET list on every run, and SQLite's
27
+ * `UPDATE OF` fires on membership in that list, not on a changed value.
28
+ */
29
+ export const FTS_UPDATE_TRIGGER_SQL = `CREATE TRIGGER message_fts_update
30
+ AFTER UPDATE OF subject, from_text, body_text ON message
31
+ WHEN old.subject IS NOT new.subject
32
+ OR old.from_text IS NOT new.from_text
33
+ OR old.body_text IS NOT new.body_text
34
+ BEGIN
35
+ INSERT INTO message_fts (message_fts, rowid, subject, from_text, body_text)
36
+ VALUES ('delete', old.rowid, old.subject, old.from_text, old.body_text);
37
+ INSERT INTO message_fts (rowid, subject, from_text, body_text)
38
+ VALUES (new.rowid, new.subject, new.from_text, new.body_text);
39
+ END;`;
40
+ /**
41
+ * Ordered upgrade steps for databases older than `to`. New tables, indexes
42
+ * and triggers need no step: SCHEMA_SQL is all IF NOT EXISTS and runs on every
43
+ * open. A step is only for changing something that already exists.
44
+ */
45
+ export const MIGRATIONS = [
46
+ {
47
+ to: 2,
48
+ sql: `DROP TRIGGER IF EXISTS message_fts_update;\n${FTS_UPDATE_TRIGGER_SQL}`,
49
+ },
50
+ ];
51
+ export const SCHEMA_SQL = `
52
+ -- Per-mailbox sync watermarks.
53
+ CREATE TABLE IF NOT EXISTS mailbox_state (
54
+ account TEXT NOT NULL,
55
+ mailbox TEXT NOT NULL,
56
+ uid_validity TEXT NOT NULL,
57
+ uid_next INTEGER,
58
+ highest_modseq TEXT,
59
+ sync_tier TEXT NOT NULL,
60
+ total_messages INTEGER,
61
+ unseen_messages INTEGER,
62
+ last_synced_at INTEGER,
63
+ PRIMARY KEY (account, mailbox)
64
+ );
65
+
66
+ -- Mirrored messages. Envelope and body structure are immutable for a given
67
+ -- (uid, uid_validity); flags are not, and are revalidated rather than trusted.
68
+ CREATE TABLE IF NOT EXISTS message (
69
+ account TEXT NOT NULL,
70
+ mailbox TEXT NOT NULL,
71
+ uid INTEGER NOT NULL,
72
+ uid_validity TEXT NOT NULL,
73
+ modseq TEXT,
74
+ envelope_json TEXT NOT NULL,
75
+ body_structure_json TEXT,
76
+ flags_json TEXT NOT NULL,
77
+ message_id TEXT,
78
+ in_reply_to TEXT,
79
+ references_json TEXT,
80
+ internal_date INTEGER NOT NULL,
81
+ subject TEXT,
82
+ from_text TEXT,
83
+ preview TEXT,
84
+ body_text TEXT,
85
+ body_fetched_at INTEGER,
86
+ has_attachments INTEGER NOT NULL DEFAULT 0,
87
+ cached_at INTEGER NOT NULL,
88
+ PRIMARY KEY (account, mailbox, uid, uid_validity)
89
+ );
90
+
91
+ -- Serves date-ordered pagination without the client-side slicing the live
92
+ -- path uses: page 5 costs the same as page 1.
93
+ CREATE INDEX IF NOT EXISTS idx_message_date
94
+ ON message (account, mailbox, internal_date DESC);
95
+
96
+ -- Serves get_thread and find_email_folder, which otherwise issue one IMAP
97
+ -- SEARCH per mailbox or per Message-ID.
98
+ CREATE INDEX IF NOT EXISTS idx_message_msgid
99
+ ON message (account, message_id);
100
+
101
+ -- Offline full-text search. External-content table: FTS5 stores only the
102
+ -- index and reads column values back from the message table via rowid, so
103
+ -- bodies are not duplicated on disk.
104
+ CREATE VIRTUAL TABLE IF NOT EXISTS message_fts USING fts5(
105
+ subject,
106
+ from_text,
107
+ body_text,
108
+ content='message',
109
+ content_rowid='rowid',
110
+ tokenize='porter unicode61'
111
+ );
112
+
113
+ -- External-content FTS5 does not self-sync; these triggers keep the index and
114
+ -- the table from drifting. The 'delete' command must be issued with the OLD
115
+ -- values, which is why update is expressed as delete-then-insert.
116
+ CREATE TRIGGER IF NOT EXISTS message_fts_insert AFTER INSERT ON message BEGIN
117
+ INSERT INTO message_fts (rowid, subject, from_text, body_text)
118
+ VALUES (new.rowid, new.subject, new.from_text, new.body_text);
119
+ END;
120
+
121
+ CREATE TRIGGER IF NOT EXISTS message_fts_delete AFTER DELETE ON message BEGIN
122
+ INSERT INTO message_fts (message_fts, rowid, subject, from_text, body_text)
123
+ VALUES ('delete', old.rowid, old.subject, old.from_text, old.body_text);
124
+ END;
125
+
126
+ ${FTS_UPDATE_TRIGGER_SQL.replace('CREATE TRIGGER', 'CREATE TRIGGER IF NOT EXISTS')}
127
+
128
+ -- Immutable per (uid, uid_validity): everything getEmail derives its output
129
+ -- from except flags. Independent of the message table, so write-back works for any
130
+ -- mailbox, mirrored or not. (message.body_text / putBody are legacy and unused.)
131
+ CREATE TABLE IF NOT EXISTS message_body (
132
+ account TEXT NOT NULL,
133
+ mailbox TEXT NOT NULL,
134
+ uid INTEGER NOT NULL,
135
+ uid_validity TEXT NOT NULL,
136
+ status TEXT NOT NULL,
137
+ skip_reason TEXT,
138
+ extractor_version INTEGER NOT NULL,
139
+ envelope_json TEXT,
140
+ body_structure_json TEXT,
141
+ headers_raw TEXT,
142
+ body_text TEXT,
143
+ body_html TEXT,
144
+ bytes INTEGER NOT NULL DEFAULT 0,
145
+ fetched_at INTEGER NOT NULL,
146
+ accessed_at INTEGER NOT NULL,
147
+ PRIMARY KEY (account, mailbox, uid, uid_validity)
148
+ );
149
+
150
+ CREATE INDEX IF NOT EXISTS idx_message_body_lru ON message_body (accessed_at);
151
+
152
+ -- A message leaving the mirror (expunge, retention prune, epoch reset) takes
153
+ -- its body with it.
154
+ CREATE TRIGGER IF NOT EXISTS message_body_gc AFTER DELETE ON message BEGIN
155
+ DELETE FROM message_body
156
+ WHERE account = old.account AND mailbox = old.mailbox
157
+ AND uid = old.uid AND uid_validity = old.uid_validity;
158
+ END;
159
+ `;
160
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/cache/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;KAUjC,CAAC;AAEN;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAuC;IAC5D;QACE,EAAE,EAAE,CAAC;QACL,GAAG,EAAE,+CAA+C,sBAAsB,EAAE;KAC7E;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2ExB,sBAAsB,CAAC,OAAO,CAAC,gBAAgB,EAAE,8BAA8B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCjF,CAAC"}