@agentlensai/server 0.10.0 → 0.13.0

package/dist/cloud/billing/quota-enforcement.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Quota Enforcement (S-6.3)
+ *
+ * Checks usage against tier limits on every ingestion request.
+ * - Free tier: hard block at 10K events/month (402)
+ * - Pro/Team: allow overage up to cap (default 2x)
+ * - 80% soft warning
+ * - Grace period for paid tiers
+ */
+import type { TierName } from './stripe-client.js';
+import type { RedisUsageStore } from './usage-metering.js';
+import type { MigrationClient } from '../migrate.js';
+export interface QuotaCheckResult {
+    allowed: boolean;
+    status: 'ok' | 'warning' | 'overage' | 'blocked';
+    usage: number;
+    quota: number;
+    usage_pct: number;
+    message?: string;
+    upgrade_url?: string;
+}
+export interface QuotaEnforcerDeps {
+    db: MigrationClient;
+    redis?: RedisUsageStore;
+}
+export interface OrgQuotaInfo {
+    plan: TierName;
+    event_quota: number;
+    overage_cap_multiplier: number;
+}
+export declare class QuotaEnforcer {
+    private deps;
+    private orgCache;
+    private cacheTtlMs;
+    constructor(deps: QuotaEnforcerDeps, config?: {
+        cacheTtlMs?: number;
+    });
+    /**
+     * Check if an org can ingest events.
+     * Designed to be < 5ms via Redis lookup.
+     */
+    checkQuota(orgId: string): Promise<QuotaCheckResult>;
+    /**
+     * Check if an org should see a warning notification.
+     * Returns the warning level or null.
+     */
+    getWarningLevel(orgId: string): Promise<'80pct' | '100pct' | null>;
+    private getOrgInfo;
+    private getCurrentUsage;
+    /** Clear cache (for testing) */
+    clearCache(): void;
+}
+//# sourceMappingURL=quota-enforcement.d.ts.map

package/dist/cloud/billing/quota-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-enforcement.d.ts","sourceRoot":"","sources":["../../../src/cloud/billing/quota-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAMrD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,eAAe,CAAC;IACpB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAMD,qBAAa,aAAa;IAKtB,OAAO,CAAC,IAAI;IAJd,OAAO,CAAC,QAAQ,CAA8D;IAC9E,OAAO,CAAC,UAAU,CAAS;gBAGjB,IAAI,EAAE,iBAAiB,EAC/B,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAKlC;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+D1D;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;YAa1D,UAAU;YAsBV,eAAe;IA4B7B,gCAAgC;IAChC,UAAU,IAAI,IAAI;CAGnB"}

package/dist/cloud/billing/quota-enforcement.js

@@ -0,0 +1,143 @@
+/**
+ * Quota Enforcement (S-6.3)
+ *
+ * Checks usage against tier limits on every ingestion request.
+ * - Free tier: hard block at 10K events/month (402)
+ * - Pro/Team: allow overage up to cap (default 2x)
+ * - 80% soft warning
+ * - Grace period for paid tiers
+ */
+import { TIER_CONFIG } from './stripe-client.js';
+// ═══════════════════════════════════════════
+// Quota Enforcer
+// ═══════════════════════════════════════════
+export class QuotaEnforcer {
+    deps;
+    orgCache = new Map();
+    cacheTtlMs;
+    constructor(deps, config) {
+        this.deps = deps;
+        this.cacheTtlMs = config?.cacheTtlMs ?? 60_000; // 1 min
+    }
+    /**
+     * Check if an org can ingest events.
+     * Designed to be < 5ms via Redis lookup.
+     */
+    async checkQuota(orgId) {
+        const orgInfo = await this.getOrgInfo(orgId);
+        const usage = await this.getCurrentUsage(orgId);
+        const quota = orgInfo.event_quota;
+        const usagePct = quota > 0 ? (usage / quota) * 100 : 0;
+        // Under 80% — all good
+        if (usagePct < 80) {
+            return { allowed: true, status: 'ok', usage, quota, usage_pct: round2(usagePct) };
+        }
+        // 80-100% — soft warning
+        if (usage < quota) {
+            return {
+                allowed: true,
+                status: 'warning',
+                usage,
+                quota,
+                usage_pct: round2(usagePct),
+                message: `You've used ${Math.round(usagePct)}% of your monthly event quota.`,
+            };
+        }
+        // At or over quota
+        const plan = orgInfo.plan;
+        // Free tier: hard block
+        if (plan === 'free') {
+            return {
+                allowed: false,
+                status: 'blocked',
+                usage,
+                quota,
+                usage_pct: round2(usagePct),
+                message: 'Monthly event quota exceeded. Upgrade to continue ingesting events.',
+                upgrade_url: '/billing/upgrade',
+            };
+        }
+        // Paid tiers: check overage cap
+        const overageCap = quota * orgInfo.overage_cap_multiplier;
+        if (usage >= overageCap) {
+            return {
+                allowed: false,
+                status: 'blocked',
+                usage,
+                quota,
+                usage_pct: round2(usagePct),
+                message: `Overage cap reached (${orgInfo.overage_cap_multiplier}x quota). Contact support to increase.`,
+            };
+        }
+        // Paid tier, within overage cap — allow with overage billing
+        return {
+            allowed: true,
+            status: 'overage',
+            usage,
+            quota,
+            usage_pct: round2(usagePct),
+            message: `You're now incurring overage charges at ${TIER_CONFIG[plan]?.overage_rate_per_1k_cents ?? 0}¢ per 1K events.`,
+        };
+    }
+    /**
+     * Check if an org should see a warning notification.
+     * Returns the warning level or null.
+     */
+    async getWarningLevel(orgId) {
+        const orgInfo = await this.getOrgInfo(orgId);
+        const usage = await this.getCurrentUsage(orgId);
+        const quota = orgInfo.event_quota;
+        const pct = quota > 0 ? (usage / quota) * 100 : 0;
+        if (pct >= 100)
+            return '100pct';
+        if (pct >= 80)
+            return '80pct';
+        return null;
+    }
+    // ── Internals ──
+    async getOrgInfo(orgId) {
+        // Check cache
+        const cached = this.orgCache.get(orgId);
+        if (cached && cached.expires > Date.now()) {
+            return cached.info;
+        }
+        const result = await this.deps.db.query(`SELECT plan, event_quota, overage_cap_multiplier FROM orgs WHERE id = $1`, [orgId]);
+        const row = result.rows[0];
+        const info = {
+            plan: (row?.plan ?? 'free'),
+            event_quota: row?.event_quota ?? TIER_CONFIG.free.event_quota,
+            overage_cap_multiplier: row?.overage_cap_multiplier ?? 2.0,
+        };
+        this.orgCache.set(orgId, { info, expires: Date.now() + this.cacheTtlMs });
+        return info;
+    }
+    async getCurrentUsage(orgId) {
+        // Try Redis first (fast path, < 1ms)
+        if (this.deps.redis) {
+            const now = new Date();
+            const month = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, '0')}`;
+            const redisKey = `usage:${orgId}:${month}`;
+            const val = await this.deps.redis.get(redisKey);
+            if (val !== null) {
+                return parseInt(val, 10);
+            }
+        }
+        // Fallback to DB
+        const now = new Date();
+        const month = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, '0')}`;
+        const monthStart = `${month}-01T00:00:00Z`;
+        const nextMonth = new Date(now.getUTCFullYear(), now.getUTCMonth() + 1, 1);
+        const result = await this.deps.db.query(`SELECT COALESCE(SUM(event_count), 0)::int as total
+       FROM usage_records
+       WHERE org_id = $1 AND hour >= $2 AND hour < $3`, [orgId, monthStart, nextMonth.toISOString()]);
+        return result.rows[0]?.total ?? 0;
+    }
+    /** Clear cache (for testing) */
+    clearCache() {
+        this.orgCache.clear();
+    }
+}
+function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=quota-enforcement.js.map

package/dist/cloud/billing/quota-enforcement.js.map

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

package/dist/cloud/billing/stripe-client.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Stripe Client Abstraction (S-6.1)
+ *
+ * Provides a unified interface for Stripe operations with a mock
+ * implementation for testing. Real Stripe calls activate when
+ * STRIPE_SECRET_KEY is set.
+ */
+export interface StripeCustomer {
+    id: string;
+    email: string;
+    name: string;
+    metadata: Record<string, string>;
+}
+export interface StripeSubscription {
+    id: string;
+    customer: string;
+    status: 'active' | 'canceled' | 'past_due' | 'trialing' | 'incomplete';
+    items: {
+        data: StripeSubscriptionItem[];
+    };
+    current_period_start: number;
+    current_period_end: number;
+    cancel_at_period_end: boolean;
+}
+export interface StripeSubscriptionItem {
+    id: string;
+    price: {
+        id: string;
+        recurring?: {
+            usage_type?: string;
+        };
+    };
+}
+export interface StripeInvoice {
+    id: string;
+    customer: string;
+    subscription: string | null;
+    status: 'draft' | 'open' | 'paid' | 'void' | 'uncollectible';
+    amount_due: number;
+    amount_paid: number;
+    period_start: number;
+    period_end: number;
+    lines: {
+        data: StripeInvoiceLine[];
+    };
+}
+export interface StripeInvoiceLine {
+    description: string;
+    amount: number;
+    quantity: number;
+}
+export interface StripeWebhookEvent {
+    id: string;
+    type: string;
+    data: {
+        object: Record<string, unknown>;
+    };
+}
+export interface CreateSubscriptionParams {
+    customer: string;
+    items: Array<{
+        price: string;
+    }>;
+    trial_period_days?: number;
+}
+export interface UsageRecordParams {
+    subscription_item: string;
+    quantity: number;
+    timestamp: number;
+    action: 'increment' | 'set';
+}
+export declare const TIER_CONFIG: {
+    readonly free: {
+        readonly name: "Free";
+        readonly base_price_cents: 0;
+        readonly event_quota: 10000;
+        readonly overage_rate_per_1k_cents: 0;
+        readonly price_id: "price_free";
+        readonly overage_price_id: string | null;
+    };
+    readonly pro: {
+        readonly name: "Pro";
+        readonly base_price_cents: 2900;
+        readonly event_quota: 1000000;
+        readonly overage_rate_per_1k_cents: 10;
+        readonly price_id: "price_pro_monthly";
+        readonly overage_price_id: "price_pro_overage";
+    };
+    readonly team: {
+        readonly name: "Team";
+        readonly base_price_cents: 9900;
+        readonly event_quota: 10000000;
+        readonly overage_rate_per_1k_cents: 8;
+        readonly price_id: "price_team_monthly";
+        readonly overage_price_id: "price_team_overage";
+    };
+    readonly enterprise: {
+        readonly name: "Enterprise";
+        readonly base_price_cents: 0;
+        readonly event_quota: 100000000;
+        readonly overage_rate_per_1k_cents: 0;
+        readonly price_id: "price_enterprise";
+        readonly overage_price_id: string | null;
+    };
+};
+export type TierName = keyof typeof TIER_CONFIG;
+export interface IStripeClient {
+    createCustomer(email: string, name: string, orgId: string): Promise<StripeCustomer>;
+    createSubscription(params: CreateSubscriptionParams): Promise<StripeSubscription>;
+    cancelSubscription(subscriptionId: string, atPeriodEnd?: boolean): Promise<StripeSubscription>;
+    updateSubscription(subscriptionId: string, items: Array<{
+        price: string;
+    }>): Promise<StripeSubscription>;
+    getSubscription(subscriptionId: string): Promise<StripeSubscription | null>;
+    reportUsage(params: UsageRecordParams): Promise<void>;
+    constructWebhookEvent(payload: string, signature: string): StripeWebhookEvent;
+}
+export declare class MockStripeClient implements IStripeClient {
+    customers: StripeCustomer[];
+    subscriptions: StripeSubscription[];
+    usageRecords: UsageRecordParams[];
+    webhookEvents: StripeWebhookEvent[];
+    private idCounter;
+    private nextId;
+    createCustomer(email: string, name: string, orgId: string): Promise<StripeCustomer>;
+    createSubscription(params: CreateSubscriptionParams): Promise<StripeSubscription>;
+    cancelSubscription(subscriptionId: string, atPeriodEnd?: boolean): Promise<StripeSubscription>;
+    updateSubscription(subscriptionId: string, items: Array<{
+        price: string;
+    }>): Promise<StripeSubscription>;
+    getSubscription(subscriptionId: string): Promise<StripeSubscription | null>;
+    reportUsage(params: UsageRecordParams): Promise<void>;
+    constructWebhookEvent(payload: string, _signature: string): StripeWebhookEvent;
+    /** Test helper: reset all state */
+    reset(): void;
+}
+/**
+ * Create a Stripe client. Returns MockStripeClient when no
+ * STRIPE_SECRET_KEY is set (for testing/development).
+ */
+export declare function createStripeClient(secretKey?: string): IStripeClient;
+//# sourceMappingURL=stripe-client.d.ts.map

package/dist/cloud/billing/stripe-client.d.ts.map

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

package/dist/cloud/billing/stripe-client.js

@@ -0,0 +1,174 @@
+/**
+ * Stripe Client Abstraction (S-6.1)
+ *
+ * Provides a unified interface for Stripe operations with a mock
+ * implementation for testing. Real Stripe calls activate when
+ * STRIPE_SECRET_KEY is set.
+ */
+// ═══════════════════════════════════════════
+// Tier Configuration
+// ═══════════════════════════════════════════
+export const TIER_CONFIG = {
+    free: {
+        name: 'Free',
+        base_price_cents: 0,
+        event_quota: 10_000,
+        overage_rate_per_1k_cents: 0, // no overage on free
+        price_id: 'price_free',
+        overage_price_id: null,
+    },
+    pro: {
+        name: 'Pro',
+        base_price_cents: 2900, // $29/mo
+        event_quota: 1_000_000,
+        overage_rate_per_1k_cents: 10, // $0.10/1K
+        price_id: 'price_pro_monthly',
+        overage_price_id: 'price_pro_overage',
+    },
+    team: {
+        name: 'Team',
+        base_price_cents: 9900, // $99/mo
+        event_quota: 10_000_000,
+        overage_rate_per_1k_cents: 8, // $0.08/1K
+        price_id: 'price_team_monthly',
+        overage_price_id: 'price_team_overage',
+    },
+    enterprise: {
+        name: 'Enterprise',
+        base_price_cents: 0, // custom
+        event_quota: 100_000_000,
+        overage_rate_per_1k_cents: 0,
+        price_id: 'price_enterprise',
+        overage_price_id: null,
+    },
+};
+// ═══════════════════════════════════════════
+// Mock Stripe Client (for testing)
+// ═══════════════════════════════════════════
+export class MockStripeClient {
+    customers = [];
+    subscriptions = [];
+    usageRecords = [];
+    webhookEvents = [];
+    idCounter = 0;
+    nextId(prefix) {
+        return `${prefix}_mock_${++this.idCounter}`;
+    }
+    async createCustomer(email, name, orgId) {
+        const customer = {
+            id: this.nextId('cus'),
+            email,
+            name,
+            metadata: { org_id: orgId },
+        };
+        this.customers.push(customer);
+        return customer;
+    }
+    async createSubscription(params) {
+        const now = Math.floor(Date.now() / 1000);
+        const sub = {
+            id: this.nextId('sub'),
+            customer: params.customer,
+            status: params.trial_period_days ? 'trialing' : 'active',
+            items: {
+                data: params.items.map((item) => ({
+                    id: this.nextId('si'),
+                    price: { id: item.price, recurring: { usage_type: item.price.includes('overage') ? 'metered' : 'licensed' } },
+                })),
+            },
+            current_period_start: now,
+            current_period_end: now + 30 * 86400,
+            cancel_at_period_end: false,
+        };
+        this.subscriptions.push(sub);
+        return sub;
+    }
+    async cancelSubscription(subscriptionId, atPeriodEnd = true) {
+        const sub = this.subscriptions.find((s) => s.id === subscriptionId);
+        if (!sub)
+            throw new Error(`Subscription ${subscriptionId} not found`);
+        if (atPeriodEnd) {
+            sub.cancel_at_period_end = true;
+        }
+        else {
+            sub.status = 'canceled';
+        }
+        return sub;
+    }
+    async updateSubscription(subscriptionId, items) {
+        const sub = this.subscriptions.find((s) => s.id === subscriptionId);
+        if (!sub)
+            throw new Error(`Subscription ${subscriptionId} not found`);
+        sub.items = {
+            data: items.map((item) => ({
+                id: this.nextId('si'),
+                price: { id: item.price, recurring: { usage_type: item.price.includes('overage') ? 'metered' : 'licensed' } },
+            })),
+        };
+        return sub;
+    }
+    async getSubscription(subscriptionId) {
+        return this.subscriptions.find((s) => s.id === subscriptionId) ?? null;
+    }
+    async reportUsage(params) {
+        this.usageRecords.push(params);
+    }
+    constructWebhookEvent(payload, _signature) {
+        return JSON.parse(payload);
+    }
+    /** Test helper: reset all state */
+    reset() {
+        this.customers = [];
+        this.subscriptions = [];
+        this.usageRecords = [];
+        this.webhookEvents = [];
+        this.idCounter = 0;
+    }
+}
+// ═══════════════════════════════════════════
+// Factory
+// ═══════════════════════════════════════════
+/**
+ * Create a Stripe client. Returns MockStripeClient when no
+ * STRIPE_SECRET_KEY is set (for testing/development).
+ */
+export function createStripeClient(secretKey) {
+    const key = secretKey ?? process.env.STRIPE_SECRET_KEY;
+    if (!key) {
+        return new MockStripeClient();
+    }
+    // Return a guarded mock that verifies webhook signatures via HMAC
+    // Real Stripe SDK integration deferred to deployment; this ensures
+    // webhook payloads are at least signature-verified in production.
+    const client = new MockStripeClient();
+    const webhookSecret = process.env.STRIPE_WEBHOOK_SECRET;
+    if (webhookSecret) {
+        const origConstruct = client.constructWebhookEvent.bind(client);
+        client.constructWebhookEvent = (payload, signature) => {
+            // Verify Stripe-style signature (v1=HMAC-SHA256)
+            const { createHmac } = require('node:crypto');
+            const parts = signature.split(',').reduce((acc, part) => {
+                const [k, v] = part.split('=');
+                acc[k] = v;
+                return acc;
+            }, {});
+            const timestamp = parts['t'];
+            const sig = parts['v1'];
+            if (!timestamp || !sig)
+                throw new Error('Invalid Stripe webhook signature format');
+            const expected = createHmac('sha256', webhookSecret)
+                .update(`${timestamp}.${payload}`)
+                .digest('hex');
+            // H-6 FIX: Use timing-safe comparison for HMAC verification
+            const { timingSafeEqual: tse } = require('node:crypto');
+            const sigBuf = Buffer.from(sig, 'utf-8');
+            const expectedBuf = Buffer.from(expected, 'utf-8');
+            if (sigBuf.length !== expectedBuf.length || !tse(sigBuf, expectedBuf)) {
+                throw new Error('Stripe webhook signature verification failed');
+            }
+            return origConstruct(payload, signature);
+        };
+    }
+    return client;
+}
+//# sourceMappingURL=stripe-client.js.map

package/dist/cloud/billing/stripe-client.js.map

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

package/dist/cloud/billing/trial-service.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Free Trial Service (S-6.6)
+ *
+ * - New signups get 14-day Pro trial, no credit card required
+ * - After trial → auto-downgrade to Free
+ * - Trial status visible in dashboard
+ * - Upgrade during trial converts to paid immediately
+ */
+import type { IStripeClient } from './stripe-client.js';
+import type { MigrationClient } from '../migrate.js';
+export interface TrialServiceDeps {
+    stripe: IStripeClient;
+    db: MigrationClient;
+}
+export interface TrialStatus {
+    is_trial: boolean;
+    trial_started_at: string | null;
+    trial_ends_at: string | null;
+    days_remaining: number;
+    expired: boolean;
+}
+export declare const TRIAL_DURATION_DAYS = 14;
+export declare class TrialService {
+    private deps;
+    constructor(deps: TrialServiceDeps);
+    /**
+     * Start a free trial for a new org. Sets plan to 'pro' with trial metadata.
+     * No credit card required.
+     */
+    startTrial(orgId: string): Promise<TrialStatus>;
+    /**
+     * Get trial status for an org.
+     */
+    getTrialStatus(orgId: string): Promise<TrialStatus>;
+    /**
+     * Check and expire trials. Called by a daily cron job.
+     * Downgrades expired trial orgs to Free.
+     * Returns number of orgs downgraded.
+     */
+    expireTrials(): Promise<number>;
+    /**
+     * Cancel trial when org upgrades to a paid plan.
+     * Clears trial metadata so the org is no longer in trial state.
+     */
+    cancelTrial(orgId: string): Promise<void>;
+}
+//# sourceMappingURL=trial-service.d.ts.map

package/dist/cloud/billing/trial-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trial-service.d.ts","sourceRoot":"","sources":["../../../src/cloud/billing/trial-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,oBAAoB,CAAC;AAElE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,eAAe,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,qBAAa,YAAY;IACX,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,gBAAgB;IAE1C;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BrD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA8BzD;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IA8BrC;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAShD"}