@nocobase/app-cli-client 0.0.0-stage → 0.1.0-beta.0

package/dist/parse/arguments.js

@@ -0,0 +1,460 @@
+// Reading a command line against a manifest command (`kind: 'rest'`): the words after the command are its positional
+// parameters, in order, and its flags, each a path, query or body parameter, or a file to send.
+//
+// Flags: `--name value` or `--name=value`; a boolean is `--name` or `--no-name`; an array repeats; a `json` value is
+// JSON text, or `key=value` repeated for an object. A parameter with `contentFile` also takes `--<name>-file <path>`,
+// parsed as JSON for a `json` parameter. A command whose body may come from a file takes `--<body.file> <path.json>`,
+// whose fields the flags then override. An upload parameter (`in: 'file'`) is `--<name> <path>`, repeated when it takes
+// several files; a ticket parameter is `--<name> <path>`, one file; a changed-files parameter is the boolean `--<name>`;
+// a binary body field takes a path. A `download` command takes `--out <path>`. A command with a `fromEnv` parameter
+// takes `--from-env`, which fills it from the environment variable named by another parameter's value. A parameter with
+// `env` defaults, left off the line, takes the first of them the environment has (`envDefaultOf`). `--json`, `--help`
+// (`-h`) and `--yes` (`-y`) are read wherever they appear.
+//
+// It touches no file, environment or terminal itself: `CliParseIo` does, so the CLI on a machine and an online run's
+// shell read a line the same way.
+import { DOWNLOAD_OUT_FLAG, EXIT_CODES, } from '@nocobase/agent-protocol';
+/** A line the command cannot take, with what the cli-envelope says of it. */
+export class CliParseError extends Error {
+    code;
+    exit;
+    suggestions;
+    details;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = 'CliParseError';
+        this.code = code;
+        this.exit = options.exit ?? EXIT_CODES.validation;
+        this.suggestions = options.suggestions ?? [];
+        this.details = options.details;
+    }
+}
+const invalid = (message) => new CliParseError('INVALID_USAGE', message);
+/** A command's words, such as `issue comment add`. */
+export function commandWords(command) {
+    return command.id.split(':').join(' ');
+}
+/** The parameters a person types without a flag, in order. */
+export function positionalOf(command) {
+    return command.parameters
+        .filter((parameter) => parameter.position !== undefined)
+        .sort((a, b) => (a.position ?? 0) - (b.position ?? 0));
+}
+/** How a parameter is named on the line: `<issue>` or `--title`. */
+export function parameterLabel(parameter) {
+    return parameter.position === undefined
+        ? `--${parameter.name}`
+        : `<${parameter.name}>`;
+}
+/** Whether running the command sends a file of the caller's, or saves one. */
+export function needsLocalFiles(command) {
+    return (command.output.kind === 'download' ||
+        command.parameters.some((parameter) => (parameter.in === 'file' || parameter.binary === true) &&
+            parameter.required));
+}
+/** Whether a file name fits `accept` (extensions such as `.log`; media types are left to the server). */
+export function accepts(accept, file) {
+    const extensions = accept.filter((entry) => entry.startsWith('.'));
+    if (extensions.length === 0 || extensions.length < accept.length)
+        return true;
+    return extensions.some((extension) => file.toLowerCase().endsWith(extension.toLowerCase()));
+}
+/** A dot-separated path into parsed JSON, as text when it ends at a string or a number. */
+function fieldAt(value, path) {
+    let at = value;
+    for (const key of path.split('.')) {
+        if (!at || typeof at !== 'object' || Array.isArray(at))
+            return undefined;
+        at = at[key];
+    }
+    if (typeof at === 'number' && Number.isFinite(at))
+        return String(at);
+    return typeof at === 'string' ? at : undefined;
+}
+/**
+ * The first of `sources` the environment has: a variable that is set and not empty, or the field of the JSON file a
+ * variable names. Undefined when none is; an unreadable file or a missing field falls through to the next source.
+ */
+export async function envDefaultOf(sources, io) {
+    for (const source of sources) {
+        if (typeof source === 'string') {
+            const value = io.env(source);
+            if (value)
+                return value;
+            continue;
+        }
+        const file = io.env(source.file);
+        if (!file)
+            continue;
+        const text = await io.readText(file);
+        if (text === undefined)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            continue;
+        }
+        const value = fieldAt(parsed, source.path);
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+function scalar(parameter, raw) {
+    const label = parameterLabel(parameter);
+    switch (parameter.type) {
+        case 'number':
+        case 'integer':
+        case 'number[]': {
+            const value = Number(raw);
+            if (raw.trim() === '' || !Number.isFinite(value))
+                throw invalid(`${label} must be a number.`);
+            if (parameter.type === 'integer' && !Number.isInteger(value))
+                throw invalid(`${label} must be a whole number.`);
+            return value;
+        }
+        case 'boolean':
+            if (raw === 'true' || raw === 'false')
+                return raw === 'true';
+            throw invalid(`${label} must be true or false.`);
+        case 'json':
+            try {
+                return JSON.parse(raw);
+            }
+            catch {
+                return raw;
+            }
+        default:
+            if (parameter.enum && !parameter.enum.includes(raw))
+                throw invalid(`${label} must be one of ${parameter.enum.join(', ')}.`);
+            return raw;
+    }
+}
+/** Adds a typed value to what the parameter holds: arrays collect, a `json` object collects `key=value` pairs. */
+function collect(parameter, previous, raw) {
+    if (parameter.type === 'string[]' || parameter.type === 'number[]')
+        return [
+            ...(previous ?? []),
+            scalar(parameter, raw),
+        ];
+    if (parameter.type === 'json') {
+        const at = raw.indexOf('=');
+        const parsed = scalar(parameter, raw);
+        if (typeof parsed === 'string' && at > 0)
+            return {
+                ...(previous && typeof previous === 'object' && !Array.isArray(previous)
+                    ? previous
+                    : {}),
+                [raw.slice(0, at)]: raw.slice(at + 1),
+            };
+        return parsed;
+    }
+    return scalar(parameter, raw);
+}
+/** A value a person can type at a prompt: not a file. */
+const askable = (parameter) => parameter.in !== 'file' && !parameter.binary;
+/** What a line without its required arguments is told, and how to see them all. */
+export function missingArguments(bin, command, missing) {
+    const hint = (parameter) => {
+        if (parameter.ticket)
+            return `--${parameter.name} <file>`;
+        if (parameter.position !== undefined)
+            return `<${parameter.name}>`;
+        return parameter.contentFile
+            ? `--${parameter.name} (or --${parameter.name}-file <path>)`
+            : `--${parameter.name}`;
+    };
+    return new CliParseError('MISSING_ARGUMENT', `${bin} ${commandWords(command)} needs ${missing.map(hint).join(', ')}.`, {
+        suggestions: [
+            ...missing.map((parameter) => ({
+                message: `Pass ${hint(parameter)}${parameter.description ? `: ${parameter.description}` : '.'}`,
+            })),
+            {
+                message: 'See its arguments and flags.',
+                run: { command: bin, args: [...command.id.split(':'), '--help'] },
+            },
+        ],
+        details: { missing: missing.map((parameter) => parameter.name) },
+    });
+}
+/** Reads the rest of the line, after the command's words, against the command's parameters. */
+export async function parseCommandLine(command, rest, options) {
+    const { bin, io } = options;
+    const values = new Map();
+    const uploads = new Map();
+    const contentFiles = new Map();
+    const positional = positionalOf(command);
+    const flags = new Map();
+    for (const parameter of command.parameters)
+        if (parameter.position === undefined) {
+            flags.set(parameter.name, parameter);
+            if (parameter.alias)
+                flags.set(parameter.alias, parameter);
+        }
+    const args = [];
+    let bodyPath;
+    let out;
+    let yes = options.yes ?? false;
+    let json = false;
+    let help = false;
+    const fileUploads = [];
+    const binaries = [];
+    let ticketPath;
+    let changedFlag;
+    const fromEnvTarget = command.parameters.find((parameter) => parameter.fromEnv !== undefined);
+    let fromEnv = false;
+    const unavailable = (name) => new CliParseError('FILES_UNAVAILABLE', `--${name} sends a file from this machine; there are no files to send here.`);
+    for (let index = 0; index < rest.length; index += 1) {
+        const word = rest[index];
+        if (word === '--') {
+            args.push(...rest.slice(index + 1));
+            break;
+        }
+        if (word === '--help' || word === '-h') {
+            help = true;
+            continue;
+        }
+        if (word === '--json') {
+            json = true;
+            continue;
+        }
+        if (word === '--yes' || word === '-y') {
+            yes = true;
+            continue;
+        }
+        if (word === '--from-env' && fromEnvTarget) {
+            fromEnv = true;
+            continue;
+        }
+        if (!word.startsWith('-') || word === '-') {
+            args.push(word);
+            continue;
+        }
+        const long = word.startsWith('--');
+        const equals = word.indexOf('=');
+        const name = word.slice(long ? 2 : 1, equals === -1 ? undefined : equals);
+        const inline = equals === -1 ? undefined : word.slice(equals + 1);
+        const value = () => {
+            if (inline !== undefined)
+                return inline;
+            const next = rest[index + 1];
+            if (next === undefined)
+                throw invalid(`--${name} needs a value.`);
+            index += 1;
+            return next;
+        };
+        const parameter = flags.get(name);
+        if (parameter) {
+            if ((parameter.in === 'file' || parameter.binary) && !io.file)
+                throw unavailable(name);
+            if (parameter.changed) {
+                if (inline === undefined || inline === 'true')
+                    changedFlag = parameter;
+                else if (inline === 'false')
+                    changedFlag = undefined;
+                else
+                    throw invalid(`--${name} must be true or false.`);
+            }
+            else if (parameter.ticket) {
+                if (ticketPath)
+                    throw invalid(`--${name} takes one file.`);
+                ticketPath = [parameter, value()];
+            }
+            else if (parameter.in === 'file')
+                fileUploads.push([parameter, value()]);
+            else if (parameter.binary)
+                binaries.push([parameter, value()]);
+            else if (parameter.type === 'boolean' && inline === undefined)
+                values.set(parameter, true);
+            else
+                values.set(parameter, collect(parameter, values.get(parameter), value()));
+            continue;
+        }
+        const negated = name.startsWith('no-')
+            ? flags.get(name.slice(3))
+            : undefined;
+        if (negated?.changed) {
+            changedFlag = undefined;
+            continue;
+        }
+        if (negated?.type === 'boolean') {
+            values.set(negated, false);
+            continue;
+        }
+        const content = name.endsWith('-file')
+            ? command.parameters.find((candidate) => candidate.contentFile && `${candidate.name}-file` === name)
+            : undefined;
+        if (content) {
+            contentFiles.set(content, value());
+            continue;
+        }
+        if (command.body?.file !== undefined && name === command.body.file) {
+            bodyPath = value();
+            continue;
+        }
+        if (command.output.kind === 'download' && name === DOWNLOAD_OUT_FLAG) {
+            out = value();
+            continue;
+        }
+        throw invalid(`Unknown flag ${word.split('=')[0]}. Run \`${bin} ${commandWords(command)} --help\`.`);
+    }
+    if (help)
+        return {
+            values,
+            uploads,
+            yes,
+            json,
+            help,
+            ...(out === undefined ? {} : { out }),
+        };
+    if (args.length > positional.length)
+        throw invalid(`Too many arguments: ${bin} ${commandWords(command)} takes ${positional.length}.`);
+    positional.forEach((parameter, index) => {
+        const raw = args[index];
+        if (raw !== undefined)
+            values.set(parameter, scalar(parameter, raw));
+    });
+    for (const [parameter, file] of contentFiles) {
+        if (values.has(parameter))
+            throw invalid(`Give --${parameter.name} or --${parameter.name}-file, not both.`);
+        const text = await io.readText(file);
+        if (text === undefined)
+            throw invalid(`--${parameter.name}-file: cannot read ${file}.`);
+        if (parameter.type !== 'json') {
+            values.set(parameter, text);
+            continue;
+        }
+        try {
+            values.set(parameter, JSON.parse(text));
+        }
+        catch {
+            throw invalid(`--${parameter.name}-file: ${file} is not valid JSON.`);
+        }
+    }
+    if (fromEnv && fromEnvTarget) {
+        // The value is read here and goes only into the request: no message below repeats it.
+        if (values.has(fromEnvTarget))
+            throw invalid(`Give ${parameterLabel(fromEnvTarget)} or --from-env, not both.`);
+        const source = command.parameters.find((parameter) => parameter.field === fromEnvTarget.fromEnv);
+        const variable = source ? values.get(source) : undefined;
+        if (typeof variable !== 'string' || variable === '')
+            throw invalid(`--from-env reads the environment variable named by ${source ? parameterLabel(source) : fromEnvTarget.fromEnv}; give it.`);
+        const value = io.env(variable);
+        if (value === undefined)
+            throw invalid(`--from-env: ${variable} is not set in this environment.`);
+        values.set(fromEnvTarget, value);
+    }
+    const localFile = async (file, maxBytes, accept) => {
+        const found = await io.file?.(file);
+        if (!found)
+            throw invalid(`${file} is not a file.`);
+        if (maxBytes !== undefined && found.size > maxBytes)
+            throw invalid(`${file} is larger than ${maxBytes} bytes.`);
+        if (accept?.length && !accepts(accept, file))
+            throw invalid(`${file} is not one of ${accept.join(', ')}.`);
+        return found;
+    };
+    for (const [parameter, file] of fileUploads) {
+        const list = uploads.get(parameter) ?? [];
+        if (list.length > 0 && !parameter.upload?.multiple)
+            throw invalid(`--${parameter.name} takes one file.`);
+        list.push(await localFile(file, parameter.upload?.maxBytes));
+        uploads.set(parameter, list);
+    }
+    for (const [parameter, file] of binaries) {
+        const previous = values.get(parameter) ?? [];
+        values.set(parameter, [...previous, await localFile(file)]);
+    }
+    const ticket = ticketPath
+        ? await localFile(ticketPath[1], ticketPath[0].ticket?.maxBytes, ticketPath[0].ticket?.accept)
+        : undefined;
+    let changed;
+    if (changedFlag?.changed !== undefined) {
+        if (!io.changed)
+            throw unavailable(changedFlag.name);
+        changed = {
+            field: changedFlag.field,
+            files: await io.changed(changedFlag.changed, changedFlag.name),
+        };
+    }
+    let bodyFile;
+    if (bodyPath !== undefined) {
+        const text = await io.readText(bodyPath);
+        if (text === undefined)
+            throw invalid(`--${command.body?.file ?? 'file'}: cannot read ${bodyPath}.`);
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            throw invalid(`${bodyPath} is not valid JSON.`);
+        }
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            throw invalid(`${bodyPath} must hold a JSON object.`);
+        bodyFile = parsed;
+    }
+    // What CI already knows, such as the repository and the commit, for what neither the line nor the body file gives.
+    for (const parameter of command.parameters) {
+        if (!parameter.env?.length || values.has(parameter))
+            continue;
+        if (parameter.in === 'body' && bodyFile?.[parameter.field] !== undefined)
+            continue;
+        const value = await envDefaultOf(parameter.env, io);
+        if (value !== undefined)
+            values.set(parameter, collect(parameter, undefined, value));
+    }
+    if (options.dryRun) {
+        const flag = command.parameters.find((parameter) => parameter.name === 'dry-run' && parameter.type === 'boolean');
+        if (!flag)
+            throw new CliParseError('DRY_RUN_UNSUPPORTED', `The server offers no dry run of \`${bin} ${commandWords(command)}\`; nothing was sent.`, {
+                suggestions: [
+                    {
+                        message: 'Read what it does before running it without --dry-run.',
+                        run: { command: bin, args: [...command.id.split(':'), '--help'] },
+                    },
+                ],
+            });
+        values.set(flag, true);
+    }
+    const missing = [];
+    for (const parameter of command.parameters) {
+        if (!parameter.required || values.has(parameter))
+            continue;
+        if (parameter.ticket) {
+            if (ticket)
+                continue;
+            missing.push(parameter);
+            continue;
+        }
+        if (parameter.in === 'body' && bodyFile?.[parameter.field] !== undefined)
+            continue;
+        if (parameter.default !== undefined)
+            continue;
+        if (askable(parameter) && io.ask) {
+            values.set(parameter, collect(parameter, undefined, await io.ask(parameter)));
+            continue;
+        }
+        missing.push(parameter);
+    }
+    if (missing.length > 0)
+        throw missingArguments(bin, command, missing);
+    if (command.body?.file !== undefined &&
+        command.body.required &&
+        bodyFile === undefined &&
+        !command.parameters.some((parameter) => parameter.in === 'body' && values.has(parameter)))
+        throw invalid(`--${command.body.file} <file.json> is required.`);
+    return {
+        values,
+        ...(bodyFile ? { bodyFile } : {}),
+        uploads,
+        ...(ticket ? { ticket } : {}),
+        ...(changed ? { changed } : {}),
+        ...(out === undefined ? {} : { out }),
+        yes,
+        json,
+        help,
+    };
+}
+//# sourceMappingURL=arguments.js.map

package/dist/parse/arguments.js.map

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

package/dist/parse/exit.d.ts

@@ -0,0 +1,7 @@
+import { type ExitCode } from '@nocobase/agent-protocol';
+/**
+ * A reason of the standard error body (one with its canonical `apiStatus`, or one the agent protocol defines) decides;
+ * otherwise the HTTP status does, 0 meaning no response arrived.
+ */
+export declare function apiExitCode(httpStatus: number, reason: string, apiStatus?: string): ExitCode;
+//# sourceMappingURL=exit.d.ts.map

package/dist/parse/exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.d.ts","sourceRoot":"","sources":["../../src/parse/exit.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,CAUV"}

package/dist/parse/exit.js

@@ -0,0 +1,24 @@
+// The exit code of a failed request: what the CLI on a machine and an online run's shell both exit with.
+import { ERROR_API_STATUS, EXIT_CODES, exitCodeFor, } from '@nocobase/agent-protocol';
+/**
+ * A reason of the standard error body (one with its canonical `apiStatus`, or one the agent protocol defines) decides;
+ * otherwise the HTTP status does, 0 meaning no response arrived.
+ */
+export function apiExitCode(httpStatus, reason, apiStatus) {
+    if (apiStatus !== undefined || reason in ERROR_API_STATUS)
+        return exitCodeFor(reason, apiStatus);
+    if (httpStatus === 0)
+        return EXIT_CODES.network;
+    if (httpStatus === 401 || httpStatus === 403)
+        return EXIT_CODES.auth;
+    if (httpStatus === 404)
+        return EXIT_CODES.notFound;
+    if (httpStatus === 400)
+        return EXIT_CODES.validation;
+    if (httpStatus === 409)
+        return EXIT_CODES.conflict;
+    if (httpStatus >= 500)
+        return EXIT_CODES.network;
+    return EXIT_CODES.general;
+}
+//# sourceMappingURL=exit.js.map

package/dist/parse/exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../src/parse/exit.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,WAAW,GAEZ,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,UAAkB,EAClB,MAAc,EACd,SAAkB;IAElB,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,IAAI,gBAAgB;QACvD,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IAChD,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC;IACrE,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC;IACnD,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,UAAU,CAAC,UAAU,CAAC;IACrD,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC;IACnD,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IACjD,OAAO,UAAU,CAAC,OAAO,CAAC;AAC5B,CAAC"}

package/dist/parse/help.d.ts

@@ -0,0 +1,22 @@
+import type { CliCommand } from './manifest.ts';
+/** A help row: the flag as typed, and what it does. */
+export type HelpRow = readonly [string, string];
+export interface CommandHelpOptions {
+    /** The CLI's command name. */
+    readonly bin: string;
+    /** Listed under GLOBAL FLAGS; the section is left out when empty. */
+    readonly globalFlags?: readonly HelpRow[];
+    /** Whether the flags that send or save a file of the caller's are offered; true by default. */
+    readonly localFiles?: boolean;
+}
+/** Rows as two aligned columns, indented. */
+export declare function helpColumns(rows: readonly HelpRow[]): string[];
+/** The FLAGS rows of a command. */
+export declare function flagRows(command: CliCommand, localFiles?: boolean): HelpRow[];
+/** A command's help: usage, arguments, flags, description and examples. */
+export declare function renderCommandHelp(command: CliCommand, options: CommandHelpOptions): string;
+/** The commands under `prefix` (all with an empty prefix), one line each; undefined when there are none. */
+export declare function renderCommandList(commands: readonly CliCommand[], prefix?: readonly string[]): string | undefined;
+/** The help of the commands under `prefix`; undefined when there are none. */
+export declare function renderTopicHelp(bin: string, commands: readonly CliCommand[], prefix: readonly string[]): string | undefined;
+//# sourceMappingURL=help.d.ts.map

package/dist/parse/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/parse/help.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAA+B,MAAM,eAAe,CAAC;AAE7E,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1C,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,EAAE,CAK9D;AAuBD,mCAAmC;AACnC,wBAAgB,QAAQ,CACtB,OAAO,EAAE,UAAU,EACnB,UAAU,GAAE,OAAc,GACzB,OAAO,EAAE,CAwDX;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CA6CR;AAED,4GAA4G;AAC5G,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,MAAM,GAAE,SAAS,MAAM,EAAO,GAC7B,MAAM,GAAG,SAAS,CAUpB;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,GAAG,SAAS,CAUpB"}