envoy-pay 0.1.0

package/dist/esm/facilitator/facilitator-service.js

@@ -0,0 +1,301 @@
+/**
+ * FacilitatorService — Core payment processing + fee extraction.
+ *
+ * This is where money is made. The FacilitatorService:
+ * 1. Validates the API key and checks rate limits
+ * 2. Calculates the facilitator fee
+ * 3. Routes the payment through UnifiedWallet
+ * 4. Extracts the fee before settlement
+ * 5. Records usage for billing
+ * 6. Returns a receipt
+ *
+ * Revenue flow:
+ * Agent pays $5.00 → envoy extracts $0.025 (0.5%) → Merchant gets $4.975
+ */
+import { PRICING_TIERS, } from './types.js';
+import { FeeCalculator } from './fee-calculator.js';
+/**
+ * Generate unique IDs.
+ */
+function generateId(prefix) {
+    const ts = Date.now().toString(36);
+    const rand = Math.random().toString(36).substring(2, 10);
+    return `${prefix}_${ts}_${rand}`;
+}
+export class FacilitatorService {
+    apiKeys = new Map();
+    transactions = [];
+    feeCalculator;
+    log;
+    constructor(options) {
+        this.feeCalculator = new FeeCalculator();
+        this.log = options?.logger ?? (() => { });
+    }
+    // ═══ API Key Management ═══════════════════════════════════════════
+    /**
+     * Create a new API key for a merchant.
+     */
+    createApiKey(ownerId, name, plan = 'dev') {
+        const prefix = plan === 'dev' ? 'asg_test' : 'asg_live';
+        const key = `${prefix}_${generateId('key')}`;
+        const now = new Date();
+        const periodEnd = new Date(now);
+        periodEnd.setMonth(periodEnd.getMonth() + 1);
+        const record = {
+            key,
+            name,
+            ownerId,
+            plan,
+            isActive: true,
+            createdAt: now,
+            periodStart: now,
+            periodEnd,
+            transactionsUsed: 0,
+            revenueGenerated: 0,
+            rateLimit: this.getRateLimit(plan),
+            metadata: {},
+        };
+        this.apiKeys.set(key, record);
+        this.log(`[Facilitator] 🔑 API key created: ${key} (plan: ${plan})`);
+        return record;
+    }
+    /**
+     * Validate an API key.
+     */
+    validateApiKey(key) {
+        const record = this.apiKeys.get(key);
+        if (!record) {
+            return { valid: false, reason: 'API key not found' };
+        }
+        if (!record.isActive) {
+            return { valid: false, reason: 'API key is deactivated' };
+        }
+        // Check transaction limit
+        const tier = PRICING_TIERS[record.plan];
+        if (record.transactionsUsed >= tier.includedTransactions && record.plan === 'dev') {
+            return { valid: false, reason: 'Transaction limit reached (upgrade to Growth)' };
+        }
+        return { valid: true };
+    }
+    /**
+     * Revoke an API key.
+     */
+    revokeApiKey(key) {
+        const record = this.apiKeys.get(key);
+        if (!record)
+            return false;
+        record.isActive = false;
+        this.log(`[Facilitator] 🚫 API key revoked: ${key}`);
+        return true;
+    }
+    /**
+     * Upgrade an API key's plan.
+     */
+    upgradePlan(key, newPlan) {
+        const record = this.apiKeys.get(key);
+        if (!record)
+            return false;
+        record.plan = newPlan;
+        record.rateLimit = this.getRateLimit(newPlan);
+        this.log(`[Facilitator] ⬆️ Plan upgraded: ${key} → ${newPlan}`);
+        return true;
+    }
+    // ═══ Payment Facilitation ═════════════════════════════════════════
+    /**
+     * Process a payment facilitation request.
+     * This is the core revenue-generating method.
+     */
+    async facilitate(apiKey, request) {
+        const facilitationId = generateId('fac');
+        const timestamp = new Date();
+        // 1. Validate API key
+        const keyValidation = this.validateApiKey(apiKey);
+        if (!keyValidation.valid) {
+            return this.failedResponse(facilitationId, request, keyValidation.reason, timestamp);
+        }
+        const record = this.apiKeys.get(apiKey);
+        const amount = parseFloat(request.amount);
+        if (isNaN(amount) || amount <= 0) {
+            return this.failedResponse(facilitationId, request, 'Invalid amount', timestamp);
+        }
+        // 2. Calculate fee
+        const protocol = request.protocol === 'auto' ? 'x402' : request.protocol;
+        const chain = request.preferredChain ?? 'eip155:42220';
+        const feeBreakdown = this.feeCalculator.calculate(amount, record.plan, protocol, chain);
+        this.log(`[Facilitator] 💰 Processing $${amount} via ${protocol} on ${chain} ` +
+            `— fee: $${feeBreakdown.finalFee.toFixed(4)} (${feeBreakdown.feePercent}%)`);
+        // 3. In production: execute the actual payment via UnifiedWallet here
+        //    For now, simulate settlement
+        const txHash = `0x${Date.now().toString(16)}${Math.random().toString(16).slice(2)}`;
+        // 4. Record transaction
+        const amountSettled = amount - feeBreakdown.finalFee;
+        const response = {
+            success: true,
+            facilitationId,
+            transactionHash: txHash,
+            protocol,
+            chain: this.chainName(chain),
+            caip2Id: chain,
+            amountSettled: amountSettled.toFixed(4),
+            fee: feeBreakdown.finalFee.toFixed(4),
+            feePercent: feeBreakdown.feePercent,
+            totalCost: feeBreakdown.totalCost.toFixed(4),
+            settlement: 'instant',
+            timestamp,
+        };
+        // 5. Update usage metrics
+        record.transactionsUsed += 1;
+        record.revenueGenerated += feeBreakdown.netRevenue;
+        // 6. Store for analytics
+        this.transactions.push(response);
+        this.log(`[Facilitator] ✅ Settled: $${amountSettled.toFixed(2)} to merchant, ` +
+            `$${feeBreakdown.finalFee.toFixed(4)} fee → envoy net: $${feeBreakdown.netRevenue.toFixed(4)}`);
+        return response;
+    }
+    // ═══ Usage & Billing ══════════════════════════════════════════════
+    /**
+     * Get usage for an API key in the current period.
+     */
+    getUsage(apiKey) {
+        const record = this.apiKeys.get(apiKey);
+        if (!record)
+            return null;
+        const tier = PRICING_TIERS[record.plan];
+        const overage = Math.max(0, record.transactionsUsed - tier.includedTransactions);
+        const overageCharges = overage * tier.overageRate;
+        return {
+            apiKey,
+            periodStart: record.periodStart,
+            periodEnd: record.periodEnd,
+            totalTransactions: record.transactionsUsed,
+            includedTransactions: tier.includedTransactions,
+            overageTransactions: overage,
+            totalVolume: this.getVolumeForKey(apiKey),
+            totalFees: record.revenueGenerated,
+            overageCharges,
+            subscriptionCharge: tier.monthlyPrice,
+            totalBilling: tier.monthlyPrice + overageCharges,
+        };
+    }
+    // ═══ Revenue Analytics ════════════════════════════════════════════
+    /**
+     * Get revenue summary across all API keys.
+     */
+    getRevenueSummary(period = 'all-time') {
+        const now = Date.now();
+        const periodMs = {
+            day: 86_400_000,
+            week: 604_800_000,
+            month: 2_592_000_000,
+            'all-time': Infinity,
+        };
+        const cutoff = now - periodMs[period];
+        const txs = this.transactions.filter((t) => t.success && t.timestamp.getTime() >= cutoff);
+        const totalVolume = txs.reduce((sum, t) => sum + parseFloat(t.amountSettled), 0);
+        const totalFees = txs.reduce((sum, t) => sum + parseFloat(t.fee), 0);
+        const x402Txs = txs.filter((t) => t.protocol === 'x402');
+        const mppTxs = txs.filter((t) => t.protocol === 'mpp');
+        const subscriptionRevenue = Array.from(this.apiKeys.values())
+            .filter((k) => k.isActive)
+            .reduce((sum, k) => sum + PRICING_TIERS[k.plan].monthlyPrice, 0);
+        const overageRevenue = Array.from(this.apiKeys.values())
+            .reduce((sum, k) => {
+            const tier = PRICING_TIERS[k.plan];
+            const overage = Math.max(0, k.transactionsUsed - tier.includedTransactions);
+            return sum + overage * tier.overageRate;
+        }, 0);
+        // Breakdown by chain
+        const byChain = {};
+        for (const tx of txs) {
+            if (!byChain[tx.chain]) {
+                byChain[tx.chain] = { count: 0, volume: 0, fees: 0 };
+            }
+            byChain[tx.chain].count += 1;
+            byChain[tx.chain].volume += parseFloat(tx.amountSettled);
+            byChain[tx.chain].fees += parseFloat(tx.fee);
+        }
+        return {
+            period,
+            totalTransactions: txs.length,
+            totalVolume: parseFloat(totalVolume.toFixed(2)),
+            totalFees: parseFloat(totalFees.toFixed(2)),
+            subscriptionRevenue,
+            overageRevenue: parseFloat(overageRevenue.toFixed(2)),
+            totalRevenue: parseFloat((totalFees + subscriptionRevenue + overageRevenue).toFixed(2)),
+            avgTransactionSize: txs.length > 0 ? parseFloat((totalVolume / txs.length).toFixed(2)) : 0,
+            avgFee: txs.length > 0 ? parseFloat((totalFees / txs.length).toFixed(4)) : 0,
+            activeKeys: Array.from(this.apiKeys.values()).filter((k) => k.isActive).length,
+            byProtocol: {
+                x402: {
+                    count: x402Txs.length,
+                    volume: parseFloat(x402Txs.reduce((s, t) => s + parseFloat(t.amountSettled), 0).toFixed(2)),
+                    fees: parseFloat(x402Txs.reduce((s, t) => s + parseFloat(t.fee), 0).toFixed(4)),
+                },
+                mpp: {
+                    count: mppTxs.length,
+                    volume: parseFloat(mppTxs.reduce((s, t) => s + parseFloat(t.amountSettled), 0).toFixed(2)),
+                    fees: parseFloat(mppTxs.reduce((s, t) => s + parseFloat(t.fee), 0).toFixed(4)),
+                },
+            },
+            byChain,
+        };
+    }
+    /**
+     * Get total API keys count.
+     */
+    getApiKeyCount() {
+        return this.apiKeys.size;
+    }
+    /**
+     * Get all active API keys.
+     */
+    getActiveKeys() {
+        return Array.from(this.apiKeys.values()).filter((k) => k.isActive);
+    }
+    // ─── Internal ──────────────────────────────────────────────────────
+    failedResponse(facilitationId, request, error, timestamp) {
+        return {
+            success: false,
+            facilitationId,
+            transactionHash: null,
+            protocol: request.protocol === 'auto' ? 'x402' : request.protocol,
+            chain: 'none',
+            caip2Id: 'none',
+            amountSettled: '0',
+            fee: '0',
+            feePercent: 0,
+            totalCost: request.amount,
+            settlement: 'failed',
+            timestamp,
+            error,
+        };
+    }
+    getRateLimit(plan) {
+        switch (plan) {
+            case 'dev': return 10;
+            case 'growth': return 100;
+            case 'scale': return 1000;
+            case 'enterprise': return 10000;
+        }
+    }
+    chainName(caip2Id) {
+        const names = {
+            'eip155:42220': 'Celo',
+            'eip155:44787': 'Celo Alfajores',
+            'eip155:8453': 'Base',
+            'eip155:1': 'Ethereum',
+            'eip155:42161': 'Arbitrum',
+            'eip155:10': 'Optimism',
+            'stellar:pubnet': 'Stellar',
+            'solana:mainnet': 'Solana',
+            'fiat:stripe': 'Stripe MPP',
+        };
+        return names[caip2Id] ?? caip2Id;
+    }
+    getVolumeForKey(apiKey) {
+        return this.transactions
+            .filter((t) => t.success)
+            .reduce((sum, t) => sum + parseFloat(t.amountSettled), 0);
+    }
+}
+//# sourceMappingURL=facilitator-service.js.map

package/dist/esm/facilitator/facilitator-service.js.map

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

package/dist/esm/facilitator/fee-calculator.js

@@ -0,0 +1,130 @@
+/**
+ * FeeCalculator — Compute facilitator fees per transaction.
+ *
+ * This is the core revenue logic. Every transaction through envoy
+ * gets a fee calculated based on:
+ * 1. The merchant's pricing plan (dev/growth/scale/enterprise)
+ * 2. The payment protocol (x402 vs MPP)
+ * 3. The transaction amount (micropayment premiums)
+ * 4. Volume discounts
+ *
+ * Fee = max(amount × feePercent, minFee) + networkCost
+ */
+import { PRICING_TIERS, } from './types.js';
+/**
+ * Protocol-specific fee adjustments.
+ * MPP has higher base cost (Stripe processing underneath).
+ */
+const PROTOCOL_ADJUSTMENTS = {
+    x402: 0, // No adjustment — pure on-chain
+    mpp: 0.5, // +0.5% for Stripe processing layer
+};
+/**
+ * Micropayment premium: transactions under $1 get a higher fee
+ * because fixed costs are a larger percentage.
+ */
+const MICROPAYMENT_THRESHOLD = 1.0;
+const MICROPAYMENT_PREMIUM = 0.5; // +0.5%
+/**
+ * Estimated network costs per chain (gas fees in USD).
+ */
+const NETWORK_COSTS = {
+    'eip155:42220': 0.001, // Celo (default)
+    'eip155:44787': 0, // Celo Alfajores testnet
+    'eip155:8453': 0.001, // Base
+    'eip155:84532': 0.0001, // Base Sepolia
+    'eip155:42161': 0.002, // Arbitrum
+    'eip155:1': 2.50, // Ethereum L1
+    'eip155:10': 0.001, // Optimism
+    'stellar:pubnet': 0.00001, // Stellar
+    'stellar:testnet': 0, // Stellar testnet
+    'solana:mainnet': 0.0005, // Solana
+    'solana:devnet': 0, // Solana devnet
+    'fiat:stripe': 0.30, // Stripe base fee
+};
+export class FeeCalculator {
+    tiers;
+    constructor(customTiers) {
+        this.tiers = { ...PRICING_TIERS };
+        if (customTiers) {
+            for (const [plan, tier] of Object.entries(customTiers)) {
+                this.tiers[plan] = tier;
+            }
+        }
+    }
+    /**
+     * Calculate the full fee breakdown for a transaction.
+     */
+    calculate(amountUsd, plan, protocol = 'x402', chain = 'eip155:42220') {
+        const tier = this.tiers[plan];
+        // Base fee percent from tier
+        let feePercent = tier.feePercent;
+        // Protocol adjustment
+        feePercent += PROTOCOL_ADJUSTMENTS[protocol] ?? 0;
+        // Micropayment premium
+        if (amountUsd < MICROPAYMENT_THRESHOLD) {
+            feePercent += MICROPAYMENT_PREMIUM;
+        }
+        // Calculate fee
+        const calculatedFee = amountUsd * (feePercent / 100);
+        const minFeeApplied = calculatedFee < tier.minFee;
+        const finalFee = Math.max(calculatedFee, tier.minFee);
+        // Network cost
+        const networkCost = NETWORK_COSTS[chain] ?? 0.01;
+        // Net revenue (what envoy keeps after network costs)
+        const netRevenue = Math.max(0, finalFee - networkCost);
+        return {
+            baseAmount: amountUsd,
+            feePercent,
+            calculatedFee: parseFloat(calculatedFee.toFixed(6)),
+            minFeeApplied,
+            finalFee: parseFloat(finalFee.toFixed(6)),
+            networkCost,
+            netRevenue: parseFloat(netRevenue.toFixed(6)),
+            totalCost: parseFloat((amountUsd + finalFee).toFixed(6)),
+        };
+    }
+    /**
+     * Quick fee estimate (just the fee amount, no breakdown).
+     */
+    estimateFee(amountUsd, plan = 'growth', protocol = 'x402') {
+        const breakdown = this.calculate(amountUsd, plan, protocol);
+        return breakdown.finalFee;
+    }
+    /**
+     * Calculate net revenue from a transaction (what envoy makes).
+     */
+    netRevenue(amountUsd, plan = 'growth', protocol = 'x402', chain = 'eip155:42220') {
+        return this.calculate(amountUsd, plan, protocol, chain).netRevenue;
+    }
+    /**
+     * Calculate revenue from N transactions at given plan.
+     * Useful for financial modeling.
+     */
+    projectRevenue(avgTransactionUsd, transactionCount, plan, protocol = 'x402', chain = 'eip155:42220') {
+        const breakdown = this.calculate(avgTransactionUsd, plan, protocol, chain);
+        const grossFees = breakdown.finalFee * transactionCount;
+        const networkCosts = breakdown.networkCost * transactionCount;
+        const netRevenue = breakdown.netRevenue * transactionCount;
+        const margin = grossFees > 0 ? netRevenue / grossFees : 0;
+        return {
+            grossFees: parseFloat(grossFees.toFixed(2)),
+            networkCosts: parseFloat(networkCosts.toFixed(2)),
+            netRevenue: parseFloat(netRevenue.toFixed(2)),
+            margin: parseFloat((margin * 100).toFixed(1)),
+        };
+    }
+    /**
+     * Get the pricing tier for a plan.
+     */
+    getTier(plan) {
+        return { ...this.tiers[plan] };
+    }
+    /**
+     * Get all pricing tiers.
+     */
+    getAllTiers() {
+        return { ...this.tiers };
+    }
+}
+//# sourceMappingURL=fee-calculator.js.map

package/dist/esm/facilitator/fee-calculator.js.map

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

package/dist/esm/facilitator/index.js

@@ -0,0 +1,5 @@
+// Facilitator — Barrel exports (Revenue Engine)
+export { FacilitatorService } from './facilitator-service.js';
+export { FeeCalculator } from './fee-calculator.js';
+export { PRICING_TIERS, CARD_TIERS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/facilitator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/facilitator/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAajD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/esm/facilitator/types.js

@@ -0,0 +1,96 @@
+/**
+ * Facilitator Types — Hosted payment facilitation with fee extraction.
+ *
+ * The Facilitator API is the PRIMARY revenue engine. It processes
+ * agent payments, extracts a configurable fee (0.5-1.5%), and
+ * settles to the merchant.
+ *
+ * Revenue model:
+ * - x402 on-chain: 0.5% facilitator fee
+ * - MPP fiat: 1.5% + $0.05
+ * - Cross-chain: 1.0%
+ * - Micropayments (<$1): 2% (min $0.001)
+ *
+ * @see Stripe Connect — inspiration for fee model
+ */
+/** Default pricing tiers. */
+export const PRICING_TIERS = {
+    dev: {
+        plan: 'dev',
+        monthlyPrice: 0,
+        includedTransactions: 100,
+        overageRate: 0, // no overage on free tier (hard limit)
+        feePercent: 1.5,
+        minFee: 0.005,
+        chains: 'single',
+        priorityRouting: false,
+        dedicatedInfra: false,
+    },
+    growth: {
+        plan: 'growth',
+        monthlyPrice: 49,
+        includedTransactions: 10_000,
+        overageRate: 0.003,
+        feePercent: 1.0,
+        minFee: 0.002,
+        chains: 'all',
+        priorityRouting: false,
+        dedicatedInfra: false,
+    },
+    scale: {
+        plan: 'scale',
+        monthlyPrice: 199,
+        includedTransactions: 100_000,
+        overageRate: 0.002,
+        feePercent: 0.5,
+        minFee: 0.001,
+        chains: 'all',
+        priorityRouting: true,
+        slaUptime: 99.9,
+        dedicatedInfra: false,
+    },
+    enterprise: {
+        plan: 'enterprise',
+        monthlyPrice: 999,
+        includedTransactions: Infinity,
+        overageRate: 0,
+        feePercent: 0.3,
+        minFee: 0.001,
+        chains: 'all',
+        priorityRouting: true,
+        slaUptime: 99.99,
+        dedicatedInfra: true,
+    },
+};
+/** Default card tiers. */
+export const CARD_TIERS = {
+    starter: {
+        plan: 'starter',
+        monthlyPrice: 0,
+        maxCards: 1,
+        perCardLimit: 100,
+        interchangeRate: 1.5,
+    },
+    pro: {
+        plan: 'pro',
+        monthlyPrice: 29,
+        maxCards: 10,
+        perCardLimit: 1_000,
+        interchangeRate: 1.7,
+    },
+    business: {
+        plan: 'business',
+        monthlyPrice: 99,
+        maxCards: 50,
+        perCardLimit: 10_000,
+        interchangeRate: 2.0,
+    },
+    enterprise: {
+        plan: 'enterprise',
+        monthlyPrice: 499,
+        maxCards: Infinity,
+        perCardLimit: Infinity,
+        interchangeRate: 2.0,
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/facilitator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/facilitator/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA8BH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,aAAa,GAAqC;IAC7D,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,YAAY,EAAE,CAAC;QACf,oBAAoB,EAAE,GAAG;QACzB,WAAW,EAAE,CAAC,EAAE,uCAAuC;QACvD,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;QAChB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,EAAE;QAChB,oBAAoB,EAAE,MAAM;QAC5B,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,GAAG;QACjB,oBAAoB,EAAE,OAAO;QAC7B,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,KAAK;KACtB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,GAAG;QACjB,oBAAoB,EAAE,QAAQ;QAC9B,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,KAAK;QAChB,cAAc,EAAE,IAAI;KACrB;CACF,CAAC;AA2LF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,UAAU,GAA+B;IACpD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,CAAC;QACf,QAAQ,EAAE,CAAC;QACX,YAAY,EAAE,GAAG;QACjB,eAAe,EAAE,GAAG;KACrB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,YAAY,EAAE,EAAE;QAChB,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,GAAG;KACrB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE,EAAE;QAChB,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,MAAM;QACpB,eAAe,EAAE,GAAG;KACrB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,GAAG;QACjB,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,GAAG;KACrB;CACF,CAAC"}