@mainwp/control 1.0.0

package/dist/lib/base-command.js

@@ -0,0 +1,285 @@
+/**
+ * Base command for mainwpcontrol
+ *
+ * Provides common functionality for all CLI commands:
+ * - Profile and authentication management
+ * - JSON/human output handling
+ * - AbilitiesExecutor initialization
+ */
+import { Command, Flags } from '@oclif/core';
+import { getProfileStore } from '../config/profile-store.js';
+import { getKeychain } from '../config/keychain.js';
+import { loadSettings, resolveSettings, } from '../config/settings.js';
+import { createAbilitiesExecutor } from '../core/abilities-executor.js';
+import { createBatchManager } from '../core/batch-manager.js';
+import { isMainWPCTLError, ConfigError } from '../utils/errors.js';
+import { successOutput, errorOutput } from '../output/json-envelope.js';
+import { ExitCode } from '../utils/exit-codes.js';
+import { formatError, formatWarning } from '../output/formatter.js';
+/**
+ * Common flags available to all commands
+ */
+export const commonFlags = {
+    json: Flags.boolean({
+        description: 'Output JSON (for scripting/CI)',
+        // No default - allows distinguishing "not provided" from "explicitly false"
+        // Precedence: --json flag > settings.defaultJsonOutput > false
+    }),
+    quiet: Flags.boolean({
+        char: 'q',
+        description: 'Suppress output (exit code only)',
+        default: false,
+    }),
+    profile: Flags.string({
+        char: 'p',
+        description: 'Use a specific profile',
+    }),
+    debug: Flags.boolean({
+        description: 'Show debug output',
+    }),
+};
+/**
+ * Base command class
+ *
+ * All mainwpcontrol commands should extend this class.
+ */
+export class BaseCommand extends Command {
+    /**
+     * Current active profile
+     */
+    currentProfile;
+    /**
+     * Whether to output JSON
+     */
+    jsonOutput = false;
+    /**
+     * Debug mode flag
+     */
+    debugMode = false;
+    /**
+     * Whether debug was explicitly requested on the CLI.
+     */
+    explicitDebugMode = false;
+    /**
+     * Quiet mode flag — suppress stdout output (exit code only)
+     */
+    quietMode = false;
+    /**
+     * Raw settings from settings.json
+     */
+    rawSettings = {};
+    /**
+     * Validated and normalized settings
+     */
+    settings = {
+        defaultJsonOutput: false,
+        timeout: 30000,
+        skipSSLVerification: false,
+        debug: false,
+        chatContextMessages: 20,
+        allowInsecureHttp: false,
+    };
+    /**
+     * Cached executor instance
+     */
+    executor;
+    /**
+     * Cached batch manager instance
+     */
+    batchManagerInstance;
+    /**
+     * Whether this command needs a profile to be loaded.
+     * Override to return false for commands like `login` that don't need a profile.
+     */
+    needsProfile() {
+        return true;
+    }
+    /**
+     * Initialize common functionality.
+     * Call this at the start of each command's run() method.
+     */
+    async initCommon(flags) {
+        // Load and validate settings
+        this.rawSettings = await loadSettings();
+        const resolved = resolveSettings(this.rawSettings);
+        this.settings = resolved.settings;
+        // Apply precedence: explicit flag > settings file > default (false)
+        // flags.json is undefined if not provided, boolean if provided
+        this.jsonOutput = flags.json ?? this.settings.defaultJsonOutput;
+        this.explicitDebugMode = flags.debug === true;
+        this.debugMode = flags.debug ?? this.settings.debug;
+        // Quiet mode: suppress stdout. --json and explicit --debug override --quiet.
+        this.quietMode = (flags.quiet ?? false) && !this.jsonOutput && !this.explicitDebugMode;
+        for (const warning of resolved.warnings) {
+            this.logToStderr(formatWarning(warning));
+        }
+        if (this.needsProfile()) {
+            await this.loadProfile(flags.profile);
+        }
+    }
+    /**
+     * Load the specified or active profile
+     */
+    async loadProfile(profileName) {
+        const profileStore = getProfileStore();
+        if (profileName) {
+            const profile = await profileStore.get(profileName);
+            if (!profile) {
+                throw new ConfigError(`Profile not found: ${profileName}`, undefined, 'List available profiles with `mainwpcontrol profile list` or create one with `mainwpcontrol login`');
+            }
+            this.currentProfile = profile;
+        }
+        else {
+            this.currentProfile = await profileStore.getActive();
+            if (!this.currentProfile) {
+                throw new ConfigError('No profile configured.', undefined, 'Create your first profile with `mainwpcontrol login`');
+            }
+        }
+        if (this.currentProfile) {
+            this.debugLog('Loaded profile', {
+                profile: this.currentProfile.name,
+                dashboardUrl: this.currentProfile.dashboardUrl,
+                skipSSLVerification: this.getTransportConfig().skipSSLVerification,
+            });
+        }
+    }
+    /**
+     * Get the AbilitiesExecutor instance
+     */
+    async getExecutor() {
+        if (this.executor) {
+            return this.executor;
+        }
+        if (!this.currentProfile) {
+            throw new ConfigError('No profile loaded', undefined, 'This is an internal error. Please report this issue.');
+        }
+        const keychain = getKeychain();
+        const password = await keychain.getOrThrow(this.currentProfile.name);
+        this.executor = createAbilitiesExecutor({
+            baseUrl: this.currentProfile.dashboardUrl,
+            username: this.currentProfile.username,
+            appPassword: password,
+            ...this.getTransportConfig(),
+        });
+        this.debugLog('Initialized abilities executor', {
+            profile: this.currentProfile.name,
+            timeoutMs: this.settings.timeout,
+            allowInsecureHttp: this.settings.allowInsecureHttp,
+            skipSSLVerification: this.getTransportConfig().skipSSLVerification,
+        });
+        return this.executor;
+    }
+    /**
+     * Get the BatchManager instance (lazy, cached)
+     */
+    async getBatchManager() {
+        if (this.batchManagerInstance) {
+            return this.batchManagerInstance;
+        }
+        if (!this.currentProfile) {
+            throw new ConfigError('No profile loaded', undefined, 'This is an internal error. Please report this issue.');
+        }
+        const keychain = getKeychain();
+        const appPassword = await keychain.getOrThrow(this.currentProfile.name);
+        this.batchManagerInstance = createBatchManager({
+            baseUrl: this.currentProfile.dashboardUrl,
+            username: this.currentProfile.username,
+            appPassword,
+            ...this.getTransportConfig(),
+        });
+        this.debugLog('Initialized batch manager', {
+            profile: this.currentProfile.name,
+            timeoutMs: this.settings.timeout,
+            allowInsecureHttp: this.settings.allowInsecureHttp,
+            skipSSLVerification: this.getTransportConfig().skipSSLVerification,
+        });
+        return this.batchManagerInstance;
+    }
+    /**
+     * Build common transport configuration using profile-scoped settings first.
+     */
+    getTransportConfig() {
+        return {
+            skipSSLVerification: this.currentProfile?.skipSSLVerification ?? this.settings.skipSSLVerification,
+            allowInsecureHttp: this.settings.allowInsecureHttp,
+            timeout: this.settings.timeout,
+        };
+    }
+    /**
+     * Emit redacted debug output to stderr.
+     */
+    debugLog(message, context) {
+        if (!this.shouldEmitDebug()) {
+            return;
+        }
+        const suffix = context && Object.keys(context).length > 0
+            ? ` ${JSON.stringify(this.redactDebugContext(context))}`
+            : '';
+        this.logToStderr(`[debug] ${message}${suffix}`);
+    }
+    shouldEmitDebug() {
+        if (!this.debugMode) {
+            return false;
+        }
+        return this.explicitDebugMode || !this.quietMode;
+    }
+    redactDebugContext(context) {
+        const sensitiveKeys = ['password', 'secret', 'token', 'authorization', 'cookie', 'apikey'];
+        const redacted = {};
+        for (const [key, value] of Object.entries(context)) {
+            if (sensitiveKeys.includes(key.toLowerCase())) {
+                redacted[key] = '[REDACTED]';
+                continue;
+            }
+            if (typeof value === 'string' && value.length > 300) {
+                redacted[key] = `${value.slice(0, 297)}...`;
+                continue;
+            }
+            if (value && typeof value === 'object' && !Array.isArray(value)) {
+                redacted[key] = this.redactDebugContext(value);
+                continue;
+            }
+            redacted[key] = value;
+        }
+        return redacted;
+    }
+    /**
+     * Output data in JSON or human-readable format.
+     *
+     * @param data - The data to output (used for JSON mode)
+     * @param humanFormatter - Optional function that returns human-readable string
+     */
+    output(data, humanFormatter) {
+        if (this.quietMode) {
+            return;
+        }
+        if (this.jsonOutput) {
+            const envelope = successOutput(data);
+            this.log(JSON.stringify(envelope, null, 2));
+        }
+        else if (humanFormatter) {
+            this.log(humanFormatter());
+        }
+    }
+    /**
+     * Handle errors with appropriate exit codes
+     */
+    async catch(err) {
+        // Re-throw oclif exit errors to preserve their exit code
+        if (err.oclif && typeof err.oclif.exit === 'number') {
+            throw err;
+        }
+        if (this.jsonOutput) {
+            const envelope = errorOutput(err);
+            this.log(JSON.stringify(envelope, null, 2));
+        }
+        else {
+            // Human-readable error output with hints
+            this.logToStderr(formatError(err));
+        }
+        // Determine exit code from error class (MainWPCTLError subclasses carry exitCode)
+        const exitCode = isMainWPCTLError(err) ? err.exitCode : (err.exitCode ?? ExitCode.INTERNAL_ERROR);
+        this.exit(exitCode);
+    }
+}
+//# sourceMappingURL=base-command.js.map

package/dist/lib/base-command.js.map

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

package/dist/output/formatter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Human-readable output formatter for mainwpcontrol
+ */
+/**
+ * Format a success message
+ */
+export declare function formatSuccess(message: string): string;
+/**
+ * Format an error message
+ */
+export declare function formatError(error: Error | string): string;
+/**
+ * Format a warning message
+ */
+export declare function formatWarning(message: string): string;
+/**
+ * Format an info message
+ */
+export declare function formatInfo(message: string): string;
+/**
+ * Format a heading
+ */
+export declare function formatHeading(text: string): string;
+/**
+ * Format a key-value pair
+ */
+export declare function formatKeyValue(key: string, value: unknown): string;
+/**
+ * Format a table of data
+ */
+export declare function formatTable(headers: string[], rows: string[][]): string;
+/**
+ * Format a list of items
+ */
+export declare function formatList(items: string[], bullet?: string): string;
+/**
+ * Format a preview/dry-run result
+ */
+export declare function formatPreview(action: string, affectedItems: unknown): string;
+/**
+ * Format a progress bar
+ */
+export declare function formatProgressBar(percent: number, width?: number): string;
+/**
+ * Format elapsed time
+ */
+export declare function formatElapsed(ms: number): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAgBzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAKlE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EAAE,GACf,MAAM,CAgCR;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,SAAM,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,GACrB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CASrE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAgBhD"}

package/dist/output/formatter.js

@@ -0,0 +1,138 @@
+/**
+ * Human-readable output formatter for mainwpcontrol
+ */
+import { isMainWPCTLError } from '../utils/errors.js';
+import { stripControlChars, sanitizeForTerminal, safeString } from '../utils/terminal-sanitizer.js';
+import { colors, color } from '../utils/colors.js';
+/**
+ * Format a success message
+ */
+export function formatSuccess(message) {
+    return color('✓ ', colors.green) + message;
+}
+/**
+ * Format an error message
+ */
+export function formatError(error) {
+    const message = error instanceof Error ? stripControlChars(error.message) : stripControlChars(error);
+    let output = color('✗ Error: ', colors.red, colors.bold) + message;
+    if (isMainWPCTLError(error)) {
+        if (error.details) {
+            // Sanitize error details before display (untrusted API data)
+            const sanitizedDetails = sanitizeForTerminal(error.details);
+            output += '\n' + color('  Details: ', colors.dim) + JSON.stringify(sanitizedDetails);
+        }
+        if (error.hint) {
+            output += '\n' + color('💡 ' + stripControlChars(error.hint), colors.dim);
+        }
+    }
+    return output;
+}
+/**
+ * Format a warning message
+ */
+export function formatWarning(message) {
+    return color('⚠ Warning: ', colors.yellow) + stripControlChars(message);
+}
+/**
+ * Format an info message
+ */
+export function formatInfo(message) {
+    return color('ℹ ', colors.blue) + message;
+}
+/**
+ * Format a heading
+ */
+export function formatHeading(text) {
+    return color(text, colors.bold, colors.cyan);
+}
+/**
+ * Format a key-value pair
+ */
+export function formatKeyValue(key, value) {
+    // Sanitize both key and value (may contain untrusted API data)
+    const safeKey = stripControlChars(key);
+    const valueStr = safeString(value);
+    return color(safeKey + ': ', colors.dim) + valueStr;
+}
+/**
+ * Format a table of data
+ */
+export function formatTable(headers, rows) {
+    if (rows.length === 0) {
+        return '(no data)';
+    }
+    // Sanitize all table data (may contain untrusted API data)
+    const safeHeaders = headers.map((h) => stripControlChars(h));
+    const safeRows = rows.map((row) => row.map((cell) => stripControlChars(cell ?? '')));
+    // Calculate column widths using sanitized data
+    const widths = safeHeaders.map((h, i) => {
+        const rowWidths = safeRows.map((r) => (r[i] ?? '').length);
+        return Math.max(h.length, ...rowWidths);
+    });
+    // Format header
+    const headerLine = safeHeaders
+        .map((h, i) => h.padEnd(widths[i] ?? 0))
+        .join('  ');
+    const separator = widths.map((w) => '-'.repeat(w)).join('  ');
+    // Format rows
+    const dataLines = safeRows.map((row) => row.map((cell, i) => (cell ?? '').padEnd(widths[i] ?? 0)).join('  '));
+    return [
+        color(headerLine, colors.bold),
+        separator,
+        ...dataLines,
+    ].join('\n');
+}
+/**
+ * Format a list of items
+ */
+export function formatList(items, bullet = '•') {
+    // Sanitize list items (may contain untrusted API data)
+    return items.map((item) => `  ${bullet} ${stripControlChars(item)}`).join('\n');
+}
+/**
+ * Format a preview/dry-run result
+ */
+export function formatPreview(action, affectedItems) {
+    // Sanitize preview data (may contain untrusted API data)
+    const sanitizedItems = sanitizeForTerminal(affectedItems);
+    const lines = [
+        color('Preview: ', colors.yellow, colors.bold) + stripControlChars(action),
+        '',
+        color('Affected items:', colors.dim),
+        JSON.stringify(sanitizedItems, null, 2),
+        '',
+        color('This is a preview. No changes have been made.', colors.yellow),
+        'To execute, run the command with --confirm',
+    ];
+    return lines.join('\n');
+}
+/**
+ * Format a progress bar
+ */
+export function formatProgressBar(percent, width = 20) {
+    const clampedPercent = Math.max(0, Math.min(100, percent));
+    const filled = Math.round((clampedPercent / 100) * width);
+    const empty = width - filled;
+    const bar = '█'.repeat(filled) + '░'.repeat(empty);
+    const percentStr = `${clampedPercent}%`.padStart(4);
+    return `[${bar}] ${percentStr}`;
+}
+/**
+ * Format elapsed time
+ */
+export function formatElapsed(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        const remainingMinutes = minutes % 60;
+        return `${hours}h ${remainingMinutes}m`;
+    }
+    if (minutes > 0) {
+        const remainingSeconds = seconds % 60;
+        return `${minutes}m ${remainingSeconds}s`;
+    }
+    return `${seconds}s`;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/output/formatter.js.map

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

package/dist/output/json-envelope.d.ts

@@ -0,0 +1,43 @@
+/**
+ * JSON output envelope for mainwpcontrol
+ *
+ * This structure is stable and should not be changed without a major version bump.
+ */
+import { type MainWPCTLError } from '../utils/errors.js';
+/**
+ * Stable CLI output envelope
+ */
+export interface CLIOutput<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+        hint?: string;
+    };
+    meta?: {
+        command: string;
+        timestamp: string;
+        version: string;
+    };
+}
+/**
+ * Create a success response
+ */
+export declare function successOutput<T>(data: T, meta?: {
+    command: string;
+    version: string;
+}): CLIOutput<T>;
+/**
+ * Create an error response
+ */
+export declare function errorOutput(error: MainWPCTLError | Error | string, meta?: {
+    command: string;
+    version: string;
+}): CLIOutput<never>;
+/**
+ * Format output as JSON string
+ */
+export declare function formatJSON<T>(output: CLIOutput<T>): string;
+//# sourceMappingURL=json-envelope.d.ts.map

package/dist/output/json-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-envelope.d.ts","sourceRoot":"","sources":["../../src/output/json-envelope.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG3E;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,IAAI,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1C,SAAS,CAAC,CAAC,CAAC,CAkBd;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,GAAG,KAAK,GAAG,MAAM,EACtC,IAAI,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1C,SAAS,CAAC,KAAK,CAAC,CAsClB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAE1D"}

package/dist/output/json-envelope.js

@@ -0,0 +1,73 @@
+/**
+ * JSON output envelope for mainwpcontrol
+ *
+ * This structure is stable and should not be changed without a major version bump.
+ */
+import { isMainWPCTLError } from '../utils/errors.js';
+import { sanitizeForTerminal, stripControlChars } from '../utils/terminal-sanitizer.js';
+/**
+ * Create a success response
+ */
+export function successOutput(data, meta) {
+    // Sanitize data to prevent terminal escape injection in piped JSON
+    const sanitizedData = sanitizeForTerminal(data);
+    const output = {
+        success: true,
+        data: sanitizedData,
+    };
+    if (meta) {
+        output.meta = {
+            command: meta.command,
+            timestamp: new Date().toISOString(),
+            version: meta.version,
+        };
+    }
+    return output;
+}
+/**
+ * Create an error response
+ */
+export function errorOutput(error, meta) {
+    let errorBody;
+    if (isMainWPCTLError(error)) {
+        errorBody = {
+            code: error.code,
+            message: stripControlChars(error.message),
+            details: error.details ? sanitizeForTerminal(error.details) : undefined,
+        };
+        if (error.hint) {
+            errorBody.hint = stripControlChars(error.hint);
+        }
+    }
+    else if (error instanceof Error) {
+        errorBody = {
+            code: 'INTERNAL_ERROR',
+            message: stripControlChars(error.message),
+        };
+    }
+    else {
+        errorBody = {
+            code: 'INTERNAL_ERROR',
+            message: stripControlChars(String(error)),
+        };
+    }
+    const output = {
+        success: false,
+        error: errorBody,
+    };
+    if (meta) {
+        output.meta = {
+            command: meta.command,
+            timestamp: new Date().toISOString(),
+            version: meta.version,
+        };
+    }
+    return output;
+}
+/**
+ * Format output as JSON string
+ */
+export function formatJSON(output) {
+    return JSON.stringify(output, null, 2);
+}
+//# sourceMappingURL=json-envelope.js.map

package/dist/output/json-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-envelope.js","sourceRoot":"","sources":["../../src/output/json-envelope.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAuB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAqBxF;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAO,EACP,IAA2C;IAE3C,mEAAmE;IACnE,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAM,CAAC;IAErD,MAAM,MAAM,GAAiB;QAC3B,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,aAAa;KACpB,CAAC;IAEF,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,GAAG;YACZ,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,KAAsC,EACtC,IAA2C;IAE3C,IAAI,SAAoC,CAAC;IAEzC,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,SAAS,GAAG;YACV,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC;YACzC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;SACxE,CAAC;QACF,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,SAAS,CAAC,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,SAAS,GAAG;YACV,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC;SAC1C,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,SAAS,GAAG;YACV,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAqB;QAC/B,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,SAAS;KACjB,CAAC;IAEF,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,GAAG;YACZ,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAI,MAAoB;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}