@teamnetwork-nz/mailstore-spe-mcp 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/README.md +360 -0
- package/dist/config/env.d.ts +14 -0
- package/dist/config/env.js +45 -0
- package/dist/config/env.js.map +1 -0
- package/dist/config/schema.d.ts +86 -0
- package/dist/config/schema.js +55 -0
- package/dist/config/schema.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +60 -0
- package/dist/index.js.map +1 -0
- package/dist/logging/logger.d.ts +12 -0
- package/dist/logging/logger.js +80 -0
- package/dist/logging/logger.js.map +1 -0
- package/dist/mailstore/authentication.d.ts +7 -0
- package/dist/mailstore/authentication.js +15 -0
- package/dist/mailstore/authentication.js.map +1 -0
- package/dist/mailstore/capability-registry.d.ts +40 -0
- package/dist/mailstore/capability-registry.js +152 -0
- package/dist/mailstore/capability-registry.js.map +1 -0
- package/dist/mailstore/client.d.ts +33 -0
- package/dist/mailstore/client.js +274 -0
- package/dist/mailstore/client.js.map +1 -0
- package/dist/mailstore/encoder.d.ts +14 -0
- package/dist/mailstore/encoder.js +42 -0
- package/dist/mailstore/encoder.js.map +1 -0
- package/dist/mailstore/errors.d.ts +44 -0
- package/dist/mailstore/errors.js +49 -0
- package/dist/mailstore/errors.js.map +1 -0
- package/dist/mailstore/instance-resolver.d.ts +43 -0
- package/dist/mailstore/instance-resolver.js +143 -0
- package/dist/mailstore/instance-resolver.js.map +1 -0
- package/dist/mailstore/metadata.d.ts +21 -0
- package/dist/mailstore/metadata.js +50 -0
- package/dist/mailstore/metadata.js.map +1 -0
- package/dist/mailstore/operation-poller.d.ts +19 -0
- package/dist/mailstore/operation-poller.js +72 -0
- package/dist/mailstore/operation-poller.js.map +1 -0
- package/dist/mailstore/response-parser.d.ts +11 -0
- package/dist/mailstore/response-parser.js +66 -0
- package/dist/mailstore/response-parser.js.map +1 -0
- package/dist/mailstore/types.d.ts +79 -0
- package/dist/mailstore/types.js +6 -0
- package/dist/mailstore/types.js.map +1 -0
- package/dist/output/normalizers.d.ts +11 -0
- package/dist/output/normalizers.js +40 -0
- package/dist/output/normalizers.js.map +1 -0
- package/dist/output/tool-result.d.ts +30 -0
- package/dist/output/tool-result.js +24 -0
- package/dist/output/tool-result.js.map +1 -0
- package/dist/output/truncation.d.ts +17 -0
- package/dist/output/truncation.js +27 -0
- package/dist/output/truncation.js.map +1 -0
- package/dist/policy/access-mode.d.ts +16 -0
- package/dist/policy/access-mode.js +21 -0
- package/dist/policy/access-mode.js.map +1 -0
- package/dist/policy/confirmations.d.ts +24 -0
- package/dist/policy/confirmations.js +49 -0
- package/dist/policy/confirmations.js.map +1 -0
- package/dist/policy/redaction.d.ts +15 -0
- package/dist/policy/redaction.js +63 -0
- package/dist/policy/redaction.js.map +1 -0
- package/dist/policy/tool-policy.d.ts +15 -0
- package/dist/policy/tool-policy.js +2 -0
- package/dist/policy/tool-policy.js.map +1 -0
- package/dist/resources/health.d.ts +17 -0
- package/dist/resources/health.js +55 -0
- package/dist/resources/health.js.map +1 -0
- package/dist/resources/register-resources.d.ts +7 -0
- package/dist/resources/register-resources.js +37 -0
- package/dist/resources/register-resources.js.map +1 -0
- package/dist/server.d.ts +17 -0
- package/dist/server.js +62 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/compliance.d.ts +6 -0
- package/dist/tools/compliance.js +96 -0
- package/dist/tools/compliance.js.map +1 -0
- package/dist/tools/instances.d.ts +4 -0
- package/dist/tools/instances.js +197 -0
- package/dist/tools/instances.js.map +1 -0
- package/dist/tools/jobs.d.ts +2 -0
- package/dist/tools/jobs.js +125 -0
- package/dist/tools/jobs.js.map +1 -0
- package/dist/tools/maintenance.d.ts +3 -0
- package/dist/tools/maintenance.js +22 -0
- package/dist/tools/maintenance.js.map +1 -0
- package/dist/tools/platform.d.ts +4 -0
- package/dist/tools/platform.js +134 -0
- package/dist/tools/platform.js.map +1 -0
- package/dist/tools/profiles.d.ts +2 -0
- package/dist/tools/profiles.js +140 -0
- package/dist/tools/profiles.js.map +1 -0
- package/dist/tools/raw-api.d.ts +16 -0
- package/dist/tools/raw-api.js +109 -0
- package/dist/tools/raw-api.js.map +1 -0
- package/dist/tools/register-tools.d.ts +14 -0
- package/dist/tools/register-tools.js +121 -0
- package/dist/tools/register-tools.js.map +1 -0
- package/dist/tools/smtp.d.ts +2 -0
- package/dist/tools/smtp.js +39 -0
- package/dist/tools/smtp.js.map +1 -0
- package/dist/tools/stores.d.ts +2 -0
- package/dist/tools/stores.js +116 -0
- package/dist/tools/stores.js.map +1 -0
- package/dist/tools/tool.d.ts +41 -0
- package/dist/tools/tool.js +33 -0
- package/dist/tools/tool.js.map +1 -0
- package/dist/tools/users.d.ts +2 -0
- package/dist/tools/users.js +266 -0
- package/dist/tools/users.js.map +1 -0
- package/package.json +52 -0
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import pino, {} from 'pino';
|
|
2
|
+
import { isSensitiveKey } from '../policy/redaction.js';
|
|
3
|
+
/** Pino redaction paths for well-known top-level fields. */
|
|
4
|
+
const REDACT_PATHS = [
|
|
5
|
+
'password',
|
|
6
|
+
'passphrase',
|
|
7
|
+
'secret',
|
|
8
|
+
'token',
|
|
9
|
+
'authorization',
|
|
10
|
+
'apiPassword',
|
|
11
|
+
'encryptionKey',
|
|
12
|
+
'privateKey',
|
|
13
|
+
'certificate',
|
|
14
|
+
'*.password',
|
|
15
|
+
'*.passphrase',
|
|
16
|
+
'*.secret',
|
|
17
|
+
'*.token',
|
|
18
|
+
'*.authorization',
|
|
19
|
+
];
|
|
20
|
+
let rootLogger;
|
|
21
|
+
export function initLogger(opts) {
|
|
22
|
+
const pinoOptions = {
|
|
23
|
+
level: opts.level,
|
|
24
|
+
redact: { paths: REDACT_PATHS, censor: '[REDACTED]' },
|
|
25
|
+
formatters: {
|
|
26
|
+
level: (label) => ({ level: label }),
|
|
27
|
+
},
|
|
28
|
+
timestamp: pino.stdTimeFunctions.isoTime,
|
|
29
|
+
// Deep-redact any object appearing under a sensitive key in bound fields.
|
|
30
|
+
serializers: {
|
|
31
|
+
args: deepRedactSerializer,
|
|
32
|
+
result: deepRedactSerializer,
|
|
33
|
+
data: deepRedactSerializer,
|
|
34
|
+
},
|
|
35
|
+
};
|
|
36
|
+
// Pretty transport is dev-only and requires the optional pino-pretty package;
|
|
37
|
+
// fall back to JSON on stderr if it is not installed (e.g. production image).
|
|
38
|
+
let destination = pino.destination(2);
|
|
39
|
+
if (opts.format === 'pretty') {
|
|
40
|
+
try {
|
|
41
|
+
destination = pino.transport({
|
|
42
|
+
target: 'pino-pretty',
|
|
43
|
+
options: { destination: 2, colorize: true },
|
|
44
|
+
});
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
// keep JSON destination
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
rootLogger = pino(pinoOptions, destination);
|
|
51
|
+
return rootLogger;
|
|
52
|
+
}
|
|
53
|
+
export function getLogger() {
|
|
54
|
+
if (!rootLogger) {
|
|
55
|
+
// Safe fallback before init (e.g. very early errors): JSON to stderr.
|
|
56
|
+
rootLogger = pino({ level: 'info' }, pino.destination(2));
|
|
57
|
+
}
|
|
58
|
+
return rootLogger;
|
|
59
|
+
}
|
|
60
|
+
/** Serializer that walks a value and redacts sensitive keys at any depth. */
|
|
61
|
+
function deepRedactSerializer(value) {
|
|
62
|
+
return walk(value, 8, new WeakSet());
|
|
63
|
+
}
|
|
64
|
+
function walk(value, depth, seen) {
|
|
65
|
+
if (value === null || typeof value !== 'object')
|
|
66
|
+
return value;
|
|
67
|
+
if (depth <= 0)
|
|
68
|
+
return '[TRUNCATED]';
|
|
69
|
+
if (seen.has(value))
|
|
70
|
+
return '[CIRCULAR]';
|
|
71
|
+
seen.add(value);
|
|
72
|
+
if (Array.isArray(value))
|
|
73
|
+
return value.map((v) => walk(v, depth - 1, seen));
|
|
74
|
+
const out = {};
|
|
75
|
+
for (const [k, v] of Object.entries(value)) {
|
|
76
|
+
out[k] = isSensitiveKey(k) ? '[REDACTED]' : walk(v, depth - 1, seen);
|
|
77
|
+
}
|
|
78
|
+
return out;
|
|
79
|
+
}
|
|
80
|
+
//# sourceMappingURL=logger.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* HTTP Basic authentication header construction.
|
|
3
|
+
*
|
|
4
|
+
* The header is built in memory and must never be logged or returned in any MCP
|
|
5
|
+
* response. Callers hold the returned string only for the lifetime of a request.
|
|
6
|
+
*/
|
|
7
|
+
export declare function buildBasicAuthHeader(username: string, password: string): string;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* HTTP Basic authentication header construction.
|
|
3
|
+
*
|
|
4
|
+
* The header is built in memory and must never be logged or returned in any MCP
|
|
5
|
+
* response. Callers hold the returned string only for the lifetime of a request.
|
|
6
|
+
*/
|
|
7
|
+
export function buildBasicAuthHeader(username, password) {
|
|
8
|
+
if (!username || !password) {
|
|
9
|
+
// Fail closed — missing credentials must not produce an anonymous request.
|
|
10
|
+
throw new Error('MailStore credentials are not configured');
|
|
11
|
+
}
|
|
12
|
+
const token = Buffer.from(`${username}:${password}`, 'utf-8').toString('base64');
|
|
13
|
+
return `Basic ${token}`;
|
|
14
|
+
}
|
|
15
|
+
//# sourceMappingURL=authentication.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"authentication.js","sourceRoot":"","sources":["../../src/mailstore/authentication.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,QAAgB;IACrE,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3B,2EAA2E;QAC3E,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjF,OAAO,SAAS,KAAK,EAAE,CAAC;AAC1B,CAAC"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type { Logger } from 'pino';
|
|
2
|
+
import type { ApiArgument, ApiFunctionMetadata } from './types.js';
|
|
3
|
+
import type { MetadataService } from './metadata.js';
|
|
4
|
+
/**
|
|
5
|
+
* Functions the read-only core depends on. If any is missing from the live
|
|
6
|
+
* metadata, startup fails (§9.1) — the server would be broken without them.
|
|
7
|
+
*/
|
|
8
|
+
export declare const ESSENTIAL_FUNCTIONS: readonly ["Ping", "GetEnvironmentInfo", "GetServiceStatus", "GetInstances"];
|
|
9
|
+
/**
|
|
10
|
+
* Functions used by individual tools. If missing, only the dependent tool is
|
|
11
|
+
* disabled (with a warning), not the whole server.
|
|
12
|
+
*/
|
|
13
|
+
export declare const OPTIONAL_FUNCTIONS: readonly ["GetInstanceHosts", "GetClientAccessServers", "GetInstanceConfiguration", "GetInstanceStatistics", "GetInstanceProcessLiveStatistics", "GetFolderStatistics", "GetStores", "GetUsers", "GetUserInfo", "GetProfiles", "GetJobs", "GetSmtpSettings", "GetComplianceConfiguration", "GetRetentionPolicies", "GetWorkerResults", "GetWorkerResultReport", "GetJobResults", "StartInstances", "StopInstances", "RestartInstances", "RunProfile", "RunJobAsync", "CancelJobAsync", "TestSmtpSettings", "RefreshAllStoreStatistics", "VerifyStore", "VerifyStores", "SyncUsersWithDirectoryServices", "CreateUser", "SetUserEmailAddresses", "SetUserFullName", "SetUserAuthentication", "SetUserDistinguishedName", "SetUserLoginPrivileges", "SetUserPrivileges", "SetUserPrivilegesOnFolder", "SetUserPop3UserNames", "SetUserPassword", "DeleteUser", "SetRetentionPolicies"];
|
|
14
|
+
/**
|
|
15
|
+
* Registry built from live metadata. Validates that a function exists and that
|
|
16
|
+
* arguments match its declared parameters before any invocation (§9.2), and
|
|
17
|
+
* converts MCP argument values into MailStore form values.
|
|
18
|
+
*/
|
|
19
|
+
export declare class CapabilityRegistry {
|
|
20
|
+
private readonly metadata;
|
|
21
|
+
private readonly logger;
|
|
22
|
+
private byName;
|
|
23
|
+
constructor(metadata: MetadataService, logger: Logger);
|
|
24
|
+
/** Load metadata and index it. Throws if an essential function is missing. */
|
|
25
|
+
initialize(): Promise<void>;
|
|
26
|
+
reload(): Promise<void>;
|
|
27
|
+
has(functionName: string): boolean;
|
|
28
|
+
/** True only if every named function is available. */
|
|
29
|
+
hasAll(functionNames: readonly string[]): boolean;
|
|
30
|
+
get(functionName: string): ApiFunctionMetadata | undefined;
|
|
31
|
+
get functionCount(): number;
|
|
32
|
+
/**
|
|
33
|
+
* Validate a call against metadata and return the arguments to send. Rejects
|
|
34
|
+
* unknown functions and (unless allowUnknownArgs) unknown parameters, and
|
|
35
|
+
* enforces non-nullable required arguments that are present-but-null.
|
|
36
|
+
*/
|
|
37
|
+
validateCall(functionName: string, args: Record<string, ApiArgument>, opts?: {
|
|
38
|
+
allowUnknownArgs?: boolean;
|
|
39
|
+
}): Record<string, ApiArgument>;
|
|
40
|
+
}
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
import { Errors } from './errors.js';
|
|
2
|
+
/**
|
|
3
|
+
* Functions the read-only core depends on. If any is missing from the live
|
|
4
|
+
* metadata, startup fails (§9.1) — the server would be broken without them.
|
|
5
|
+
*/
|
|
6
|
+
export const ESSENTIAL_FUNCTIONS = [
|
|
7
|
+
'Ping',
|
|
8
|
+
'GetEnvironmentInfo',
|
|
9
|
+
'GetServiceStatus',
|
|
10
|
+
'GetInstances',
|
|
11
|
+
];
|
|
12
|
+
/**
|
|
13
|
+
* Functions used by individual tools. If missing, only the dependent tool is
|
|
14
|
+
* disabled (with a warning), not the whole server.
|
|
15
|
+
*/
|
|
16
|
+
export const OPTIONAL_FUNCTIONS = [
|
|
17
|
+
'GetInstanceHosts',
|
|
18
|
+
'GetClientAccessServers',
|
|
19
|
+
'GetInstanceConfiguration',
|
|
20
|
+
'GetInstanceStatistics',
|
|
21
|
+
'GetInstanceProcessLiveStatistics',
|
|
22
|
+
'GetFolderStatistics',
|
|
23
|
+
'GetStores',
|
|
24
|
+
'GetUsers',
|
|
25
|
+
'GetUserInfo',
|
|
26
|
+
'GetProfiles',
|
|
27
|
+
'GetJobs',
|
|
28
|
+
'GetSmtpSettings',
|
|
29
|
+
'GetComplianceConfiguration',
|
|
30
|
+
'GetRetentionPolicies',
|
|
31
|
+
'GetWorkerResults',
|
|
32
|
+
'GetWorkerResultReport',
|
|
33
|
+
'GetJobResults',
|
|
34
|
+
'StartInstances',
|
|
35
|
+
'StopInstances',
|
|
36
|
+
'RestartInstances',
|
|
37
|
+
'RunProfile',
|
|
38
|
+
'RunJobAsync',
|
|
39
|
+
'CancelJobAsync',
|
|
40
|
+
'TestSmtpSettings',
|
|
41
|
+
'RefreshAllStoreStatistics',
|
|
42
|
+
'VerifyStore',
|
|
43
|
+
'VerifyStores',
|
|
44
|
+
'SyncUsersWithDirectoryServices',
|
|
45
|
+
'CreateUser',
|
|
46
|
+
'SetUserEmailAddresses',
|
|
47
|
+
'SetUserFullName',
|
|
48
|
+
'SetUserAuthentication',
|
|
49
|
+
'SetUserDistinguishedName',
|
|
50
|
+
'SetUserLoginPrivileges',
|
|
51
|
+
'SetUserPrivileges',
|
|
52
|
+
'SetUserPrivilegesOnFolder',
|
|
53
|
+
'SetUserPop3UserNames',
|
|
54
|
+
'SetUserPassword',
|
|
55
|
+
'DeleteUser',
|
|
56
|
+
'SetRetentionPolicies',
|
|
57
|
+
];
|
|
58
|
+
/**
|
|
59
|
+
* Registry built from live metadata. Validates that a function exists and that
|
|
60
|
+
* arguments match its declared parameters before any invocation (§9.2), and
|
|
61
|
+
* converts MCP argument values into MailStore form values.
|
|
62
|
+
*/
|
|
63
|
+
export class CapabilityRegistry {
|
|
64
|
+
metadata;
|
|
65
|
+
logger;
|
|
66
|
+
byName = new Map();
|
|
67
|
+
constructor(metadata, logger) {
|
|
68
|
+
this.metadata = metadata;
|
|
69
|
+
this.logger = logger;
|
|
70
|
+
}
|
|
71
|
+
/** Load metadata and index it. Throws if an essential function is missing. */
|
|
72
|
+
async initialize() {
|
|
73
|
+
await this.reload();
|
|
74
|
+
const missingEssential = ESSENTIAL_FUNCTIONS.filter((f) => !this.byName.has(f));
|
|
75
|
+
if (missingEssential.length > 0) {
|
|
76
|
+
throw Errors.config(`MailStore metadata is missing essential functions: ${missingEssential.join(', ')}`, { missingEssential });
|
|
77
|
+
}
|
|
78
|
+
const missingOptional = OPTIONAL_FUNCTIONS.filter((f) => !this.byName.has(f));
|
|
79
|
+
this.logger.info({
|
|
80
|
+
totalFunctions: this.byName.size,
|
|
81
|
+
essentialPresent: ESSENTIAL_FUNCTIONS.length - missingEssential.length,
|
|
82
|
+
optionalMissing: missingOptional.length,
|
|
83
|
+
}, 'capability registry initialised');
|
|
84
|
+
if (missingOptional.length > 0) {
|
|
85
|
+
this.logger.warn({ missingOptional }, 'some optional functions are unavailable; dependent tools will be disabled');
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
async reload() {
|
|
89
|
+
const fns = await this.metadata.get(true);
|
|
90
|
+
this.byName = new Map(fns.map((f) => [f.name, f]));
|
|
91
|
+
}
|
|
92
|
+
has(functionName) {
|
|
93
|
+
return this.byName.has(functionName);
|
|
94
|
+
}
|
|
95
|
+
/** True only if every named function is available. */
|
|
96
|
+
hasAll(functionNames) {
|
|
97
|
+
return functionNames.every((f) => this.byName.has(f));
|
|
98
|
+
}
|
|
99
|
+
get(functionName) {
|
|
100
|
+
return this.byName.get(functionName);
|
|
101
|
+
}
|
|
102
|
+
get functionCount() {
|
|
103
|
+
return this.byName.size;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Validate a call against metadata and return the arguments to send. Rejects
|
|
107
|
+
* unknown functions and (unless allowUnknownArgs) unknown parameters, and
|
|
108
|
+
* enforces non-nullable required arguments that are present-but-null.
|
|
109
|
+
*/
|
|
110
|
+
validateCall(functionName, args, opts = {}) {
|
|
111
|
+
const meta = this.byName.get(functionName);
|
|
112
|
+
if (!meta) {
|
|
113
|
+
throw Errors.unsupported(`Function "${functionName}" is not available on this MailStore server`, {
|
|
114
|
+
functionName,
|
|
115
|
+
});
|
|
116
|
+
}
|
|
117
|
+
const known = new Map(meta.arguments.map((a) => [a.name.toLowerCase(), a]));
|
|
118
|
+
const provided = new Set(Object.keys(args).map((k) => k.toLowerCase()));
|
|
119
|
+
if (!opts.allowUnknownArgs) {
|
|
120
|
+
for (const key of Object.keys(args)) {
|
|
121
|
+
if (!known.has(key.toLowerCase())) {
|
|
122
|
+
throw Errors.invalidArgument(`Unknown argument "${key}" for function "${functionName}"`, {
|
|
123
|
+
functionName,
|
|
124
|
+
argument: key,
|
|
125
|
+
allowed: meta.arguments.map((a) => a.name),
|
|
126
|
+
});
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
// Enforce nullability: a non-nullable argument that is present must not be null.
|
|
131
|
+
for (const arg of meta.arguments) {
|
|
132
|
+
if (provided.has(arg.name.toLowerCase())) {
|
|
133
|
+
const value = pickArg(args, arg.name);
|
|
134
|
+
if (value === null && !arg.nullable) {
|
|
135
|
+
throw Errors.invalidArgument(`Argument "${arg.name}" for "${functionName}" is not nullable`, { functionName, argument: arg.name });
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
return args;
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
function pickArg(args, name) {
|
|
143
|
+
if (name in args)
|
|
144
|
+
return args[name];
|
|
145
|
+
const lower = name.toLowerCase();
|
|
146
|
+
for (const [k, v] of Object.entries(args)) {
|
|
147
|
+
if (k.toLowerCase() === lower)
|
|
148
|
+
return v;
|
|
149
|
+
}
|
|
150
|
+
return undefined;
|
|
151
|
+
}
|
|
152
|
+
//# sourceMappingURL=capability-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capability-registry.js","sourceRoot":"","sources":["../../src/mailstore/capability-registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM;IACN,oBAAoB;IACpB,kBAAkB;IAClB,cAAc;CACN,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,kBAAkB;IAClB,wBAAwB;IACxB,0BAA0B;IAC1B,uBAAuB;IACvB,kCAAkC;IAClC,qBAAqB;IACrB,WAAW;IACX,UAAU;IACV,aAAa;IACb,aAAa;IACb,SAAS;IACT,iBAAiB;IACjB,4BAA4B;IAC5B,sBAAsB;IACtB,kBAAkB;IAClB,uBAAuB;IACvB,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,kBAAkB;IAClB,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,kBAAkB;IAClB,2BAA2B;IAC3B,aAAa;IACb,cAAc;IACd,gCAAgC;IAChC,YAAY;IACZ,uBAAuB;IACvB,iBAAiB;IACjB,uBAAuB;IACvB,0BAA0B;IAC1B,wBAAwB;IACxB,mBAAmB;IACnB,2BAA2B;IAC3B,sBAAsB;IACtB,iBAAiB;IACjB,YAAY;IACZ,sBAAsB;CACd,CAAC;AAEX;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAIV;IACA;IAJX,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IAExD,YACmB,QAAyB,EACzB,MAAc;QADd,aAAQ,GAAR,QAAQ,CAAiB;QACzB,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ,8EAA8E;IAC9E,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,CAAC,MAAM,CACjB,sDAAsD,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACnF,EAAE,gBAAgB,EAAE,CACrB,CAAC;QACJ,CAAC;QACD,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;YACE,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YAChC,gBAAgB,EAAE,mBAAmB,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM;YACtE,eAAe,EAAE,eAAe,CAAC,MAAM;SACxC,EACD,iCAAiC,CAClC,CAAC;QACF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,EAAE,2EAA2E,CAAC,CAAC;QACrH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,GAAG,CAAC,YAAoB;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,sDAAsD;IACtD,MAAM,CAAC,aAAgC;QACrC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,GAAG,CAAC,YAAoB;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,YAAY,CACV,YAAoB,EACpB,IAAiC,EACjC,OAAuC,EAAE;QAEzC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,MAAM,CAAC,WAAW,CAAC,aAAa,YAAY,6CAA6C,EAAE;gBAC/F,YAAY;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAExE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAClC,MAAM,MAAM,CAAC,eAAe,CAAC,qBAAqB,GAAG,mBAAmB,YAAY,GAAG,EAAE;wBACvF,YAAY;wBACZ,QAAQ,EAAE,GAAG;wBACb,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qBAC3C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,iFAAiF;QACjF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACpC,MAAM,MAAM,CAAC,eAAe,CAC1B,aAAa,GAAG,CAAC,IAAI,UAAU,YAAY,mBAAmB,EAC9D,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CACrC,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAS,OAAO,CAAC,IAAiC,EAAE,IAAY;IAC9D,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK;YAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { Logger } from 'pino';
|
|
2
|
+
import type { AppConfig } from '../config/schema.js';
|
|
3
|
+
import { type ApiArgument, type ApiFunctionMetadata, type IMailStoreClient, type InvokeOptions, type MailStoreCompletedOperation, type MailStoreOperation, type RequestOptions, type WaitOptions } from './types.js';
|
|
4
|
+
/**
|
|
5
|
+
* MailStore SPE Management API client. Deliberately independent of the MCP SDK
|
|
6
|
+
* so it can be tested and reused in isolation. Handles authentication, form
|
|
7
|
+
* encoding, BOM-tolerant parsing, long-operation polling, retries and TLS.
|
|
8
|
+
*/
|
|
9
|
+
export declare class MailStoreClient implements IMailStoreClient {
|
|
10
|
+
private readonly config;
|
|
11
|
+
private readonly logger;
|
|
12
|
+
private readonly dispatcher;
|
|
13
|
+
private readonly authHeader;
|
|
14
|
+
private readonly baseUrl;
|
|
15
|
+
constructor(config: AppConfig, logger: Logger);
|
|
16
|
+
close(): Promise<void>;
|
|
17
|
+
getMetadata(options?: RequestOptions): Promise<ApiFunctionMetadata[]>;
|
|
18
|
+
invoke<T>(functionName: string, args?: Record<string, ApiArgument>, options?: InvokeOptions): Promise<MailStoreOperation<T>>;
|
|
19
|
+
waitForOperation<T>(operation: MailStoreOperation<T>, options?: WaitOptions): Promise<MailStoreCompletedOperation<T>>;
|
|
20
|
+
invokeAndWait<T>(functionName: string, args?: Record<string, ApiArgument>, options?: InvokeOptions & WaitOptions): Promise<T | null>;
|
|
21
|
+
ping(options?: RequestOptions): Promise<void>;
|
|
22
|
+
private getStatus;
|
|
23
|
+
private assertTerminalSuccess;
|
|
24
|
+
private throwIfApiError;
|
|
25
|
+
/** POST with retry-on-transient for safe calls. Returns a parsed envelope. */
|
|
26
|
+
private rawPost;
|
|
27
|
+
private mapHttpStatus;
|
|
28
|
+
private mapTransportError;
|
|
29
|
+
private composeSignal;
|
|
30
|
+
private backoff;
|
|
31
|
+
}
|
|
32
|
+
/** Normalise the metadata payload into ApiFunctionMetadata[] tolerating shape variation. */
|
|
33
|
+
export declare function normaliseMetadata(result: unknown): ApiFunctionMetadata[];
|
|
@@ -0,0 +1,274 @@
|
|
|
1
|
+
import { readFileSync } from 'node:fs';
|
|
2
|
+
import { Agent, request } from 'undici';
|
|
3
|
+
import { buildBasicAuthHeader } from './authentication.js';
|
|
4
|
+
import { encodeFormBody } from './encoder.js';
|
|
5
|
+
import { parseEnvelope, errorMessage } from './response-parser.js';
|
|
6
|
+
import { pollUntilTerminal, envelopeToOperation } from './operation-poller.js';
|
|
7
|
+
import { McpError, Errors } from './errors.js';
|
|
8
|
+
import { isTerminalStatus, } from './types.js';
|
|
9
|
+
const MAX_RETRIES = 3;
|
|
10
|
+
const BASE_BACKOFF_MS = 250;
|
|
11
|
+
/**
|
|
12
|
+
* MailStore SPE Management API client. Deliberately independent of the MCP SDK
|
|
13
|
+
* so it can be tested and reused in isolation. Handles authentication, form
|
|
14
|
+
* encoding, BOM-tolerant parsing, long-operation polling, retries and TLS.
|
|
15
|
+
*/
|
|
16
|
+
export class MailStoreClient {
|
|
17
|
+
config;
|
|
18
|
+
logger;
|
|
19
|
+
dispatcher;
|
|
20
|
+
authHeader;
|
|
21
|
+
baseUrl;
|
|
22
|
+
constructor(config, logger) {
|
|
23
|
+
this.config = config;
|
|
24
|
+
this.logger = logger;
|
|
25
|
+
this.baseUrl = config.baseUrl;
|
|
26
|
+
this.authHeader = buildBasicAuthHeader(config.username, config.password);
|
|
27
|
+
const ca = config.caFile ? readFileSync(config.caFile, 'utf-8') : undefined;
|
|
28
|
+
this.dispatcher = new Agent({
|
|
29
|
+
connect: {
|
|
30
|
+
rejectUnauthorized: config.verifyTls,
|
|
31
|
+
...(ca ? { ca } : {}),
|
|
32
|
+
},
|
|
33
|
+
headersTimeout: config.requestTimeoutMs,
|
|
34
|
+
bodyTimeout: config.requestTimeoutMs,
|
|
35
|
+
keepAliveTimeout: 30_000,
|
|
36
|
+
keepAliveMaxTimeout: 60_000,
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
async close() {
|
|
40
|
+
await this.dispatcher.close();
|
|
41
|
+
}
|
|
42
|
+
// ── metadata ────────────────────────────────────────────────────────────
|
|
43
|
+
async getMetadata(options = {}) {
|
|
44
|
+
const envelope = await this.rawPost('/api/get-metadata', '', { ...options, retrySafe: true });
|
|
45
|
+
this.throwIfApiError('get-metadata', envelope);
|
|
46
|
+
return normaliseMetadata(envelope.result);
|
|
47
|
+
}
|
|
48
|
+
// ── invoke ──────────────────────────────────────────────────────────────
|
|
49
|
+
async invoke(functionName, args = {}, options = {}) {
|
|
50
|
+
const body = encodeFormBody(args);
|
|
51
|
+
const envelope = await this.rawPost(`/api/invoke/${encodeURIComponent(functionName)}`, body, options);
|
|
52
|
+
this.throwIfApiError(functionName, envelope);
|
|
53
|
+
return envelopeToOperation(functionName, envelope);
|
|
54
|
+
}
|
|
55
|
+
async waitForOperation(operation, options = {}) {
|
|
56
|
+
if (operation.completed) {
|
|
57
|
+
return this.assertTerminalSuccess(operation);
|
|
58
|
+
}
|
|
59
|
+
if (!operation.token) {
|
|
60
|
+
throw Errors.operationFailed(`Operation "${operation.functionName}" is not terminal but returned no token`, { functionName: operation.functionName, statusCode: operation.statusCode });
|
|
61
|
+
}
|
|
62
|
+
const final = await pollUntilTerminal(operation.functionName, operation.token, operation.statusVersion, {
|
|
63
|
+
operationTimeoutMs: options.operationTimeoutMs ?? this.config.operationTimeoutMs,
|
|
64
|
+
...(options.signal ? { signal: options.signal } : {}),
|
|
65
|
+
...(options.onProgress ? { onProgress: options.onProgress } : {}),
|
|
66
|
+
getStatus: (token, lastKnownStatusVersion, signal) => this.getStatus(token, lastKnownStatusVersion, options.longPollTimeoutMs ?? this.config.longPollTimeoutMs, signal),
|
|
67
|
+
});
|
|
68
|
+
return this.assertTerminalSuccess(final);
|
|
69
|
+
}
|
|
70
|
+
async invokeAndWait(functionName, args = {}, options = {}) {
|
|
71
|
+
const op = await this.invoke(functionName, args, options);
|
|
72
|
+
const completed = await this.waitForOperation(op, options);
|
|
73
|
+
return completed.result;
|
|
74
|
+
}
|
|
75
|
+
async ping(options = {}) {
|
|
76
|
+
await this.invokeAndWait('Ping', {}, { ...options, retrySafe: true });
|
|
77
|
+
}
|
|
78
|
+
// ── internals ─────────────────────────────────────────────────────────────
|
|
79
|
+
async getStatus(token, lastKnownStatusVersion, longPollTimeoutMs, signal) {
|
|
80
|
+
const body = encodeFormBody({
|
|
81
|
+
token,
|
|
82
|
+
lastKnownStatusVersion,
|
|
83
|
+
millisecondsTimeout: longPollTimeoutMs,
|
|
84
|
+
});
|
|
85
|
+
// get-status is a safe, idempotent poll → retry on transient failures.
|
|
86
|
+
return this.rawPost('/api/get-status', body, {
|
|
87
|
+
retrySafe: true,
|
|
88
|
+
signal,
|
|
89
|
+
// Allow the request to run slightly longer than the long-poll window.
|
|
90
|
+
timeoutMs: longPollTimeoutMs + 5000,
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
assertTerminalSuccess(op) {
|
|
94
|
+
const code = op.statusCode.toLowerCase();
|
|
95
|
+
if (code === 'succeeded') {
|
|
96
|
+
return { ...op, completed: true };
|
|
97
|
+
}
|
|
98
|
+
if (code === 'canceled' || code === 'cancelled') {
|
|
99
|
+
throw Errors.operationFailed(`Operation "${op.functionName}" was cancelled`, {
|
|
100
|
+
functionName: op.functionName,
|
|
101
|
+
statusText: op.statusText ?? undefined,
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
// failed or any other terminal-but-not-succeeded state
|
|
105
|
+
throw Errors.operationFailed(`Operation "${op.functionName}" failed: ${op.statusText ?? 'unknown reason'}`, {
|
|
106
|
+
functionName: op.functionName,
|
|
107
|
+
statusCode: op.statusCode,
|
|
108
|
+
statusText: op.statusText ?? undefined,
|
|
109
|
+
});
|
|
110
|
+
}
|
|
111
|
+
throwIfApiError(functionName, envelope) {
|
|
112
|
+
if (envelope.error !== null) {
|
|
113
|
+
throw Errors.apiError(`MailStore "${functionName}" returned an error: ${errorMessage(envelope.error)}`, {
|
|
114
|
+
functionName,
|
|
115
|
+
statusCode: envelope.statusCode,
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
// A non-terminal statusCode without a token is a protocol inconsistency.
|
|
119
|
+
if (!isTerminalStatus(envelope.statusCode) && envelope.statusCode !== 'running' && envelope.token === null) {
|
|
120
|
+
this.logger.debug({ functionName, statusCode: envelope.statusCode }, 'unexpected non-terminal status without token');
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
/** POST with retry-on-transient for safe calls. Returns a parsed envelope. */
|
|
124
|
+
async rawPost(path, body, options = {}) {
|
|
125
|
+
const url = `${this.baseUrl}${path}`;
|
|
126
|
+
const timeoutMs = options.timeoutMs ?? this.config.requestTimeoutMs;
|
|
127
|
+
const maxAttempts = options.retrySafe ? MAX_RETRIES : 1;
|
|
128
|
+
let lastErr;
|
|
129
|
+
for (let attempt = 1; attempt <= maxAttempts; attempt++) {
|
|
130
|
+
const signal = this.composeSignal(options.signal, timeoutMs);
|
|
131
|
+
try {
|
|
132
|
+
const res = await request(url, {
|
|
133
|
+
method: 'POST',
|
|
134
|
+
dispatcher: this.dispatcher,
|
|
135
|
+
headers: {
|
|
136
|
+
authorization: this.authHeader,
|
|
137
|
+
'content-type': 'application/x-www-form-urlencoded',
|
|
138
|
+
accept: 'application/json',
|
|
139
|
+
},
|
|
140
|
+
body,
|
|
141
|
+
signal,
|
|
142
|
+
});
|
|
143
|
+
const text = await res.body.text();
|
|
144
|
+
const httpStatus = res.statusCode;
|
|
145
|
+
if (httpStatus >= 200 && httpStatus < 300) {
|
|
146
|
+
return parseEnvelope(text);
|
|
147
|
+
}
|
|
148
|
+
// Non-2xx: map and decide retry.
|
|
149
|
+
const err = this.mapHttpStatus(httpStatus, path, text);
|
|
150
|
+
if (err.retryable && attempt < maxAttempts) {
|
|
151
|
+
lastErr = err;
|
|
152
|
+
await this.backoff(attempt);
|
|
153
|
+
continue;
|
|
154
|
+
}
|
|
155
|
+
throw err;
|
|
156
|
+
}
|
|
157
|
+
catch (err) {
|
|
158
|
+
if (err instanceof McpError) {
|
|
159
|
+
if (err.retryable && attempt < maxAttempts) {
|
|
160
|
+
lastErr = err;
|
|
161
|
+
await this.backoff(attempt);
|
|
162
|
+
continue;
|
|
163
|
+
}
|
|
164
|
+
throw err;
|
|
165
|
+
}
|
|
166
|
+
const mapped = this.mapTransportError(err, path);
|
|
167
|
+
if (mapped.retryable && options.retrySafe && attempt < maxAttempts) {
|
|
168
|
+
lastErr = mapped;
|
|
169
|
+
await this.backoff(attempt);
|
|
170
|
+
continue;
|
|
171
|
+
}
|
|
172
|
+
throw mapped;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
throw lastErr instanceof McpError
|
|
176
|
+
? lastErr
|
|
177
|
+
: Errors.unavailable('MailStore request failed after retries', { path });
|
|
178
|
+
}
|
|
179
|
+
mapHttpStatus(status, path, bodyText) {
|
|
180
|
+
const snippet = bodyText.slice(0, 200);
|
|
181
|
+
switch (status) {
|
|
182
|
+
case 401:
|
|
183
|
+
return Errors.auth('MailStore authentication failed (HTTP 401)', { path });
|
|
184
|
+
case 403:
|
|
185
|
+
return Errors.authorization('MailStore authorization failed (HTTP 403)', { path });
|
|
186
|
+
case 404:
|
|
187
|
+
return new McpError('MAILSTORE_API_ERROR', 'MailStore endpoint not found (HTTP 404)', { path });
|
|
188
|
+
case 429:
|
|
189
|
+
return new McpError('MAILSTORE_UNAVAILABLE', 'MailStore rate limited (HTTP 429)', { path }, true);
|
|
190
|
+
case 502:
|
|
191
|
+
case 503:
|
|
192
|
+
case 504:
|
|
193
|
+
return Errors.unavailable(`MailStore temporarily unavailable (HTTP ${status})`, { path });
|
|
194
|
+
default:
|
|
195
|
+
return new McpError('MAILSTORE_API_ERROR', `MailStore returned HTTP ${status}`, {
|
|
196
|
+
path,
|
|
197
|
+
bodySnippet: snippet,
|
|
198
|
+
});
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
mapTransportError(err, path) {
|
|
202
|
+
const code = err?.code;
|
|
203
|
+
const name = err?.name;
|
|
204
|
+
if (name === 'AbortError' || name === 'TimeoutError' || code === 'UND_ERR_ABORTED' || code === 'ABORT_ERR') {
|
|
205
|
+
return Errors.unavailable('MailStore request timed out', { path });
|
|
206
|
+
}
|
|
207
|
+
if (typeof code === 'string' && /CERT|SSL|TLS|SELF_SIGNED|UNABLE_TO_VERIFY|DEPTH_ZERO/i.test(code)) {
|
|
208
|
+
return Errors.tls(`TLS validation failed connecting to MailStore (${code})`, { path });
|
|
209
|
+
}
|
|
210
|
+
if (code === 'ECONNRESET' || code === 'ECONNREFUSED' || code === 'EAI_AGAIN' || code === 'ENOTFOUND' || code === 'EPIPE') {
|
|
211
|
+
return Errors.unavailable(`Connection to MailStore failed (${code})`, { path });
|
|
212
|
+
}
|
|
213
|
+
return Errors.unavailable('Unexpected transport error contacting MailStore', {
|
|
214
|
+
path,
|
|
215
|
+
detail: err?.message,
|
|
216
|
+
});
|
|
217
|
+
}
|
|
218
|
+
composeSignal(outer, timeoutMs) {
|
|
219
|
+
const timeout = AbortSignal.timeout(timeoutMs);
|
|
220
|
+
return outer ? AbortSignal.any([outer, timeout]) : timeout;
|
|
221
|
+
}
|
|
222
|
+
backoff(attempt) {
|
|
223
|
+
const jitter = Math.random() * BASE_BACKOFF_MS;
|
|
224
|
+
const delay = BASE_BACKOFF_MS * 2 ** (attempt - 1) + jitter;
|
|
225
|
+
return new Promise((r) => setTimeout(r, delay));
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
/** Normalise the metadata payload into ApiFunctionMetadata[] tolerating shape variation. */
|
|
229
|
+
export function normaliseMetadata(result) {
|
|
230
|
+
const functions = extractFunctionArray(result);
|
|
231
|
+
const out = [];
|
|
232
|
+
for (const fn of functions) {
|
|
233
|
+
if (!fn || typeof fn !== 'object')
|
|
234
|
+
continue;
|
|
235
|
+
const rec = fn;
|
|
236
|
+
const name = typeof rec['name'] === 'string' ? rec['name'] : typeof rec['functionName'] === 'string' ? rec['functionName'] : undefined;
|
|
237
|
+
if (!name)
|
|
238
|
+
continue;
|
|
239
|
+
out.push({ name, arguments: normaliseArgs(rec['arguments'] ?? rec['args'] ?? rec['parameters']) });
|
|
240
|
+
}
|
|
241
|
+
return out;
|
|
242
|
+
}
|
|
243
|
+
function extractFunctionArray(result) {
|
|
244
|
+
if (Array.isArray(result))
|
|
245
|
+
return result;
|
|
246
|
+
if (result && typeof result === 'object') {
|
|
247
|
+
const rec = result;
|
|
248
|
+
for (const key of ['functions', 'methods', 'commands', 'items']) {
|
|
249
|
+
if (Array.isArray(rec[key]))
|
|
250
|
+
return rec[key];
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
return [];
|
|
254
|
+
}
|
|
255
|
+
function normaliseArgs(raw) {
|
|
256
|
+
if (!Array.isArray(raw))
|
|
257
|
+
return [];
|
|
258
|
+
const out = [];
|
|
259
|
+
for (const a of raw) {
|
|
260
|
+
if (!a || typeof a !== 'object')
|
|
261
|
+
continue;
|
|
262
|
+
const rec = a;
|
|
263
|
+
const name = typeof rec['name'] === 'string' ? rec['name'] : undefined;
|
|
264
|
+
if (!name)
|
|
265
|
+
continue;
|
|
266
|
+
out.push({
|
|
267
|
+
name,
|
|
268
|
+
type: typeof rec['type'] === 'string' ? rec['type'] : 'string',
|
|
269
|
+
nullable: rec['nullable'] === true,
|
|
270
|
+
});
|
|
271
|
+
}
|
|
272
|
+
return out;
|
|
273
|
+
}
|
|
274
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/mailstore/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAWL,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAMP;IACA;IANF,UAAU,CAAQ;IAClB,UAAU,CAAS;IACnB,OAAO,CAAS;IAEjC,YACmB,MAAiB,EACjB,MAAc;QADd,WAAM,GAAN,MAAM,CAAW;QACjB,WAAM,GAAN,MAAM,CAAQ;QAE/B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEzE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,IAAI,CAAC,UAAU,GAAG,IAAI,KAAK,CAAC;YAC1B,OAAO,EAAE;gBACP,kBAAkB,EAAE,MAAM,CAAC,SAAS;gBACpC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtB;YACD,cAAc,EAAE,MAAM,CAAC,gBAAgB;YACvC,WAAW,EAAE,MAAM,CAAC,gBAAgB;YACpC,gBAAgB,EAAE,MAAM;YACxB,mBAAmB,EAAE,MAAM;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,WAAW,CAAC,UAA0B,EAAE;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAC/C,OAAO,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,MAAM,CACV,YAAoB,EACpB,OAAoC,EAAE,EACtC,UAAyB,EAAE;QAE3B,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAI,eAAe,kBAAkB,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACzG,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAA0B,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,SAAgC,EAChC,UAAuB,EAAE;QAEzB,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,MAAM,CAAC,eAAe,CAC1B,cAAc,SAAS,CAAC,YAAY,yCAAyC,EAC7E,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAC3E,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,aAAa,EAAE;YACtG,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB;YAChF,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,SAAS,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,EAAE,CACnD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,sBAAsB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC;SACpH,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,qBAAqB,CAAC,KAA8B,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,YAAoB,EACpB,OAAoC,EAAE,EACtC,UAAuC,EAAE;QAEzC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAI,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,SAAS,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAA0B,EAAE;QACrC,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,6EAA6E;IAErE,KAAK,CAAC,SAAS,CACrB,KAAa,EACb,sBAA8B,EAC9B,iBAAyB,EACzB,MAAmB;QAEnB,MAAM,IAAI,GAAG,cAAc,CAAC;YAC1B,KAAK;YACL,sBAAsB;YACtB,mBAAmB,EAAE,iBAAiB;SACvC,CAAC,CAAC;QACH,uEAAuE;QACvE,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,EAAE;YAC3C,SAAS,EAAE,IAAI;YACf,MAAM;YACN,sEAAsE;YACtE,SAAS,EAAE,iBAAiB,GAAG,IAAI;SACpC,CAAC,CAAC;IACL,CAAC;IAEO,qBAAqB,CAAI,EAAyB;QACxD,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,OAAO,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACpC,CAAC;QACD,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAChD,MAAM,MAAM,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC,YAAY,iBAAiB,EAAE;gBAC3E,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,UAAU,EAAE,EAAE,CAAC,UAAU,IAAI,SAAS;aACvC,CAAC,CAAC;QACL,CAAC;QACD,uDAAuD;QACvD,MAAM,MAAM,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC,YAAY,aAAa,EAAE,CAAC,UAAU,IAAI,gBAAgB,EAAE,EAAE;YAC1G,YAAY,EAAE,EAAE,CAAC,YAAY;YAC7B,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,UAAU,EAAE,EAAE,CAAC,UAAU,IAAI,SAAS;SACvC,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CAAC,YAAoB,EAAE,QAA2B;QACvE,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,MAAM,CAAC,QAAQ,CAAC,cAAc,YAAY,wBAAwB,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE;gBACtG,YAAY;gBACZ,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,CAAC,CAAC;QACL,CAAC;QACD,yEAAyE;QACzE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC3G,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,EAAE,8CAA8C,CAAC,CAAC;QACvH,CAAC;IACH,CAAC;IAED,8EAA8E;IACtE,KAAK,CAAC,OAAO,CACnB,IAAY,EACZ,IAAY,EACZ,UAAyB,EAAE;QAE3B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACpE,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,OAAgB,CAAC;QAErB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC7D,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;oBAC7B,MAAM,EAAE,MAAM;oBACd,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,OAAO,EAAE;wBACP,aAAa,EAAE,IAAI,CAAC,UAAU;wBAC9B,cAAc,EAAE,mCAAmC;wBACnD,MAAM,EAAE,kBAAkB;qBAC3B;oBACD,IAAI;oBACJ,MAAM;iBACP,CAAC,CAAC;gBAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;gBAElC,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;oBAC1C,OAAO,aAAa,CAAI,IAAI,CAAC,CAAC;gBAChC,CAAC;gBACD,iCAAiC;gBACjC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;gBACvD,IAAI,GAAG,CAAC,SAAS,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;oBAC3C,OAAO,GAAG,GAAG,CAAC;oBACd,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC5B,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;oBAC5B,IAAI,GAAG,CAAC,SAAS,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;wBAC3C,OAAO,GAAG,GAAG,CAAC;wBACd,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;wBAC5B,SAAS;oBACX,CAAC;oBACD,MAAM,GAAG,CAAC;gBACZ,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACjD,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;oBACnE,OAAO,GAAG,MAAM,CAAC;oBACjB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC5B,SAAS;gBACX,CAAC;gBACD,MAAM,MAAM,CAAC;YACf,CAAC;QACH,CAAC;QACD,MAAM,OAAO,YAAY,QAAQ;YAC/B,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,wCAAwC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAEO,aAAa,CAAC,MAAc,EAAE,IAAY,EAAE,QAAgB;QAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACvC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,GAAG;gBACN,OAAO,MAAM,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7E,KAAK,GAAG;gBACN,OAAO,MAAM,CAAC,aAAa,CAAC,2CAA2C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACrF,KAAK,GAAG;gBACN,OAAO,IAAI,QAAQ,CAAC,qBAAqB,EAAE,yCAAyC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAClG,KAAK,GAAG;gBACN,OAAO,IAAI,QAAQ,CAAC,uBAAuB,EAAE,mCAAmC,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;YACpG,KAAK,GAAG,CAAC;YACT,KAAK,GAAG,CAAC;YACT,KAAK,GAAG;gBACN,OAAO,MAAM,CAAC,WAAW,CAAC,2CAA2C,MAAM,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5F;gBACE,OAAO,IAAI,QAAQ,CAAC,qBAAqB,EAAE,2BAA2B,MAAM,EAAE,EAAE;oBAC9E,IAAI;oBACJ,WAAW,EAAE,OAAO;iBACrB,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAEO,iBAAiB,CAAC,GAAY,EAAE,IAAY;QAClD,MAAM,IAAI,GAAI,GAAyB,EAAE,IAAI,CAAC;QAC9C,MAAM,IAAI,GAAI,GAAyB,EAAE,IAAI,CAAC;QAE9C,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,iBAAiB,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC3G,OAAO,MAAM,CAAC,WAAW,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,uDAAuD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnG,OAAO,MAAM,CAAC,GAAG,CAAC,kDAAkD,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACzH,OAAO,MAAM,CAAC,WAAW,CAAC,mCAAmC,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,MAAM,CAAC,WAAW,CAAC,iDAAiD,EAAE;YAC3E,IAAI;YACJ,MAAM,EAAG,GAAa,EAAE,OAAO;SAChC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,KAA8B,EAAE,SAAiB;QACrE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,CAAC;IAEO,OAAO,CAAC,OAAe;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,eAAe,CAAC;QAC/C,MAAM,KAAK,GAAG,eAAe,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;QAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;CACF;AAED,4FAA4F;AAC5F,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,GAAG,GAA0B,EAAE,CAAC;IACtC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,SAAS;QAC5C,MAAM,GAAG,GAAG,EAA6B,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,cAAc,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QACnJ,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAe;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,MAAiC,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;YAChE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,GAAG,CAAC,GAAG,CAAc,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,aAAa,CAAC,GAAY;IACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAA0B,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,SAAS;QAC1C,MAAM,GAAG,GAAG,CAA4B,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,GAAG,CAAC,IAAI,CAAC;YACP,IAAI;YACJ,IAAI,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ;YAC9D,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI;SACnC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
|