@mainwp/control 1.0.0

package/dist/utils/format.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Formatting utilities for mainwpcontrol
+ *
+ * Provides consistent secret masking across all commands.
+ */
+/**
+ * Options for customizing secret masking behavior
+ */
+export interface MaskOptions {
+    /** Number of characters to show at the start (default: 4) */
+    showFirst?: number;
+    /** Number of characters to show at the end (default: 4) */
+    showLast?: number;
+    /** Minimum length before masking applies; shorter secrets return placeholder (default: 8) */
+    minLength?: number;
+    /** Placeholder string for secrets that are too short to mask (default: '****') */
+    placeholder?: string;
+}
+/**
+ * Masks a secret value by showing only the first and last few characters.
+ *
+ * @param value - The secret string to mask
+ * @param options - Configuration options for masking behavior
+ * @returns The masked string in format "xxxx...xxxx" or the placeholder if too short
+ *
+ * @example
+ * ```ts
+ * maskSecret('mypassword123') // Returns 'mypa...d123'
+ * maskSecret('short') // Returns '****'
+ * maskSecret('api-key-12345678', { showFirst: 6, showLast: 4 }) // Returns 'api-ke...5678'
+ * ```
+ */
+export declare function maskSecret(value: string, options?: MaskOptions): string;
+/**
+ * Masks a password using standard format (4 chars...4 chars).
+ *
+ * Passwords 8 characters or shorter are fully masked with '****'.
+ *
+ * @param password - The password to mask
+ * @returns The masked password
+ *
+ * @example
+ * ```ts
+ * maskPassword('mypassword123') // Returns 'mypa...d123'
+ * maskPassword('short') // Returns '****'
+ * ```
+ */
+export declare function maskPassword(password: string): string;
+/**
+ * Masks an API key using standard format (6 chars...4 chars).
+ *
+ * API keys 10 characters or shorter are fully masked with '****'.
+ *
+ * @param apiKey - The API key to mask
+ * @returns The masked API key
+ *
+ * @example
+ * ```ts
+ * maskApiKey('sk-1234567890abcdefghij') // Returns 'sk-123...ghij'
+ * maskApiKey('shortkey') // Returns '****'
+ * ```
+ */
+export declare function maskApiKey(apiKey: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAa3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjD"}

package/dist/utils/format.js

@@ -0,0 +1,69 @@
+/**
+ * Formatting utilities for mainwpcontrol
+ *
+ * Provides consistent secret masking across all commands.
+ */
+/**
+ * Masks a secret value by showing only the first and last few characters.
+ *
+ * @param value - The secret string to mask
+ * @param options - Configuration options for masking behavior
+ * @returns The masked string in format "xxxx...xxxx" or the placeholder if too short
+ *
+ * @example
+ * ```ts
+ * maskSecret('mypassword123') // Returns 'mypa...d123'
+ * maskSecret('short') // Returns '****'
+ * maskSecret('api-key-12345678', { showFirst: 6, showLast: 4 }) // Returns 'api-ke...5678'
+ * ```
+ */
+export function maskSecret(value, options = {}) {
+    const { showFirst = 4, showLast = 4, minLength = 8, placeholder = '****', } = options;
+    if (!value || value.length <= minLength) {
+        return placeholder;
+    }
+    return `${value.substring(0, showFirst)}...${value.substring(value.length - showLast)}`;
+}
+/**
+ * Masks a password using standard format (4 chars...4 chars).
+ *
+ * Passwords 8 characters or shorter are fully masked with '****'.
+ *
+ * @param password - The password to mask
+ * @returns The masked password
+ *
+ * @example
+ * ```ts
+ * maskPassword('mypassword123') // Returns 'mypa...d123'
+ * maskPassword('short') // Returns '****'
+ * ```
+ */
+export function maskPassword(password) {
+    return maskSecret(password, {
+        showFirst: 4,
+        showLast: 4,
+        minLength: 8,
+    });
+}
+/**
+ * Masks an API key using standard format (6 chars...4 chars).
+ *
+ * API keys 10 characters or shorter are fully masked with '****'.
+ *
+ * @param apiKey - The API key to mask
+ * @returns The masked API key
+ *
+ * @example
+ * ```ts
+ * maskApiKey('sk-1234567890abcdefghij') // Returns 'sk-123...ghij'
+ * maskApiKey('shortkey') // Returns '****'
+ * ```
+ */
+export function maskApiKey(apiKey) {
+    return maskSecret(apiKey, {
+        showFirst: 6,
+        showLast: 4,
+        minLength: 10,
+    });
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,UAAuB,EAAE;IACjE,MAAM,EACJ,SAAS,GAAG,CAAC,EACb,QAAQ,GAAG,CAAC,EACZ,SAAS,GAAG,CAAC,EACb,WAAW,GAAG,MAAM,GACrB,GAAG,OAAO,CAAC;IAEZ,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACxC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;AAC1F,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,UAAU,CAAC,QAAQ,EAAE;QAC1B,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,CAAC;KACb,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,UAAU,CAAC,MAAM,EAAE;QACxB,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,EAAE;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/prompt.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Interactive prompting utilities for mainwpcontrol
+ *
+ * Handles user confirmation for destructive actions.
+ * Auto-declines in non-interactive mode unless explicit flags are used.
+ */
+/**
+ * Check if we're in an interactive terminal
+ */
+export declare function isInteractive(): boolean;
+/**
+ * Prompt for yes/no confirmation
+ *
+ * @param question - The question to ask
+ * @param defaultAnswer - Default answer if user just presses Enter (default: false)
+ * @returns true if user confirmed, false otherwise
+ */
+export declare function promptForConfirmation(question: string, defaultAnswer?: boolean): Promise<boolean>;
+/**
+ * Prompt for text input
+ *
+ * @param question - The question to ask
+ * @param defaultValue - Default value if user just presses Enter
+ * @returns The user's input (or default)
+ */
+export declare function promptForInput(question: string, defaultValue?: string): Promise<string>;
+/**
+ * Prompt for password input (hidden)
+ *
+ * @param question - The question to ask
+ * @returns The user's input
+ */
+export declare function promptForPassword(question: string): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/utils/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAoBD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,aAAa,UAAQ,GACpB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsEzE"}

package/dist/utils/prompt.js

@@ -0,0 +1,132 @@
+/**
+ * Interactive prompting utilities for mainwpcontrol
+ *
+ * Handles user confirmation for destructive actions.
+ * Auto-declines in non-interactive mode unless explicit flags are used.
+ */
+import * as readline from 'node:readline';
+import { colors, color } from './colors.js';
+/**
+ * Check if we're in an interactive terminal
+ */
+export function isInteractive() {
+    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+/**
+ * Ask a single question via readline, returning the raw answer.
+ * Handles interface creation and cleanup.
+ */
+function ask(promptText) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(promptText, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+/**
+ * Prompt for yes/no confirmation
+ *
+ * @param question - The question to ask
+ * @param defaultAnswer - Default answer if user just presses Enter (default: false)
+ * @returns true if user confirmed, false otherwise
+ */
+export async function promptForConfirmation(question, defaultAnswer = false) {
+    if (!isInteractive()) {
+        return defaultAnswer;
+    }
+    const hint = defaultAnswer ? '[Y/n]' : '[y/N]';
+    const prompt = color('? ', colors.yellow) + question + ' ' + color(hint, colors.dim) + ' ';
+    const answer = await ask(prompt);
+    const normalized = answer.trim().toLowerCase();
+    if (normalized === '')
+        return defaultAnswer;
+    return normalized === 'y' || normalized === 'yes';
+}
+/**
+ * Prompt for text input
+ *
+ * @param question - The question to ask
+ * @param defaultValue - Default value if user just presses Enter
+ * @returns The user's input (or default)
+ */
+export async function promptForInput(question, defaultValue) {
+    if (!isInteractive()) {
+        return defaultValue ?? '';
+    }
+    const defaultHint = defaultValue ? color(` (${defaultValue})`, colors.dim) : '';
+    const prompt = color('? ', colors.yellow) + question + defaultHint + ' ';
+    const answer = await ask(prompt);
+    return answer.trim() || defaultValue || '';
+}
+/**
+ * Prompt for password input (hidden)
+ *
+ * @param question - The question to ask
+ * @returns The user's input
+ */
+export async function promptForPassword(question) {
+    if (!isInteractive()) {
+        return '';
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    // Hide input
+    const stdin = process.stdin;
+    const originalRawMode = stdin.isRaw;
+    return new Promise((resolve) => {
+        const prompt = color('? ', colors.yellow) + question + ' ';
+        process.stdout.write(prompt);
+        let input = '';
+        // Enable raw mode to capture individual keystrokes
+        if (stdin.isTTY && stdin.setRawMode) {
+            stdin.setRawMode(true);
+        }
+        const onData = (char) => {
+            const c = char.toString('utf8');
+            switch (c) {
+                case '\n':
+                case '\r':
+                case '\u0004': // Ctrl-D
+                    // Restore raw mode and cleanup
+                    if (stdin.isTTY && stdin.setRawMode) {
+                        stdin.setRawMode(originalRawMode ?? false);
+                    }
+                    stdin.removeListener('data', onData);
+                    rl.close();
+                    process.stdout.write('\n');
+                    resolve(input);
+                    break;
+                case '\u0003': // Ctrl-C
+                    // Restore raw mode and exit
+                    if (stdin.isTTY && stdin.setRawMode) {
+                        stdin.setRawMode(originalRawMode ?? false);
+                    }
+                    stdin.removeListener('data', onData);
+                    rl.close();
+                    process.stdout.write('\n');
+                    process.exit(1);
+                    break;
+                case '\u007F': // Backspace
+                    if (input.length > 0) {
+                        input = input.slice(0, -1);
+                        // Clear character from display
+                        process.stdout.write('\b \b');
+                    }
+                    break;
+                default:
+                    // Regular character - add to input, show asterisk
+                    input += c;
+                    process.stdout.write('*');
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/utils/prompt.js.map

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

package/dist/utils/retry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Retry utilities for mainwpcontrol
+ *
+ * Provides exponential backoff functionality for polling operations.
+ */
+/**
+ * Backoff configuration options
+ */
+export interface BackoffOptions {
+    /** Initial delay in milliseconds (default: 1000) */
+    initialDelay?: number | undefined;
+    /** Maximum delay in milliseconds (default: 30000) */
+    maxDelay?: number | undefined;
+    /** Delay multiplier (default: 2) */
+    multiplier?: number | undefined;
+    /** Maximum number of retries (default: Infinity) */
+    maxRetries?: number | undefined;
+    /** Optional abort signal */
+    signal?: AbortSignal | undefined;
+}
+/**
+ * Exponential backoff delay calculator
+ */
+export declare class ExponentialBackoff {
+    private readonly initialDelay;
+    private readonly maxDelay;
+    private readonly multiplier;
+    private readonly maxRetries;
+    private readonly signal;
+    private currentDelay;
+    private retryCount;
+    constructor(options?: BackoffOptions);
+    /**
+     * Get the current retry count
+     */
+    get attempts(): number;
+    /**
+     * Get the current delay
+     */
+    get delay(): number;
+    /**
+     * Check if more retries are allowed
+     */
+    get canRetry(): boolean;
+    /**
+     * Reset the backoff state
+     */
+    reset(): void;
+    /**
+     * Wait for the current delay, then advance to the next interval
+     * Returns false if aborted or max retries exceeded
+     */
+    wait(): Promise<boolean>;
+    /**
+     * Get delay for a specific retry attempt (without advancing state)
+     */
+    getDelayForAttempt(attempt: number): number;
+}
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC;AAYD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,GAAE,cAAmB;IASxC;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAkC9B;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAK5C"}

package/dist/utils/retry.js

@@ -0,0 +1,96 @@
+/**
+ * Retry utilities for mainwpcontrol
+ *
+ * Provides exponential backoff functionality for polling operations.
+ */
+/**
+ * Default backoff configuration
+ */
+const DEFAULTS = {
+    initialDelay: 1000,
+    maxDelay: 30000,
+    multiplier: 2,
+    maxRetries: Infinity,
+};
+/**
+ * Exponential backoff delay calculator
+ */
+export class ExponentialBackoff {
+    initialDelay;
+    maxDelay;
+    multiplier;
+    maxRetries;
+    signal;
+    currentDelay;
+    retryCount = 0;
+    constructor(options = {}) {
+        this.initialDelay = options.initialDelay ?? DEFAULTS.initialDelay;
+        this.maxDelay = options.maxDelay ?? DEFAULTS.maxDelay;
+        this.multiplier = options.multiplier ?? DEFAULTS.multiplier;
+        this.maxRetries = options.maxRetries ?? DEFAULTS.maxRetries;
+        this.signal = options.signal;
+        this.currentDelay = this.initialDelay;
+    }
+    /**
+     * Get the current retry count
+     */
+    get attempts() {
+        return this.retryCount;
+    }
+    /**
+     * Get the current delay
+     */
+    get delay() {
+        return this.currentDelay;
+    }
+    /**
+     * Check if more retries are allowed
+     */
+    get canRetry() {
+        return this.retryCount < this.maxRetries;
+    }
+    /**
+     * Reset the backoff state
+     */
+    reset() {
+        this.currentDelay = this.initialDelay;
+        this.retryCount = 0;
+    }
+    /**
+     * Wait for the current delay, then advance to the next interval
+     * Returns false if aborted or max retries exceeded
+     */
+    async wait() {
+        if (!this.canRetry) {
+            return false;
+        }
+        if (this.signal?.aborted) {
+            return false;
+        }
+        const delay = this.currentDelay;
+        // Create a promise that resolves after delay or rejects on abort
+        await new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(resolve, delay);
+            if (this.signal) {
+                this.signal.addEventListener('abort', () => {
+                    clearTimeout(timeoutId);
+                    reject(new Error('Backoff aborted'));
+                }, { once: true });
+            }
+        });
+        // Advance to next interval
+        this.retryCount++;
+        this.currentDelay = Math.min(this.currentDelay * this.multiplier, this.maxDelay);
+        return true;
+    }
+    /**
+     * Get delay for a specific retry attempt (without advancing state)
+     */
+    getDelayForAttempt(attempt) {
+        if (attempt === 0)
+            return 0;
+        const delay = this.initialDelay * Math.pow(this.multiplier, attempt - 1);
+        return Math.min(delay, this.maxDelay);
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/dist/utils/terminal-sanitizer.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Terminal Output Sanitizer for mainwpcontrol
+ *
+ * Security utility to strip ANSI escape sequences and control characters
+ * from untrusted data before rendering to terminal output.
+ *
+ * Prevents:
+ * - Terminal escape sequence injection
+ * - Fake prompt attacks
+ * - Screen manipulation/overwriting
+ * - OSC command execution
+ */
+/**
+ * Strip all ANSI escape sequences and control characters from a string.
+ *
+ * This is the core sanitization function that removes:
+ * - ANSI CSI sequences (colors, cursor movement, screen control)
+ * - OSC sequences (window titles, clipboard commands)
+ * - Other escape sequences (DCS, APC, PM, SOS)
+ * - C0 control characters (except tab, newline, carriage return)
+ * - C1 control characters
+ *
+ * @param str - The string to sanitize
+ * @returns The sanitized string with all escape sequences removed
+ */
+export declare function stripControlChars(str: string): string;
+/**
+ * Recursively sanitize a value for safe terminal output.
+ *
+ * Handles:
+ * - Strings: strips control characters
+ * - Arrays: recursively sanitizes each element
+ * - Objects: recursively sanitizes each value
+ * - Other types: converted to string and sanitized
+ *
+ * @param value - The value to sanitize
+ * @returns A sanitized copy of the value (original is not modified)
+ */
+export declare function sanitizeForTerminal(value: unknown): unknown;
+/**
+ * Sanitize a string for safe display, preserving safe content.
+ *
+ * This is a convenience wrapper that handles non-string inputs
+ * by converting them to JSON first.
+ *
+ * @param value - The value to sanitize for display
+ * @returns A safe string suitable for terminal output
+ */
+export declare function safeString(value: unknown): string;
+/**
+ * Check if a string contains potentially dangerous escape sequences.
+ *
+ * Useful for logging or debugging when you want to detect
+ * but not necessarily remove escape sequences.
+ *
+ * @param str - The string to check
+ * @returns True if the string contains escape sequences
+ */
+export declare function containsEscapeSequences(str: string): boolean;
+//# sourceMappingURL=terminal-sanitizer.d.ts.map

package/dist/utils/terminal-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-sanitizer.d.ts","sourceRoot":"","sources":["../../src/utils/terminal-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuCH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAwBrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA6B3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoBjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAuB5D"}