feique 1.1.0

package/dist/feishu/client.js

@@ -0,0 +1,315 @@
+import { randomUUID } from 'node:crypto';
+import axios from 'axios';
+import * as lark from '@larksuiteoapi/node-sdk';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import { splitTextForFeishu } from './text.js';
+const FEISHU_MAX_SEND_ATTEMPTS = 3;
+const FEISHU_RETRY_BASE_DELAY_MS = 500;
+const FEISHU_RETRY_MAX_DELAY_MS = 5000;
+const FEISHU_REQUEST_TIMEOUT_MS = 10000;
+const RETRYABLE_NETWORK_CODES = new Set(['ECONNABORTED', 'ECONNRESET', 'ECONNREFUSED', 'ENOTFOUND', 'EAI_AGAIN', 'ETIMEDOUT']);
+export class FeishuClient {
+    config;
+    logger;
+    metrics;
+    client;
+    sdkHttpInstance;
+    constructor(config, logger, metrics) {
+        this.config = config;
+        this.logger = logger;
+        this.metrics = metrics;
+        this.sdkHttpInstance = this.createSdkHttpInstance();
+        this.client = new lark.Client({
+            appId: config.app_id,
+            appSecret: config.app_secret,
+            domain: lark.Domain.Feishu,
+            appType: lark.AppType.SelfBuild,
+            loggerLevel: lark.LoggerLevel.warn,
+            httpInstance: this.sdkHttpInstance,
+        });
+    }
+    createSdkClient() {
+        return this.client;
+    }
+    createWsClient() {
+        const agent = this.createWsAgent();
+        const httpInstance = this.createWsHttpInstance(agent);
+        return new lark.WSClient({
+            appId: this.config.app_id,
+            appSecret: this.config.app_secret,
+            domain: lark.Domain.Feishu,
+            loggerLevel: lark.LoggerLevel.warn,
+            ...(agent ? { agent } : {}),
+            ...(httpInstance ? { httpInstance } : {}),
+        });
+    }
+    async sendText(chatId, text, options = {}) {
+        const parts = splitTextForFeishu(text);
+        let lastResponse = {};
+        for (const [index, part] of parts.entries()) {
+            lastResponse = await this.sendMessage('chat_id', chatId, 'text', JSON.stringify({ text: part }), options);
+            this.logger.debug({ chatId, chunk: index + 1, totalChunks: parts.length }, 'Sent Feishu text chunk');
+        }
+        return lastResponse;
+    }
+    async sendCard(chatId, card, options = {}) {
+        return this.sendMessage('chat_id', chatId, 'interactive', JSON.stringify(card), options);
+    }
+    async sendPost(chatId, post, options = {}) {
+        return this.sendMessage('chat_id', chatId, 'post', JSON.stringify(post), options);
+    }
+    async updateText(messageId, text) {
+        return this.updateMessage(messageId, 'text', JSON.stringify({ text }));
+    }
+    async updateCard(messageId, card) {
+        return this.updateMessage(messageId, 'interactive', JSON.stringify(card));
+    }
+    async updatePost(messageId, post) {
+        return this.updateMessage(messageId, 'post', JSON.stringify(post));
+    }
+    async sendTextToReceiveId(receiveIdType, receiveId, text, options = {}) {
+        return this.sendMessage(receiveIdType, receiveId, 'text', JSON.stringify({ text }), options);
+    }
+    async requestApi(payload) {
+        let attempt = 0;
+        while (attempt < FEISHU_MAX_SEND_ATTEMPTS) {
+            attempt += 1;
+            try {
+                const response = (await this.client.request({
+                    method: payload.method,
+                    url: payload.url,
+                    ...(payload.params ? { params: payload.params } : {}),
+                    ...(payload.data ? { data: payload.data } : {}),
+                    timeout: payload.timeoutMs ?? FEISHU_REQUEST_TIMEOUT_MS,
+                }));
+                this.logger.debug({ url: payload.url, method: payload.method, attempt }, 'Feishu API request completed');
+                return response;
+            }
+            catch (error) {
+                const delayMs = getRetryDelayMs(error, attempt);
+                if (delayMs === null || attempt >= FEISHU_MAX_SEND_ATTEMPTS) {
+                    throw error;
+                }
+                this.logger.warn({ method: payload.method, url: payload.url, attempt, delayMs, err: error }, 'Retrying Feishu API request after transient failure');
+                await sleep(delayMs);
+            }
+        }
+        throw new Error(`Feishu API request failed unexpectedly: ${payload.method} ${payload.url}`);
+    }
+    async sendMessage(receiveIdType, receiveId, msgType, content, options = {}) {
+        if (this.config.dry_run) {
+            const dryRunId = `dry-run-${Date.now()}`;
+            const response = {
+                message_id: dryRunId,
+                open_message_id: dryRunId,
+            };
+            this.metrics?.recordOutboundMessage(msgType, 'success');
+            this.logger.info({ receiveIdType, receiveId, msgType, content, replyToMessageId: options.replyToMessageId }, 'Skipped Feishu outbound send because dry_run is enabled');
+            return response;
+        }
+        try {
+            const response = options.replyToMessageId
+                ? await this.requestApi({
+                    method: 'POST',
+                    url: `/open-apis/im/v1/messages/${encodeURIComponent(options.replyToMessageId)}/reply`,
+                    data: {
+                        content,
+                        msg_type: msgType,
+                        reply_in_thread: options.replyInThread ?? false,
+                        uuid: randomUUID(),
+                    },
+                })
+                : await this.requestApi({
+                    method: 'POST',
+                    url: '/open-apis/im/v1/messages',
+                    params: {
+                        receive_id_type: receiveIdType,
+                    },
+                    data: {
+                        receive_id: receiveId,
+                        content,
+                        msg_type: msgType,
+                        uuid: randomUUID(),
+                    },
+                });
+            ensureSuccessfulResponse(response);
+            this.metrics?.recordOutboundMessage(msgType, 'success');
+            this.logger.debug({ receiveIdType, receiveId, msgType, replyToMessageId: options.replyToMessageId }, 'Sent Feishu message');
+            return response.data ?? {};
+        }
+        catch (error) {
+            this.metrics?.recordOutboundMessage(msgType, 'failure');
+            throw error;
+        }
+    }
+    async updateMessage(messageId, msgType, content) {
+        if (this.config.dry_run) {
+            const response = {
+                message_id: messageId,
+                open_message_id: messageId,
+            };
+            this.metrics?.recordOutboundMessage(msgType, 'success');
+            this.logger.info({ messageId, msgType, content }, 'Skipped Feishu outbound update because dry_run is enabled');
+            return response;
+        }
+        try {
+            const response = await this.requestApi({
+                method: 'PATCH',
+                url: `/open-apis/im/v1/messages/${encodeURIComponent(messageId)}`,
+                data: {
+                    content,
+                    msg_type: msgType,
+                },
+            });
+            ensureSuccessfulResponse(response);
+            this.metrics?.recordOutboundMessage(msgType, 'success');
+            this.logger.debug({ messageId, msgType }, 'Updated Feishu message');
+            return response.data ?? {};
+        }
+        catch (error) {
+            this.metrics?.recordOutboundMessage(msgType, 'failure');
+            throw error;
+        }
+    }
+    createWsAgent() {
+        const proxyUrl = process.env.HTTPS_PROXY ??
+            process.env.https_proxy ??
+            process.env.HTTP_PROXY ??
+            process.env.http_proxy;
+        if (!proxyUrl) {
+            return undefined;
+        }
+        try {
+            return new HttpsProxyAgent(proxyUrl);
+        }
+        catch (error) {
+            this.logger.warn({ err: error }, 'Failed to build Feishu WebSocket proxy agent; falling back to direct connection');
+            return undefined;
+        }
+    }
+    createWsHttpInstance(agent) {
+        if (!agent) {
+            return undefined;
+        }
+        return this.createSdkHttpInstance(agent);
+    }
+    createSdkHttpInstance(agent) {
+        const httpInstance = axios.create({
+            ...(agent ? { httpAgent: agent, httpsAgent: agent } : {}),
+            proxy: false,
+        });
+        httpInstance.interceptors.request.use((request) => {
+            if (request.headers) {
+                request.headers['User-Agent'] = 'oapi-node-sdk/1.0.0';
+            }
+            return request;
+        }, undefined, { synchronous: true });
+        httpInstance.interceptors.response.use((response) => {
+            if (response.config.$return_headers) {
+                return {
+                    data: response.data,
+                    headers: response.headers,
+                };
+            }
+            return response.data;
+        });
+        return httpInstance;
+    }
+}
+function ensureSuccessfulResponse(response) {
+    if (response.code === undefined || response.code === 0 || response.code === '0') {
+        return;
+    }
+    const error = new Error(`Feishu API error ${String(response.code)}: ${response.msg ?? 'unknown error'}`);
+    error.retryable = isRetryableMessage(response.msg);
+    throw error;
+}
+function getRetryDelayMs(error, attempt) {
+    const retryAfterMs = getRetryAfterMs(error);
+    if (retryAfterMs !== null) {
+        return retryAfterMs;
+    }
+    const status = getErrorStatus(error);
+    if (status === 429 || (status !== null && status >= 500)) {
+        return boundedBackoff(attempt);
+    }
+    const code = getErrorCode(error);
+    if (code && RETRYABLE_NETWORK_CODES.has(code)) {
+        return boundedBackoff(attempt);
+    }
+    if (hasRetryableFlag(error) || isRetryableMessage(getErrorMessage(error))) {
+        return boundedBackoff(attempt);
+    }
+    return null;
+}
+function getRetryAfterMs(error) {
+    if (!isRecord(error)) {
+        return null;
+    }
+    const response = isRecord(error.response) ? error.response : null;
+    if (!response) {
+        return null;
+    }
+    const headers = isRecord(response.headers) ? response.headers : null;
+    if (!headers) {
+        return null;
+    }
+    const candidate = headers['retry-after'] ?? headers['Retry-After'];
+    if (typeof candidate === 'number' && Number.isFinite(candidate) && candidate >= 0) {
+        return candidate * 1000;
+    }
+    if (typeof candidate === 'string') {
+        const seconds = Number(candidate);
+        if (Number.isFinite(seconds) && seconds >= 0) {
+            return seconds * 1000;
+        }
+    }
+    return null;
+}
+function getErrorStatus(error) {
+    if (!isRecord(error)) {
+        return null;
+    }
+    const status = error.status;
+    if (typeof status === 'number') {
+        return status;
+    }
+    const response = isRecord(error.response) ? error.response : null;
+    return typeof response?.status === 'number' ? response.status : null;
+}
+function getErrorCode(error) {
+    if (!isRecord(error) || typeof error.code !== 'string') {
+        return null;
+    }
+    return error.code;
+}
+function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (isRecord(error) && typeof error.message === 'string') {
+        return error.message;
+    }
+    return '';
+}
+function hasRetryableFlag(error) {
+    return isRecord(error) && error.retryable === true;
+}
+function isRetryableMessage(message) {
+    if (typeof message !== 'string') {
+        return false;
+    }
+    return /(rate limit|too many requests|temporar|timeout|timed out|network|system busy|service unavailable)/i.test(message);
+}
+function boundedBackoff(attempt) {
+    return Math.min(FEISHU_RETRY_BASE_DELAY_MS * attempt, FEISHU_RETRY_MAX_DELAY_MS);
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/feishu/client.js.map

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

package/dist/feishu/diagnostics.d.ts

@@ -0,0 +1,42 @@
+import type { BridgeConfig } from '../config/schema.js';
+interface HttpJsonResponse {
+    status: number;
+    body: unknown;
+}
+type Requester = (request: {
+    method: 'GET' | 'POST';
+    url: string;
+    headers?: Record<string, string>;
+    body?: string;
+    timeoutMs: number;
+}) => Promise<HttpJsonResponse>;
+export interface FeishuProbeSummary {
+    ok: boolean;
+    code?: number | string;
+    msg?: string;
+    http_status?: number;
+}
+export interface FeishuInspectResult {
+    app_id: string;
+    transport: BridgeConfig['feishu']['transport'];
+    token: FeishuProbeSummary & {
+        expire?: number;
+    };
+    app: FeishuProbeSummary & {
+        name?: string;
+        status?: number;
+        pc_default_ability?: string | null;
+        mobile_default_ability?: string | null;
+    };
+    bot: FeishuProbeSummary & {
+        name?: string;
+        open_id?: string;
+        activate_status?: number;
+    };
+    chats_probe: FeishuProbeSummary & {
+        count?: number;
+    };
+}
+export declare function inspectFeishuEnvironment(config: BridgeConfig['feishu'], requester?: Requester): Promise<FeishuInspectResult>;
+export declare function formatFeishuInspect(result: FeishuInspectResult): string;
+export {};

package/dist/feishu/diagnostics.js

@@ -0,0 +1,194 @@
+import https from 'node:https';
+import { URL } from 'node:url';
+export async function inspectFeishuEnvironment(config, requester = requestJsonOverHttps) {
+    const tokenResponse = await fetchTenantAccessToken(config, requester);
+    const token = tokenResponse.envelope.tenant_access_token;
+    if (!token || !isEnvelopeOk(tokenResponse.envelope)) {
+        return {
+            app_id: config.app_id,
+            transport: config.transport,
+            token: {
+                ok: false,
+                code: tokenResponse.envelope.code,
+                msg: tokenResponse.envelope.msg,
+                http_status: tokenResponse.httpStatus,
+                expire: tokenResponse.envelope.expire,
+            },
+            app: { ok: false, msg: 'Skipped because token acquisition failed.' },
+            bot: { ok: false, msg: 'Skipped because token acquisition failed.' },
+            chats_probe: { ok: false, msg: 'Skipped because token acquisition failed.' },
+        };
+    }
+    const [appResponse, botResponse, chatsResponse] = await Promise.all([
+        feishuGet(token, `https://open.feishu.cn/open-apis/application/v6/applications/${config.app_id}?lang=zh_cn`, requester),
+        feishuGet(token, 'https://open.feishu.cn/open-apis/bot/v3/info', requester),
+        feishuGet(token, 'https://open.feishu.cn/open-apis/im/v1/chats?page_size=1', requester),
+    ]);
+    const botInfo = botResponse.envelope.bot ?? (isRecord(botResponse.envelope.data) ? botResponse.envelope.data : undefined);
+    return {
+        app_id: config.app_id,
+        transport: config.transport,
+        token: {
+            ok: true,
+            code: tokenResponse.envelope.code,
+            msg: tokenResponse.envelope.msg,
+            http_status: tokenResponse.httpStatus,
+            expire: tokenResponse.envelope.expire,
+        },
+        app: {
+            ...toProbeSummary(appResponse),
+            name: appResponse.envelope.data?.app?.app_name,
+            status: appResponse.envelope.data?.app?.status,
+            pc_default_ability: appResponse.envelope.data?.app?.pc_default_ability ?? null,
+            mobile_default_ability: appResponse.envelope.data?.app?.mobile_default_ability ?? null,
+        },
+        bot: {
+            ...toProbeSummary(botResponse),
+            name: botInfo?.app_name,
+            open_id: botInfo?.open_id,
+            activate_status: botInfo?.activate_status,
+        },
+        chats_probe: {
+            ...toProbeSummary(chatsResponse),
+            count: chatsResponse.envelope.data?.items?.length,
+        },
+    };
+}
+export function formatFeishuInspect(result) {
+    return [
+        `App ID: ${result.app_id}`,
+        `Transport: ${result.transport}`,
+        '',
+        `[token] ok=${result.token.ok} code=${stringOrDash(result.token.code)} msg=${stringOrDash(result.token.msg)} expire=${stringOrDash(result.token.expire)}`,
+        `[app] ok=${result.app.ok} code=${stringOrDash(result.app.code)} msg=${stringOrDash(result.app.msg)}`,
+        `  name=${stringOrDash(result.app.name)} status=${stringOrDash(result.app.status)} pc_default_ability=${stringOrDash(result.app.pc_default_ability)} mobile_default_ability=${stringOrDash(result.app.mobile_default_ability)}`,
+        `[bot] ok=${result.bot.ok} code=${stringOrDash(result.bot.code)} msg=${stringOrDash(result.bot.msg)}`,
+        `  name=${stringOrDash(result.bot.name)} activate_status=${stringOrDash(result.bot.activate_status)} open_id=${mask(result.bot.open_id)}`,
+        `[im.chats] ok=${result.chats_probe.ok} code=${stringOrDash(result.chats_probe.code)} msg=${stringOrDash(result.chats_probe.msg)} count=${stringOrDash(result.chats_probe.count)}`,
+    ].join('\n');
+}
+async function fetchTenantAccessToken(config, requester) {
+    try {
+        const response = await requester({
+            method: 'POST',
+            url: 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal',
+            headers: {
+                'content-type': 'application/json; charset=utf-8',
+                connection: 'close',
+            },
+            body: JSON.stringify({
+                app_id: config.app_id,
+                app_secret: config.app_secret,
+            }),
+            timeoutMs: 5000,
+        });
+        return {
+            httpStatus: response.status,
+            envelope: normalizeEnvelope(response.body),
+        };
+    }
+    catch (error) {
+        return {
+            envelope: {
+                msg: error instanceof Error ? error.message : String(error),
+            },
+        };
+    }
+}
+async function feishuGet(token, url, requester) {
+    try {
+        const response = await requester({
+            method: 'GET',
+            url,
+            headers: {
+                authorization: `Bearer ${token}`,
+                connection: 'close',
+            },
+            timeoutMs: 5000,
+        });
+        return {
+            httpStatus: response.status,
+            envelope: normalizeEnvelope(response.body),
+        };
+    }
+    catch (error) {
+        return {
+            envelope: {
+                msg: error instanceof Error ? error.message : String(error),
+            },
+        };
+    }
+}
+function toProbeSummary(response) {
+    return {
+        ok: isEnvelopeOk(response.envelope),
+        code: response.envelope.code,
+        msg: response.envelope.msg,
+        http_status: response.httpStatus,
+    };
+}
+function normalizeEnvelope(value) {
+    return isRecord(value) ? value : {};
+}
+function isEnvelopeOk(envelope) {
+    return envelope.code === undefined || envelope.code === 0 || envelope.code === '0';
+}
+function stringOrDash(value) {
+    if (value === null || value === undefined || value === '') {
+        return '-';
+    }
+    return String(value);
+}
+function mask(value) {
+    if (!value) {
+        return '-';
+    }
+    if (value.length <= 8) {
+        return value;
+    }
+    return `${value.slice(0, 6)}...${value.slice(-4)}`;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function requestJsonOverHttps(request) {
+    return new Promise((resolve, reject) => {
+        const target = new URL(request.url);
+        const req = https.request({
+            protocol: target.protocol,
+            hostname: target.hostname,
+            port: target.port ? Number(target.port) : undefined,
+            path: `${target.pathname}${target.search}`,
+            method: request.method,
+            headers: request.headers,
+            agent: false,
+        }, (response) => {
+            const chunks = [];
+            response.on('data', (chunk) => {
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            });
+            response.on('end', () => {
+                try {
+                    const bodyText = Buffer.concat(chunks).toString('utf8');
+                    const body = bodyText ? JSON.parse(bodyText) : {};
+                    resolve({
+                        status: response.statusCode ?? 0,
+                        body,
+                    });
+                }
+                catch (error) {
+                    reject(error);
+                }
+            });
+        });
+        req.setTimeout(request.timeoutMs, () => {
+            req.destroy(new Error(`Request timed out after ${request.timeoutMs}ms`));
+        });
+        req.on('error', reject);
+        if (request.body) {
+            req.write(request.body);
+        }
+        req.end();
+    });
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/feishu/diagnostics.js.map

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

package/dist/feishu/doc.d.ts

@@ -0,0 +1,13 @@
+import * as lark from '@larksuiteoapi/node-sdk';
+export interface FeishuDocRecord {
+    documentId: string;
+    title?: string;
+    content?: string;
+    url?: string;
+}
+export declare class FeishuDocClient {
+    private readonly client;
+    constructor(client: lark.Client);
+    create(title: string, folderToken?: string): Promise<FeishuDocRecord>;
+    read(target: string): Promise<FeishuDocRecord>;
+}

package/dist/feishu/doc.js

@@ -0,0 +1,59 @@
+export class FeishuDocClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(title, folderToken) {
+        const response = await this.client.docx.v1.document.create({
+            data: {
+                title,
+                ...(folderToken ? { folder_token: folderToken } : {}),
+            },
+        });
+        ensureSuccess(response);
+        const documentId = response.data?.document?.document_id;
+        if (!documentId) {
+            throw new Error('Feishu doc create returned no document_id.');
+        }
+        return {
+            documentId,
+            title: response.data?.document?.title ?? title,
+            url: `https://feishu.cn/docx/${documentId}`,
+        };
+    }
+    async read(target) {
+        const documentId = parseDocumentId(target);
+        const [metaResponse, contentResponse] = await Promise.all([
+            this.client.docx.v1.document.get({
+                path: {
+                    document_id: documentId,
+                },
+            }),
+            this.client.docx.v1.document.rawContent({
+                path: {
+                    document_id: documentId,
+                },
+            }),
+        ]);
+        ensureSuccess(metaResponse);
+        ensureSuccess(contentResponse);
+        return {
+            documentId,
+            title: metaResponse.data?.document?.title,
+            content: contentResponse.data?.content,
+            url: `https://feishu.cn/docx/${documentId}`,
+        };
+    }
+}
+function parseDocumentId(target) {
+    const trimmed = target.trim();
+    const match = trimmed.match(/\/docx\/([A-Za-z0-9]+)/i);
+    return match?.[1] ?? trimmed;
+}
+function ensureSuccess(response) {
+    if (response.code === undefined || response.code === 0) {
+        return;
+    }
+    throw new Error(`Feishu API error ${response.code}: ${response.msg ?? 'unknown error'}`);
+}
+//# sourceMappingURL=doc.js.map

package/dist/feishu/doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc.js","sourceRoot":"","sources":["../../src/feishu/doc.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,eAAe;IACU;IAApC,YAAoC,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,WAAoB;QACrD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YACzD,IAAI,EAAE;gBACJ,KAAK;gBACL,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD;SACF,CAAC,CAAC;QACH,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC;QACxD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,OAAO;YACL,UAAU;YACV,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,IAAI,KAAK;YAC9C,GAAG,EAAE,0BAA0B,UAAU,EAAE;SAC5C,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAAc;QAC9B,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAC/B,IAAI,EAAE;oBACJ,WAAW,EAAE,UAAU;iBACxB;aACF,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACtC,IAAI,EAAE;oBACJ,WAAW,EAAE,UAAU;iBACxB;aACF,CAAC;SACH,CAAC,CAAC;QACH,aAAa,CAAC,YAAY,CAAC,CAAC;QAC5B,aAAa,CAAC,eAAe,CAAC,CAAC;QAC/B,OAAO;YACL,UAAU;YACV,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK;YACzC,OAAO,EAAE,eAAe,CAAC,IAAI,EAAE,OAAO;YACtC,GAAG,EAAE,0BAA0B,UAAU,EAAE;SAC5C,CAAC;IACJ,CAAC;CACF;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACvD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;AAC/B,CAAC;AAED,SAAS,aAAa,CAAC,QAAyC;IAC9D,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO;IACT,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC,CAAC;AAC3F,CAAC"}