@usejunior/provider-microsoft 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/auth.d.ts ADDED
@@ -0,0 +1,115 @@
1
+ import type { AuthManager } from '@usejunior/email-core';
2
+ import { type AuthenticationRecord } from '@azure/identity';
3
+ export declare const GRAPH_SCOPES: string[];
4
+ export declare const GRAPH_SCOPES_FULL: string[];
5
+ /**
6
+ * Resolve the config directory for token storage.
7
+ * Supports EMAIL_AGENT_MCP_HOME env var override for test isolation.
8
+ */
9
+ export declare function getConfigDir(): string;
10
+ export interface MicrosoftAuthConfig {
11
+ mode: 'delegated' | 'client_credentials';
12
+ clientId: string;
13
+ clientSecret?: string;
14
+ tenantId?: string;
15
+ }
16
+ export interface MailboxMetadata {
17
+ authenticationRecord: AuthenticationRecord;
18
+ cacheName?: string;
19
+ lastInteractiveAuthAt: string;
20
+ clientId: string;
21
+ tenantId?: string;
22
+ mailboxName: string;
23
+ emailAddress?: string;
24
+ }
25
+ /**
26
+ * Convert an email address to a filesystem-safe key.
27
+ * Lowercase, replace `@` with `-at-`, replace `.` with `-`, strip anything not [a-z0-9-].
28
+ * Example: `test-user@example.com` → `test-user-at-example-com`
29
+ */
30
+ export declare function toFilesystemSafeKey(email: string): string;
31
+ /**
32
+ * Delegated OAuth auth manager — real device code flow with MSAL cache persistence.
33
+ *
34
+ * Tokens are stored in the OS keychain by MSAL.
35
+ * Only the AuthenticationRecord (non-secret metadata) is saved to disk.
36
+ */
37
+ export declare class DelegatedAuthManager implements AuthManager {
38
+ private credential;
39
+ private authRecord;
40
+ private cacheName;
41
+ private readonly config;
42
+ private readonly mailboxName;
43
+ private _needsReauth;
44
+ private _lastInteractiveAuthAt;
45
+ private _emailAddress;
46
+ constructor(config: MicrosoftAuthConfig, mailboxName?: string);
47
+ /** Set the email address for this mailbox (called after profile fetch during configure). */
48
+ setEmailAddress(email: string): void;
49
+ /** Get the email address for this mailbox (may be null if not yet fetched). */
50
+ get emailAddress(): string | null;
51
+ get needsReauth(): boolean;
52
+ get lastInteractiveAuthAt(): string | null;
53
+ /**
54
+ * Interactive device code flow — prints URL + code to stderr.
55
+ * Call this from `email-agent-mcp configure`, NOT from MCP serve.
56
+ */
57
+ connect(_credentials: Record<string, string>): Promise<void>;
58
+ /**
59
+ * Reconnect from a saved AuthenticationRecord (silent, no user interaction).
60
+ */
61
+ reconnect(): Promise<void>;
62
+ /**
63
+ * Get a valid access token (refreshes automatically via MSAL cache).
64
+ */
65
+ getAccessToken(): Promise<string>;
66
+ refresh(): Promise<void>;
67
+ disconnect(): Promise<void>;
68
+ isTokenExpired(): boolean;
69
+ /**
70
+ * Check token health: returns a warning if approaching expiry.
71
+ */
72
+ getTokenHealthWarning(): string | undefined;
73
+ private getMetadataPath;
74
+ private getLegacyCacheName;
75
+ private createCacheName;
76
+ private createPersistentCredential;
77
+ saveMetadata(): Promise<void>;
78
+ private loadMetadata;
79
+ }
80
+ /**
81
+ * Client credentials auth manager (app-only / daemon).
82
+ * Uses ClientSecretCredential from @azure/identity for real Azure AD authentication.
83
+ */
84
+ export declare class ClientCredentialsAuthManager implements AuthManager {
85
+ private credential;
86
+ private accessToken?;
87
+ private expiresAt?;
88
+ private readonly config;
89
+ private static readonly GRAPH_SCOPE;
90
+ constructor(config: MicrosoftAuthConfig);
91
+ connect(_credentials: Record<string, string>): Promise<void>;
92
+ refresh(): Promise<void>;
93
+ disconnect(): Promise<void>;
94
+ isTokenExpired(): boolean;
95
+ getAccessToken(): Promise<string | undefined>;
96
+ }
97
+ /**
98
+ * List all configured mailboxes from ~/.email-agent-mcp/tokens/
99
+ * Returns mailbox names (filename stems) for backward compatibility.
100
+ */
101
+ export declare function listConfiguredMailboxes(): Promise<string[]>;
102
+ /**
103
+ * List all configured mailboxes with their full metadata.
104
+ * Deduplicates by emailAddress: if multiple files have the same email,
105
+ * keeps the one with the most recent lastInteractiveAuthAt and deletes the older file(s).
106
+ * Legacy files (no emailAddress) are kept only if no email-based file exists for the same mailboxName.
107
+ */
108
+ export declare function listConfiguredMailboxesWithMetadata(): Promise<MailboxMetadata[]>;
109
+ /**
110
+ * Load metadata for a specific mailbox.
111
+ * Accepts a mailbox name (filename stem), an email address, or a filesystem-safe key.
112
+ */
113
+ export declare function loadMailboxMetadata(identifier: string): Promise<MailboxMetadata | null>;
114
+ export { type AuthenticationRecord } from '@azure/identity';
115
+ //# sourceMappingURL=auth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}
package/dist/auth.js ADDED
@@ -0,0 +1,421 @@
1
+ import { DeviceCodeCredential, ClientSecretCredential, useIdentityPlugin } from '@azure/identity';
2
+ import { cachePersistencePlugin } from '@azure/identity-cache-persistence';
3
+ import { randomUUID } from 'node:crypto';
4
+ import { readFile, writeFile, mkdir } from 'node:fs/promises';
5
+ import { join, dirname } from 'node:path';
6
+ import { homedir } from 'node:os';
7
+ // Enable MSAL persistent cache (OS keychain on macOS, DPAPI on Windows, libsecret on Linux)
8
+ useIdentityPlugin(cachePersistencePlugin);
9
+ export const GRAPH_SCOPES = ['Mail.Read', 'Mail.ReadWrite', 'Mail.Send', 'User.Read', 'offline_access'];
10
+ // Full URL scopes for device code flow (ensures correct audience in the token)
11
+ export const GRAPH_SCOPES_FULL = [
12
+ 'https://graph.microsoft.com/Mail.Read',
13
+ 'https://graph.microsoft.com/Mail.ReadWrite',
14
+ 'https://graph.microsoft.com/Mail.Send',
15
+ 'https://graph.microsoft.com/User.Read',
16
+ 'offline_access',
17
+ ];
18
+ /**
19
+ * Resolve the config directory for token storage.
20
+ * Supports EMAIL_AGENT_MCP_HOME env var override for test isolation.
21
+ */
22
+ export function getConfigDir() {
23
+ const base = process.env['EMAIL_AGENT_MCP_HOME'] ?? join(homedir(), '.email-agent-mcp');
24
+ return join(base, 'tokens');
25
+ }
26
+ /**
27
+ * Convert an email address to a filesystem-safe key.
28
+ * Lowercase, replace `@` with `-at-`, replace `.` with `-`, strip anything not [a-z0-9-].
29
+ * Example: `test-user@example.com` → `test-user-at-example-com`
30
+ */
31
+ export function toFilesystemSafeKey(email) {
32
+ return email
33
+ .toLowerCase()
34
+ .replace(/@/g, '-at-')
35
+ .replace(/\./g, '-')
36
+ .replace(/[^a-z0-9-]/g, '');
37
+ }
38
+ /**
39
+ * Delegated OAuth auth manager — real device code flow with MSAL cache persistence.
40
+ *
41
+ * Tokens are stored in the OS keychain by MSAL.
42
+ * Only the AuthenticationRecord (non-secret metadata) is saved to disk.
43
+ */
44
+ export class DelegatedAuthManager {
45
+ credential = null;
46
+ authRecord = null;
47
+ cacheName = null;
48
+ config;
49
+ mailboxName;
50
+ _needsReauth = false;
51
+ _lastInteractiveAuthAt = null;
52
+ _emailAddress = null;
53
+ constructor(config, mailboxName = 'default') {
54
+ this.config = config;
55
+ this.mailboxName = mailboxName;
56
+ }
57
+ /** Set the email address for this mailbox (called after profile fetch during configure). */
58
+ setEmailAddress(email) {
59
+ this._emailAddress = email;
60
+ }
61
+ /** Get the email address for this mailbox (may be null if not yet fetched). */
62
+ get emailAddress() {
63
+ return this._emailAddress;
64
+ }
65
+ get needsReauth() { return this._needsReauth; }
66
+ get lastInteractiveAuthAt() { return this._lastInteractiveAuthAt; }
67
+ /**
68
+ * Interactive device code flow — prints URL + code to stderr.
69
+ * Call this from `email-agent-mcp configure`, NOT from MCP serve.
70
+ */
71
+ async connect(_credentials) {
72
+ this.cacheName = this.createCacheName();
73
+ this.credential = this.createPersistentCredential({
74
+ clientId: this.config.clientId,
75
+ tenantId: this.config.tenantId,
76
+ cacheName: this.cacheName,
77
+ disableAutomaticAuthentication: true, // Force interactive in connect()
78
+ userPromptCallback: (info) => {
79
+ console.error('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
80
+ console.error(' To sign in, open this URL in your browser:');
81
+ console.error(` ${info.verificationUri}`);
82
+ console.error(` Enter code: ${info.userCode}`);
83
+ console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
84
+ },
85
+ });
86
+ this.authRecord = (await this.credential.authenticate(GRAPH_SCOPES_FULL)) ?? null;
87
+ if (!this.authRecord)
88
+ throw new Error('Authentication failed — no record received');
89
+ this._lastInteractiveAuthAt = new Date().toISOString();
90
+ this._needsReauth = false;
91
+ // Persist metadata (not the tokens — those are in OS keychain via MSAL)
92
+ await this.saveMetadata();
93
+ }
94
+ /**
95
+ * Reconnect from a saved AuthenticationRecord (silent, no user interaction).
96
+ */
97
+ async reconnect() {
98
+ const metadata = await this.loadMetadata();
99
+ if (!metadata) {
100
+ throw new Error(`No saved credentials for mailbox "${this.mailboxName}". Run: email-agent-mcp configure --mailbox ${this.mailboxName}`);
101
+ }
102
+ this.authRecord = metadata.authenticationRecord;
103
+ this.cacheName = metadata.cacheName ?? this.getLegacyCacheName();
104
+ this._lastInteractiveAuthAt = metadata.lastInteractiveAuthAt;
105
+ this._emailAddress = metadata.emailAddress ?? null;
106
+ this.credential = this.createPersistentCredential({
107
+ clientId: metadata.clientId,
108
+ tenantId: metadata.tenantId,
109
+ authenticationRecord: this.authRecord,
110
+ cacheName: this.cacheName,
111
+ });
112
+ // Verify the token still works
113
+ try {
114
+ await this.credential.getToken(GRAPH_SCOPES_FULL);
115
+ this._needsReauth = false;
116
+ }
117
+ catch (err) {
118
+ const message = err instanceof Error ? err.message : String(err);
119
+ if (message.includes('interaction_required') || message.includes('invalid_grant')) {
120
+ this._needsReauth = true;
121
+ throw new Error(`Token expired. Run: email-agent-mcp configure --mailbox ${this.mailboxName}`);
122
+ }
123
+ throw err;
124
+ }
125
+ }
126
+ /**
127
+ * Get a valid access token (refreshes automatically via MSAL cache).
128
+ */
129
+ async getAccessToken() {
130
+ if (!this.credential) {
131
+ throw new Error('Not connected. Call connect() or reconnect() first.');
132
+ }
133
+ try {
134
+ const token = await this.credential.getToken(GRAPH_SCOPES_FULL);
135
+ if (!token)
136
+ throw new Error('Failed to acquire token');
137
+ return token.token;
138
+ }
139
+ catch (err) {
140
+ const message = err instanceof Error ? err.message : String(err);
141
+ if (message.includes('interaction_required') || message.includes('invalid_grant')) {
142
+ this._needsReauth = true;
143
+ }
144
+ throw err;
145
+ }
146
+ }
147
+ async refresh() {
148
+ // MSAL handles refresh automatically via getToken() / cache
149
+ await this.getAccessToken();
150
+ }
151
+ async disconnect() {
152
+ this.credential = null;
153
+ this.authRecord = null;
154
+ this.cacheName = null;
155
+ }
156
+ isTokenExpired() {
157
+ // With MSAL cache, we don't track expiry directly — MSAL handles it.
158
+ // We use needsReauth as the signal.
159
+ return this._needsReauth;
160
+ }
161
+ /**
162
+ * Check token health: returns a warning if approaching expiry.
163
+ */
164
+ getTokenHealthWarning() {
165
+ if (this._needsReauth) {
166
+ return `Authentication expired. Run: email-agent-mcp configure --mailbox ${this.mailboxName}`;
167
+ }
168
+ if (this._lastInteractiveAuthAt) {
169
+ const daysSinceAuth = (Date.now() - new Date(this._lastInteractiveAuthAt).getTime()) / (1000 * 60 * 60 * 24);
170
+ if (daysSinceAuth > 80) {
171
+ return `Token may expire soon (last authenticated ${Math.round(daysSinceAuth)} days ago). Run: email-agent-mcp configure --mailbox ${this.mailboxName}`;
172
+ }
173
+ }
174
+ return undefined;
175
+ }
176
+ getMetadataPath() {
177
+ if (this._emailAddress) {
178
+ return join(getConfigDir(), `${toFilesystemSafeKey(this._emailAddress)}.json`);
179
+ }
180
+ return join(getConfigDir(), `${this.mailboxName}.json`);
181
+ }
182
+ getLegacyCacheName() {
183
+ return `email-agent-mcp-${this.mailboxName}`;
184
+ }
185
+ createCacheName() {
186
+ return `${this.getLegacyCacheName()}-${randomUUID()}`;
187
+ }
188
+ createPersistentCredential(options) {
189
+ return new DeviceCodeCredential({
190
+ clientId: options.clientId,
191
+ tenantId: options.tenantId ?? 'organizations',
192
+ authenticationRecord: options.authenticationRecord,
193
+ disableAutomaticAuthentication: options.disableAutomaticAuthentication ?? false,
194
+ userPromptCallback: options.userPromptCallback,
195
+ tokenCachePersistenceOptions: {
196
+ enabled: true,
197
+ name: options.cacheName,
198
+ unsafeAllowUnencryptedStorage: process.platform === 'linux',
199
+ },
200
+ });
201
+ }
202
+ async saveMetadata() {
203
+ const path = this.getMetadataPath();
204
+ await mkdir(dirname(path), { recursive: true });
205
+ const metadata = {
206
+ authenticationRecord: this.authRecord,
207
+ cacheName: this.cacheName ?? undefined,
208
+ lastInteractiveAuthAt: this._lastInteractiveAuthAt,
209
+ clientId: this.config.clientId,
210
+ tenantId: this.config.tenantId,
211
+ mailboxName: this.mailboxName,
212
+ emailAddress: this._emailAddress ?? undefined,
213
+ };
214
+ await writeFile(path, JSON.stringify(metadata, null, 2), 'utf-8');
215
+ }
216
+ async loadMetadata() {
217
+ // Use the public loadMailboxMetadata which handles both old-style (name-based)
218
+ // and new-style (email-based) filenames, plus fallback search
219
+ return loadMailboxMetadata(this.mailboxName);
220
+ }
221
+ }
222
+ /**
223
+ * Client credentials auth manager (app-only / daemon).
224
+ * Uses ClientSecretCredential from @azure/identity for real Azure AD authentication.
225
+ */
226
+ export class ClientCredentialsAuthManager {
227
+ credential = null;
228
+ accessToken;
229
+ expiresAt;
230
+ config;
231
+ static GRAPH_SCOPE = 'https://graph.microsoft.com/.default';
232
+ constructor(config) {
233
+ this.config = config;
234
+ }
235
+ async connect(_credentials) {
236
+ if (!this.config.clientSecret || !this.config.tenantId) {
237
+ throw new Error('Client credentials require clientSecret and tenantId');
238
+ }
239
+ this.credential = new ClientSecretCredential(this.config.tenantId, this.config.clientId, this.config.clientSecret);
240
+ const tokenResponse = await this.credential.getToken(ClientCredentialsAuthManager.GRAPH_SCOPE);
241
+ if (!tokenResponse)
242
+ throw new Error('Failed to acquire token via client credentials');
243
+ this.accessToken = tokenResponse.token;
244
+ this.expiresAt = tokenResponse.expiresOnTimestamp;
245
+ }
246
+ async refresh() {
247
+ if (!this.credential) {
248
+ throw new Error('Not connected. Call connect() first.');
249
+ }
250
+ const tokenResponse = await this.credential.getToken(ClientCredentialsAuthManager.GRAPH_SCOPE);
251
+ if (!tokenResponse)
252
+ throw new Error('Failed to refresh token via client credentials');
253
+ this.accessToken = tokenResponse.token;
254
+ this.expiresAt = tokenResponse.expiresOnTimestamp;
255
+ }
256
+ async disconnect() {
257
+ this.credential = null;
258
+ this.accessToken = undefined;
259
+ this.expiresAt = undefined;
260
+ }
261
+ isTokenExpired() {
262
+ if (!this.expiresAt)
263
+ return true;
264
+ return Date.now() >= this.expiresAt;
265
+ }
266
+ async getAccessToken() {
267
+ if (!this.credential)
268
+ return undefined;
269
+ if (this.isTokenExpired()) {
270
+ await this.refresh();
271
+ }
272
+ return this.accessToken;
273
+ }
274
+ }
275
+ /**
276
+ * List all configured mailboxes from ~/.email-agent-mcp/tokens/
277
+ * Returns mailbox names (filename stems) for backward compatibility.
278
+ */
279
+ export async function listConfiguredMailboxes() {
280
+ try {
281
+ const { readdir } = await import('node:fs/promises');
282
+ const files = await readdir(getConfigDir());
283
+ return files
284
+ .filter(f => f.endsWith('.json'))
285
+ .map(f => f.replace('.json', ''));
286
+ }
287
+ catch {
288
+ return [];
289
+ }
290
+ }
291
+ /**
292
+ * List all configured mailboxes with their full metadata.
293
+ * Deduplicates by emailAddress: if multiple files have the same email,
294
+ * keeps the one with the most recent lastInteractiveAuthAt and deletes the older file(s).
295
+ * Legacy files (no emailAddress) are kept only if no email-based file exists for the same mailboxName.
296
+ */
297
+ export async function listConfiguredMailboxesWithMetadata() {
298
+ const { readdir, unlink } = await import('node:fs/promises');
299
+ let files;
300
+ try {
301
+ files = (await readdir(getConfigDir())).filter(f => f.endsWith('.json'));
302
+ }
303
+ catch {
304
+ return [];
305
+ }
306
+ // Load all metadata with their filenames
307
+ const entries = [];
308
+ for (const file of files) {
309
+ try {
310
+ const content = await readFile(join(getConfigDir(), file), 'utf-8');
311
+ const metadata = JSON.parse(content);
312
+ entries.push({ filename: file, metadata });
313
+ }
314
+ catch {
315
+ // Skip unreadable files
316
+ }
317
+ }
318
+ // Group by emailAddress for dedup
319
+ const byEmail = new Map();
320
+ const noEmail = [];
321
+ for (const entry of entries) {
322
+ if (entry.metadata.emailAddress) {
323
+ const email = entry.metadata.emailAddress.toLowerCase();
324
+ const group = byEmail.get(email) ?? [];
325
+ group.push(entry);
326
+ byEmail.set(email, group);
327
+ }
328
+ else {
329
+ noEmail.push(entry);
330
+ }
331
+ }
332
+ const results = [];
333
+ const emailAddressesSeen = new Set();
334
+ // For each email group, keep the most recent and delete the rest
335
+ for (const [email, group] of byEmail) {
336
+ // Sort by lastInteractiveAuthAt descending (most recent first)
337
+ group.sort((a, b) => {
338
+ const dateA = new Date(a.metadata.lastInteractiveAuthAt ?? '1970-01-01').getTime();
339
+ const dateB = new Date(b.metadata.lastInteractiveAuthAt ?? '1970-01-01').getTime();
340
+ return dateB - dateA;
341
+ });
342
+ // Keep the first (most recent), delete the rest
343
+ results.push(group[0].metadata);
344
+ emailAddressesSeen.add(email);
345
+ for (let i = 1; i < group.length; i++) {
346
+ const staleFile = group[i].filename;
347
+ console.error(`[email-agent-mcp] Removing stale token file ${staleFile} (superseded by ${group[0].filename} for ${email})`);
348
+ try {
349
+ await unlink(join(getConfigDir(), staleFile));
350
+ }
351
+ catch {
352
+ // Best-effort cleanup
353
+ }
354
+ }
355
+ }
356
+ // Keep legacy (no email) entries only if no email-based file exists for the same mailboxName
357
+ for (const entry of noEmail) {
358
+ // Check if any email-based entry has the same mailboxName
359
+ const superseded = results.some(r => r.mailboxName === entry.metadata.mailboxName && r.emailAddress);
360
+ if (superseded) {
361
+ console.error(`[email-agent-mcp] Removing legacy token file ${entry.filename} (superseded by email-based file for mailbox "${entry.metadata.mailboxName}")`);
362
+ try {
363
+ await unlink(join(getConfigDir(), entry.filename));
364
+ }
365
+ catch {
366
+ // Best-effort cleanup
367
+ }
368
+ }
369
+ else {
370
+ results.push(entry.metadata);
371
+ }
372
+ }
373
+ return results;
374
+ }
375
+ /**
376
+ * Load metadata for a specific mailbox.
377
+ * Accepts a mailbox name (filename stem), an email address, or a filesystem-safe key.
378
+ */
379
+ export async function loadMailboxMetadata(identifier) {
380
+ // Try direct filename match first (e.g., "work" → "work.json", or safe key → safe key.json)
381
+ try {
382
+ const content = await readFile(join(getConfigDir(), `${identifier}.json`), 'utf-8');
383
+ return JSON.parse(content);
384
+ }
385
+ catch {
386
+ // Not found by direct name
387
+ }
388
+ // Try as email address: convert to filesystem-safe key
389
+ if (identifier.includes('@')) {
390
+ try {
391
+ const safeKey = toFilesystemSafeKey(identifier);
392
+ const content = await readFile(join(getConfigDir(), `${safeKey}.json`), 'utf-8');
393
+ return JSON.parse(content);
394
+ }
395
+ catch {
396
+ // Not found
397
+ }
398
+ }
399
+ // Fall back: search all metadata files for matching mailboxName or emailAddress
400
+ try {
401
+ const { readdir } = await import('node:fs/promises');
402
+ const files = await readdir(getConfigDir());
403
+ for (const file of files.filter(f => f.endsWith('.json'))) {
404
+ try {
405
+ const content = await readFile(join(getConfigDir(), file), 'utf-8');
406
+ const metadata = JSON.parse(content);
407
+ if (metadata.mailboxName === identifier || metadata.emailAddress === identifier) {
408
+ return metadata;
409
+ }
410
+ }
411
+ catch {
412
+ // Skip unreadable files
413
+ }
414
+ }
415
+ }
416
+ catch {
417
+ // No config dir
418
+ }
419
+ return null;
420
+ }
421
+ //# sourceMappingURL=auth.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,83 @@
1
+ import type { EmailMessage, EmailThread, ComposeMessage, SendResult, DraftResult, ListOptions, ReplyOptions, EmailReader, EmailSender, EmailCategorizer } from '@usejunior/email-core';
2
+ export interface GraphApiClient {
3
+ get(url: string): Promise<{
4
+ value?: unknown[];
5
+ [key: string]: unknown;
6
+ }>;
7
+ post(url: string, body?: unknown): Promise<{
8
+ id?: string;
9
+ [key: string]: unknown;
10
+ }>;
11
+ patch(url: string, body: unknown): Promise<void>;
12
+ delete(url: string): Promise<void>;
13
+ }
14
+ /** Result from delta query, including messages and the deltaLink for persistence */
15
+ export interface DeltaResult {
16
+ messages: EmailMessage[];
17
+ nextDeltaLink: string;
18
+ }
19
+ /**
20
+ * Real Graph API client using fetch + Bearer token.
21
+ * Used when connected to a real mailbox via DelegatedAuthManager.
22
+ */
23
+ export declare class RealGraphApiClient implements GraphApiClient {
24
+ private getToken;
25
+ constructor(getToken: () => Promise<string>);
26
+ get(url: string): Promise<{
27
+ value?: unknown[];
28
+ [key: string]: unknown;
29
+ }>;
30
+ post(url: string, body?: unknown): Promise<{
31
+ id?: string;
32
+ [key: string]: unknown;
33
+ }>;
34
+ patch(url: string, body: unknown): Promise<void>;
35
+ delete(url: string): Promise<void>;
36
+ }
37
+ export declare class GraphApiError extends Error {
38
+ status: number;
39
+ body: string;
40
+ constructor(status: number, body: string);
41
+ }
42
+ export declare class GraphEmailProvider implements EmailReader, EmailSender, EmailCategorizer {
43
+ private client;
44
+ private basePath;
45
+ constructor(client: GraphApiClient, userId?: string);
46
+ listMessages(opts: ListOptions): Promise<EmailMessage[]>;
47
+ getMessage(id: string): Promise<EmailMessage>;
48
+ searchMessages(query: string, folder?: string): Promise<EmailMessage[]>;
49
+ getThread(messageId: string): Promise<EmailThread>;
50
+ applyLabels(messageId: string, labels: string[]): Promise<void>;
51
+ removeLabels(messageId: string, labels: string[]): Promise<void>;
52
+ setFlag(messageId: string, flagged: boolean): Promise<void>;
53
+ setReadState(messageId: string, isRead: boolean): Promise<void>;
54
+ moveToFolder(messageId: string, folder: string): Promise<string>;
55
+ deleteMessage(messageId: string, hard?: boolean): Promise<void>;
56
+ sendMessage(msg: ComposeMessage): Promise<SendResult>;
57
+ replyToMessage(messageId: string, body: string, opts?: ReplyOptions): Promise<SendResult>;
58
+ createDraft(msg: ComposeMessage): Promise<DraftResult>;
59
+ sendDraft(draftId: string): Promise<SendResult>;
60
+ createReplyDraft(messageId: string, body: string, opts?: ReplyOptions): Promise<DraftResult>;
61
+ updateDraft(draftId: string, msg: Partial<ComposeMessage>): Promise<DraftResult>;
62
+ /**
63
+ * Get new inbox messages received after a given timestamp.
64
+ * Uses simple $filter=receivedDateTime gt {since} — instant, no full-inbox sync.
65
+ * This is the primary method for the watcher polling loop.
66
+ */
67
+ getNewMessages(since: string): Promise<EmailMessage[]>;
68
+ /**
69
+ * Delta Query polling — follows all pages.
70
+ * Note: Delta Query requires paging through the ENTIRE inbox on first use,
71
+ * even with $deltatoken=latest. Use getNewMessages() for the watcher instead.
72
+ * This method is kept for scenarios that need full sync (e.g., offline sync).
73
+ */
74
+ getDeltaMessages(deltaLink: string): Promise<DeltaResult>;
75
+ static get egressDomains(): string[];
76
+ private getMessageCategories;
77
+ }
78
+ /**
79
+ * Simplify a search query by stripping field prefixes, boolean operators, and quotes.
80
+ * Returns space-separated keywords suitable for a Graph API $search retry.
81
+ */
82
+ export declare function simplifySearchQuery(query: string): string;
83
+ //# sourceMappingURL=email-graph-provider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"email-graph-provider.d.ts","sourceRoot":"","sources":["../src/email-graph-provider.ts"],"names":[],"mappings":"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"}