feishu-docs-cli 0.1.0-beta.2

package/dist/cli.js

@@ -0,0 +1,166 @@
+/**
+ * CLI entry point: declarative command registration + routing.
+ * Supports both top-level commands and subcommands (e.g., share list).
+ */
+import { parseArgs } from "node:util";
+import { loginMeta, logoutMeta, whoamiMeta } from "./commands/login.js";
+import { meta as readMeta } from "./commands/read.js";
+import { meta as spaceMeta } from "./commands/spaces.js";
+import { meta as treeMeta } from "./commands/tree.js";
+import { meta as catMeta } from "./commands/cat.js";
+import { meta as searchMeta } from "./commands/search.js";
+import { meta as createMeta } from "./commands/create.js";
+import { meta as updateMeta } from "./commands/update.js";
+import { meta as deleteMeta } from "./commands/delete.js";
+import { meta as shareMeta } from "./commands/share.js";
+import { meta as infoMeta } from "./commands/info.js";
+import { meta as lsMeta } from "./commands/ls.js";
+import { meta as wikiMeta } from "./commands/wiki.js";
+import { handleError, CliError } from "./utils/errors.js";
+const HELP_TEXT = `feishu-docs - AI Agent 飞书云文档 CLI 工具
+
+用法: feishu-docs <command> [options]
+
+认证:
+  login [--scope "..."] [--redirect-uri <url>] [--port <port>]
+                                           OAuth 登录获取 user_access_token
+  logout                                   清除已保存的凭证
+  whoami                                   查看当前认证身份和模式
+
+文档:
+  read   <url|token>                       读取文档，输出 Markdown
+  create <title> [options]                 创建文档
+  update <url|token> [options]             更新文档内容
+  delete <url|token>                       删除文档
+  info   <url|token>                       查看文档元信息
+
+知识库:
+  spaces                                   列出所有知识库
+  tree   <space_id|url> [--node <token>]   展示知识库节点树
+  cat    <space_id|url> [--node <token>]   递归读取节点下所有文档
+  wiki create-space <name>                 创建知识库
+  wiki add-member <space_id> <member>      添加知识库成员
+  wiki remove-member <space_id> <member>   移除知识库成员
+  wiki rename <url> --title <new_title>    重命名节点
+  wiki move <url> --to <space_id>          移动节点
+  wiki copy <url> --to <space_id>          复制节点
+
+搜索:
+  search <query> [options]                 搜索文档
+
+云空间:
+  ls     [folder_token]                    列出文件夹内容
+
+权限:
+  share list <url>                         查看协作者
+  share add <url> <member> --role <role>   添加协作者
+  share set <url> --public <mode>          修改分享设置
+
+全局选项:
+  --auth <user|tenant|auto>   认证模式（默认 auto）
+  --json                      输出 JSON 格式
+  --lark                      使用海外 Lark 域名
+  --help                      显示帮助信息
+`;
+const GLOBAL_OPTIONS = {
+    auth: { type: "string", default: "auto" },
+    json: { type: "boolean", default: false },
+    lark: { type: "boolean", default: false },
+    help: { type: "boolean", default: false },
+};
+/**
+ * Command registry: name → meta definition.
+ * Each meta has: { handler, options, positionals } or { subcommands }.
+ */
+const COMMANDS = {
+    login: loginMeta,
+    logout: logoutMeta,
+    whoami: whoamiMeta,
+    read: readMeta,
+    spaces: spaceMeta,
+    tree: treeMeta,
+    cat: catMeta,
+    search: searchMeta,
+    create: createMeta,
+    update: updateMeta,
+    delete: deleteMeta,
+    share: shareMeta,
+    info: infoMeta,
+    ls: lsMeta,
+    wiki: wikiMeta,
+};
+function extractGlobalOpts(values) {
+    return {
+        auth: values.auth,
+        json: values.json,
+        lark: values.lark,
+    };
+}
+/**
+ * Remap hyphenated option keys to camelCase for args.
+ */
+function remapArgs(values, optionDefs) {
+    const args = {};
+    for (const key of Object.keys(optionDefs)) {
+        const camel = key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        if (values[key] !== undefined) {
+            args[camel] = values[key];
+        }
+    }
+    return args;
+}
+/**
+ * Parse and dispatch a command.
+ */
+function parseAndRun(def, argv) {
+    const allOptions = { ...GLOBAL_OPTIONS, ...def.options };
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: allOptions,
+        allowPositionals: def.positionals ?? false,
+        strict: false,
+    });
+    const globalOpts = extractGlobalOpts(values);
+    const args = remapArgs(values, def.options);
+    if (def.positionals) {
+        args.positionals = positionals;
+    }
+    return { handler: def.handler, args, globalOpts };
+}
+export async function run(argv) {
+    if (argv.length === 0 || argv.includes("--help") || argv.includes("-h")) {
+        process.stdout.write(HELP_TEXT);
+        return;
+    }
+    const command = argv[0];
+    const restArgs = argv.slice(1);
+    const def = COMMANDS[command];
+    if (!def) {
+        throw new CliError("INVALID_ARGS", `未知命令: ${command}。运行 feishu-docs --help 查看可用命令`);
+    }
+    let handler, args, globalOpts;
+    if (def.subcommands) {
+        const subDef = def;
+        const subName = restArgs[0];
+        if (!subName ||
+            subName === "--help" ||
+            subName === "-h" ||
+            !subDef.subcommands[subName]) {
+            const available = Object.keys(subDef.subcommands).join(", ");
+            throw new CliError("INVALID_ARGS", `用法: feishu-docs ${command} <${available}> [options]`);
+        }
+        const subCmd = subDef.subcommands[subName];
+        const subArgs = restArgs.slice(1);
+        ({ handler, args, globalOpts } = parseAndRun(subCmd, subArgs));
+    }
+    else {
+        ({ handler, args, globalOpts } = parseAndRun(def, restArgs));
+    }
+    try {
+        await handler(args, globalOpts);
+    }
+    catch (err) {
+        handleError(err, globalOpts.json);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Lark SDK client factory with auth mode support.
+ */
+import * as lark from "@larksuiteoapi/node-sdk";
+import type { AuthInfo, GlobalOpts, FetchOptions, ApiResponse } from "./types/index.js";
+/**
+ * Create a configured Lark SDK client.
+ * @param {object} options - { auth: 'user'|'tenant'|'auto', lark: boolean }
+ * @returns {{ client: lark.Client, authInfo: object }}
+ */
+export declare function createClient(options?: Partial<GlobalOpts>, _refreshAttempt?: number): Promise<{
+    client: lark.Client;
+    authInfo: AuthInfo;
+}>;
+/**
+ * Build request options with appropriate auth header.
+ */
+export declare function withAuth(authInfo: AuthInfo): {
+    headers?: {
+        Authorization: string;
+    };
+};
+/**
+ * Resolve the API base URL based on whether we're using Lark or Feishu.
+ */
+export declare function getApiBase(authInfo: AuthInfo): string;
+/**
+ * Get tenant_access_token for tenant mode API calls.
+ */
+export declare function getTenantToken(authInfo: AuthInfo): Promise<string>;
+/**
+ * Direct fetch wrapper that correctly passes user/tenant token.
+ * Use this instead of SDK methods for APIs where the SDK overrides the token.
+ */
+export declare function fetchWithAuth(authInfo: AuthInfo, path: string, options?: FetchOptions): Promise<ApiResponse>;
+/**
+ * Execute an API call with retry for idempotent operations.
+ */
+export declare function apiCall<T>(fn: () => Promise<T>, { retries, idempotent, }?: {
+    retries?: number;
+    idempotent?: boolean;
+}): Promise<T>;

package/dist/client.js

@@ -0,0 +1,269 @@
+/**
+ * Lark SDK client factory with auth mode support.
+ */
+import * as lark from "@larksuiteoapi/node-sdk";
+import { resolveAuth, refreshUserToken, acquireRefreshLock } from "./auth.js";
+import { CliError, mapApiError } from "./utils/errors.js";
+const silentLogger = {
+    fatal: () => { },
+    error: () => { },
+    warn: () => { },
+    info: () => { },
+    debug: () => { },
+    trace: () => { },
+};
+/**
+ * Create a configured Lark SDK client.
+ * @param {object} options - { auth: 'user'|'tenant'|'auto', lark: boolean }
+ * @returns {{ client: lark.Client, authInfo: object }}
+ */
+export async function createClient(options = {}, _refreshAttempt = 0) {
+    const authMode = options.auth || "auto";
+    const useLark = options.lark || false;
+    const resolved = await resolveAuth(authMode);
+    const authInfo = { ...resolved, useLark };
+    const { appId, appSecret } = authInfo;
+    if (!appId || !appSecret) {
+        if (authInfo.mode === "user" && authInfo.userToken) {
+            // User token from env, no app credentials needed for some APIs
+            // Create a minimal client
+            const client = new lark.Client({
+                appId: "placeholder",
+                appSecret: "placeholder",
+                domain: useLark ? lark.Domain.Lark : lark.Domain.Feishu,
+                logger: silentLogger,
+            });
+            return { client, authInfo };
+        }
+        throw new CliError("AUTH_REQUIRED", "缺少 FEISHU_APP_ID 或 FEISHU_APP_SECRET");
+    }
+    const client = new lark.Client({
+        appId,
+        appSecret,
+        domain: useLark ? lark.Domain.Lark : lark.Domain.Feishu,
+        logger: silentLogger,
+    });
+    // Auto-refresh user token if expired
+    if (authInfo.mode === "user" && authInfo.expiresAt) {
+        if (Date.now() >= authInfo.expiresAt) {
+            if (authInfo.refreshToken) {
+                try {
+                    process.stderr.write("feishu-docs: info: token 已过期，正在自动刷新...\n");
+                    const releaseLock = await acquireRefreshLock();
+                    if (!releaseLock) {
+                        if (_refreshAttempt >= 3) {
+                            throw new CliError("TOKEN_EXPIRED", "等待 token 刷新超时。如果问题持续，请手动删除 ~/.feishu-docs/.refresh.lock 后重试");
+                        }
+                        process.stderr.write("feishu-docs: info: 另一个进程正在刷新 token，等待中...\n");
+                        await new Promise((r) => setTimeout(r, 2000));
+                        return createClient(options, _refreshAttempt + 1);
+                    }
+                    try {
+                        const newTokens = await refreshUserToken(appId, appSecret, authInfo.refreshToken, { useLark });
+                        const refreshedAuthInfo = {
+                            ...authInfo,
+                            userToken: newTokens.user_access_token,
+                            expiresAt: newTokens.expires_at,
+                            refreshToken: newTokens.refresh_token,
+                        };
+                        return { client, authInfo: refreshedAuthInfo };
+                    }
+                    finally {
+                        await releaseLock();
+                    }
+                }
+                catch (refreshErr) {
+                    const refreshError = refreshErr;
+                    // In auto mode, fall back to tenant auth instead of failing
+                    if (authMode === "auto" && appId && appSecret) {
+                        process.stderr.write(`feishu-docs: info: 自动刷新失败 (${refreshError.message})，回退到 tenant 模式\n`);
+                        const tenantAuthInfo = {
+                            ...authInfo,
+                            mode: "tenant",
+                            userToken: undefined,
+                        };
+                        return { client, authInfo: tenantAuthInfo };
+                    }
+                    throw new CliError("TOKEN_EXPIRED", "自动刷新 token 失败，请重新运行 feishu-docs login", {
+                        recovery: "运行 feishu-docs login 重新认证",
+                    });
+                }
+            }
+            else {
+                // In auto mode, fall back to tenant auth instead of failing
+                if (authMode === "auto" && appId && appSecret) {
+                    process.stderr.write("feishu-docs: info: user token 已过期，回退到 tenant 模式\n");
+                    const tenantAuthInfo = {
+                        ...authInfo,
+                        mode: "tenant",
+                        userToken: undefined,
+                    };
+                    return { client, authInfo: tenantAuthInfo };
+                }
+                throw new CliError("TOKEN_EXPIRED", "token 已过期，请重新运行 feishu-docs login", {
+                    recovery: "运行 feishu-docs login 重新认证",
+                });
+            }
+        }
+    }
+    return { client, authInfo };
+}
+/**
+ * Build request options with appropriate auth header.
+ */
+export function withAuth(authInfo) {
+    if (authInfo.mode === "user" && authInfo.userToken) {
+        return {
+            headers: { Authorization: `Bearer ${authInfo.userToken}` },
+        };
+    }
+    // tenant mode uses SDK's built-in tenant_access_token
+    return {};
+}
+/**
+ * Resolve the API base URL based on whether we're using Lark or Feishu.
+ */
+export function getApiBase(authInfo) {
+    return authInfo.useLark
+        ? "https://open.larksuite.com"
+        : "https://open.feishu.cn";
+}
+/**
+ * Get tenant_access_token for tenant mode API calls.
+ */
+export async function getTenantToken(authInfo) {
+    const res = await fetch(`${getApiBase(authInfo)}/open-apis/auth/v3/tenant_access_token/internal`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            app_id: authInfo.appId,
+            app_secret: authInfo.appSecret,
+        }),
+    });
+    const body = (await res.json());
+    if (body.code !== 0) {
+        throw new CliError("AUTH_REQUIRED", `获取 tenant_access_token 失败: ${body.msg}`, {
+            apiCode: body.code,
+        });
+    }
+    if (!body.tenant_access_token) {
+        throw new CliError("AUTH_REQUIRED", "获取 tenant_access_token 失败: API 返回空值");
+    }
+    return body.tenant_access_token;
+}
+/**
+ * Build Authorization header value for any auth mode.
+ */
+async function resolveBearer(authInfo) {
+    if (authInfo.mode === "user" && authInfo.userToken) {
+        return `Bearer ${authInfo.userToken}`;
+    }
+    if (authInfo.tenantToken) {
+        return `Bearer ${authInfo.tenantToken}`;
+    }
+    const tenantToken = await getTenantToken(authInfo);
+    return `Bearer ${tenantToken}`;
+}
+/**
+ * Direct fetch wrapper that correctly passes user/tenant token.
+ * Use this instead of SDK methods for APIs where the SDK overrides the token.
+ */
+export async function fetchWithAuth(authInfo, path, options = {}) {
+    const base = getApiBase(authInfo);
+    const bearer = await resolveBearer(authInfo);
+    const url = new URL(path, base);
+    if (options.params) {
+        for (const [key, value] of Object.entries(options.params)) {
+            if (value === undefined || value === null)
+                continue;
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    url.searchParams.append(key, String(item));
+                }
+            }
+            else {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    const fetchOpts = {
+        method: options.method || "GET",
+        headers: {
+            Authorization: bearer,
+            "Content-Type": "application/json",
+            ...options.headers,
+        },
+    };
+    if (options.body) {
+        fetchOpts.body = JSON.stringify(options.body);
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 30_000);
+    let res;
+    try {
+        res = await fetch(url.toString(), {
+            ...fetchOpts,
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        const error = err;
+        if (error.name === "AbortError") {
+            throw new CliError("API_ERROR", "API 请求超时（30秒）", {
+                retryable: true,
+            });
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+    const body = (await res.json());
+    if (body.code !== undefined && body.code !== 0) {
+        throw mapApiError({ code: body.code, msg: body.msg });
+    }
+    return body;
+}
+/**
+ * Extract Feishu API error code from various error shapes.
+ */
+function extractErrorCode(err) {
+    const e = err;
+    return e?.code ?? e?.response?.data?.code ?? e?.response?.code;
+}
+/**
+ * Execute an API call with retry for idempotent operations.
+ */
+export async function apiCall(fn, { retries = 3, idempotent = true, } = {}) {
+    let lastError;
+    for (let attempt = 0; attempt <= (idempotent ? retries : 0); attempt++) {
+        try {
+            const res = await fn();
+            // Check SDK response code
+            const resWithCode = res;
+            if (resWithCode?.code && resWithCode.code !== 0) {
+                throw mapApiError({ code: resWithCode.code, msg: resWithCode.msg });
+            }
+            return res;
+        }
+        catch (err) {
+            lastError = err;
+            const code = extractErrorCode(err);
+            // Don't retry client errors (permission, not found, auth errors)
+            const NON_RETRYABLE = new Set([
+                131001, 131002, 131006, 131008, 99991400, 99991663,
+            ]);
+            if (code && NON_RETRYABLE.has(code)) {
+                throw mapApiError(err);
+            }
+            // Retry on network/server errors
+            if (attempt < retries && idempotent) {
+                const delay = 1000 * Math.pow(2, attempt);
+                await new Promise((r) => setTimeout(r, delay));
+                continue;
+            }
+        }
+    }
+    throw mapApiError(lastError);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/commands/cat.d.ts

@@ -0,0 +1,6 @@
+/**
+ * cat command: Recursively read all documents under a knowledge base node.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function cat(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/cat.js

@@ -0,0 +1,151 @@
+/**
+ * cat command: Recursively read all documents under a knowledge base node.
+ */
+import { createClient } from "../client.js";
+import { blocksToMarkdown } from "../parser/blocks-to-md.js";
+import { fetchChildren } from "../services/wiki-nodes.js";
+import { fetchAllBlocks } from "../services/doc-blocks.js";
+import { CliError } from "../utils/errors.js";
+import { validateToken } from "../utils/validate.js";
+/**
+ * Parse size string like "500k", "1m" to bytes.
+ */
+function parseSize(sizeStr) {
+    if (typeof sizeStr === "number")
+        return sizeStr;
+    const match = String(sizeStr).match(/^(\d+(?:\.\d+)?)\s*([km]?)$/i);
+    if (!match)
+        return Number(sizeStr) || Infinity;
+    const num = parseFloat(match[1]);
+    const unit = match[2].toLowerCase();
+    if (unit === "k")
+        return num * 1024;
+    if (unit === "m")
+        return num * 1024 * 1024;
+    return num;
+}
+/**
+ * Recursively collect and output documents.
+ */
+async function walkNodes(client, authInfo, spaceId, parentNodeToken, path, ctx) {
+    if (ctx.stopped)
+        return;
+    if (ctx.maxDepth !== undefined && ctx.currentDepth >= ctx.maxDepth)
+        return;
+    const children = await fetchChildren(authInfo, spaceId, parentNodeToken);
+    for (const node of children) {
+        if (ctx.stopped)
+            return;
+        const nodePath = path
+            ? `${path}/${node.title || "(无标题)"}`
+            : node.title || "(无标题)";
+        const objType = node.obj_type || "unknown";
+        // Filter by type
+        if (ctx.typeFilter && objType !== ctx.typeFilter) {
+            // Still recurse into non-matching nodes that have children
+            if (node.has_child) {
+                ctx.currentDepth++;
+                await walkNodes(client, authInfo, spaceId, node.node_token, nodePath, ctx);
+                ctx.currentDepth--;
+            }
+            continue;
+        }
+        // Check limits
+        if (ctx.docsRead >= ctx.maxDocs) {
+            ctx.skipped++;
+            ctx.stopped = true;
+            process.stderr.write(`feishu-docs: warning: 已达到 --max-docs 上限 (${ctx.maxDocs})，共跳过 ${ctx.skipped} 篇文档\n`);
+            return;
+        }
+        if (ctx.bytesWritten >= ctx.maxBytes) {
+            ctx.skipped++;
+            ctx.stopped = true;
+            process.stderr.write(`feishu-docs: warning: 已达到 --max-bytes 上限，共跳过 ${ctx.skipped} 篇文档\n`);
+            return;
+        }
+        // Output document
+        const header = `---\npath: ${nodePath}\ntoken: ${node.node_token}\ntype: ${objType}\n---\n\n`;
+        if (ctx.titleOnly) {
+            process.stdout.write(header);
+            ctx.bytesWritten += Buffer.byteLength(header);
+            ctx.docsRead++;
+        }
+        else if (objType === "docx") {
+            try {
+                const blocks = await fetchAllBlocks(client, authInfo, node.obj_token);
+                const md = blocksToMarkdown(blocks);
+                const output = header + md + "\n";
+                // Check byte limit before writing
+                const outputBytes = Buffer.byteLength(output);
+                if (ctx.bytesWritten + outputBytes > ctx.maxBytes) {
+                    ctx.skipped++;
+                    ctx.stopped = true;
+                    process.stderr.write(`feishu-docs: warning: 已达到 --max-bytes 上限，共跳过 ${ctx.skipped} 篇文档\n`);
+                    return;
+                }
+                process.stdout.write(output);
+                ctx.bytesWritten += outputBytes;
+                ctx.docsRead++;
+            }
+            catch (err) {
+                process.stderr.write(`feishu-docs: warning: 读取 ${nodePath} 失败: ${err.message}\n`);
+                ctx.docsRead++;
+            }
+        }
+        else {
+            // Non-docx types: output header only with type info
+            const output = header + `[${objType}: ${node.obj_token}]\n\n`;
+            process.stdout.write(output);
+            ctx.bytesWritten += Buffer.byteLength(output);
+            ctx.docsRead++;
+        }
+        // Recurse into children
+        if (node.has_child) {
+            ctx.currentDepth++;
+            await walkNodes(client, authInfo, spaceId, node.node_token, nodePath, ctx);
+            ctx.currentDepth--;
+        }
+    }
+}
+export const meta = {
+    options: {
+        node: { type: "string" },
+        depth: { type: "string" },
+        "max-docs": { type: "string" },
+        "max-bytes": { type: "string" },
+        "title-only": { type: "boolean", default: false },
+        type: { type: "string" },
+    },
+    positionals: true,
+    handler: cat,
+};
+export async function cat(args, globalOpts) {
+    const spaceId = args.positionals[0];
+    if (!spaceId) {
+        throw new CliError("INVALID_ARGS", "缺少知识库 ID。用法: feishu-docs cat <space_id> [--node <token>]");
+    }
+    validateToken(spaceId, "space_id");
+    const { client, authInfo } = await createClient(globalOpts);
+    const parentNode = args.node || undefined;
+    if (parentNode)
+        validateToken(parentNode, "node_token");
+    const ctx = {
+        maxDocs: args.maxDocs !== undefined ? Number(args.maxDocs) : 50,
+        maxBytes: args.maxBytes !== undefined
+            ? parseSize(args.maxBytes)
+            : parseSize("1m"),
+        maxDepth: args.depth !== undefined ? Number(args.depth) : undefined,
+        typeFilter: args.type || undefined,
+        titleOnly: args.titleOnly || false,
+        docsRead: 0,
+        bytesWritten: 0,
+        skipped: 0,
+        stopped: false,
+        currentDepth: 0,
+    };
+    await walkNodes(client, authInfo, spaceId, parentNode, "", ctx);
+    if (ctx.docsRead === 0) {
+        process.stderr.write("feishu-docs: info: 未找到任何文档\n");
+    }
+}
+//# sourceMappingURL=cat.js.map

package/dist/commands/cat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cat.js","sourceRoot":"","sources":["../../src/commands/cat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsBrD;;GAEG;AACH,SAAS,SAAS,CAAC,OAAwB;IACzC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC;IAC/C,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,GAAG,GAAG,IAAI,CAAC;IACpC,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3C,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,SAAS,CACtB,MAAmB,EACnB,QAAkB,EAClB,OAAe,EACf,eAAmC,EACnC,IAAY,EACZ,GAAY;IAEZ,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO;IACxB,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,QAAQ;QAAE,OAAO;IAE3E,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IAEzE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,OAAO;YAAE,OAAO;QAExB,MAAM,QAAQ,GAAG,IAAI;YACnB,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,EAAE;YACpC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC;QAE3C,iBAAiB;QACjB,IAAI,GAAG,CAAC,UAAU,IAAI,OAAO,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC;YACjD,2DAA2D;YAC3D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,GAAG,CAAC,YAAY,EAAE,CAAC;gBACnB,MAAM,SAAS,CACb,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,CAAC,UAAU,EACf,QAAQ,EACR,GAAG,CACJ,CAAC;gBACF,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,CAAC;YACD,SAAS;QACX,CAAC;QAED,eAAe;QACf,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChC,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4CAA4C,GAAG,CAAC,OAAO,SAAS,GAAG,CAAC,OAAO,QAAQ,CACpF,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACrC,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gDAAgD,GAAG,CAAC,OAAO,QAAQ,CACpE,CAAC;YACF,OAAO;QACT,CAAC;QAED,kBAAkB;QAClB,MAAM,MAAM,GAAG,cAAc,QAAQ,YAAY,IAAI,CAAC,UAAU,WAAW,OAAO,WAAW,CAAC;QAE9F,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC9C,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,CAAC;aAAM,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtE,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACpC,MAAM,MAAM,GAAG,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC;gBAElC,kCAAkC;gBAClC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC9C,IAAI,GAAG,CAAC,YAAY,GAAG,WAAW,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;oBAClD,GAAG,CAAC,OAAO,EAAE,CAAC;oBACd,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;oBACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gDAAgD,GAAG,CAAC,OAAO,QAAQ,CACpE,CAAC;oBACF,OAAO;gBACT,CAAC;gBAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC7B,GAAG,CAAC,YAAY,IAAI,WAAW,CAAC;gBAChC,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4BAA4B,QAAQ,QAAS,GAAa,CAAC,OAAO,IAAI,CACvE,CAAC;gBACF,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,oDAAoD;YACpD,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,OAAO,CAAC;YAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC9C,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,GAAG,CAAC,YAAY,EAAE,CAAC;YACnB,MAAM,SAAS,CACb,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,CAAC,UAAU,EACf,QAAQ,EACR,GAAG,CACJ,CAAC;YACF,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAgB;IAC/B,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;QACjD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACzB;IACD,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,GAAG;CACb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,IAAiB,EACjB,UAAsB;IAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAY,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEnC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,UAAU,GAAI,IAAI,CAAC,IAA2B,IAAI,SAAS,CAAC;IAClE,IAAI,UAAU;QAAE,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAExD,MAAM,GAAG,GAAY;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;QAC/D,QAAQ,EACN,IAAI,CAAC,QAAQ,KAAK,SAAS;YACzB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,QAA2B,CAAC;YAC7C,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;QACrB,QAAQ,EAAE,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QACnE,UAAU,EAAG,IAAI,CAAC,IAA2B,IAAI,SAAS;QAC1D,SAAS,EAAG,IAAI,CAAC,SAAqB,IAAI,KAAK;QAC/C,QAAQ,EAAE,CAAC;QACX,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,CAAC;KAChB,CAAC;IAEF,MAAM,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAEhE,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}