http-mitm-proxy-ui 0.1.1

package/README.md

@@ -0,0 +1,359 @@
+# http-mitm-proxy-ui
+
+A self-contained Node.js package that bundles `http-mitm-proxy` with a modern web-based UI for inspecting HTTP/HTTPS traffic in real time.
+
+![http-mitm-proxy-ui screenshot](docs/images/screenshot.png)
+
+## Features
+
+- **Real-time Traffic Inspection**: Live stream of HTTP/HTTPS requests and responses with WebSocket updates
+- **Complete Request/Response Details**: Headers, bodies, cookies, query parameters with syntax highlighting
+- **Advanced Filtering & Search**: Filter by domain, method, status code, content type with full-text search
+- **Export Data**: Export traffic as JSON or CSV for offline analysis and sharing
+- **HTTPS Interception**: Auto-generates and manages SSL certificates with easy CA download
+- **Standalone CLI**: Single command to start both proxy and UI with configurable options
+- **REST API**: Programmatic access to traffic data and configuration
+- **Material Design UI**: Clean, responsive interface with red/black on white theme
+
+## Guides
+
+- 📖 **[User Guide](docs/guides/USER-GUIDE.md)** — Complete documentation with screenshots
+- 🔍 **[Qwen Code Use Cases](docs/guides/use-cases-qwen-code.md)** — Inspect Qwen Code API traffic with examples
+
+## Installation
+
+```bash
+npm install http-mitm-proxy-ui
+```
+
+## Usage
+
+### CLI Usage
+
+Start with default ports (proxy: 8080, UI: 3000):
+
+```bash
+npx http-mitm-proxy-ui
+```
+
+Custom configuration:
+
+```bash
+http-mitm-proxy-ui --proxy-port 9090 --ui-port 4000 --ssl-ca-dir ./my-certs
+```
+
+Available options:
+- `-p, --proxy-port <port>`: MITM proxy server port (default: 8080)
+- `-u, --ui-port <port>`: Web UI server port (default: 3000)
+- `-H, --headless`: Run in proxy-only mode (no UI)
+- `-c, --config <path>`: Path to JSON config file
+- `--ssl-ca-dir <path>`: Directory for SSL CA certificates
+- `--ca-cert <path>`: Path to custom CA certificate file (.pem)
+- `--ca-key <path>`: Path to custom CA private key file (.pem)
+- `--max-requests <count>`: Max requests to keep in memory (default: 1000)
+- `-h, --help`: Display help
+
+### Using Custom CA Certificates
+
+If you already have a CA certificate and key (e.g., from a corporate PKI or a previous proxy setup), you can use them instead of auto-generating:
+
+```bash
+http-mitm-proxy-ui --ca-cert /path/to/ca.pem --ca-key /path/to/ca.key
+```
+
+Both `--ca-cert` and `--ca-key` must be provided together. The files are copied into the `--ssl-ca-dir` (default: `~/.http-mitm-proxy-ui/ca`) in the format expected by the proxy. When omitted, a new CA is auto-generated on first run.
+
+You can also set these in a JSON config file:
+
+```json
+{
+  "caCertPath": "/path/to/ca.pem",
+  "caKeyPath": "/path/to/ca.key"
+}
+```
+
+### Programmatic Usage
+
+```typescript
+import { createProxyUI } from 'http-mitm-proxy-ui';
+
+const proxy = createProxyUI({
+  proxyPort: 8080,
+  uiPort: 3000,
+});
+
+proxy.on('request', (req) => {
+  console.log('Request:', req.method, req.url);
+});
+
+proxy.on('response', (req) => {
+  console.log('Response:', req.response?.statusCode);
+});
+
+await proxy.start();
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────┐
+│           http-mitm-proxy-ui                │
+├──────────────────┬──────────────────────────┤
+│  MITM Proxy      │  Web UI Server           │
+│  (http-mitm-     │  (Express + Vue 3)       │
+│   proxy core)    │                          │
+│  - Intercept     │  - WebSocket for         │
+│    HTTP/HTTPS    │    real-time updates     │
+│  - Capture &     │  - REST API for          │
+│    emit events   │    history/query         │
+│                  │  - Static file serving   │
+└────────┬─────────┴────────────┬─────────────┘
+         │                      │
+         ▼                      ▼
+    Network Traffic        Browser (localhost:3000)
+    (localhost:8080)
+```
+
+## API Endpoints
+
+When the UI server is running (not headless):
+
+- `GET /api/health` - Health check
+- `GET /api/requests` - List requests with filtering/pagination
+- `GET /api/requests/:id` - Get specific request details
+- `DELETE /api/requests` - Clear request history
+- `GET /api/config` - Get current configuration
+- `GET /api/ca-cert` - Download CA certificate for trust installation
+- `GET /*` - Serves the Vue SPA (all other routes)
+
+## WebSocket Events
+
+Connect to `ws://localhost:3000/ws` for real-time updates:
+
+- `{ type: 'init', data: [...] }` - Initial state on connection
+- `{ type: 'request', data: RequestRecord }` - New request captured
+- `{ type: 'response', data: RequestRecord }` - Response received
+- `{ type: 'error', data: { message: string } }` - Error occurred
+- `{ type: 'clear', data: {} }` - History cleared
+
+## Configuration
+
+Create a `proxy-config.json` file:
+
+```json
+{
+  "proxyPort": 8080,
+  "uiPort": 3000,
+  "sslCaDir": "./certs",
+  "maxRequests": 1000,
+  "headless": false
+}
+```
+
+Then start with: `http-mitm-proxy-ui --config ./proxy-config.json`
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the package
+npm run build
+
+# Start in development mode (watches for changes)
+npm run dev
+
+# Run tests
+npm test
+```
+
+## Use Cases
+
+### Debugging API Calls
+1. Start the proxy: `http-mitm-proxy-ui`
+2. Configure your application to use `localhost:8080` as HTTP/HTTPS proxy
+3. Visit `http://localhost:3000` to see live traffic
+4. Use filtering to isolate specific endpoints
+5. Inspect full request/response details including headers, bodies, and timing
+
+### Mobile App Testing
+1. Start the proxy on your development machine
+2. Configure your mobile device to use your machine's IP:8080 as proxy
+3. Install the CA certificate on your device (download from `http://YOUR_IP:3000/api/ca-cert`)
+4. Inspect mobile app network calls with full visibility
+
+### Security Testing
+1. Capture and inspect all traffic for unexpected requests or data leaks
+2. Verify authorization headers and sensitive data in transit
+3. Export captured traffic as JSON or CSV for team analysis
+
+## Configuring Existing Applications to Use the Proxy
+
+The primary purpose of this tool is to **intercept and inspect traffic from existing applications without modifying their code**. You do this by setting proxy environment variables or command-line flags.
+
+### Step 1: Install the CA Certificate (for HTTPS)
+
+Before intercepting HTTPS traffic, you must trust the proxy's CA certificate:
+
+```bash
+# Start the proxy once to generate the CA
+http-mitm-proxy-ui
+
+# Download the CA certificate
+curl http://localhost:3000/api/ca-cert -o http-mitm-proxy-ca.pem
+
+# On macOS, add to Keychain and trust it:
+security add-trusted-cert -d -r trustRoot -k ~/Library/Keychains/login.keychain http-mitm-proxy-ca.pem
+
+# On Linux (Debian/Ubuntu):
+sudo cp http-mitm-proxy-ca.pem /usr/local/share/ca-certificates/
+sudo update-ca-certificates
+```
+
+### Step 2: Configure Your Application
+
+#### Node.js Applications
+
+Node.js respects standard proxy environment variables. Start your app with:
+
+```bash
+# For HTTP and HTTPS traffic
+HTTP_PROXY=http://localhost:8080 HTTPS_PROXY=http://localhost:8080 node your-app.js
+
+# Or if using npm scripts
+HTTP_PROXY=http://localhost:8080 HTTPS_PROXY=http://localhost:8080 npm start
+
+# For apps that use the `proxy` env var (some libraries)
+proxy=http://localhost:8080 node your-app.js
+```
+
+**Note**: Some HTTP clients in Node.js (like `axios`, `node-fetch`) don't automatically respect env vars. For those, you may need to pass an `agent` with proxy support, or use `global-agent`:
+
+```bash
+# Force all Node.js HTTP clients through the proxy
+npx global-agent bootstrap -- node your-app.js
+```
+
+#### curl / wget
+
+```bash
+# curl with proxy
+curl --proxy http://localhost:8080 https://api.example.com/data
+
+# curl with explicit HTTPS proxy (for HTTPS targets)
+curl --proxy http://localhost:8080 --proxy-insecure https://api.example.com/data
+
+# wget with proxy
+export http_proxy=http://localhost:8080
+export https_proxy=http://localhost:8080
+wget https://api.example.com/data
+```
+
+#### Java Applications
+
+Java uses system properties for proxy configuration. Pass them via `-D` flags:
+
+```bash
+# Basic HTTP proxy
+java -Dhttp.proxyHost=localhost -Dhttp.proxyPort=8080 \
+     -Dhttps.proxyHost=localhost -Dhttps.proxyPort=8080 \
+     -jar your-app.jar
+
+# For Spring Boot apps
+java -Dhttp.proxyHost=localhost -Dhttp.proxyPort=8080 \
+     -Dhttps.proxyHost=localhost -Dhttps.proxyPort=8080 \
+     -Dhttp.nonProxyHosts="localhost|127.0.0.1" \
+     -jar your-app.jar
+
+# For Maven-based apps
+mvn -Dhttp.proxyHost=localhost -Dhttp.proxyPort=8080 \
+    -Dhttps.proxyHost=localhost -Dhttps.proxyPort=8080 \
+    spring-boot:run
+
+# For Gradle-based apps
+gradle -Dorg.gradle.jvmargs="-Dhttp.proxyHost=localhost -Dhttp.proxyPort=8080 -Dhttps.proxyHost=localhost -Dhttps.proxyPort=8080" bootRun
+```
+
+**Note**: Java's default HTTP client may not intercept all traffic (e.g., OkHttp, Apache HttpClient may need separate proxy config). See [Java-specific notes below](#java-specific-http-clients).
+
+#### Python Applications
+
+```bash
+# Standard library (urllib, requests with env var support)
+HTTP_PROXY=http://localhost:8080 HTTPS_PROXY=http://localhost:8080 python your-app.py
+
+# For pip itself (debugging package installs)
+HTTP_PROXY=http://localhost:8080 HTTPS_PROXY=http://localhost:8080 pip install requests
+```
+
+#### Docker Containers
+
+```bash
+# Pass proxy env vars to container
+docker run -e HTTP_PROXY=http://host.docker.internal:8080 \
+           -e HTTPS_PROXY=http://host.docker.internal:8080 \
+           your-image
+
+# Or in docker-compose.yml:
+# services:
+#   app:
+#     environment:
+#       - HTTP_PROXY=http://host.docker.internal:8080
+#       - HTTPS_PROXY=http://host.docker.internal:8080
+```
+
+**Note**: On macOS/Windows, use `host.docker.internal` instead of `localhost` to reach the host machine from inside a container.
+
+#### React / Angular / Vue Dev Servers
+
+```bash
+# React (Create React App)
+HTTP_PROXY=http://localhost:8080 npm start
+
+# Angular
+HTTP_PROXY=http://localhost:8080 ng serve
+
+# Vite
+HTTP_PROXY=http://localhost:8080 npm run dev
+```
+
+### Java-Specific HTTP Clients
+
+Some Java HTTP libraries don't respect the `-D` system properties above. Configure them individually:
+
+**OkHttp:**
+```java
+Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("localhost", 8080));
+OkHttpClient client = new OkHttpClient.Builder()
+    .proxy(proxy)
+    .build();
+```
+
+**Apache HttpClient:**
+```java
+HttpHost proxy = new HttpHost("localhost", 8080, "http");
+RequestConfig config = RequestConfig.custom()
+    .setProxy(proxy)
+    .build();
+CloseableHttpClient client = HttpClients.custom()
+    .setDefaultRequestConfig(config)
+    .build();
+```
+
+**Java 11+ HttpClient:**
+```java
+HttpClient client = HttpClient.newBuilder()
+    .proxy(ProxySelector.of(new InetSocketAddress("localhost", 8080)))
+    .build();
+```
+
+## License
+
+ISC
+
+## Author & Credits
+
+- **Dung Tran** ([dungviettran89](https://github.com/dungviettran89))
+- Built with [OpenClaw](https://github.com/dungviettran89/openclaw) — an AI agent framework for autonomous development
+- Code written with assistance from [Qwen Coder](https://qwenlm.github.io/) — an AI coding assistant

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs"));
+const proxy_1 = require("./proxy");
+const server_1 = require("./ui/server");
+// node-forge has no @types, but it's already a dependency and we only use it for public key extraction
+// eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-explicit-any
+const nodeForge = require('node-forge');
+const DEFAULT_PROXY_PORT = 8080;
+const DEFAULT_UI_PORT = 3000;
+const DEFAULT_SSL_CA_DIR = path.join(os.homedir(), '.http-mitm-proxy-ui', 'ca');
+const DEFAULT_MAX_REQUESTS = 1000;
+async function loadConfigFile(configPath) {
+    if (!configPath)
+        return {};
+    try {
+        const { default: fs } = await Promise.resolve().then(() => __importStar(require('fs')));
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        console.error(`Warning: Could not load config file "${configPath}": ${err.message}`);
+        return {};
+    }
+}
+/**
+ * If custom CA cert/key are provided, copy them to the expected locations
+ * in sslCaDir so http-mitm-proxy's CA class loads them instead of generating.
+ * The CA class expects three files: certs/ca.pem, keys/ca.private.key, keys/ca.public.key
+ */
+async function setupCaFiles(caCertPath, caKeyPath, sslCaDir) {
+    const certsDir = path.join(sslCaDir, 'certs');
+    const keysDir = path.join(sslCaDir, 'keys');
+    // Ensure directories exist
+    fs.mkdirSync(certsDir, { recursive: true });
+    fs.mkdirSync(keysDir, { recursive: true });
+    // Copy cert and private key to expected locations
+    const destCert = path.join(certsDir, 'ca.pem');
+    const destPrivateKey = path.join(keysDir, 'ca.private.key');
+    const destPublicKey = path.join(keysDir, 'ca.public.key');
+    fs.copyFileSync(caCertPath, destCert);
+    fs.copyFileSync(caKeyPath, destPrivateKey);
+    // Extract public key from the private key using node-forge (already a dependency)
+    const pki = nodeForge.pki;
+    const privateKey = pki.privateKeyFromPem(fs.readFileSync(caKeyPath, 'utf-8'));
+    const publicKey = pki.setRsaPublicKey(privateKey.n, privateKey.e);
+    fs.writeFileSync(destPublicKey, pki.publicKeyToPem(publicKey));
+    console.log(`  CA cert: ${caCertPath} → ${destCert}`);
+    console.log(`  CA key:  ${caKeyPath} → ${destPrivateKey}`);
+    console.log(`  CA pub:  (derived) → ${destPublicKey}`);
+}
+async function main() {
+    const program = new commander_1.Command();
+    program
+        .name('http-mitm-proxy-ui')
+        .description('HTTP MITM Proxy with a web-based UI for inspecting and modifying traffic')
+        .version('1.0.0')
+        .option('-p, --proxy-port <port>', 'Port for the MITM proxy server', String(DEFAULT_PROXY_PORT))
+        .option('-u, --ui-port <port>', 'Port for the web UI server', String(DEFAULT_UI_PORT))
+        .option('-H, --headless', 'Run in headless mode (proxy only, no UI)', false)
+        .option('-c, --config <path>', 'Path to a JSON config file')
+        .option('--ssl-ca-dir <path>', 'Directory for storing CA certificates')
+        .option('--max-requests <count>', 'Maximum number of requests to keep in memory', String(DEFAULT_MAX_REQUESTS))
+        .option('--no-modification', 'Disable request/response modification features')
+        .option('--ca-cert <path>', 'Path to custom CA certificate file (.pem)')
+        .option('--ca-key <path>', 'Path to custom CA private key file (.pem)')
+        .parse(process.argv);
+    const opts = program.opts();
+    // Load config file if provided
+    const fileConfig = await loadConfigFile(opts.config);
+    // Merge: defaults < file config < CLI flags
+    const config = {
+        proxyPort: parseInt(fileConfig.proxyPort != null ? String(fileConfig.proxyPort) : opts.proxyPort, 10),
+        uiPort: parseInt(fileConfig.uiPort != null ? String(fileConfig.uiPort) : opts.uiPort, 10),
+        headless: fileConfig.headless != null ? Boolean(fileConfig.headless) : Boolean(opts.headless),
+        sslCaDir: fileConfig.sslCaDir || opts.sslCaDir || DEFAULT_SSL_CA_DIR,
+        maxRequests: parseInt(fileConfig.maxRequests != null ? String(fileConfig.maxRequests) : opts.maxRequests, 10),
+        enableModification: fileConfig.enableModification != null
+            ? Boolean(fileConfig.enableModification)
+            : opts.enableModification !== false,
+        caCertPath: fileConfig.caCertPath || opts.caCert,
+        caKeyPath: fileConfig.caKeyPath || opts.caKey,
+    };
+    // Validate CA cert/key: both or neither must be provided
+    if ((config.caCertPath && !config.caKeyPath) || (!config.caCertPath && config.caKeyPath)) {
+        console.error('Error: --ca-cert and --ca-key must be provided together.');
+        process.exit(1);
+    }
+    // Validate CA cert/key files exist
+    if (config.caCertPath && !fs.existsSync(config.caCertPath)) {
+        console.error(`Error: CA certificate file not found: ${config.caCertPath}`);
+        process.exit(1);
+    }
+    if (config.caKeyPath && !fs.existsSync(config.caKeyPath)) {
+        console.error(`Error: CA private key file not found: ${config.caKeyPath}`);
+        process.exit(1);
+    }
+    // Validate ports
+    if (config.proxyPort < 1 || config.proxyPort > 65535) {
+        console.error(`Error: Invalid proxy port ${config.proxyPort}. Must be between 1 and 65535.`);
+        process.exit(1);
+    }
+    if (config.uiPort < 1 || config.uiPort > 65535) {
+        console.error(`Error: Invalid UI port ${config.uiPort}. Must be between 1 and 65535.`);
+        process.exit(1);
+    }
+    if (config.proxyPort === config.uiPort) {
+        console.error('Error: Proxy port and UI port must be different.');
+        process.exit(1);
+    }
+    const proxyConfig = {
+        proxyPort: config.proxyPort,
+        uiPort: config.uiPort,
+        sslCaDir: config.sslCaDir,
+        maxRequests: config.maxRequests,
+        enableModification: config.enableModification,
+        headless: config.headless,
+        caCertPath: config.caCertPath,
+        caKeyPath: config.caKeyPath,
+    };
+    console.log('Starting http-mitm-proxy-ui...');
+    console.log(`  Proxy: localhost:${config.proxyPort}`);
+    if (!config.headless) {
+        console.log(`  UI:    http://localhost:${config.uiPort}`);
+    }
+    console.log(`  Headless: ${config.headless}`);
+    if (config.caCertPath && config.caKeyPath) {
+        console.log(`  Custom CA: yes`);
+        await setupCaFiles(config.caCertPath, config.caKeyPath, config.sslCaDir);
+    }
+    else {
+        console.log(`  Custom CA: no (auto-generate)`);
+    }
+    console.log('');
+    // Start the proxy
+    const proxy = new proxy_1.MitmProxy(proxyConfig);
+    proxy.on('error', (err) => {
+        console.error('Proxy error:', err.message);
+    });
+    try {
+        await proxy.start();
+    }
+    catch (err) {
+        console.error(`Failed to start proxy: ${err.message}`);
+        process.exit(1);
+    }
+    // Start the UI (unless in headless mode)
+    let uiServer = null;
+    if (!config.headless) {
+        uiServer = new server_1.UIServer(proxy, proxyConfig);
+        try {
+            await uiServer.start();
+        }
+        catch (err) {
+            console.error(`Failed to start UI server: ${err.message}`);
+            proxy.stop();
+            process.exit(1);
+        }
+    }
+    // Graceful shutdown
+    const shutdown = (signal) => {
+        console.log(`\nReceived ${signal}. Shutting down...`);
+        if (uiServer) {
+            uiServer.stop();
+        }
+        proxy.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/proxy/RequestStore.d.ts

@@ -0,0 +1,31 @@
+import type { RequestRecord } from '.';
+/**
+ * Persistent request store backed by a local JSON file via lowdb.
+ */
+export declare class RequestStore {
+    private db;
+    private filePath;
+    constructor(dbPath?: string);
+    init(): Promise<this>;
+    /**
+     * Add a new request record to the store.
+     */
+    add(req: RequestRecord): Promise<void>;
+    /**
+     * Update an existing request record (merge by id).
+     */
+    update(req: RequestRecord): Promise<void>;
+    /**
+     * Get all requests, converted back to live form.
+     */
+    getAll(): RequestRecord[];
+    /**
+     * Get a single request by id.
+     */
+    getById(id: string): RequestRecord | undefined;
+    /**
+     * Clear all stored requests.
+     */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=RequestStore.d.ts.map

package/dist/proxy/RequestStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestStore.d.ts","sourceRoot":"","sources":["../../src/proxy/RequestStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,GAAG,CAAA;AA+GtD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAuD;IACjE,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,MAAM,CAAC,EAAE,MAAM;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C;;OAEG;IACH,MAAM,IAAI,aAAa,EAAE;IAIzB;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAK9C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}