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
@@ -0,0 +1,381 @@
1
+ /**
2
+ * NotifierService — multi-channel notification dispatcher.
3
+ *
4
+ * Routes email alerts to the appropriate channels based on urgency:
5
+ * - Desktop notifications (native OS commands — zero npm deps)
6
+ * - Sound alerts (via OS notification sound)
7
+ * - MCP log level escalation (urgent→alert, high→warning, …)
8
+ * - Webhook dispatch (HTTP POST to Slack/Discord/ntfy.sh/etc.)
9
+ *
10
+ * All channels are opt-in and disabled by default.
11
+ */
12
+ import { execFile } from 'node:child_process';
13
+ import http from 'node:http';
14
+ import https from 'node:https';
15
+ import { mcpLog } from '../logging.js';
16
+ import { validateWebhookUrl } from '../safety/validation.js';
17
+ import { assertWebhookTargetAllowed } from '../safety/webhook-guard.js';
18
+ export async function fetchWithPinnedTarget(url, pinned, init) {
19
+ const parsed = new URL(url);
20
+ const isHttps = parsed.protocol === 'https:';
21
+ const lib = isHttps ? https : http;
22
+ return new Promise((resolve, reject) => {
23
+ const req = lib.request(url, {
24
+ method: init.method,
25
+ headers: init.headers,
26
+ signal: init.signal,
27
+ // Pin the connection to the validated address — do not resolve again.
28
+ // Node's http may call lookup with all:true expecting an array; handle both.
29
+ lookup: (_hostname, opts, cb) => {
30
+ if (opts.all) {
31
+ cb(null, [{ address: pinned.address, family: pinned.family }]);
32
+ }
33
+ else {
34
+ cb(null, pinned.address, pinned.family);
35
+ }
36
+ },
37
+ ...(isHttps ? { servername: pinned.hostname } : {}),
38
+ }, (res) => {
39
+ // Drain body — we only need status, and redirects are never followed
40
+ // (manual), so no re-validation is needed.
41
+ res.on('data', () => { });
42
+ res.on('end', () => {
43
+ const status = res.statusCode ?? 0;
44
+ resolve({ status, ok: status >= 200 && status < 300 });
45
+ });
46
+ });
47
+ req.on('error', reject);
48
+ if (init.signal) {
49
+ init.signal.addEventListener('abort', () => {
50
+ req.destroy(new Error('aborted'));
51
+ });
52
+ }
53
+ req.write(init.body);
54
+ req.end();
55
+ });
56
+ }
57
+ // ---------------------------------------------------------------------------
58
+ // Priority ordering for threshold comparison
59
+ // ---------------------------------------------------------------------------
60
+ const URGENCY_ORDER = {
61
+ urgent: 4,
62
+ high: 3,
63
+ normal: 2,
64
+ low: 1,
65
+ };
66
+ const MCP_LOG_LEVEL_MAP = {
67
+ urgent: 'alert',
68
+ high: 'warning',
69
+ normal: 'info',
70
+ low: 'debug',
71
+ };
72
+ // ---------------------------------------------------------------------------
73
+ // Text sanitization — prevent command injection in OS notifications
74
+ // ---------------------------------------------------------------------------
75
+ function sanitizeForShell(text) {
76
+ return text
77
+ .replace(/[\\"'`$]/g, '')
78
+ .replace(/[\n\r\t]/g, ' ')
79
+ .replace(/[^\x20-\x7E\u00A0-\uFFFF]/g, '')
80
+ .slice(0, 200);
81
+ }
82
+ // ---------------------------------------------------------------------------
83
+ // NotifierService
84
+ // ---------------------------------------------------------------------------
85
+ export default class NotifierService {
86
+ config;
87
+ desktopCount = 0;
88
+ desktopResetTimer = null;
89
+ static MAX_DESKTOP_PER_MIN = 5;
90
+ constructor(config) {
91
+ this.config = config;
92
+ // Reset desktop rate counter every 60s
93
+ this.desktopResetTimer = setInterval(() => {
94
+ this.desktopCount = 0;
95
+ }, 60_000);
96
+ }
97
+ stop() {
98
+ if (this.desktopResetTimer) {
99
+ clearInterval(this.desktopResetTimer);
100
+ this.desktopResetTimer = null;
101
+ }
102
+ }
103
+ /** Returns the current alerts configuration. */
104
+ getConfig() {
105
+ return { ...this.config };
106
+ }
107
+ /**
108
+ * Updates alert configuration at runtime (partial merge).
109
+ *
110
+ * Validates the webhook URL here rather than only at dispatch time, so a
111
+ * rejected URL never becomes the live configuration — and, since callers
112
+ * may persist config, never reaches the file either.
113
+ */
114
+ updateConfig(partial) {
115
+ if (partial.webhookUrl !== undefined && partial.webhookUrl !== '') {
116
+ validateWebhookUrl(partial.webhookUrl);
117
+ }
118
+ this.config = { ...this.config, ...partial };
119
+ return this.getConfig();
120
+ }
121
+ // -------------------------------------------------------------------------
122
+ // Platform diagnostics — check if notification tools are available
123
+ // -------------------------------------------------------------------------
124
+ static async checkPlatformSupport() {
125
+ const { platform } = process;
126
+ const issues = [];
127
+ const instructions = [];
128
+ if (platform === 'darwin') {
129
+ const osascriptOk = await NotifierService.commandExists('osascript');
130
+ const afplayOk = await NotifierService.commandExists('afplay');
131
+ if (!osascriptOk)
132
+ issues.push('osascript not found (should be built-in on macOS)');
133
+ instructions.push('1. Open System Settings → Notifications & Focus', '2. Find your terminal app (Terminal, iTerm2, VS Code, Cursor, etc.)', '3. Enable "Allow Notifications" and choose "Banners" or "Alerts"', '4. Ensure "Do Not Disturb" / Focus mode is not active', '5. If using an MCP client, the notification appears from the terminal running the server');
134
+ return {
135
+ platform: 'macOS',
136
+ supported: osascriptOk,
137
+ desktopTool: { name: 'osascript', available: osascriptOk },
138
+ soundTool: { name: 'afplay', available: afplayOk },
139
+ issues,
140
+ setupInstructions: instructions,
141
+ };
142
+ }
143
+ if (platform === 'linux') {
144
+ const notifySendOk = await NotifierService.commandExists('notify-send');
145
+ const paplayOk = await NotifierService.commandExists('paplay');
146
+ if (!notifySendOk) {
147
+ issues.push('notify-send not found');
148
+ instructions.push('Install libnotify:', ' Ubuntu/Debian: sudo apt install libnotify-bin', ' Fedora: sudo dnf install libnotify', ' Arch: sudo pacman -S libnotify');
149
+ }
150
+ if (!paplayOk) {
151
+ issues.push('paplay not found (needed for sound alerts)');
152
+ instructions.push('Install PulseAudio utils for sound:', ' Ubuntu/Debian: sudo apt install pulseaudio-utils', ' Fedora: sudo dnf install pulseaudio-utils');
153
+ }
154
+ instructions.push('Note: Desktop notifications require a running display server (X11/Wayland).', 'They will not work in headless/SSH sessions.');
155
+ return {
156
+ platform: 'Linux',
157
+ supported: notifySendOk,
158
+ desktopTool: { name: 'notify-send', available: notifySendOk },
159
+ soundTool: { name: 'paplay', available: paplayOk },
160
+ issues,
161
+ setupInstructions: instructions,
162
+ };
163
+ }
164
+ if (platform === 'win32') {
165
+ const psOk = await NotifierService.commandExists('powershell');
166
+ if (!psOk)
167
+ issues.push('PowerShell not found');
168
+ instructions.push('1. Open Settings → System → Notifications', '2. Ensure "Notifications" is turned on', '3. Ensure "Focus Assist" is set to allow notifications', '4. If using Windows Terminal, ensure its notifications are enabled');
169
+ return {
170
+ platform: 'Windows',
171
+ supported: psOk,
172
+ desktopTool: { name: 'powershell', available: psOk },
173
+ soundTool: { name: 'powershell', available: psOk },
174
+ issues,
175
+ setupInstructions: instructions,
176
+ };
177
+ }
178
+ return {
179
+ platform,
180
+ supported: false,
181
+ desktopTool: { name: 'unknown', available: false },
182
+ soundTool: { name: 'unknown', available: false },
183
+ issues: [`Unsupported platform: ${platform}. Desktop notifications are not available.`],
184
+ setupInstructions: ['Desktop notifications are only supported on macOS, Linux, and Windows.'],
185
+ };
186
+ }
187
+ /** Test if a command-line tool exists on the system. */
188
+ static async commandExists(cmd) {
189
+ const bin = process.platform === 'win32' ? 'where' : 'which';
190
+ return new Promise((resolve) => {
191
+ execFile(bin, [cmd], { timeout: 3000 }, (err) => {
192
+ resolve(!err);
193
+ });
194
+ });
195
+ }
196
+ /** Send a test notification to verify platform setup. */
197
+ async sendTestNotification(withSound = false) {
198
+ const diag = await NotifierService.checkPlatformSupport();
199
+ if (!diag.supported) {
200
+ return {
201
+ success: false,
202
+ message: `Desktop notifications not supported: ${diag.issues.join('; ')}`,
203
+ };
204
+ }
205
+ // Temporarily force desktop + sound for the test
206
+ const origDesktop = this.config.desktop;
207
+ const origSound = this.config.sound;
208
+ this.config.desktop = true;
209
+ this.config.sound = withSound;
210
+ try {
211
+ const testPayload = {
212
+ account: 'test',
213
+ sender: { name: 'IMAP Wizard', address: 'test@email-mcp' },
214
+ subject: 'If you see this, notifications work!',
215
+ priority: 'urgent',
216
+ };
217
+ await this.sendDesktopNotification(testPayload);
218
+ return {
219
+ success: true,
220
+ message: withSound
221
+ ? 'Test notification sent with sound. Check your notification center.'
222
+ : 'Test notification sent. Check your notification center.',
223
+ };
224
+ }
225
+ catch (err) {
226
+ const errMsg = err instanceof Error ? err.message : String(err);
227
+ return {
228
+ success: false,
229
+ message: `Notification failed: ${errMsg}. Check platform setup instructions.`,
230
+ };
231
+ }
232
+ finally {
233
+ this.config.desktop = origDesktop;
234
+ this.config.sound = origSound;
235
+ }
236
+ }
237
+ // -------------------------------------------------------------------------
238
+ // Main dispatch — routes alert to channels based on urgency + config
239
+ // -------------------------------------------------------------------------
240
+ async alert(payload, forceDesktop = false) {
241
+ const meetsThreshold = URGENCY_ORDER[payload.priority] >= URGENCY_ORDER[this.config.urgencyThreshold];
242
+ // 1. MCP log — always, with appropriate level
243
+ const logLevel = MCP_LOG_LEVEL_MAP[payload.priority];
244
+ const icon = payload.priority === 'urgent' ? '🚨' : '📧';
245
+ const logMsg = `${icon} [${payload.priority.toUpperCase()}] ${payload.sender.name ?? payload.sender.address}: "${payload.subject}"${payload.labels?.length ? ` [${payload.labels.join(', ')}]` : ''}${payload.ruleName ? ` (rule: ${payload.ruleName})` : ''}`;
246
+ await mcpLog(logLevel, 'notifier', logMsg);
247
+ // 2. Desktop notification — if enabled + meets threshold (or forced by rule)
248
+ if (this.config.desktop && (meetsThreshold || forceDesktop)) {
249
+ await this.sendDesktopNotification(payload);
250
+ }
251
+ // 3. Webhook — if configured + meets webhook event filter
252
+ if (this.config.webhookUrl && this.config.webhookEvents.includes(payload.priority)) {
253
+ this.sendWebhook(payload).catch(() => { });
254
+ }
255
+ }
256
+ // -------------------------------------------------------------------------
257
+ // Desktop notification — native OS commands, zero npm deps
258
+ // -------------------------------------------------------------------------
259
+ async sendDesktopNotification(payload) {
260
+ if (this.desktopCount >= NotifierService.MAX_DESKTOP_PER_MIN)
261
+ return;
262
+ this.desktopCount += 1;
263
+ const title = sanitizeForShell(`📧 IMAP Wizard — ${payload.priority === 'urgent' ? 'Urgent' : 'Important'}`);
264
+ const senderDisplay = sanitizeForShell(payload.sender.name ?? payload.sender.address);
265
+ const subject = sanitizeForShell(payload.subject);
266
+ const body = `From: ${senderDisplay}\n${subject}`;
267
+ const playSound = this.config.sound && payload.priority === 'urgent';
268
+ const { platform } = process;
269
+ try {
270
+ if (platform === 'darwin') {
271
+ await NotifierService.execDarwin(title, body, playSound);
272
+ }
273
+ else if (platform === 'linux') {
274
+ await NotifierService.execLinux(title, body, playSound);
275
+ }
276
+ else if (platform === 'win32') {
277
+ await NotifierService.execWindows(title, body);
278
+ }
279
+ }
280
+ catch {
281
+ // Desktop notification failure is non-fatal — silently degrade to MCP log only
282
+ }
283
+ }
284
+ static async execDarwin(title, body, sound) {
285
+ const soundClause = sound ? ' sound name "Glass"' : '';
286
+ const script = `display notification "${body}" with title "${title}"${soundClause}`;
287
+ await NotifierService.execCommand('osascript', ['-e', script]);
288
+ }
289
+ static async execLinux(title, body, sound) {
290
+ const urgency = sound ? 'critical' : 'normal';
291
+ await NotifierService.execCommand('notify-send', ['-u', urgency, title, body]);
292
+ if (sound) {
293
+ try {
294
+ await NotifierService.execCommand('paplay', [
295
+ '/usr/share/sounds/freedesktop/stereo/message-new-instant.oga',
296
+ ]);
297
+ }
298
+ catch {
299
+ // Sound playback failure is non-fatal
300
+ }
301
+ }
302
+ }
303
+ static async execWindows(title, body) {
304
+ const ps = `[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); ` +
305
+ `$n = New-Object System.Windows.Forms.NotifyIcon; ` +
306
+ `$n.Icon = [System.Drawing.SystemIcons]::Information; ` +
307
+ `$n.Visible = $true; ` +
308
+ `$n.ShowBalloonTip(5000, '${title}', '${body}', 'Info')`;
309
+ await NotifierService.execCommand('powershell', ['-Command', ps]);
310
+ }
311
+ static async execCommand(bin, args) {
312
+ return new Promise((resolve, reject) => {
313
+ execFile(bin, args, { timeout: 5000 }, (err) => {
314
+ if (err)
315
+ reject(err);
316
+ else
317
+ resolve();
318
+ });
319
+ });
320
+ }
321
+ // -------------------------------------------------------------------------
322
+ // Webhook dispatch — HTTP POST with JSON payload
323
+ // -------------------------------------------------------------------------
324
+ async sendWebhook(payload) {
325
+ if (!this.config.webhookUrl)
326
+ return;
327
+ let pinned;
328
+ try {
329
+ validateWebhookUrl(this.config.webhookUrl);
330
+ // The synchronous checks above see the hostname as text. This resolves
331
+ // it and range-checks every address, so a name answering in private
332
+ // space is refused before anything goes out. The returned target is
333
+ // pinned — dispatch uses it, not a fresh lookup, closing the rebinding
334
+ // window between check and connect.
335
+ pinned = await assertWebhookTargetAllowed(this.config.webhookUrl);
336
+ }
337
+ catch (err) {
338
+ await mcpLog('warning', 'notifier', `Invalid webhook URL: ${err instanceof Error ? err.message : String(err)}`);
339
+ return;
340
+ }
341
+ const body = JSON.stringify({
342
+ event: `email.${payload.priority}`,
343
+ account: payload.account,
344
+ sender: payload.sender,
345
+ subject: payload.subject,
346
+ priority: payload.priority,
347
+ labels: payload.labels ?? [],
348
+ rule: payload.ruleName ?? null,
349
+ uid: payload.uid ?? null,
350
+ messageId: payload.messageId ?? null,
351
+ folder: payload.folder ?? null,
352
+ hasAttachments: payload.hasAttachments ?? null,
353
+ timestamp: new Date().toISOString(),
354
+ });
355
+ const controller = new AbortController();
356
+ const timeout = setTimeout(() => {
357
+ controller.abort();
358
+ }, 5000);
359
+ try {
360
+ const resp = await fetchWithPinnedTarget(this.config.webhookUrl, pinned, {
361
+ method: 'POST',
362
+ headers: { 'Content-Type': 'application/json' },
363
+ body,
364
+ signal: controller.signal,
365
+ });
366
+ if (resp.status >= 300 && resp.status < 400) {
367
+ await mcpLog('warning', 'notifier', `Webhook redirect refused (${resp.status})`);
368
+ }
369
+ else if (!resp.ok) {
370
+ await mcpLog('warning', 'notifier', `Webhook returned ${resp.status}`);
371
+ }
372
+ }
373
+ catch {
374
+ await mcpLog('debug', 'notifier', 'Webhook dispatch failed (non-fatal)');
375
+ }
376
+ finally {
377
+ clearTimeout(timeout);
378
+ }
379
+ }
380
+ }
381
+ //# sourceMappingURL=notifier.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"notifier.service.js","sourceRoot":"","sources":["../../src/services/notifier.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,47 @@
1
+ /**
2
+ * OAuth2 token management service.
3
+ *
4
+ * Handles token refresh and caching for Google and Microsoft OAuth2/XOAUTH2.
5
+ * Uses native fetch (Node 22+) — no external HTTP dependencies.
6
+ */
7
+ import type { OAuth2Config } from '../types/index.js';
8
+ interface ProviderEndpoints {
9
+ tokenUrl: string;
10
+ authUrl: string;
11
+ scopes: string[];
12
+ }
13
+ export default class OAuthService {
14
+ /**
15
+ * Get a valid access token, refreshing if expired.
16
+ */
17
+ getAccessToken(oauth2: OAuth2Config): Promise<string>;
18
+ /**
19
+ * Check if the cached access token is expired or missing.
20
+ */
21
+ static isTokenExpired(oauth2: OAuth2Config): boolean;
22
+ /**
23
+ * Exchange refresh token for a new access token.
24
+ */
25
+ static refreshAccessToken(oauth2: OAuth2Config): Promise<{
26
+ accessToken: string;
27
+ expiresIn: number;
28
+ }>;
29
+ /**
30
+ * Get provider endpoints for token exchange and authorization.
31
+ */
32
+ static getProviderEndpoints(oauth2: OAuth2Config): ProviderEndpoints;
33
+ /**
34
+ * Generate an OAuth2 authorization URL for the CLI setup wizard.
35
+ */
36
+ static generateAuthUrl(oauth2: OAuth2Config, redirectUri: string): string;
37
+ /**
38
+ * Exchange an authorization code for tokens (initial setup).
39
+ */
40
+ static exchangeCode(oauth2: OAuth2Config, code: string, redirectUri: string): Promise<{
41
+ accessToken: string;
42
+ refreshToken: string;
43
+ expiresIn: number;
44
+ }>;
45
+ }
46
+ export {};
47
+ //# sourceMappingURL=oauth.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth.service.d.ts","sourceRoot":"","sources":["../../src/services/oauth.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAsBD,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B;;OAEG;IAEG,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAc1D;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAGnD;IAED;;OAEG;IACH,OAAa,kBAAkB,CAC7B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CA8BrD;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,CAiBnE;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAWxE;IAED;;OAEG;IACH,OAAa,YAAY,CACvB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAiC3E;CACF"}
@@ -0,0 +1,140 @@
1
+ /**
2
+ * OAuth2 token management service.
3
+ *
4
+ * Handles token refresh and caching for Google and Microsoft OAuth2/XOAUTH2.
5
+ * Uses native fetch (Node 22+) — no external HTTP dependencies.
6
+ */
7
+ const PROVIDER_ENDPOINTS = {
8
+ google: {
9
+ tokenUrl: 'https://oauth2.googleapis.com/token',
10
+ authUrl: 'https://accounts.google.com/o/oauth2/v2/auth',
11
+ scopes: ['https://mail.google.com/'],
12
+ },
13
+ microsoft: {
14
+ tokenUrl: 'https://login.microsoftonline.com/common/oauth2/v2.0/token',
15
+ authUrl: 'https://login.microsoftonline.com/common/oauth2/v2.0/authorize',
16
+ scopes: [
17
+ 'https://outlook.office.com/IMAP.AccessAsUser.All',
18
+ 'https://outlook.office.com/SMTP.Send',
19
+ 'offline_access',
20
+ ],
21
+ },
22
+ };
23
+ /** 5-minute safety buffer before token expiry */
24
+ const TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1000;
25
+ export default class OAuthService {
26
+ /**
27
+ * Get a valid access token, refreshing if expired.
28
+ */
29
+ // eslint-disable-next-line class-methods-use-this
30
+ async getAccessToken(oauth2) {
31
+ if (!OAuthService.isTokenExpired(oauth2) && oauth2.accessToken) {
32
+ return oauth2.accessToken;
33
+ }
34
+ const result = await OAuthService.refreshAccessToken(oauth2);
35
+ // Cache on the config object (in-memory only)
36
+ Object.assign(oauth2, {
37
+ accessToken: result.accessToken,
38
+ tokenExpiry: Date.now() + result.expiresIn * 1000,
39
+ });
40
+ return result.accessToken;
41
+ }
42
+ /**
43
+ * Check if the cached access token is expired or missing.
44
+ */
45
+ static isTokenExpired(oauth2) {
46
+ if (!oauth2.accessToken || !oauth2.tokenExpiry)
47
+ return true;
48
+ return Date.now() >= oauth2.tokenExpiry - TOKEN_EXPIRY_BUFFER_MS;
49
+ }
50
+ /**
51
+ * Exchange refresh token for a new access token.
52
+ */
53
+ static async refreshAccessToken(oauth2) {
54
+ const endpoints = OAuthService.getProviderEndpoints(oauth2);
55
+ const body = new URLSearchParams({
56
+ grant_type: 'refresh_token',
57
+ client_id: oauth2.clientId,
58
+ client_secret: oauth2.clientSecret,
59
+ refresh_token: oauth2.refreshToken,
60
+ });
61
+ const response = await fetch(endpoints.tokenUrl, {
62
+ method: 'POST',
63
+ headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
64
+ body: body.toString(),
65
+ });
66
+ if (!response.ok) {
67
+ const text = await response.text();
68
+ throw new Error(`OAuth2 token refresh failed (${response.status}): ${text}`);
69
+ }
70
+ const data = (await response.json());
71
+ return {
72
+ accessToken: data.access_token,
73
+ expiresIn: data.expires_in,
74
+ };
75
+ }
76
+ /**
77
+ * Get provider endpoints for token exchange and authorization.
78
+ */
79
+ static getProviderEndpoints(oauth2) {
80
+ if (oauth2.provider === 'custom') {
81
+ if (!oauth2.tokenUrl || !oauth2.authUrl) {
82
+ throw new Error('Custom OAuth2 provider requires tokenUrl and authUrl');
83
+ }
84
+ return {
85
+ tokenUrl: oauth2.tokenUrl,
86
+ authUrl: oauth2.authUrl,
87
+ scopes: oauth2.scopes ?? [],
88
+ };
89
+ }
90
+ const endpoints = PROVIDER_ENDPOINTS[oauth2.provider];
91
+ if (!endpoints) {
92
+ throw new Error(`Unknown OAuth2 provider: ${oauth2.provider}`);
93
+ }
94
+ return endpoints;
95
+ }
96
+ /**
97
+ * Generate an OAuth2 authorization URL for the CLI setup wizard.
98
+ */
99
+ static generateAuthUrl(oauth2, redirectUri) {
100
+ const endpoints = OAuthService.getProviderEndpoints(oauth2);
101
+ const params = new URLSearchParams({
102
+ client_id: oauth2.clientId,
103
+ redirect_uri: redirectUri,
104
+ response_type: 'code',
105
+ scope: endpoints.scopes.join(' '),
106
+ access_type: 'offline',
107
+ prompt: 'consent',
108
+ });
109
+ return `${endpoints.authUrl}?${params.toString()}`;
110
+ }
111
+ /**
112
+ * Exchange an authorization code for tokens (initial setup).
113
+ */
114
+ static async exchangeCode(oauth2, code, redirectUri) {
115
+ const endpoints = OAuthService.getProviderEndpoints(oauth2);
116
+ const body = new URLSearchParams({
117
+ grant_type: 'authorization_code',
118
+ client_id: oauth2.clientId,
119
+ client_secret: oauth2.clientSecret,
120
+ code,
121
+ redirect_uri: redirectUri,
122
+ });
123
+ const response = await fetch(endpoints.tokenUrl, {
124
+ method: 'POST',
125
+ headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
126
+ body: body.toString(),
127
+ });
128
+ if (!response.ok) {
129
+ const text = await response.text();
130
+ throw new Error(`OAuth2 code exchange failed (${response.status}): ${text}`);
131
+ }
132
+ const data = (await response.json());
133
+ return {
134
+ accessToken: data.access_token,
135
+ refreshToken: data.refresh_token,
136
+ expiresIn: data.expires_in,
137
+ };
138
+ }
139
+ }
140
+ //# sourceMappingURL=oauth.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth.service.js","sourceRoot":"","sources":["../../src/services/oauth.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Built-in hook presets — ready-to-use AI triage profiles.
3
+ *
4
+ * Each preset provides a system prompt template, suggested labels,
5
+ * and a description. Users select a preset in config.toml and can
6
+ * append their own `custom_instructions` for personalisation.
7
+ */
8
+ export interface HookPreset {
9
+ /** Unique identifier used in config (e.g. "inbox-zero"). */
10
+ id: string;
11
+ /** Human-readable name. */
12
+ name: string;
13
+ /** Short description shown in `list_presets`. */
14
+ description: string;
15
+ /** System prompt template. `{{LABELS}}` and `{{CUSTOM}}` are replaced at runtime. */
16
+ systemPrompt: string;
17
+ /** Labels the AI is encouraged to use when triaging. */
18
+ suggestedLabels: string[];
19
+ }
20
+ export declare const DEFAULT_PRESET_ID = "priority-focus";
21
+ /** Get a preset by id. Returns undefined for unknown ids. */
22
+ export declare function getPreset(id: string): HookPreset | undefined;
23
+ /** List all available presets. */
24
+ export declare function listPresets(): HookPreset[];
25
+ /**
26
+ * Build the final system prompt for AI triage by combining:
27
+ * 1. The preset's system prompt template
28
+ * 2. The preset's suggested labels
29
+ * 3. The user's custom instructions (if any)
30
+ * 4. OR the user's full system_prompt override (if preset = "custom")
31
+ */
32
+ export declare function buildSystemPrompt(presetId: string, options?: {
33
+ customInstructions?: string;
34
+ systemPrompt?: string;
35
+ }): string;
36
+ //# sourceMappingURL=presets.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/services/presets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AA2ID,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE5D;AAED,kCAAkC;AAClC,wBAAgB,WAAW,IAAI,UAAU,EAAE,CAE1C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,MAAM,CAiCR"}