imap-wizard 0.0.0-stage → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +155 -0
- package/README.md +495 -2
- package/dist/app.d.ts +61 -0
- package/dist/app.d.ts.map +1 -0
- package/dist/app.js +201 -0
- package/dist/app.js.map +1 -0
- package/dist/cache/body-cache.d.ts +29 -0
- package/dist/cache/body-cache.d.ts.map +1 -0
- package/dist/cache/body-cache.js +95 -0
- package/dist/cache/body-cache.js.map +1 -0
- package/dist/cache/schema.d.ts +40 -0
- package/dist/cache/schema.d.ts.map +1 -0
- package/dist/cache/schema.js +160 -0
- package/dist/cache/schema.js.map +1 -0
- package/dist/cache/store.d.ts +233 -0
- package/dist/cache/store.d.ts.map +1 -0
- package/dist/cache/store.js +556 -0
- package/dist/cache/store.js.map +1 -0
- package/dist/cache/sync-engine.d.ts +140 -0
- package/dist/cache/sync-engine.d.ts.map +1 -0
- package/dist/cache/sync-engine.js +477 -0
- package/dist/cache/sync-engine.js.map +1 -0
- package/dist/cli/account-commands.d.ts +51 -0
- package/dist/cli/account-commands.d.ts.map +1 -0
- package/dist/cli/account-commands.js +767 -0
- package/dist/cli/account-commands.js.map +1 -0
- package/dist/cli/config-commands.d.ts +9 -0
- package/dist/cli/config-commands.d.ts.map +1 -0
- package/dist/cli/config-commands.js +293 -0
- package/dist/cli/config-commands.js.map +1 -0
- package/dist/cli/email-commands.d.ts +18 -0
- package/dist/cli/email-commands.d.ts.map +1 -0
- package/dist/cli/email-commands.js +447 -0
- package/dist/cli/email-commands.js.map +1 -0
- package/dist/cli/guard.d.ts +11 -0
- package/dist/cli/guard.d.ts.map +1 -0
- package/dist/cli/guard.js +18 -0
- package/dist/cli/guard.js.map +1 -0
- package/dist/cli/http.d.ts +15 -0
- package/dist/cli/http.d.ts.map +1 -0
- package/dist/cli/http.js +263 -0
- package/dist/cli/http.js.map +1 -0
- package/dist/cli/install-commands.d.ts +18 -0
- package/dist/cli/install-commands.d.ts.map +1 -0
- package/dist/cli/install-commands.js +323 -0
- package/dist/cli/install-commands.js.map +1 -0
- package/dist/cli/keychain-commands.d.ts +9 -0
- package/dist/cli/keychain-commands.d.ts.map +1 -0
- package/dist/cli/keychain-commands.js +243 -0
- package/dist/cli/keychain-commands.js.map +1 -0
- package/dist/cli/notify.d.ts +8 -0
- package/dist/cli/notify.d.ts.map +1 -0
- package/dist/cli/notify.js +143 -0
- package/dist/cli/notify.js.map +1 -0
- package/dist/cli/providers.d.ts +13 -0
- package/dist/cli/providers.d.ts.map +1 -0
- package/dist/cli/providers.js +180 -0
- package/dist/cli/providers.js.map +1 -0
- package/dist/cli/scheduler.d.ts +8 -0
- package/dist/cli/scheduler.d.ts.map +1 -0
- package/dist/cli/scheduler.js +268 -0
- package/dist/cli/scheduler.js.map +1 -0
- package/dist/cli/setup.d.ts +12 -0
- package/dist/cli/setup.d.ts.map +1 -0
- package/dist/cli/setup.js +15 -0
- package/dist/cli/setup.js.map +1 -0
- package/dist/cli/test.d.ts +7 -0
- package/dist/cli/test.d.ts.map +1 -0
- package/dist/cli/test.js +67 -0
- package/dist/cli/test.js.map +1 -0
- package/dist/config/loader.d.ts +45 -0
- package/dist/config/loader.d.ts.map +1 -0
- package/dist/config/loader.js +487 -0
- package/dist/config/loader.js.map +1 -0
- package/dist/config/password-command.d.ts +14 -0
- package/dist/config/password-command.d.ts.map +1 -0
- package/dist/config/password-command.js +74 -0
- package/dist/config/password-command.js.map +1 -0
- package/dist/config/schema.d.ts +416 -0
- package/dist/config/schema.d.ts.map +1 -0
- package/dist/config/schema.js +260 -0
- package/dist/config/schema.js.map +1 -0
- package/dist/config/send-limit.d.ts +18 -0
- package/dist/config/send-limit.d.ts.map +1 -0
- package/dist/config/send-limit.js +64 -0
- package/dist/config/send-limit.js.map +1 -0
- package/dist/config/validate.d.ts +30 -0
- package/dist/config/validate.d.ts.map +1 -0
- package/dist/config/validate.js +120 -0
- package/dist/config/validate.js.map +1 -0
- package/dist/config/xdg.d.ts +44 -0
- package/dist/config/xdg.d.ts.map +1 -0
- package/dist/config/xdg.js +49 -0
- package/dist/config/xdg.js.map +1 -0
- package/dist/connections/manager.d.ts +53 -0
- package/dist/connections/manager.d.ts.map +1 -0
- package/dist/connections/manager.js +376 -0
- package/dist/connections/manager.js.map +1 -0
- package/dist/connections/types.d.ts +15 -0
- package/dist/connections/types.d.ts.map +1 -0
- package/dist/connections/types.js +2 -0
- package/dist/connections/types.js.map +1 -0
- package/dist/logging.d.ts +22 -0
- package/dist/logging.d.ts.map +1 -0
- package/dist/logging.js +33 -0
- package/dist/logging.js.map +1 -0
- package/dist/main.d.ts +15 -0
- package/dist/main.d.ts.map +1 -0
- package/dist/main.js +276 -0
- package/dist/main.js.map +1 -0
- package/dist/prompts/actions.prompt.d.ts +9 -0
- package/dist/prompts/actions.prompt.d.ts.map +1 -0
- package/dist/prompts/actions.prompt.js +70 -0
- package/dist/prompts/actions.prompt.js.map +1 -0
- package/dist/prompts/calendar.prompt.d.ts +9 -0
- package/dist/prompts/calendar.prompt.d.ts.map +1 -0
- package/dist/prompts/calendar.prompt.js +59 -0
- package/dist/prompts/calendar.prompt.js.map +1 -0
- package/dist/prompts/cleanup.prompt.d.ts +9 -0
- package/dist/prompts/cleanup.prompt.d.ts.map +1 -0
- package/dist/prompts/cleanup.prompt.js +82 -0
- package/dist/prompts/cleanup.prompt.js.map +1 -0
- package/dist/prompts/compose.prompt.d.ts +8 -0
- package/dist/prompts/compose.prompt.d.ts.map +1 -0
- package/dist/prompts/compose.prompt.js +124 -0
- package/dist/prompts/compose.prompt.js.map +1 -0
- package/dist/prompts/register.d.ts +8 -0
- package/dist/prompts/register.d.ts.map +1 -0
- package/dist/prompts/register.js +20 -0
- package/dist/prompts/register.js.map +1 -0
- package/dist/prompts/thread.prompt.d.ts +9 -0
- package/dist/prompts/thread.prompt.d.ts.map +1 -0
- package/dist/prompts/thread.prompt.js +62 -0
- package/dist/prompts/thread.prompt.js.map +1 -0
- package/dist/prompts/triage.prompt.d.ts +9 -0
- package/dist/prompts/triage.prompt.d.ts.map +1 -0
- package/dist/prompts/triage.prompt.js +71 -0
- package/dist/prompts/triage.prompt.js.map +1 -0
- package/dist/resources/accounts.resource.d.ts +9 -0
- package/dist/resources/accounts.resource.d.ts.map +1 -0
- package/dist/resources/accounts.resource.js +26 -0
- package/dist/resources/accounts.resource.js.map +1 -0
- package/dist/resources/mailboxes.resource.d.ts +10 -0
- package/dist/resources/mailboxes.resource.d.ts.map +1 -0
- package/dist/resources/mailboxes.resource.js +33 -0
- package/dist/resources/mailboxes.resource.js.map +1 -0
- package/dist/resources/register.d.ts +12 -0
- package/dist/resources/register.d.ts.map +1 -0
- package/dist/resources/register.js +20 -0
- package/dist/resources/register.js.map +1 -0
- package/dist/resources/scheduled.resource.d.ts +9 -0
- package/dist/resources/scheduled.resource.d.ts.map +1 -0
- package/dist/resources/scheduled.resource.js +31 -0
- package/dist/resources/scheduled.resource.js.map +1 -0
- package/dist/resources/stats.resource.d.ts +10 -0
- package/dist/resources/stats.resource.d.ts.map +1 -0
- package/dist/resources/stats.resource.js +50 -0
- package/dist/resources/stats.resource.js.map +1 -0
- package/dist/resources/templates.resource.d.ts +9 -0
- package/dist/resources/templates.resource.d.ts.map +1 -0
- package/dist/resources/templates.resource.js +34 -0
- package/dist/resources/templates.resource.js.map +1 -0
- package/dist/resources/unread.resource.d.ts +11 -0
- package/dist/resources/unread.resource.d.ts.map +1 -0
- package/dist/resources/unread.resource.js +53 -0
- package/dist/resources/unread.resource.js.map +1 -0
- package/dist/safety/audit.d.ts +17 -0
- package/dist/safety/audit.d.ts.map +1 -0
- package/dist/safety/audit.js +50 -0
- package/dist/safety/audit.js.map +1 -0
- package/dist/safety/rate-limiter.d.ts +22 -0
- package/dist/safety/rate-limiter.d.ts.map +1 -0
- package/dist/safety/rate-limiter.js +52 -0
- package/dist/safety/rate-limiter.js.map +1 -0
- package/dist/safety/validation.d.ts +46 -0
- package/dist/safety/validation.d.ts.map +1 -0
- package/dist/safety/validation.js +114 -0
- package/dist/safety/validation.js.map +1 -0
- package/dist/safety/webhook-guard.d.ts +33 -0
- package/dist/safety/webhook-guard.d.ts.map +1 -0
- package/dist/safety/webhook-guard.js +154 -0
- package/dist/safety/webhook-guard.js.map +1 -0
- package/dist/security/keychain.d.ts +31 -0
- package/dist/security/keychain.d.ts.map +1 -0
- package/dist/security/keychain.js +217 -0
- package/dist/security/keychain.js.map +1 -0
- package/dist/server.d.ts +13 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +35 -0
- package/dist/server.js.map +1 -0
- package/dist/services/calendar.service.d.ts +22 -0
- package/dist/services/calendar.service.d.ts.map +1 -0
- package/dist/services/calendar.service.js +115 -0
- package/dist/services/calendar.service.js.map +1 -0
- package/dist/services/clipboard.service.d.ts +16 -0
- package/dist/services/clipboard.service.d.ts.map +1 -0
- package/dist/services/clipboard.service.js +92 -0
- package/dist/services/clipboard.service.js.map +1 -0
- package/dist/services/event-bus.d.ts +62 -0
- package/dist/services/event-bus.d.ts.map +1 -0
- package/dist/services/event-bus.js +16 -0
- package/dist/services/event-bus.js.map +1 -0
- package/dist/services/hooks.service.d.ts +88 -0
- package/dist/services/hooks.service.d.ts.map +1 -0
- package/dist/services/hooks.service.js +539 -0
- package/dist/services/hooks.service.js.map +1 -0
- package/dist/services/imap.service.d.ts +301 -0
- package/dist/services/imap.service.d.ts.map +1 -0
- package/dist/services/imap.service.js +2135 -0
- package/dist/services/imap.service.js.map +1 -0
- package/dist/services/label-strategy.d.ts +20 -0
- package/dist/services/label-strategy.d.ts.map +1 -0
- package/dist/services/label-strategy.js +247 -0
- package/dist/services/label-strategy.js.map +1 -0
- package/dist/services/local-calendar.service.d.ts +127 -0
- package/dist/services/local-calendar.service.d.ts.map +1 -0
- package/dist/services/local-calendar.service.js +537 -0
- package/dist/services/local-calendar.service.js.map +1 -0
- package/dist/services/notifier.service.d.ts +91 -0
- package/dist/services/notifier.service.d.ts.map +1 -0
- package/dist/services/notifier.service.js +381 -0
- package/dist/services/notifier.service.js.map +1 -0
- package/dist/services/oauth.service.d.ts +47 -0
- package/dist/services/oauth.service.d.ts.map +1 -0
- package/dist/services/oauth.service.js +140 -0
- package/dist/services/oauth.service.js.map +1 -0
- package/dist/services/presets.d.ts +36 -0
- package/dist/services/presets.d.ts.map +1 -0
- package/dist/services/presets.js +175 -0
- package/dist/services/presets.js.map +1 -0
- package/dist/services/reminders.service.d.ts +63 -0
- package/dist/services/reminders.service.d.ts.map +1 -0
- package/dist/services/reminders.service.js +305 -0
- package/dist/services/reminders.service.js.map +1 -0
- package/dist/services/scheduler.service.d.ts +42 -0
- package/dist/services/scheduler.service.d.ts.map +1 -0
- package/dist/services/scheduler.service.js +294 -0
- package/dist/services/scheduler.service.js.map +1 -0
- package/dist/services/smtp.service.d.ts +97 -0
- package/dist/services/smtp.service.d.ts.map +1 -0
- package/dist/services/smtp.service.js +339 -0
- package/dist/services/smtp.service.js.map +1 -0
- package/dist/services/template.service.d.ts +33 -0
- package/dist/services/template.service.d.ts.map +1 -0
- package/dist/services/template.service.js +123 -0
- package/dist/services/template.service.js.map +1 -0
- package/dist/services/verification.service.d.ts +26 -0
- package/dist/services/verification.service.d.ts.map +1 -0
- package/dist/services/verification.service.js +94 -0
- package/dist/services/verification.service.js.map +1 -0
- package/dist/services/watcher.service.d.ts +36 -0
- package/dist/services/watcher.service.d.ts.map +1 -0
- package/dist/services/watcher.service.js +238 -0
- package/dist/services/watcher.service.js.map +1 -0
- package/dist/tools/accounts.tool.d.ts +7 -0
- package/dist/tools/accounts.tool.d.ts.map +1 -0
- package/dist/tools/accounts.tool.js +33 -0
- package/dist/tools/accounts.tool.js.map +1 -0
- package/dist/tools/analytics.tool.d.ts +9 -0
- package/dist/tools/analytics.tool.d.ts.map +1 -0
- package/dist/tools/analytics.tool.js +32 -0
- package/dist/tools/analytics.tool.js.map +1 -0
- package/dist/tools/attachments.tool.d.ts +7 -0
- package/dist/tools/attachments.tool.d.ts.map +1 -0
- package/dist/tools/attachments.tool.js +93 -0
- package/dist/tools/attachments.tool.js.map +1 -0
- package/dist/tools/bulk.tool.d.ts +7 -0
- package/dist/tools/bulk.tool.d.ts.map +1 -0
- package/dist/tools/bulk.tool.js +80 -0
- package/dist/tools/bulk.tool.js.map +1 -0
- package/dist/tools/calendar.tool.d.ts +19 -0
- package/dist/tools/calendar.tool.d.ts.map +1 -0
- package/dist/tools/calendar.tool.js +576 -0
- package/dist/tools/calendar.tool.js.map +1 -0
- package/dist/tools/contacts.tool.d.ts +7 -0
- package/dist/tools/contacts.tool.d.ts.map +1 -0
- package/dist/tools/contacts.tool.js +49 -0
- package/dist/tools/contacts.tool.js.map +1 -0
- package/dist/tools/drafts.tool.d.ts +8 -0
- package/dist/tools/drafts.tool.d.ts.map +1 -0
- package/dist/tools/drafts.tool.js +110 -0
- package/dist/tools/drafts.tool.js.map +1 -0
- package/dist/tools/emails.tool.d.ts +17 -0
- package/dist/tools/emails.tool.d.ts.map +1 -0
- package/dist/tools/emails.tool.js +508 -0
- package/dist/tools/emails.tool.js.map +1 -0
- package/dist/tools/folders.tool.d.ts +7 -0
- package/dist/tools/folders.tool.d.ts.map +1 -0
- package/dist/tools/folders.tool.js +129 -0
- package/dist/tools/folders.tool.js.map +1 -0
- package/dist/tools/health.tool.d.ts +10 -0
- package/dist/tools/health.tool.d.ts.map +1 -0
- package/dist/tools/health.tool.js +106 -0
- package/dist/tools/health.tool.js.map +1 -0
- package/dist/tools/label.tool.d.ts +11 -0
- package/dist/tools/label.tool.d.ts.map +1 -0
- package/dist/tools/label.tool.js +190 -0
- package/dist/tools/label.tool.js.map +1 -0
- package/dist/tools/locate.tool.d.ts +11 -0
- package/dist/tools/locate.tool.d.ts.map +1 -0
- package/dist/tools/locate.tool.js +65 -0
- package/dist/tools/locate.tool.js.map +1 -0
- package/dist/tools/mailboxes.tool.d.ts +7 -0
- package/dist/tools/mailboxes.tool.d.ts.map +1 -0
- package/dist/tools/mailboxes.tool.js +49 -0
- package/dist/tools/mailboxes.tool.js.map +1 -0
- package/dist/tools/manage.tool.d.ts +7 -0
- package/dist/tools/manage.tool.d.ts.map +1 -0
- package/dist/tools/manage.tool.js +140 -0
- package/dist/tools/manage.tool.js.map +1 -0
- package/dist/tools/register.d.ts +20 -0
- package/dist/tools/register.d.ts.map +1 -0
- package/dist/tools/register.js +60 -0
- package/dist/tools/register.js.map +1 -0
- package/dist/tools/scheduler.tool.d.ts +9 -0
- package/dist/tools/scheduler.tool.d.ts.map +1 -0
- package/dist/tools/scheduler.tool.js +130 -0
- package/dist/tools/scheduler.tool.js.map +1 -0
- package/dist/tools/schemas.d.ts +146 -0
- package/dist/tools/schemas.d.ts.map +1 -0
- package/dist/tools/schemas.js +89 -0
- package/dist/tools/schemas.js.map +1 -0
- package/dist/tools/security.tool.d.ts +11 -0
- package/dist/tools/security.tool.d.ts.map +1 -0
- package/dist/tools/security.tool.js +49 -0
- package/dist/tools/security.tool.js.map +1 -0
- package/dist/tools/send.tool.d.ts +7 -0
- package/dist/tools/send.tool.d.ts.map +1 -0
- package/dist/tools/send.tool.js +196 -0
- package/dist/tools/send.tool.js.map +1 -0
- package/dist/tools/templates.tool.d.ts +12 -0
- package/dist/tools/templates.tool.d.ts.map +1 -0
- package/dist/tools/templates.tool.js +149 -0
- package/dist/tools/templates.tool.js.map +1 -0
- package/dist/tools/thread.tool.d.ts +10 -0
- package/dist/tools/thread.tool.d.ts.map +1 -0
- package/dist/tools/thread.tool.js +140 -0
- package/dist/tools/thread.tool.js.map +1 -0
- package/dist/tools/verification.tool.d.ts +5 -0
- package/dist/tools/verification.tool.d.ts.map +1 -0
- package/dist/tools/verification.tool.js +125 -0
- package/dist/tools/verification.tool.js.map +1 -0
- package/dist/tools/watcher.tool.d.ts +19 -0
- package/dist/tools/watcher.tool.d.ts.map +1 -0
- package/dist/tools/watcher.tool.js +319 -0
- package/dist/tools/watcher.tool.js.map +1 -0
- package/dist/types/index.d.ts +329 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +5 -0
- package/dist/types/index.js.map +1 -0
- package/dist/utils/auth-results.d.ts +24 -0
- package/dist/utils/auth-results.d.ts.map +1 -0
- package/dist/utils/auth-results.js +71 -0
- package/dist/utils/auth-results.js.map +1 -0
- package/dist/utils/bulk-headers.d.ts +34 -0
- package/dist/utils/bulk-headers.d.ts.map +1 -0
- package/dist/utils/bulk-headers.js +112 -0
- package/dist/utils/bulk-headers.js.map +1 -0
- package/dist/utils/calendar-notes.d.ts +31 -0
- package/dist/utils/calendar-notes.d.ts.map +1 -0
- package/dist/utils/calendar-notes.js +83 -0
- package/dist/utils/calendar-notes.js.map +1 -0
- package/dist/utils/calendar-state.d.ts +27 -0
- package/dist/utils/calendar-state.d.ts.map +1 -0
- package/dist/utils/calendar-state.js +85 -0
- package/dist/utils/calendar-state.js.map +1 -0
- package/dist/utils/conference-details.d.ts +12 -0
- package/dist/utils/conference-details.d.ts.map +1 -0
- package/dist/utils/conference-details.js +71 -0
- package/dist/utils/conference-details.js.map +1 -0
- package/dist/utils/html.d.ts +24 -0
- package/dist/utils/html.d.ts.map +1 -0
- package/dist/utils/html.js +162 -0
- package/dist/utils/html.js.map +1 -0
- package/dist/utils/imap-client.d.ts +22 -0
- package/dist/utils/imap-client.d.ts.map +1 -0
- package/dist/utils/imap-client.js +26 -0
- package/dist/utils/imap-client.js.map +1 -0
- package/dist/utils/imap-error.d.ts +28 -0
- package/dist/utils/imap-error.d.ts.map +1 -0
- package/dist/utils/imap-error.js +82 -0
- package/dist/utils/imap-error.js.map +1 -0
- package/dist/utils/meeting-url.d.ts +10 -0
- package/dist/utils/meeting-url.d.ts.map +1 -0
- package/dist/utils/meeting-url.js +30 -0
- package/dist/utils/meeting-url.js.map +1 -0
- package/dist/utils/offline-notice.d.ts +10 -0
- package/dist/utils/offline-notice.d.ts.map +1 -0
- package/dist/utils/offline-notice.js +10 -0
- package/dist/utils/offline-notice.js.map +1 -0
- package/dist/utils/reply-chain.d.ts +6 -0
- package/dist/utils/reply-chain.d.ts.map +1 -0
- package/dist/utils/reply-chain.js +15 -0
- package/dist/utils/reply-chain.js.map +1 -0
- package/dist/utils/verification-code.d.ts +29 -0
- package/dist/utils/verification-code.d.ts.map +1 -0
- package/dist/utils/verification-code.js +305 -0
- package/dist/utils/verification-code.js.map +1 -0
- package/dist/utils/verification-link.d.ts +26 -0
- package/dist/utils/verification-link.d.ts.map +1 -0
- package/dist/utils/verification-link.js +197 -0
- package/dist/utils/verification-link.js.map +1 -0
- package/package.json +105 -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
|
package/dist/app.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,SAAS,MAAM,uBAAuB,CAAC;AAC9C,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,UAAU,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AACvD,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,WAAW,MAAM,0BAA0B,CAAC;AACnD,OAAO,YAAY,MAAM,aAAa,CAAC;AACvC,OAAO,eAAe,MAAM,gCAAgC,CAAC;AAC7D,OAAO,YAAY,MAAM,6BAA6B,CAAC;AACvD,OAAO,WAAW,MAAM,4BAA4B,CAAC;AACrD,OAAO,oBAAoB,MAAM,sCAAsC,CAAC;AACxE,OAAO,YAAY,MAAM,6BAA6B,CAAC;AACvD,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;AAC3D,OAAO,gBAAgB,MAAM,qBAAqB,CAAC;AAqBnD,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAElC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,IAAI,WAAW,CACjC,WAAW,EACX,WAAW,EACX,WAAW,EACX,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CACrC,CAAC;IACF,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACxD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAChD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACxE,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAClG,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAE1E,2EAA2E;IAC3E,yEAAyE;IACzE,gCAAgC;IAChC,IAAI,UAAkC,CAAC;IACvC,IAAI,UAAkC,CAAC;IACvC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;YACtC,uEAAuE;YACvE,qEAAqE;YACrE,cAAc;YACd,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACrF,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjF,UAAU,GAAG,IAAI,UAAU,CACzB,WAAW,EACX,UAAU,EACV;gBACE,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU;gBAC5C,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS;aAC3C,EACD,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CACtE,CAAC;YACF,IAAI,SAAS;gBAAE,WAAW,CAAC,eAAe,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,GAAG,SAAS,CAAC;YACvB,UAAU,GAAG,SAAS,CAAC;YACvB,MAAM,MAAM,CACV,SAAS,EACT,OAAO,EACP,0CAA0C,QAAQ,KAChD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM;QACN,WAAW;QACX,WAAW;QACX,WAAW;QACX,eAAe;QACf,eAAe;QACf,oBAAoB;QACpB,gBAAgB;QAChB,gBAAgB;QAChB,cAAc;QACd,YAAY;QACZ,UAAU;QACV,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAqB;IAC/C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,gBAAgB,CACd,MAAM,EACN,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,eAAe,EACxB,QAAQ,CAAC,eAAe,EACxB,QAAQ,CAAC,oBAAoB,EAC7B,QAAQ,CAAC,gBAAgB,EACzB,QAAQ,CAAC,gBAAgB,EACzB,QAAQ,CAAC,cAAc,EACvB,QAAQ,CAAC,YAAY,CACtB,CAAC;IACF,oBAAoB,CAClB,MAAM,EACN,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,eAAe,EACxB,QAAQ,CAAC,gBAAgB,CAC1B,CAAC;IACF,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAqB,EACrB,cAA6B;IAE7B,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,GACvF,QAAQ,CAAC;IACX,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,iBAA6D,CAAC;IAClE,IAAI,aAAyD,CAAC;IAE9D,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,iBAAiB;oBAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;gBACxD,IAAI,aAAa;oBAAE,aAAa,CAAC,aAAa,CAAC,CAAC;gBAChD,UAAU,EAAE,IAAI,EAAE,CAAC;YACrB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACnC,UAAU,EAAE,KAAK,EAAE,CAAC;IAEpB,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YAC7B,mEAAmE;YACnE,oEAAoE;YACpE,qEAAqE;YACrE,0CAA0C;YAC1C,IAAI,OAAO;gBAAE,OAAO;YACpB,MAAM,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,yCAAyC,CAAC,CAAC;YAE1E,iDAAiD;YACjD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,YAAY,EAAE,CAAC;gBACrD,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;oBACpB,MAAM,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,MAAM,CAAC,IAAI,8BAA8B,CAAC,CAAC;gBACvF,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,kEAAkE;YACpE,CAAC;YAED,6CAA6C;YAC7C,IAAI,OAAO;gBAAE,OAAO;YACpB,iBAAiB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;gBACzC,IAAI,CAAC;oBACH,MAAM,gBAAgB,CAAC,YAAY,EAAE,CAAC;gBACxC,CAAC;gBAAC,MAAM,CAAC;oBACP,4BAA4B;gBAC9B,CAAC;YACH,CAAC,EAAE,MAAM,CAAC,CAAC;YAEX,oEAAoE;YACpE,qEAAqE;YACrE,wBAAwB;YACxB,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC1D,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE;oBAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW;yBAC9B,eAAe,EAAE;yBACjB,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CACrE,CAAC;oBACJ,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBACjC,CAAC,CAAC;gBAEF,IAAI,OAAO;oBAAE,OAAO;gBACpB,MAAM,SAAS,EAAE,CAAC;gBAClB,IAAI,OAAO;oBAAE,OAAO;gBACpB,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;oBAC/B,KAAK,SAAS,EAAE,CAAC;gBACnB,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yCAAyC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC9F,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,iBAAiB;gBAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;YACxD,IAAI,aAAa;gBAAE,aAAa,CAAC,aAAa,CAAC,CAAC;YAChD,YAAY,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC;YAC5B,UAAU,EAAE,IAAI,EAAE,CAAC;YACnB,WAAW,CAAC,OAAO,EAAE,CAAC;YACtB,sEAAsE;YACtE,uEAAuE;YACvE,mDAAmD;YACnD,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -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"}
|