@rashidazarang/airtable-mcp 3.0.0 → 3.2.5

package/dist/typescript/app/airtable-client.js

@@ -0,0 +1,325 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirtableClient = void 0;
+const node_https_1 = __importDefault(require("node:https"));
+const node_url_1 = require("node:url");
+const promises_1 = require("node:timers/promises");
+const errors_1 = require("../errors");
+function toQueryString(query) {
+    if (!query) {
+        return '';
+    }
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            value.forEach((item) => params.append(`${key}[]`, String(item)));
+        }
+        else {
+            params.append(key, String(value));
+        }
+    }
+    const queryString = params.toString();
+    return queryString.length > 0 ? `?${queryString}` : '';
+}
+function parseRetryAfter(headers) {
+    const retryAfter = headers['retry-after'];
+    if (!retryAfter)
+        return undefined;
+    const parsedSeconds = Number(retryAfter);
+    if (!Number.isNaN(parsedSeconds)) {
+        return parsedSeconds * 1000;
+    }
+    const retryDate = new Date(retryAfter);
+    if (!Number.isNaN(retryDate.getTime())) {
+        return Math.max(retryDate.getTime() - Date.now(), 0);
+    }
+    return undefined;
+}
+class AirtableClient {
+    constructor(personalAccessToken, options) {
+        this.pat = personalAccessToken;
+        this.baseLimiter = options.baseLimiter;
+        this.patLimiter = options.patLimiter;
+        this.logger = options.logger;
+        this.userAgent = options.userAgent;
+        this.patHash = options.patHash;
+        this.maxRetries = options.maxRetries ?? 3;
+    }
+    async listBases() {
+        return this.request({
+            method: 'GET',
+            path: '/v0/meta/bases'
+        });
+    }
+    async getBase(baseId) {
+        return this.request({
+            method: 'GET',
+            path: `/v0/meta/bases/${encodeURIComponent(baseId)}`,
+            baseId
+        });
+    }
+    async listTables(baseId) {
+        return this.request({
+            method: 'GET',
+            path: `/v0/meta/bases/${encodeURIComponent(baseId)}/tables`,
+            baseId
+        });
+    }
+    async queryRecords(baseId, table, query) {
+        const requestOptions = {
+            method: 'GET',
+            path: `/v0/${encodeURIComponent(baseId)}/${encodeURIComponent(table)}`,
+            baseId
+        };
+        if (query && Object.keys(query).length > 0) {
+            requestOptions.query = query;
+        }
+        return this.request(requestOptions);
+    }
+    async createRecords(baseId, table, payload, idempotencyKey) {
+        const requestOptions = {
+            method: 'POST',
+            path: `/v0/${encodeURIComponent(baseId)}/${encodeURIComponent(table)}`,
+            baseId,
+            body: payload
+        };
+        if (idempotencyKey) {
+            requestOptions.idempotencyKey = idempotencyKey;
+        }
+        return this.request(requestOptions);
+    }
+    async updateRecords(baseId, table, payload, idempotencyKey) {
+        const requestOptions = {
+            method: 'PATCH',
+            path: `/v0/${encodeURIComponent(baseId)}/${encodeURIComponent(table)}`,
+            baseId,
+            body: payload
+        };
+        if (idempotencyKey) {
+            requestOptions.idempotencyKey = idempotencyKey;
+        }
+        return this.request(requestOptions);
+    }
+    async upsertRecords(baseId, table, payload, idempotencyKey) {
+        const requestOptions = {
+            method: 'PATCH',
+            path: `/v0/${encodeURIComponent(baseId)}/${encodeURIComponent(table)}`,
+            baseId,
+            body: payload
+        };
+        if (idempotencyKey) {
+            requestOptions.idempotencyKey = idempotencyKey;
+        }
+        return this.request(requestOptions);
+    }
+    async request(options) {
+        const { baseId } = options;
+        if (baseId) {
+            await this.baseLimiter.schedule(baseId);
+        }
+        await this.patLimiter.schedule(this.patHash);
+        return this.withRetry(() => this.performRequest(options));
+    }
+    async withRetry(fn) {
+        let attempt = 0;
+        let lastError;
+        while (attempt < this.maxRetries) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                attempt += 1;
+                if (error instanceof errors_1.RateLimitError) {
+                    const delayMs = error.retryAfterMs ?? this.backoffWithJitter(attempt);
+                    this.logger.warn('Rate limited, backing off', {
+                        attempt,
+                        delayMs
+                    });
+                    await (0, promises_1.setTimeout)(delayMs);
+                    continue;
+                }
+                if (error instanceof errors_1.InternalServerError && attempt < this.maxRetries) {
+                    const delayMs = this.backoffWithJitter(attempt);
+                    this.logger.warn('Upstream error, retrying', {
+                        attempt,
+                        delayMs
+                    });
+                    await (0, promises_1.setTimeout)(delayMs);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        if (lastError instanceof errors_1.AirtableBrainError) {
+            throw lastError.withContext({ attempt: this.maxRetries, totalAttempts: this.maxRetries });
+        }
+        throw lastError;
+    }
+    backoffWithJitter(attempt) {
+        const baseDelay = Math.min(1000 * 2 ** (attempt - 1), 8000);
+        const jitter = Math.random() * 250;
+        return baseDelay + jitter;
+    }
+    performRequest(options) {
+        const { method = 'GET', path, query, body, idempotencyKey } = options;
+        const logger = this.logger.child({
+            op: 'airtable_request',
+            method,
+            path,
+            baseId: options.baseId,
+            patHash: this.patHash
+        });
+        const queryString = toQueryString(query);
+        const url = new node_url_1.URL(`https://api.airtable.com${path}${queryString}`);
+        const payload = body === undefined ? undefined : JSON.stringify(body);
+        return new Promise((resolve, reject) => {
+            const request = node_https_1.default.request({
+                method,
+                hostname: url.hostname,
+                path: url.pathname + url.search,
+                headers: {
+                    Authorization: `Bearer ${this.pat}`,
+                    'Content-Type': 'application/json',
+                    'User-Agent': this.userAgent,
+                    ...(payload ? { 'Content-Length': Buffer.byteLength(payload) } : {}),
+                    ...(idempotencyKey ? { 'Idempotency-Key': idempotencyKey } : {})
+                }
+            }, (response) => {
+                const chunks = [];
+                response.on('data', (chunk) => {
+                    chunks.push(chunk);
+                });
+                response.on('end', () => {
+                    const rawBody = Buffer.concat(chunks).toString('utf8');
+                    let parsedBody;
+                    if (rawBody.length > 0) {
+                        try {
+                            parsedBody = JSON.parse(rawBody);
+                        }
+                        catch (error) {
+                            reject(new errors_1.InternalServerError('Failed to parse Airtable response', {
+                                cause: error,
+                                status: response.statusCode ?? 0
+                            }));
+                            return;
+                        }
+                    }
+                    const result = {
+                        status: response.statusCode ?? 0,
+                        body: parsedBody,
+                        headers: response.headers
+                    };
+                    try {
+                        if (result.status >= 200 && result.status < 300) {
+                            resolve(parsedBody);
+                            return;
+                        }
+                        reject(this.toDomainError(result, options));
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                });
+            });
+            request.on('error', (error) => {
+                logger.error('Network error calling Airtable', {
+                    error: error instanceof Error ? error.message : String(error)
+                });
+                reject(new errors_1.InternalServerError('Network error communicating with Airtable', {
+                    cause: error
+                }));
+            });
+            request.setTimeout(30000, () => {
+                request.destroy();
+                reject(new errors_1.InternalServerError('Airtable request timed out', {
+                    status: 504
+                }));
+            });
+            if (payload) {
+                request.write(payload);
+            }
+            request.end();
+        });
+    }
+    toDomainError(response, request) {
+        const { status, body, headers } = response;
+        const baseContext = {
+            endpoint: request.path
+        };
+        if (request.baseId) {
+            baseContext.baseId = request.baseId;
+        }
+        if (status === 401 || status === 403) {
+            return new errors_1.AuthError('Authentication failed with Airtable', {
+                status,
+                context: baseContext
+            });
+        }
+        if (status === 404) {
+            return new errors_1.NotFoundError('Requested resource was not found in Airtable', {
+                status,
+                context: baseContext
+            });
+        }
+        if (status === 409) {
+            return new errors_1.ConflictError('Airtable reported a conflict', {
+                status,
+                context: baseContext
+            });
+        }
+        if (status === 400 || status === 422) {
+            const validationContext = { ...baseContext };
+            const upstreamErrorType = this.safeExtractErrorType(body);
+            if (upstreamErrorType) {
+                validationContext.upstreamErrorType = upstreamErrorType;
+            }
+            return new errors_1.AirtableValidationError('Airtable validation error', {
+                status,
+                context: validationContext
+            });
+        }
+        if (status === 429) {
+            const retryAfterMs = parseRetryAfter(headers);
+            return new errors_1.RateLimitError('Airtable rate limit exceeded', {
+                status,
+                ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+                context: baseContext
+            });
+        }
+        if (status >= 500) {
+            const internalContext = { ...baseContext };
+            const upstreamErrorType = this.safeExtractErrorType(body);
+            if (upstreamErrorType) {
+                internalContext.upstreamErrorType = upstreamErrorType;
+            }
+            return new errors_1.InternalServerError('Airtable returned an internal error', {
+                status,
+                context: internalContext
+            });
+        }
+        return new errors_1.InternalServerError('Unexpected Airtable response', {
+            status,
+            context: baseContext
+        });
+    }
+    safeExtractErrorType(body) {
+        if (body && typeof body === 'object' && 'error' in body) {
+            const error = body.error;
+            if (error && typeof error === 'object' && 'type' in error) {
+                const type = error.type;
+                if (typeof type === 'string') {
+                    return type;
+                }
+            }
+        }
+        return undefined;
+    }
+}
+exports.AirtableClient = AirtableClient;
+//# sourceMappingURL=airtable-client.js.map

package/dist/typescript/app/airtable-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"airtable-client.js","sourceRoot":"","sources":["../../../src/typescript/app/airtable-client.ts"],"names":[],"mappings":"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"}

package/dist/typescript/app/config.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const dotenv_1 = require("dotenv");
+const types_1 = require("./types");
+const errors_1 = require("../errors");
+(0, dotenv_1.config)();
+const DEFAULT_EXCEPTION_QUEUE_SIZE = 500;
+function parseCsv(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+function hashSecret(secret) {
+    return (0, node_crypto_1.createHash)('sha256').update(secret).digest('hex').slice(0, 12);
+}
+function resolveLogLevel() {
+    const raw = (process.env.LOG_LEVEL || 'info').toLowerCase();
+    if (raw === 'error' || raw === 'warn' || raw === 'info' || raw === 'debug') {
+        return raw;
+    }
+    return 'info';
+}
+function determineAllowedBases(defaultBaseId) {
+    const fromEnv = parseCsv(process.env.AIRTABLE_ALLOWED_BASES || process.env.AIRTABLE_BASE_ALLOWLIST);
+    const baseSet = new Set();
+    if (defaultBaseId) {
+        baseSet.add(defaultBaseId);
+    }
+    fromEnv.forEach((base) => baseSet.add(base));
+    // Allow empty base list - users can use list_bases tool to discover bases
+    // and then specify them dynamically in tool calls
+    return Array.from(baseSet);
+}
+function parseAllowedTables(raw) {
+    if (!raw) {
+        return [];
+    }
+    const tables = [];
+    for (const entry of raw.split(',')) {
+        const trimmed = entry.trim();
+        if (!trimmed)
+            continue;
+        const [baseId, table] = trimmed.split(':');
+        if (!baseId || !table) {
+            throw new errors_1.GovernanceError(`Invalid AIRTABLE_ALLOWED_TABLES entry "${trimmed}". Expected format baseId:tableName.`);
+        }
+        tables.push({ baseId: baseId.trim(), table: table.trim() });
+    }
+    return tables;
+}
+function readGovernanceFile() {
+    const explicitPath = process.env.AIRTABLE_GOVERNANCE_PATH;
+    const fallbackPath = node_path_1.default.resolve(process.cwd(), 'config', 'governance.json');
+    const filePath = explicitPath || fallbackPath;
+    if (!node_fs_1.default.existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        const raw = node_fs_1.default.readFileSync(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const partialSchema = types_1.governanceOutputSchema.partial();
+        const result = partialSchema.parse(parsed);
+        return result;
+    }
+    catch (error) {
+        throw new errors_1.GovernanceError(`Failed to parse governance configuration at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function buildGovernanceSnapshot(allowedBases) {
+    const baseSnapshot = {
+        allowedBases,
+        allowedTables: [],
+        allowedOperations: ['describe', 'query', 'create', 'update', 'upsert'],
+        piiFields: [],
+        redactionPolicy: 'mask_on_inline',
+        loggingPolicy: 'minimal',
+        retentionDays: 7
+    };
+    const overrides = readGovernanceFile();
+    const envAllowedTables = parseAllowedTables(process.env.AIRTABLE_ALLOWED_TABLES);
+    const merged = {
+        ...baseSnapshot,
+        ...(overrides ?? {})
+    };
+    // Ensure allow-lists include env tables/bases.
+    const bases = new Set(merged.allowedBases);
+    allowedBases.forEach((base) => bases.add(base));
+    merged.allowedBases = Array.from(bases);
+    if (overrides?.allowedTables || envAllowedTables.length > 0) {
+        const tableSet = new Map();
+        (overrides?.allowedTables ?? []).forEach((table) => {
+            tableSet.set(`${table.baseId}:${table.table}`, table);
+        });
+        envAllowedTables.forEach((table) => {
+            tableSet.set(`${table.baseId}:${table.table}`, table);
+        });
+        merged.allowedTables = Array.from(tableSet.values());
+    }
+    return types_1.governanceOutputSchema.parse(merged);
+}
+function loadConfig() {
+    const personalAccessToken = process.env.AIRTABLE_PAT ||
+        process.env.AIRTABLE_TOKEN ||
+        process.env.AIRTABLE_API_TOKEN ||
+        process.env.AIRTABLE_API_KEY;
+    if (!personalAccessToken) {
+        throw new errors_1.GovernanceError('Missing Airtable credentials. Set AIRTABLE_PAT (preferred) or AIRTABLE_TOKEN.');
+    }
+    const defaultBaseId = process.env.AIRTABLE_DEFAULT_BASE ?? process.env.AIRTABLE_BASE_ID ?? process.env.AIRTABLE_BASE;
+    const allowedBases = determineAllowedBases(defaultBaseId);
+    const governance = buildGovernanceSnapshot(allowedBases);
+    const auth = {
+        personalAccessToken,
+        patHash: hashSecret(personalAccessToken),
+        allowedBases
+    };
+    if (defaultBaseId) {
+        auth.defaultBaseId = defaultBaseId;
+    }
+    return {
+        version: process.env.npm_package_version || '0.0.0',
+        auth,
+        governance,
+        logLevel: resolveLogLevel(),
+        exceptionQueueSize: Number.parseInt(process.env.EXCEPTION_QUEUE_SIZE || '', 10) > 0
+            ? Number.parseInt(process.env.EXCEPTION_QUEUE_SIZE, 10)
+            : DEFAULT_EXCEPTION_QUEUE_SIZE
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/typescript/app/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/typescript/app/config.ts"],"names":[],"mappings":"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"}

package/dist/typescript/app/context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=context.js.map

package/dist/typescript/app/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/typescript/app/context.ts"],"names":[],"mappings":""}

package/dist/typescript/app/exceptions.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExceptionStore = void 0;
+const node_crypto_1 = require("node:crypto");
+function mapCategory(code) {
+    switch (code) {
+        case 'RateLimited':
+            return 'rate_limit';
+        case 'ValidationError':
+            return 'validation';
+        case 'AuthError':
+            return 'auth';
+        case 'ConflictError':
+            return 'conflict';
+        case 'GovernanceError':
+            return 'schema_drift';
+        default:
+            return 'other';
+    }
+}
+function mapSeverity(code) {
+    switch (code) {
+        case 'RateLimited':
+        case 'AuthError':
+        case 'ConflictError':
+        case 'GovernanceError':
+            return 'error';
+        case 'ValidationError':
+            return 'warning';
+        default:
+            return 'error';
+    }
+}
+class ExceptionStore {
+    constructor(capacity, logger) {
+        this.items = [];
+        this.capacity = capacity;
+        this.logger = logger.child({ component: 'exception_store' });
+    }
+    record(error, summary, details, proposedFix) {
+        const item = {
+            id: (0, node_crypto_1.randomUUID)(),
+            timestamp: new Date().toISOString(),
+            severity: mapSeverity(error.code),
+            category: mapCategory(error.code),
+            summary,
+            details,
+            proposedFix
+        };
+        this.items.unshift(item);
+        if (this.items.length > this.capacity) {
+            this.items.pop();
+        }
+        this.logger.debug('Recorded exception', { code: error.code });
+    }
+    list(params) {
+        const limit = params.limit ?? 100;
+        const cursorIndex = this.parseCursor(params.cursor);
+        let filtered = this.items;
+        if (params.since) {
+            filtered = filtered.filter((item) => item.timestamp > params.since);
+        }
+        if (params.severity) {
+            filtered = filtered.filter((item) => item.severity === params.severity);
+        }
+        const slice = filtered.slice(cursorIndex, cursorIndex + limit);
+        const nextCursor = cursorIndex + limit < filtered.length ? String(cursorIndex + limit) : undefined;
+        return {
+            items: slice,
+            cursor: nextCursor
+        };
+    }
+    parseCursor(cursor) {
+        if (!cursor) {
+            return 0;
+        }
+        const parsed = Number.parseInt(cursor, 10);
+        if (Number.isNaN(parsed) || parsed < 0) {
+            return 0;
+        }
+        return parsed;
+    }
+}
+exports.ExceptionStore = ExceptionStore;
+//# sourceMappingURL=exceptions.js.map

package/dist/typescript/app/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../../src/typescript/app/exceptions.ts"],"names":[],"mappings":"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"}

package/dist/typescript/app/governance.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GovernanceService = void 0;
+const errors_1 = require("../errors");
+class GovernanceService {
+    constructor(snapshot) {
+        this.snapshot = snapshot;
+        this.tablesByBase = this.buildTableIndex(snapshot);
+    }
+    ensureBaseAllowed(baseId) {
+        // If allowedBases is empty, allow all bases (user will use list_bases to discover)
+        if (this.snapshot.allowedBases.length > 0 && !this.snapshot.allowedBases.includes(baseId)) {
+            throw new errors_1.GovernanceError(`Base ${baseId} is not in the allow-list`, {
+                context: { baseId, governanceRule: 'allowedBases' }
+            });
+        }
+    }
+    ensureOperationAllowed(operation) {
+        if (!this.snapshot.allowedOperations.includes(operation)) {
+            throw new errors_1.GovernanceError(`Operation ${operation} is not permitted`, {
+                context: { governanceRule: 'allowedOperations' }
+            });
+        }
+    }
+    ensureTableAllowed(baseId, table) {
+        if (!this.isTableAllowed(baseId, table)) {
+            throw new errors_1.GovernanceError(`Table ${table} is not allowed in base ${baseId}`, {
+                context: { baseId, table, governanceRule: 'allowedTables' }
+            });
+        }
+    }
+    listPiiPolicies(baseId, table) {
+        return this.snapshot.piiFields
+            ?.filter((field) => field.baseId === baseId && field.table === table)
+            .map((field) => ({ field: field.field, policy: field.policy })) ?? [];
+    }
+    getSnapshot() {
+        return this.snapshot;
+    }
+    isTableAllowed(baseId, table) {
+        const allowedTables = this.tablesByBase.get(baseId);
+        if (!allowedTables || allowedTables.size === 0) {
+            return true;
+        }
+        return allowedTables.has(table);
+    }
+    buildTableIndex(snapshot) {
+        const map = new Map();
+        for (const item of snapshot.allowedTables ?? []) {
+            const baseTables = map.get(item.baseId) ?? new Set();
+            baseTables.add(item.table);
+            map.set(item.baseId, baseTables);
+        }
+        return map;
+    }
+}
+exports.GovernanceService = GovernanceService;
+//# sourceMappingURL=governance.js.map

package/dist/typescript/app/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../../src/typescript/app/governance.ts"],"names":[],"mappings":";;;AACA,sCAA4C;AAI5C,MAAa,iBAAiB;IAI5B,YAAY,QAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,iBAAiB,CAAC,MAAc;QAC9B,mFAAmF;QACnF,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1F,MAAM,IAAI,wBAAe,CAAC,QAAQ,MAAM,2BAA2B,EAAE;gBACnE,OAAO,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sBAAsB,CAAC,SAAoB;QACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,wBAAe,CAAC,aAAa,SAAS,mBAAmB,EAAE;gBACnE,OAAO,EAAE,EAAE,cAAc,EAAE,mBAAmB,EAAE;aACjD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,KAAa;QAC9C,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,wBAAe,CAAC,SAAS,KAAK,2BAA2B,MAAM,EAAE,EAAE;gBAC3E,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE;aAC5D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,eAAe,CAAC,MAAc,EAAE,KAAa;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS;YAC5B,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC;aACpE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1E,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,cAAc,CAAC,MAAc,EAAE,KAAa;QAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAEO,eAAe,CAAC,QAA4B;QAClD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;YAChD,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YAC7D,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA7DD,8CA6DC"}