@fluxmail/core 0.6.1 → 0.7.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/index.d.ts CHANGED
@@ -3,4 +3,5 @@ export * from './errors.js';
3
3
  export * from './provider.js';
4
4
  export * from './reply.js';
5
5
  export * from './addresses.js';
6
+ export * from './search.js';
6
7
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}
package/dist/index.js CHANGED
@@ -3,4 +3,5 @@ export * from './errors.js';
3
3
  export * from './provider.js';
4
4
  export * from './reply.js';
5
5
  export * from './addresses.js';
6
+ export * from './search.js';
6
7
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}
@@ -0,0 +1,53 @@
1
+ import type { EmailQuery, PortableEmailQuery, PortableFolderRole, SearchCapabilities, SearchDiagnostic, SearchFilter } from './types.js';
2
+ declare const normalizedPortableEmailQuery: unique symbol;
3
+ export type NormalizedPortableEmailQuery = PortableEmailQuery & {
4
+ readonly [normalizedPortableEmailQuery]: true;
5
+ };
6
+ export type NormalizeEmailQueryResult<T> = {
7
+ success: true;
8
+ query: T;
9
+ } | {
10
+ success: false;
11
+ diagnostics: SearchDiagnostic[];
12
+ };
13
+ export interface SearchToken {
14
+ kind: 'text' | 'filter' | 'invalid';
15
+ raw: string;
16
+ value: string;
17
+ start: number;
18
+ end: number;
19
+ field?: SearchFilter;
20
+ }
21
+ export type ParseEmailSearchResult = {
22
+ valid: true;
23
+ query: NormalizedPortableEmailQuery;
24
+ tokens: SearchToken[];
25
+ diagnostics: SearchDiagnostic[];
26
+ } | {
27
+ valid: false;
28
+ query: PortableEmailQuery;
29
+ tokens: SearchToken[];
30
+ diagnostics: SearchDiagnostic[];
31
+ };
32
+ export type SearchRequirement = {
33
+ filter: Exclude<SearchFilter, 'folder'>;
34
+ } | {
35
+ filter: 'folder';
36
+ role: PortableFolderRole;
37
+ };
38
+ export interface PortableEmailQuerySupport {
39
+ supported: boolean;
40
+ unsupported: SearchRequirement[];
41
+ unknown: SearchRequirement[];
42
+ }
43
+ export declare function isPortableFolderRole(value: string): value is PortableFolderRole;
44
+ export declare function normalizeEmailQuery(query: EmailQuery): NormalizeEmailQueryResult<EmailQuery>;
45
+ export declare function normalizePortableEmailQuery(query: PortableEmailQuery): NormalizeEmailQueryResult<NormalizedPortableEmailQuery>;
46
+ export declare function mergeEmailQueries(parsed: PortableEmailQuery, structured: EmailQuery): NormalizeEmailQueryResult<EmailQuery>;
47
+ export declare function parseEmailSearch(input: string): ParseEmailSearchResult;
48
+ export declare function formatEmailSearch(query: NormalizedPortableEmailQuery): string;
49
+ export declare function requiredSearchFilters(query: PortableEmailQuery): SearchRequirement[];
50
+ export declare function supportsPortableEmailQuery(capabilities: SearchCapabilities, query: PortableEmailQuery): PortableEmailQuerySupport;
51
+ export declare function intersectSearchCapabilities(capabilities: readonly SearchCapabilities[]): SearchCapabilities;
52
+ export {};
53
+ //# sourceMappingURL=search.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAElB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,CAAC,MAAM,4BAA4B,EAAE,OAAO,MAAM,CAAC;AAE1D,MAAM,MAAM,4BAA4B,GAAG,kBAAkB,GAAG;IAC9D,QAAQ,CAAC,CAAC,4BAA4B,CAAC,EAAE,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,yBAAyB,CAAC,CAAC,IACnC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC3B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,4BAA4B,CAAC;IACpC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC,GACD;IACE,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC,CAAC;AAEN,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAyDD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAuED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAE5F;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,kBAAkB,GACxB,yBAAyB,CAAC,4BAA4B,CAAC,CAEzD;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,UAAU,GACrB,yBAAyB,CAAC,UAAU,CAAC,CAsBvC;AA4FD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAwJtE;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,4BAA4B,GAAG,MAAM,CAkB7E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,EAAE,CAiBpF;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,kBAAkB,EAChC,KAAK,EAAE,kBAAkB,GACxB,yBAAyB,CAiB3B;AAQD,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,CAwB3G"}
package/dist/search.js ADDED
@@ -0,0 +1,446 @@
1
+ const PORTABLE_FOLDER_ROLES = [
2
+ 'inbox',
3
+ 'sent',
4
+ 'drafts',
5
+ 'archive',
6
+ 'spam',
7
+ 'trash',
8
+ 'all',
9
+ ];
10
+ const PORTABLE_FOLDER_ROLE_SET = new Set(PORTABLE_FOLDER_ROLES);
11
+ const STRING_FIELDS = ['folder', 'text', 'from', 'to', 'subject', 'after', 'before', 'rawProviderQuery'];
12
+ const PORTABLE_STRING_FIELDS = ['text', 'from', 'to', 'subject', 'after', 'before'];
13
+ const DATE_FIELDS = ['after', 'before'];
14
+ const FIELD_OPERATORS = ['from', 'to', 'subject', 'in', 'after', 'before'];
15
+ const VALUE_OPERATORS = [
16
+ 'is:read',
17
+ 'is:unread',
18
+ 'is:starred',
19
+ 'is:unstarred',
20
+ 'has:attachment',
21
+ '-has:attachment',
22
+ ];
23
+ function diagnostic(code, severity, message, lexeme, suggestion) {
24
+ return {
25
+ code,
26
+ severity,
27
+ message,
28
+ ...(lexeme ? { start: lexeme.start, end: lexeme.end } : {}),
29
+ ...(suggestion ? { suggestion } : {}),
30
+ };
31
+ }
32
+ function validDate(value) {
33
+ if (!/^\d{4}-\d{2}-\d{2}$/.test(value))
34
+ return false;
35
+ const parsed = new Date(`${value}T00:00:00.000Z`);
36
+ return !Number.isNaN(parsed.valueOf()) && parsed.toISOString().slice(0, 10) === value;
37
+ }
38
+ export function isPortableFolderRole(value) {
39
+ return PORTABLE_FOLDER_ROLE_SET.has(value);
40
+ }
41
+ function normalizeString(value, collapseWhitespace = false) {
42
+ const trimmed = value.trim();
43
+ return collapseWhitespace ? trimmed.replace(/\s+/g, ' ') : trimmed;
44
+ }
45
+ function normalizeQuery(input, portable) {
46
+ const query = {};
47
+ const diagnostics = [];
48
+ for (const field of STRING_FIELDS) {
49
+ const value = input[field];
50
+ if (value === undefined)
51
+ continue;
52
+ if (typeof value !== 'string') {
53
+ diagnostics.push(diagnostic('invalid_type', 'error', `${field} must be a string.`));
54
+ continue;
55
+ }
56
+ const normalized = normalizeString(value, field === 'text');
57
+ if (!normalized) {
58
+ diagnostics.push(diagnostic('empty_value', 'error', `${field} cannot be empty.`));
59
+ continue;
60
+ }
61
+ query[field] = normalized;
62
+ }
63
+ for (const field of ['read', 'starred', 'hasAttachment']) {
64
+ const value = input[field];
65
+ if (value === undefined)
66
+ continue;
67
+ if (typeof value !== 'boolean') {
68
+ diagnostics.push(diagnostic('invalid_type', 'error', `${field} must be a boolean.`));
69
+ continue;
70
+ }
71
+ query[field] = value;
72
+ }
73
+ if (portable && query.folder !== undefined && !PORTABLE_FOLDER_ROLE_SET.has(query.folder)) {
74
+ diagnostics.push(diagnostic('unsupported_folder', 'error', `in must be one of: ${PORTABLE_FOLDER_ROLES.join(', ')}.`));
75
+ }
76
+ if (portable && query.rawProviderQuery !== undefined) {
77
+ diagnostics.push(diagnostic('unsupported_native_query', 'error', 'rawProviderQuery is not available in portable queries.'));
78
+ }
79
+ if (query.text !== undefined && query.rawProviderQuery !== undefined) {
80
+ diagnostics.push(diagnostic('conflicting_query', 'error', 'text cannot be combined with rawProviderQuery.'));
81
+ }
82
+ for (const field of DATE_FIELDS) {
83
+ const value = query[field];
84
+ if (typeof value === 'string' && !validDate(value)) {
85
+ diagnostics.push(diagnostic('invalid_date', 'error', `${field} must use YYYY-MM-DD.`));
86
+ }
87
+ }
88
+ if (typeof query.after === 'string' &&
89
+ typeof query.before === 'string' &&
90
+ validDate(query.after) &&
91
+ validDate(query.before) &&
92
+ query.after >= query.before) {
93
+ diagnostics.push(diagnostic('invalid_date_range', 'error', 'after must be earlier than before.'));
94
+ }
95
+ if (diagnostics.length)
96
+ return { success: false, diagnostics };
97
+ return { success: true, query: query };
98
+ }
99
+ export function normalizeEmailQuery(query) {
100
+ return normalizeQuery(query, false);
101
+ }
102
+ export function normalizePortableEmailQuery(query) {
103
+ return normalizeQuery(query, true);
104
+ }
105
+ export function mergeEmailQueries(parsed, structured) {
106
+ const diagnostics = [];
107
+ for (const field of [
108
+ 'folder',
109
+ 'text',
110
+ 'from',
111
+ 'to',
112
+ 'subject',
113
+ 'read',
114
+ 'starred',
115
+ 'hasAttachment',
116
+ 'after',
117
+ 'before',
118
+ ]) {
119
+ if (parsed[field] !== undefined && structured[field] !== undefined) {
120
+ diagnostics.push(diagnostic('duplicate_filter', 'error', `${field} is set by both the typed query and a structured filter.`));
121
+ }
122
+ }
123
+ if (diagnostics.length)
124
+ return { success: false, diagnostics };
125
+ return normalizeEmailQuery({ ...parsed, ...structured });
126
+ }
127
+ function lex(input) {
128
+ const lexemes = [];
129
+ let index = 0;
130
+ while (index < input.length) {
131
+ while (index < input.length && /\s/.test(input[index]))
132
+ index += 1;
133
+ if (index >= input.length)
134
+ break;
135
+ const start = index;
136
+ let value = '';
137
+ let quoted = false;
138
+ let inQuote = false;
139
+ let malformed = false;
140
+ while (index < input.length) {
141
+ const character = input[index];
142
+ if (!inQuote && /\s/.test(character))
143
+ break;
144
+ if (character === '"') {
145
+ quoted = true;
146
+ inQuote = !inQuote;
147
+ index += 1;
148
+ continue;
149
+ }
150
+ if (character === '\\' && inQuote) {
151
+ const escaped = input[index + 1];
152
+ if (escaped === '"' || escaped === '\\') {
153
+ value += escaped;
154
+ index += 2;
155
+ continue;
156
+ }
157
+ }
158
+ value += character;
159
+ index += 1;
160
+ }
161
+ if (inQuote)
162
+ malformed = true;
163
+ lexemes.push({ raw: input.slice(start, index), value, start, end: index, quoted, malformed });
164
+ }
165
+ return lexemes;
166
+ }
167
+ function damerauLevenshtein(left, right) {
168
+ const rows = left.length + 1;
169
+ const columns = right.length + 1;
170
+ const matrix = Array.from({ length: rows }, () => Array(columns).fill(0));
171
+ for (let row = 0; row < rows; row += 1)
172
+ matrix[row][0] = row;
173
+ for (let column = 0; column < columns; column += 1)
174
+ matrix[0][column] = column;
175
+ for (let row = 1; row < rows; row += 1) {
176
+ for (let column = 1; column < columns; column += 1) {
177
+ const cost = left[row - 1] === right[column - 1] ? 0 : 1;
178
+ matrix[row][column] = Math.min(matrix[row - 1][column] + 1, matrix[row][column - 1] + 1, matrix[row - 1][column - 1] + cost);
179
+ if (row > 1 && column > 1 && left[row - 1] === right[column - 2] && left[row - 2] === right[column - 1]) {
180
+ matrix[row][column] = Math.min(matrix[row][column], matrix[row - 2][column - 2] + cost);
181
+ }
182
+ }
183
+ }
184
+ return matrix[left.length][right.length];
185
+ }
186
+ function typoSuggestion(value) {
187
+ const normalized = value.toLowerCase();
188
+ const valueOperator = VALUE_OPERATORS.find((candidate) => damerauLevenshtein(normalized, candidate) === 1);
189
+ if (valueOperator)
190
+ return valueOperator;
191
+ const separator = normalized.indexOf(':');
192
+ const field = separator > 0 ? normalized.slice(0, separator) : normalized;
193
+ return FIELD_OPERATORS.find((candidate) => damerauLevenshtein(field, candidate) === 1);
194
+ }
195
+ function literalToken(lexeme, tokens, text) {
196
+ tokens.push({
197
+ kind: 'text',
198
+ raw: lexeme.raw,
199
+ value: lexeme.value,
200
+ start: lexeme.start,
201
+ end: lexeme.end,
202
+ });
203
+ if (lexeme.value)
204
+ text.push(lexeme.value);
205
+ }
206
+ function invalidToken(lexeme, tokens) {
207
+ tokens.push({
208
+ kind: 'invalid',
209
+ raw: lexeme.raw,
210
+ value: lexeme.value,
211
+ start: lexeme.start,
212
+ end: lexeme.end,
213
+ });
214
+ }
215
+ export function parseEmailSearch(input) {
216
+ const query = {};
217
+ const tokens = [];
218
+ const diagnostics = [];
219
+ const text = [];
220
+ const assigned = new Map();
221
+ if (!input.trim()) {
222
+ const normalized = normalizePortableEmailQuery(query);
223
+ if (normalized.success) {
224
+ return {
225
+ valid: true,
226
+ query: normalized.query,
227
+ tokens,
228
+ diagnostics,
229
+ };
230
+ }
231
+ return {
232
+ valid: false,
233
+ query,
234
+ tokens,
235
+ diagnostics: normalized.diagnostics,
236
+ };
237
+ }
238
+ const assign = (field, value, lexeme) => {
239
+ if (assigned.has(field)) {
240
+ diagnostics.push(diagnostic('duplicate_filter', 'error', `${field} is specified more than once.`, lexeme));
241
+ invalidToken(lexeme, tokens);
242
+ return false;
243
+ }
244
+ assigned.set(field, lexeme);
245
+ Object.assign(query, { [field]: value });
246
+ tokens.push({
247
+ kind: 'filter',
248
+ raw: lexeme.raw,
249
+ value: String(value),
250
+ start: lexeme.start,
251
+ end: lexeme.end,
252
+ field: field === 'folder' ? 'folder' : field,
253
+ });
254
+ return true;
255
+ };
256
+ for (const lexeme of lex(input)) {
257
+ if (lexeme.malformed) {
258
+ diagnostics.push(diagnostic('malformed_quote', 'error', 'This quoted value is not closed.', lexeme));
259
+ invalidToken(lexeme, tokens);
260
+ continue;
261
+ }
262
+ const lower = lexeme.value.toLowerCase();
263
+ const quotedLiteral = lexeme.quoted && lexeme.raw.startsWith('"');
264
+ if (quotedLiteral) {
265
+ if (!lexeme.value) {
266
+ diagnostics.push(diagnostic('empty_value', 'error', 'Quoted search text cannot be empty.', lexeme));
267
+ invalidToken(lexeme, tokens);
268
+ continue;
269
+ }
270
+ literalToken(lexeme, tokens, text);
271
+ continue;
272
+ }
273
+ const booleanOperator = {
274
+ 'is:read': ['read', true],
275
+ 'is:unread': ['read', false],
276
+ 'is:starred': ['starred', true],
277
+ 'is:unstarred': ['starred', false],
278
+ 'has:attachment': ['hasAttachment', true],
279
+ '-has:attachment': ['hasAttachment', false],
280
+ };
281
+ const boolean = booleanOperator[lower];
282
+ if (boolean) {
283
+ assign(boolean[0], boolean[1], lexeme);
284
+ continue;
285
+ }
286
+ const separator = lexeme.value.indexOf(':');
287
+ const operator = separator > 0 ? lexeme.value.slice(0, separator).toLowerCase() : '';
288
+ const value = separator > 0 ? lexeme.value.slice(separator + 1) : '';
289
+ if (FIELD_OPERATORS.includes(operator)) {
290
+ if (!value) {
291
+ diagnostics.push(diagnostic('missing_value', 'error', `${operator}: requires a value.`, lexeme));
292
+ invalidToken(lexeme, tokens);
293
+ continue;
294
+ }
295
+ if (operator === 'in') {
296
+ if (!PORTABLE_FOLDER_ROLE_SET.has(value.toLowerCase())) {
297
+ diagnostics.push(diagnostic('unsupported_folder', 'error', `in: accepts ${PORTABLE_FOLDER_ROLES.join(', ')}. Use folder discovery for custom folders.`, lexeme));
298
+ invalidToken(lexeme, tokens);
299
+ continue;
300
+ }
301
+ assign('folder', value.toLowerCase(), lexeme);
302
+ continue;
303
+ }
304
+ const field = operator;
305
+ if ((field === 'after' || field === 'before') && !validDate(value)) {
306
+ diagnostics.push(diagnostic('invalid_date', 'error', `${field}: must use YYYY-MM-DD.`, lexeme));
307
+ invalidToken(lexeme, tokens);
308
+ continue;
309
+ }
310
+ assign(field, value, lexeme);
311
+ continue;
312
+ }
313
+ const isUrl = /^[a-z][a-z\d+.-]*:\/\//i.test(lexeme.value);
314
+ const isTime = /^\d{1,2}:\d{2}(?::\d{2})?(?:[ap]m)?$/i.test(lexeme.value);
315
+ if (!lexeme.quoted && !isUrl && !isTime) {
316
+ const suggestion = typoSuggestion(lower);
317
+ if (suggestion) {
318
+ diagnostics.push(diagnostic('possible_operator_typo', 'warning', `Did you mean ${suggestion}${separator > 0 && !suggestion.includes(':') ? ':' : ''}?`, lexeme, suggestion));
319
+ }
320
+ }
321
+ literalToken(lexeme, tokens, text);
322
+ }
323
+ if (text.length)
324
+ query.text = text.join(' ').replace(/\s+/g, ' ').trim();
325
+ if (query.after && query.before && query.after >= query.before) {
326
+ const afterToken = assigned.get('after');
327
+ const beforeToken = assigned.get('before');
328
+ const rejectedField = afterToken.start > beforeToken.start ? 'after' : 'before';
329
+ const rejectedToken = assigned.get(rejectedField);
330
+ delete query[rejectedField];
331
+ const token = tokens.find((candidate) => candidate.start === rejectedToken.start && candidate.end === rejectedToken.end);
332
+ if (token) {
333
+ token.kind = 'invalid';
334
+ delete token.field;
335
+ }
336
+ diagnostics.push(diagnostic('invalid_date_range', 'error', 'after must be earlier than before.', rejectedToken));
337
+ }
338
+ const normalized = normalizePortableEmailQuery(query);
339
+ if (!normalized.success)
340
+ diagnostics.push(...normalized.diagnostics);
341
+ const valid = !diagnostics.some((item) => item.severity === 'error') && normalized.success;
342
+ if (valid)
343
+ return { valid: true, query: normalized.query, tokens, diagnostics };
344
+ return { valid: false, query, tokens, diagnostics };
345
+ }
346
+ function quote(value) {
347
+ return `"${value.replaceAll('\\', '\\\\').replaceAll('"', '\\"')}"`;
348
+ }
349
+ export function formatEmailSearch(query) {
350
+ const normalized = normalizePortableEmailQuery(query);
351
+ if (!normalized.success || query.rawProviderQuery !== undefined) {
352
+ throw new TypeError('formatEmailSearch requires a normalized portable email query.');
353
+ }
354
+ const q = normalized.query;
355
+ const parts = [];
356
+ if (q.folder)
357
+ parts.push(`in:${q.folder}`);
358
+ if (q.from)
359
+ parts.push(`from:${quote(q.from)}`);
360
+ if (q.to)
361
+ parts.push(`to:${quote(q.to)}`);
362
+ if (q.subject)
363
+ parts.push(`subject:${quote(q.subject)}`);
364
+ if (q.read !== undefined)
365
+ parts.push(q.read ? 'is:read' : 'is:unread');
366
+ if (q.starred !== undefined)
367
+ parts.push(q.starred ? 'is:starred' : 'is:unstarred');
368
+ if (q.hasAttachment !== undefined)
369
+ parts.push(q.hasAttachment ? 'has:attachment' : '-has:attachment');
370
+ if (q.after)
371
+ parts.push(`after:${q.after}`);
372
+ if (q.before)
373
+ parts.push(`before:${q.before}`);
374
+ if (q.text)
375
+ parts.push(quote(q.text));
376
+ return parts.join(' ');
377
+ }
378
+ export function requiredSearchFilters(query) {
379
+ const requirements = [];
380
+ if (query.folder)
381
+ requirements.push({ filter: 'folder', role: query.folder });
382
+ for (const filter of [
383
+ 'text',
384
+ 'from',
385
+ 'to',
386
+ 'subject',
387
+ 'read',
388
+ 'starred',
389
+ 'hasAttachment',
390
+ 'after',
391
+ 'before',
392
+ ]) {
393
+ if (query[filter] !== undefined)
394
+ requirements.push({ filter });
395
+ }
396
+ return requirements;
397
+ }
398
+ export function supportsPortableEmailQuery(capabilities, query) {
399
+ const unsupported = [];
400
+ const unknown = [];
401
+ for (const requirement of requiredSearchFilters(query)) {
402
+ if (requirement.filter === 'folder') {
403
+ if (!capabilities.filters.includes('folder')) {
404
+ unsupported.push(requirement);
405
+ continue;
406
+ }
407
+ const availability = capabilities.folderRoles[requirement.role];
408
+ if (availability === 'unavailable')
409
+ unsupported.push(requirement);
410
+ if (availability === 'unknown')
411
+ unknown.push(requirement);
412
+ }
413
+ else if (!capabilities.filters.includes(requirement.filter)) {
414
+ unsupported.push(requirement);
415
+ }
416
+ }
417
+ return { supported: unsupported.length === 0 && unknown.length === 0, unsupported, unknown };
418
+ }
419
+ function intersectAvailability(values) {
420
+ if (values.includes('unavailable'))
421
+ return 'unavailable';
422
+ if (values.includes('unknown'))
423
+ return 'unknown';
424
+ return 'available';
425
+ }
426
+ export function intersectSearchCapabilities(capabilities) {
427
+ const filters = capabilities.length
428
+ ? capabilities[0].filters.filter((filter) => capabilities.slice(1).every((candidate) => candidate.filters.includes(filter)))
429
+ : [];
430
+ const folderRoles = Object.fromEntries(PORTABLE_FOLDER_ROLES.map((role) => [
431
+ role,
432
+ capabilities.length
433
+ ? intersectAvailability(capabilities.map((candidate) => candidate.folderRoles[role]))
434
+ : 'unknown',
435
+ ]));
436
+ const native = capabilities.map((candidate) => candidate.nativeQuery);
437
+ const syntax = native[0]?.syntax;
438
+ const nativeQuery = syntax && native.every((candidate) => candidate?.syntax === syntax)
439
+ ? {
440
+ syntax,
441
+ availability: intersectAvailability(native.map((candidate) => candidate.availability)),
442
+ }
443
+ : null;
444
+ return { filters, folderRoles, nativeQuery };
445
+ }
446
+ //# sourceMappingURL=search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -1,11 +1,25 @@
1
1
  export type Provider = 'gmail' | 'outlook' | 'imap';
2
+ export type PortableFolderRole = 'inbox' | 'sent' | 'drafts' | 'archive' | 'spam' | 'trash' | 'all';
3
+ export type SearchAvailability = 'available' | 'unavailable' | 'unknown';
4
+ export type SearchFilter = 'folder' | 'text' | 'from' | 'to' | 'subject' | 'read' | 'starred' | 'hasAttachment' | 'after' | 'before';
5
+ export interface SearchCapabilities {
6
+ filters: SearchFilter[];
7
+ folderRoles: Record<PortableFolderRole, SearchAvailability>;
8
+ nativeQuery: null | {
9
+ syntax: 'gmail' | 'outlook-kql';
10
+ availability: SearchAvailability;
11
+ unavailableReason?: string;
12
+ };
13
+ }
2
14
  export interface Capabilities {
3
15
  /** Gmail labels and Outlook categories. */
4
16
  labels: boolean;
5
17
  /** Gmail/Outlook thread server-side; IMAP threads are synthesized from References headers. */
6
18
  serverThreads: boolean;
7
- /** Gmail q= / Graph $search vs IMAP SEARCH. */
19
+ /** @deprecated Use search capabilities instead. */
8
20
  serverSearch: 'rich' | 'basic';
21
+ /** Search behavior available for this account. */
22
+ search: SearchCapabilities;
9
23
  /** Whether list results include snippets without fetching bodies. */
10
24
  snippets: boolean;
11
25
  }
@@ -139,27 +153,43 @@ export type ModifyAction = 'markRead' | 'markUnread' | 'star' | 'unstar' | 'arch
139
153
  export interface EmailQuery {
140
154
  /** Folder id or role. An omitted folder uses All Mail, excluding Spam and Trash. */
141
155
  folder?: string;
142
- /** Full-text search. */
156
+ /** Literal full-text search. Provider operators are escaped. */
143
157
  text?: string;
144
158
  from?: string;
145
159
  to?: string;
146
160
  subject?: string;
147
- unreadOnly?: boolean;
148
- starredOnly?: boolean;
161
+ read?: boolean;
162
+ starred?: boolean;
149
163
  hasAttachment?: boolean;
150
- /** ISO date (inclusive). */
164
+ /** YYYY-MM-DD received/internal date (inclusive, UTC). */
151
165
  after?: string;
152
- /** ISO date (exclusive). */
166
+ /** YYYY-MM-DD received/internal date (exclusive, UTC). */
153
167
  before?: string;
154
168
  /** Escape hatch: passed to the provider verbatim (e.g. Gmail q=). */
155
169
  rawProviderQuery?: string;
156
170
  }
171
+ export interface PortableEmailQuery extends Omit<EmailQuery, 'folder' | 'rawProviderQuery'> {
172
+ folder?: PortableFolderRole;
173
+ }
157
174
  export interface PageOpts {
158
175
  pageSize?: number;
159
176
  pageToken?: string;
160
177
  }
178
+ export type SearchDiagnosticSeverity = 'error' | 'warning';
179
+ export interface SearchDiagnostic {
180
+ code: string;
181
+ severity: SearchDiagnosticSeverity;
182
+ message: string;
183
+ start?: number;
184
+ end?: number;
185
+ suggestion?: string;
186
+ }
161
187
  export interface Page<T> {
162
188
  items: T[];
163
189
  nextPageToken?: string;
190
+ diagnostics?: SearchDiagnostic[];
191
+ incomplete?: true;
192
+ incompleteReason?: 'scan_limit' | 'provider_limit';
193
+ inspectedCandidates?: number;
164
194
  }
165
195
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEpG,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAEzE,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,MAAM,GACN,MAAM,GACN,IAAI,GACJ,SAAS,GACT,MAAM,GACN,SAAS,GACT,eAAe,GACf,OAAO,GACP,QAAQ,CAAC;AAEb,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAC5D,WAAW,EAAE,IAAI,GAAG;QAClB,MAAM,EAAE,OAAO,GAAG,aAAa,CAAC;QAChC,YAAY,EAAE,kBAAkB,CAAC;QACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,8FAA8F;IAC9F,aAAa,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,kDAAkD;IAClD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;IAC7C,YAAY,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,aAAa,EAAE,OAAO,CAAC;IACvB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;AAExG,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE;QACN,oCAAoC;QACpC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,8BAA8B;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,0CAA0C;QAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,EAAE,EAAE,YAAY,EAAE,CAAC;IACnB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;CACvC;AAED,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;IACpB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;IACrB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GACvB;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE/B,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,kBAAkB,CAAC;IACzF,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,wBAAwB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,gBAAgB,CAAC,EAAE,YAAY,GAAG,gBAAgB,CAAC;IACnD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fluxmail/core",
3
- "version": "0.6.1",
3
+ "version": "0.7.0",
4
4
  "description": "Unified email types and provider interface for Fluxmail",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "repository": {