@de-otio/trellis 0.4.0

package/dist/lib/performance-metrics.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Performance Metrics Collection
+ *
+ * Lightweight metrics collection for Cloudflare Workers.
+ * Tracks endpoint performance, database queries, cache performance, and errors.
+ */
+import { type LoggerEnv } from "./logger";
+export interface PerformanceMetrics {
+    endpoint: string;
+    method: string;
+    duration: number;
+    status: number;
+    timestamp: number;
+    userId?: string;
+    error?: string;
+}
+export interface DatabaseQueryMetrics {
+    operation: string;
+    region: string;
+    duration: number;
+    success: boolean;
+    retries: number;
+    timestamp: number;
+}
+export interface CacheMetrics {
+    cacheType: string;
+    hit: boolean;
+    duration?: number;
+    timestamp: number;
+}
+export interface ConnectionPoolMetrics {
+    region: string;
+    total: number;
+    idle: number;
+    waiting: number;
+    timestamp: number;
+}
+declare class PerformanceMetricsCollector {
+    private logger;
+    private endpointMetrics;
+    private databaseMetrics;
+    private cacheMetrics;
+    private connectionPoolMetrics;
+    private readonly MAX_METRICS_BUFFER;
+    constructor(env?: LoggerEnv);
+    /**
+     * Record endpoint performance metric
+     */
+    recordEndpointMetric(metric: PerformanceMetrics): void;
+    /**
+     * Record database query metric
+     */
+    recordDatabaseQuery(metric: DatabaseQueryMetrics): void;
+    /**
+     * Record cache metric
+     */
+    recordCacheMetric(metric: CacheMetrics): void;
+    /**
+     * Record connection pool metric
+     */
+    recordConnectionPoolMetric(metric: ConnectionPoolMetrics): void;
+    /**
+     * Calculate percentiles for endpoint response times
+     */
+    calculateEndpointPercentiles(endpoint: string, method: string): {
+        p50: number;
+        p95: number;
+        p99: number;
+        count: number;
+        average: number;
+        max: number;
+    } | null;
+    /**
+     * Calculate cache hit rate
+     */
+    calculateCacheHitRate(cacheType?: string): {
+        hitRate: number;
+        hitCount: number;
+        missCount: number;
+        total: number;
+    };
+    /**
+     * Calculate error rate for an endpoint
+     */
+    calculateErrorRate(endpoint: string, method: string): {
+        errorRate: number;
+        errorCount: number;
+        totalCount: number;
+        errorsByStatus: Record<number, number>;
+    };
+    /**
+     * Get summary metrics for logging
+     */
+    getSummaryMetrics(): {
+        endpoints: Record<string, {
+            p50: number;
+            p95: number;
+            p99: number;
+            average: number;
+            count: number;
+            errorRate: number;
+        }>;
+        cache: {
+            hitRate: number;
+            hitCount: number;
+            missCount: number;
+        };
+        database: {
+            averageQueryTime: number;
+            slowQueryCount: number;
+            totalQueries: number;
+        };
+    };
+    /**
+     * Log summary metrics (call periodically)
+     */
+    logSummaryMetrics(): void;
+    /**
+     * Clear metrics (call periodically to prevent memory growth)
+     */
+    clearMetrics(): void;
+}
+export declare function getPerformanceMetricsCollector(env?: LoggerEnv): PerformanceMetricsCollector;
+export {};
+//# sourceMappingURL=performance-metrics.d.ts.map

package/dist/lib/performance-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-metrics.d.ts","sourceRoot":"","sources":["../../src/lib/performance-metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,cAAM,2BAA2B;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,qBAAqB,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAO;gBAE9B,GAAG,CAAC,EAAE,SAAS;IAI3B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IA8BtD;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IA2BvD;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAO7C;;OAEG;IACH,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAiB/D;;OAEG;IACH,4BAA4B,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;QACD,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,IAAI;IA6BR;;OAEG;IACH,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;QACzC,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf;IAiBD;;OAEG;IACH,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC;IA8BD;;OAEG;IACH,iBAAiB,IAAI;QACnB,SAAS,EAAE,MAAM,CACf,MAAM,EACN;YACE,GAAG,EAAE,MAAM,CAAC;YACZ,GAAG,EAAE,MAAM,CAAC;YACZ,GAAG,EAAE,MAAM,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,SAAS,EAAE,MAAM,CAAC;SACnB,CACF,CAAC;QACF,KAAK,EAAE;YACL,OAAO,EAAE,MAAM,CAAC;YAChB,QAAQ,EAAE,MAAM,CAAC;YACjB,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,QAAQ,EAAE;YACR,gBAAgB,EAAE,MAAM,CAAC;YACzB,cAAc,EAAE,MAAM,CAAC;YACvB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC;KACH;IA4DD;;OAEG;IACH,iBAAiB,IAAI,IAAI;IA8DzB;;OAEG;IACH,YAAY,IAAI,IAAI;CAMrB;AAMD,wBAAgB,8BAA8B,CAC5C,GAAG,CAAC,EAAE,SAAS,GACd,2BAA2B,CAK7B"}

package/dist/lib/performance-metrics.js

@@ -0,0 +1,277 @@
+"use strict";
+/**
+ * Performance Metrics Collection
+ *
+ * Lightweight metrics collection for Cloudflare Workers.
+ * Tracks endpoint performance, database queries, cache performance, and errors.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPerformanceMetricsCollector = getPerformanceMetricsCollector;
+const logger_1 = require("./logger");
+class PerformanceMetricsCollector {
+    logger;
+    endpointMetrics = [];
+    databaseMetrics = [];
+    cacheMetrics = [];
+    connectionPoolMetrics = [];
+    MAX_METRICS_BUFFER = 100; // Keep last 100 metrics in memory
+    constructor(env) {
+        this.logger = logger_1.Logger.getInstance(env);
+    }
+    /**
+     * Record endpoint performance metric
+     */
+    recordEndpointMetric(metric) {
+        this.endpointMetrics.push(metric);
+        if (this.endpointMetrics.length > this.MAX_METRICS_BUFFER) {
+            this.endpointMetrics.shift();
+        }
+        // Log slow endpoints
+        if (metric.duration > 1000) {
+            this.logger.warn("[PerformanceMetrics] Slow endpoint detected", {
+                endpoint: metric.endpoint,
+                method: metric.method,
+                duration: metric.duration,
+                status: metric.status,
+                userId: metric.userId,
+            });
+        }
+        // Log errors
+        if (metric.status >= 500 || metric.error) {
+            this.logger.error("[PerformanceMetrics] Endpoint error", {
+                endpoint: metric.endpoint,
+                method: metric.method,
+                duration: metric.duration,
+                status: metric.status,
+                error: metric.error,
+                userId: metric.userId,
+            });
+        }
+    }
+    /**
+     * Record database query metric
+     */
+    recordDatabaseQuery(metric) {
+        this.databaseMetrics.push(metric);
+        if (this.databaseMetrics.length > this.MAX_METRICS_BUFFER) {
+            this.databaseMetrics.shift();
+        }
+        // Log slow queries
+        if (metric.duration > 1000) {
+            this.logger.warn("[PerformanceMetrics] Slow database query", {
+                operation: metric.operation,
+                region: metric.region,
+                duration: metric.duration,
+                retries: metric.retries,
+            });
+        }
+        // Log failed queries
+        if (!metric.success) {
+            this.logger.error("[PerformanceMetrics] Database query failed", {
+                operation: metric.operation,
+                region: metric.region,
+                duration: metric.duration,
+                retries: metric.retries,
+            });
+        }
+    }
+    /**
+     * Record cache metric
+     */
+    recordCacheMetric(metric) {
+        this.cacheMetrics.push(metric);
+        if (this.cacheMetrics.length > this.MAX_METRICS_BUFFER) {
+            this.cacheMetrics.shift();
+        }
+    }
+    /**
+     * Record connection pool metric
+     */
+    recordConnectionPoolMetric(metric) {
+        this.connectionPoolMetrics.push(metric);
+        if (this.connectionPoolMetrics.length > this.MAX_METRICS_BUFFER) {
+            this.connectionPoolMetrics.shift();
+        }
+        // Alert if pool is exhausted
+        if (metric.waiting > 0) {
+            this.logger.warn("[PerformanceMetrics] Connection pool exhausted", {
+                region: metric.region,
+                total: metric.total,
+                idle: metric.idle,
+                waiting: metric.waiting,
+            });
+        }
+    }
+    /**
+     * Calculate percentiles for endpoint response times
+     */
+    calculateEndpointPercentiles(endpoint, method) {
+        const relevantMetrics = this.endpointMetrics.filter((m) => m.endpoint === endpoint && m.method === method);
+        if (relevantMetrics.length === 0) {
+            return null;
+        }
+        const durations = relevantMetrics
+            .map((m) => m.duration)
+            .sort((a, b) => a - b);
+        const p50 = durations[Math.floor(durations.length * 0.5)] || 0;
+        const p95 = durations[Math.floor(durations.length * 0.95)] || 0;
+        const p99 = durations[Math.floor(durations.length * 0.99)] || 0;
+        const average = durations.reduce((sum, d) => sum + d, 0) / durations.length;
+        const max = durations[durations.length - 1] || 0;
+        return {
+            p50,
+            p95,
+            p99,
+            count: durations.length,
+            average,
+            max,
+        };
+    }
+    /**
+     * Calculate cache hit rate
+     */
+    calculateCacheHitRate(cacheType) {
+        const relevantMetrics = cacheType
+            ? this.cacheMetrics.filter((m) => m.cacheType === cacheType)
+            : this.cacheMetrics;
+        if (relevantMetrics.length === 0) {
+            return { hitRate: 0, hitCount: 0, missCount: 0, total: 0 };
+        }
+        const hitCount = relevantMetrics.filter((m) => m.hit).length;
+        const missCount = relevantMetrics.filter((m) => !m.hit).length;
+        const total = relevantMetrics.length;
+        const hitRate = total > 0 ? (hitCount / total) * 100 : 0;
+        return { hitRate, hitCount, missCount, total };
+    }
+    /**
+     * Calculate error rate for an endpoint
+     */
+    calculateErrorRate(endpoint, method) {
+        const relevantMetrics = this.endpointMetrics.filter((m) => m.endpoint === endpoint && m.method === method);
+        if (relevantMetrics.length === 0) {
+            return {
+                errorRate: 0,
+                errorCount: 0,
+                totalCount: 0,
+                errorsByStatus: {},
+            };
+        }
+        const errorMetrics = relevantMetrics.filter((m) => m.status >= 400 || m.error);
+        const errorsByStatus = {};
+        errorMetrics.forEach((m) => {
+            errorsByStatus[m.status] = (errorsByStatus[m.status] || 0) + 1;
+        });
+        const errorCount = errorMetrics.length;
+        const totalCount = relevantMetrics.length;
+        const errorRate = totalCount > 0 ? (errorCount / totalCount) * 100 : 0;
+        return { errorRate, errorCount, totalCount, errorsByStatus };
+    }
+    /**
+     * Get summary metrics for logging
+     */
+    getSummaryMetrics() {
+        const endpoints = {};
+        // Calculate metrics for each unique endpoint
+        const endpointKeys = new Set(this.endpointMetrics.map((m) => `${m.method}:${m.endpoint}`));
+        endpointKeys.forEach((key) => {
+            const [method, endpoint] = key.split(":");
+            const percentiles = this.calculateEndpointPercentiles(endpoint, method);
+            const errorRate = this.calculateErrorRate(endpoint, method);
+            if (percentiles) {
+                endpoints[key] = {
+                    p50: percentiles.p50,
+                    p95: percentiles.p95,
+                    p99: percentiles.p99,
+                    average: percentiles.average,
+                    count: percentiles.count,
+                    errorRate: errorRate.errorRate,
+                };
+            }
+        });
+        const cache = this.calculateCacheHitRate();
+        const slowQueryCount = this.databaseMetrics.filter((m) => m.duration > 1000).length;
+        const averageQueryTime = this.databaseMetrics.length > 0
+            ? this.databaseMetrics.reduce((sum, m) => sum + m.duration, 0) /
+                this.databaseMetrics.length
+            : 0;
+        return {
+            endpoints,
+            cache: {
+                hitRate: cache.hitRate,
+                hitCount: cache.hitCount,
+                missCount: cache.missCount,
+            },
+            database: {
+                averageQueryTime,
+                slowQueryCount,
+                totalQueries: this.databaseMetrics.length,
+            },
+        };
+    }
+    /**
+     * Log summary metrics (call periodically)
+     */
+    logSummaryMetrics() {
+        const summary = this.getSummaryMetrics();
+        this.logger.info("[PerformanceMetrics] Summary metrics", {
+            endpoints: summary.endpoints,
+            cache: summary.cache,
+            database: summary.database,
+            timestamp: Date.now(),
+        });
+        // Check for alert conditions
+        Object.entries(summary.endpoints).forEach(([key, metrics]) => {
+            // Alert if p95 > 1 second
+            if (metrics.p95 > 1000) {
+                this.logger.warn("[PerformanceMetrics] ALERT: Endpoint p95 latency > 1s", {
+                    endpoint: key,
+                    p95: metrics.p95,
+                    p99: metrics.p99,
+                });
+            }
+            // Alert if error rate > 5%
+            if (metrics.errorRate > 5) {
+                this.logger.error("[PerformanceMetrics] ALERT: Endpoint error rate > 5%", {
+                    endpoint: key,
+                    errorRate: metrics.errorRate,
+                    count: metrics.count,
+                });
+            }
+        });
+        // Alert if cache hit rate < 80%
+        if (summary.cache.hitRate < 80 &&
+            summary.cache.hitCount + summary.cache.missCount > 10) {
+            this.logger.warn("[PerformanceMetrics] ALERT: Cache hit rate < 80%", {
+                hitRate: summary.cache.hitRate,
+                hitCount: summary.cache.hitCount,
+                missCount: summary.cache.missCount,
+            });
+        }
+        // Alert if average query time > 500ms
+        if (summary.database.averageQueryTime > 500) {
+            this.logger.warn("[PerformanceMetrics] ALERT: Average database query time > 500ms", {
+                averageQueryTime: summary.database.averageQueryTime,
+                slowQueryCount: summary.database.slowQueryCount,
+                totalQueries: summary.database.totalQueries,
+            });
+        }
+    }
+    /**
+     * Clear metrics (call periodically to prevent memory growth)
+     */
+    clearMetrics() {
+        this.endpointMetrics = [];
+        this.databaseMetrics = [];
+        this.cacheMetrics = [];
+        this.connectionPoolMetrics = [];
+    }
+}
+// Singleton instance
+let sharedPerformanceMetricsCollector = null;
+function getPerformanceMetricsCollector(env) {
+    if (!sharedPerformanceMetricsCollector) {
+        sharedPerformanceMetricsCollector = new PerformanceMetricsCollector(env);
+    }
+    return sharedPerformanceMetricsCollector;
+}
+//# sourceMappingURL=performance-metrics.js.map

package/dist/lib/performance-metrics.js.map

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

package/dist/lib/post-handler.d.ts

@@ -0,0 +1,94 @@
+import type { KVNamespace } from "../types/cloudflare-compat";
+import { type LoggerEnv } from "./logger";
+import type { RequestContext } from "./request-context";
+import type { Session } from "./session-manager";
+export interface Env {
+    DATABASE_URL: string;
+    US_DATABASE_URL?: string;
+    EU_DATABASE_URL?: string;
+    CN_DATABASE_URL?: string;
+    GOOGLE_API_KEY?: string;
+    MODERATION_CACHE_KV?: KVNamespace;
+    FEED_CACHE_KV?: KVNamespace;
+    FRIENDS_KV?: KVNamespace;
+    CACHE_KV?: KVNamespace;
+    TAXONOMY_CACHE_KV?: KVNamespace;
+    LINK_CHECK_QUEUE?: any;
+    DEFAULT_REGION?: string;
+}
+export interface CreatePostRequest {
+    text: string;
+    visibility?: "public" | "friends-only" | "private";
+    radius?: string;
+    entityRefs?: string[];
+    taxonomyTags?: string[];
+    geoData?: {
+        lat: number;
+        lng: number;
+        place?: string;
+    };
+    contentWarnings?: string[];
+    media?: Array<{
+        file: File | Blob;
+        alt?: string;
+        mimeType: string;
+    }>;
+}
+export declare class PostHandler {
+    private moderationHandler;
+    private logger;
+    constructor(env?: LoggerEnv);
+    /**
+     * Create a new post
+     *
+     * PREPARATORY: Uses DataRouter for region-aware post creation.
+     */
+    createPost(request: Request, session: Session, env: Env, requestContext: RequestContext): Promise<Response>;
+    /**
+     * Delete a post (soft delete)
+     *
+     * PREPARATORY: Uses DataRouter to validate region before deletion.
+     */
+    deletePost(postId: string, request: Request, session: Session, env: Env, requestContext: RequestContext): Promise<Response>;
+    /**
+     * Edit an existing post
+     *
+     * PREPARATORY: Uses DataRouter to validate region before editing.
+     *
+     * Requirements:
+     * - 4.1: PATCH /api/posts/:postId endpoint
+     * - 4.2: Update post text and media
+     * - 4.3: Set editedAt timestamp
+     * - 4.4, 4.5: Validate input (text required, max 3000 chars)
+     * - 4.6: Return 401 if not authenticated
+     * - 4.7: Return 403 if not post owner
+     * - 4.8: Return 404 if post not found
+     * - 5.1-5.4: Content moderation on edited content
+     * - 6.1-6.4: ActivityPub sync for public posts
+     * - 7.1-7.3: Cache invalidation
+     */
+    editPost(postId: string, request: Request, session: Session, env: Env, requestContext: RequestContext): Promise<Response>;
+    /**
+     * Invalidate post-specific cache entries
+     */
+    private invalidatePostCache;
+    /**
+     * Hide a post
+     *
+     * PREPARATORY: Uses DataRouter to validate region before hiding.
+     */
+    hidePost(postId: string, request: Request, session: Session, env: Env, requestContext: RequestContext): Promise<Response>;
+    /**
+     * Unhide a post
+     *
+     * PREPARATORY: Uses DataRouter to validate region before unhiding.
+     */
+    unhidePost(postId: string, request: Request, session: Session, env: Env, requestContext: RequestContext): Promise<Response>;
+    /**
+     * Invalidate feed cache by incrementing version
+     * Uses cache versioning: all cache keys include a version number,
+     * and incrementing the version makes all old cache entries invalid.
+     */
+    private invalidateFeedCache;
+}
+//# sourceMappingURL=post-handler.d.ts.map

package/dist/lib/post-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-handler.d.ts","sourceRoot":"","sources":["../../src/lib/post-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,4BAA4B,CAAC;AAWzF,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,GAAG;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,WAAW,CAAC;IAClC,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEX,GAAG,CAAC,EAAE,SAAS;IAK3B;;;;OAIG;IACG,UAAU,CACd,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC;IA6gCpB;;;;OAIG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC;IA8HpB;;;;;;;;;;;;;;;;OAgBG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC;IAuXpB;;OAEG;YACW,mBAAmB;IAkBjC;;;;OAIG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC;IAwEpB;;;;OAIG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC;IA2EpB;;;;OAIG;YACW,mBAAmB;CAiBlC"}