@de-otio/trellis 0.4.0

package/dist/lib/moderation-handler.js

@@ -0,0 +1,230 @@
+"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 });
+exports.ModerationHandler = void 0;
+/**
+ * Moderation Handler
+ *
+ * Handles text content moderation using OpenAI Moderation API.
+ * Caches moderation results in KV to reduce API calls.
+ * Respects OpenAI budget limits — skips moderation when budget is exceeded.
+ */
+const logger_1 = require("./logger");
+const openai_budget_1 = require("./openai-budget");
+const cost_accumulator_1 = require("./cost-accumulator");
+class ModerationHandler {
+    OPENAI_API_URL = "https://api.openai.com/v1/moderations";
+    /**
+     * Moderate text content using OpenAI Moderation API
+     */
+    async moderateText(text, env) {
+        // Check OpenAI budget before making API call
+        const budgetConfig = {
+            enabled: env.OPENAI_BUDGET_ENABLED !== "false",
+            maxRequestsPerHour: parseInt(env.OPENAI_BUDGET_HOURLY_MAX || "500", 10),
+            maxRequestsPerDay: parseInt(env.OPENAI_BUDGET_DAILY_MAX || "5000", 10),
+        };
+        const budget = new openai_budget_1.OpenAiBudget(budgetConfig);
+        if (!await budget.tryConsume()) {
+            logger_1.Logger.getInstance(env).warn("[Moderation] OpenAI budget exceeded, skipping moderation");
+            return { approved: true, budgetExceeded: true };
+        }
+        // OPTIMIZATION: Check cache first with timeout to avoid slow KV reads
+        const cacheKey = this.getCacheKey(text);
+        const CACHE_TIMEOUT_MS = 500; // 0.5 seconds max for cache lookup
+        let cached = null;
+        try {
+            const cachePromise = this.getCachedResult(cacheKey, env);
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error("Cache timeout")), CACHE_TIMEOUT_MS);
+            });
+            cached = await Promise.race([cachePromise, timeoutPromise]);
+        }
+        catch (error) {
+            // If cache lookup times out or fails, continue without cache
+            logger_1.Logger.getInstance(env).debug("[ModerationHandler] Cache lookup timeout/failed, continuing without cache");
+        }
+        if (cached) {
+            return cached;
+        }
+        // Get API key using SecretResolver (supports both old and new naming conventions)
+        const { Secrets } = await Promise.resolve().then(() => __importStar(require("./secret-resolver")));
+        const apiKey = Secrets.getOpenAIApiKey(env) || env.OPENAI_API_KEY;
+        // If no API key, skip moderation (for development/testing)
+        if (!apiKey) {
+            logger_1.Logger.getInstance(env).warn("OPENAI_API_KEY not set, skipping moderation");
+            return { approved: true };
+        }
+        try {
+            // OPTIMIZATION: Add timeout to OpenAI API call to fail fast
+            // If API is slow, don't block post creation
+            const MODERATION_TIMEOUT_MS = 2000; // 2 seconds max for moderation
+            const fetchPromise = fetch(this.OPENAI_API_URL, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    input: text,
+                    model: "text-moderation-latest",
+                }),
+            });
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new Error("Moderation API timeout"));
+                }, MODERATION_TIMEOUT_MS);
+            });
+            const response = await Promise.race([fetchPromise, timeoutPromise]);
+            if (!response.ok) {
+                const errorText = await response.text();
+                logger_1.Logger.getInstance(env).error("OpenAI Moderation API error:", errorText);
+                // On API error, approve content (fail open for availability)
+                return { approved: true, error: "Moderation service unavailable" };
+            }
+            const data = (await response.json());
+            const result = data.results[0];
+            // Simple flag-based approval (no complex threshold logic)
+            const approved = !result.flagged;
+            // Convert category names to snake_case for consistency
+            const categories = {
+                hate: result.categories.hate,
+                hate_threatening: result.categories["hate/threatening"],
+                harassment: result.categories.harassment,
+                harassment_threatening: result.categories["harassment/threatening"],
+                self_harm: result.categories["self-harm"],
+                self_harm_intent: result.categories["self-harm/intent"],
+                self_harm_instructions: result.categories["self-harm/instructions"],
+                sexual: result.categories.sexual,
+                sexual_minors: result.categories["sexual/minors"],
+                violence: result.categories.violence,
+                violence_graphic: result.categories["violence/graphic"],
+            };
+            const categoryScores = {
+                hate: result.category_scores.hate,
+                hate_threatening: result.category_scores["hate/threatening"],
+                harassment: result.category_scores.harassment,
+                harassment_threatening: result.category_scores["harassment/threatening"],
+                self_harm: result.category_scores["self-harm"],
+                self_harm_intent: result.category_scores["self-harm/intent"],
+                self_harm_instructions: result.category_scores["self-harm/instructions"],
+                sexual: result.category_scores.sexual,
+                sexual_minors: result.category_scores["sexual/minors"],
+                violence: result.category_scores.violence,
+                violence_graphic: result.category_scores["violence/graphic"],
+            };
+            // Calculate max score for backwards compatibility
+            const maxScore = Math.max(...Object.values(categoryScores));
+            const moderationResult = {
+                approved,
+                score: maxScore,
+                details: {
+                    categories,
+                    categoryScores,
+                },
+            };
+            // Record cost event (in-memory, zero I/O)
+            cost_accumulator_1.CostAccumulator.getInstance().record({ service: "openai", operation: "moderation", units: 1 });
+            // Cache result (24 hour TTL) - fire and forget to avoid blocking
+            // Don't await - if caching is slow, don't block the response
+            this.cacheResult(cacheKey, moderationResult, env).catch((error) => {
+                logger_1.Logger.getInstance(env).debug("[ModerationHandler] Cache write failed (non-blocking):", error);
+            });
+            return moderationResult;
+        }
+        catch (error) {
+            logger_1.Logger.getInstance(env).error("Moderation error:", error);
+            // Fail open - approve content if moderation fails
+            return { approved: true, error: "Moderation service error" };
+        }
+    }
+    /**
+     * Get cache key for text content
+     */
+    getCacheKey(text) {
+        // Use a hash of the text as cache key
+        // In production, use a proper hash function
+        const hash = this.simpleHash(text);
+        return `moderation:${hash}`;
+    }
+    /**
+     * Simple hash function for cache keys
+     */
+    simpleHash(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return Math.abs(hash).toString(36);
+    }
+    /**
+     * Get cached moderation result
+     */
+    async getCachedResult(cacheKey, env) {
+        const kv = env.MODERATION_CACHE_KV || env.FEED_CACHE_KV;
+        if (!kv)
+            return null;
+        try {
+            const cached = await kv.get(cacheKey, "json");
+            return cached;
+        }
+        catch (error) {
+            logger_1.Logger.getInstance(env).error("Cache read error:", error);
+            return null;
+        }
+    }
+    /**
+     * Cache moderation result
+     */
+    async cacheResult(cacheKey, result, env) {
+        const kv = env.MODERATION_CACHE_KV || env.FEED_CACHE_KV;
+        if (!kv)
+            return;
+        try {
+            // Cache for 24 hours
+            await kv.put(cacheKey, JSON.stringify(result), {
+                expirationTtl: 24 * 60 * 60,
+            });
+        }
+        catch (error) {
+            logger_1.Logger.getInstance(env).error("Cache write error:", error);
+            // Non-fatal - continue without caching
+        }
+    }
+}
+exports.ModerationHandler = ModerationHandler;
+//# sourceMappingURL=moderation-handler.js.map

package/dist/lib/moderation-handler.js.map

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

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

@@ -0,0 +1,65 @@
+/**
+ * Notification Handler
+ *
+ * Manages notification creation, retrieval, and read status.
+ * Respects user preferences and quiet hours.
+ * SAFETY_ALERT and PARENTAL_LINK notifications always bypass preferences and quiet hours.
+ * Part of Stream C: Notifications.
+ */
+import type { Env } from "../env";
+import type { NotificationType } from "@prisma/client";
+export interface NotificationListResponse {
+    notifications: Array<{
+        id: string;
+        type: NotificationType;
+        title: string;
+        body: string;
+        data: any;
+        read: boolean;
+        createdAt: string;
+    }>;
+    cursor?: string;
+    hasMore: boolean;
+}
+export declare class NotificationHandler {
+    /**
+     * Create a notification for a user.
+     * Checks preferences (unless SAFETY_ALERT or PARENTAL_LINK) and quiet hours.
+     */
+    createNotification(userId: string, type: NotificationType, title: string, body: string, data: any, env: Env): Promise<{
+        id: string;
+    }>;
+    /**
+     * Get paginated notifications for a user.
+     */
+    getNotifications(userId: string, cursor: string | null, limit: number, env: Env): Promise<NotificationListResponse>;
+    /**
+     * Mark a single notification as read. Verifies it belongs to the user.
+     */
+    markRead(userId: string, notificationId: string, env: Env): Promise<void>;
+    /**
+     * Mark all unread notifications as read for a user.
+     */
+    markAllRead(userId: string, env: Env): Promise<void>;
+    /**
+     * Get unread notification count.
+     * CHILD/TEEN: return { hasUnread: boolean } only (no exact count).
+     * ADULT: return { hasUnread: boolean, count: number }.
+     */
+    getUnreadCount(userId: string, ageTier: string, env: Env): Promise<{
+        hasUnread: boolean;
+        count?: number;
+    }>;
+    /**
+     * Check whether a notification type is enabled in preferences.
+     */
+    private isTypeEnabled;
+    /**
+     * Check if current time falls within user's quiet hours.
+     */
+    private isInQuietHours;
+}
+export declare class NotificationNotFoundError extends Error {
+    constructor(notificationId: string);
+}
+//# sourceMappingURL=notification-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification-handler.d.ts","sourceRoot":"","sources":["../../src/lib/notification-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAGlC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,KAAK,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,gBAAgB,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,GAAG,CAAC;QACV,IAAI,EAAE,OAAO,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAQD,qBAAa,mBAAmB;IAC9B;;;OAGG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,GAAG,EAAE,GAAG,GACP,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAkE1B;;OAEG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,wBAAwB,CAAC;IAsCpC;;OAEG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,IAAI,CAAC;IAqBhB;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1D;;;;OAIG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,GAAG,GACP,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBlD;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACH,OAAO,CAAC,cAAc;CA0BvB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,cAAc,EAAE,MAAM;CAInC"}

package/dist/lib/notification-handler.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * Notification Handler
+ *
+ * Manages notification creation, retrieval, and read status.
+ * Respects user preferences and quiet hours.
+ * SAFETY_ALERT and PARENTAL_LINK notifications always bypass preferences and quiet hours.
+ * Part of Stream C: Notifications.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationNotFoundError = exports.NotificationHandler = void 0;
+const db_1 = require("../db");
+const logger_1 = require("./logger");
+/** Notification types that always bypass preferences and quiet hours */
+const ALWAYS_DELIVER_TYPES = [
+    "SAFETY_ALERT",
+    "PARENTAL_LINK",
+];
+class NotificationHandler {
+    /**
+     * Create a notification for a user.
+     * Checks preferences (unless SAFETY_ALERT or PARENTAL_LINK) and quiet hours.
+     */
+    async createNotification(userId, type, title, body, data, env) {
+        const logger = logger_1.Logger.getInstance(env);
+        const db = (0, db_1.createPrisma)(env);
+        try {
+            const bypassPreferences = ALWAYS_DELIVER_TYPES.includes(type);
+            // 1. Check user's NotificationPreference (skip for SAFETY_ALERT and PARENTAL_LINK)
+            if (!bypassPreferences) {
+                const prefs = await db.notificationPreference.findUnique({
+                    where: { userId },
+                });
+                if (prefs) {
+                    // 2. Check type-specific preference
+                    const enabled = this.isTypeEnabled(type, prefs);
+                    if (!enabled) {
+                        logger.info("Notification skipped due to preferences", {
+                            userId,
+                            type,
+                        });
+                        return { id: "" };
+                    }
+                }
+            }
+            // 3. Check quiet hours (skip for SAFETY_ALERT and PARENTAL_LINK)
+            let deliveredAt = new Date();
+            if (!bypassPreferences) {
+                const user = await db.user.findUnique({
+                    where: { id: userId },
+                    select: {
+                        quietHoursEnabled: true,
+                        quietHoursStart: true,
+                        quietHoursEnd: true,
+                    },
+                });
+                if (user?.quietHoursEnabled && this.isInQuietHours(user)) {
+                    // 4. In quiet hours: create with deliveredAt=null
+                    deliveredAt = null;
+                }
+            }
+            // 5. Create notification
+            const notification = await db.notification.create({
+                data: {
+                    userId,
+                    type,
+                    title,
+                    body,
+                    data: data ?? undefined,
+                    deliveredAt,
+                },
+            });
+            return { id: notification.id };
+        }
+        catch (error) {
+            logger.error("Error creating notification:", error);
+            throw error;
+        }
+        finally {
+            await db.release();
+        }
+    }
+    /**
+     * Get paginated notifications for a user.
+     */
+    async getNotifications(userId, cursor, limit, env) {
+        const db = (0, db_1.createPrisma)(env);
+        try {
+            const safeLimit = Math.min(Math.max(limit, 1), 50);
+            const notifications = await db.notification.findMany({
+                where: {
+                    userId,
+                    ...(cursor ? { createdAt: { lt: new Date(cursor) } } : {}),
+                },
+                orderBy: { createdAt: "desc" },
+                take: safeLimit + 1,
+            });
+            const hasMore = notifications.length > safeLimit;
+            const items = notifications.slice(0, safeLimit);
+            return {
+                notifications: items.map((n) => ({
+                    id: n.id,
+                    type: n.type,
+                    title: n.title,
+                    body: n.body,
+                    data: n.data,
+                    read: n.read,
+                    createdAt: n.createdAt.toISOString(),
+                })),
+                cursor: hasMore
+                    ? items[items.length - 1].createdAt.toISOString()
+                    : undefined,
+                hasMore,
+            };
+        }
+        finally {
+            await db.release();
+        }
+    }
+    /**
+     * Mark a single notification as read. Verifies it belongs to the user.
+     */
+    async markRead(userId, notificationId, env) {
+        const db = (0, db_1.createPrisma)(env);
+        try {
+            const notification = await db.notification.findFirst({
+                where: { id: notificationId, userId },
+            });
+            if (!notification) {
+                throw new NotificationNotFoundError(notificationId);
+            }
+            await db.notification.update({
+                where: { id: notificationId },
+                data: { read: true },
+            });
+        }
+        finally {
+            await db.release();
+        }
+    }
+    /**
+     * Mark all unread notifications as read for a user.
+     */
+    async markAllRead(userId, env) {
+        const db = (0, db_1.createPrisma)(env);
+        try {
+            await db.notification.updateMany({
+                where: { userId, read: false },
+                data: { read: true },
+            });
+        }
+        finally {
+            await db.release();
+        }
+    }
+    /**
+     * Get unread notification count.
+     * CHILD/TEEN: return { hasUnread: boolean } only (no exact count).
+     * ADULT: return { hasUnread: boolean, count: number }.
+     */
+    async getUnreadCount(userId, ageTier, env) {
+        const db = (0, db_1.createPrisma)(env);
+        try {
+            if (ageTier === "CHILD" || ageTier === "TEEN") {
+                // For minors, only check existence (no exact count)
+                const first = await db.notification.findFirst({
+                    where: { userId, read: false },
+                    select: { id: true },
+                });
+                return { hasUnread: !!first };
+            }
+            // ADULT: return exact count
+            const count = await db.notification.count({
+                where: { userId, read: false },
+            });
+            return { hasUnread: count > 0, count };
+        }
+        finally {
+            await db.release();
+        }
+    }
+    /**
+     * Check whether a notification type is enabled in preferences.
+     */
+    isTypeEnabled(type, prefs) {
+        switch (type) {
+            case "DIRECT_MESSAGE":
+                return prefs.dmEnabled;
+            case "FOLLOW":
+                return prefs.followEnabled;
+            case "SENTIMENT_DIGEST":
+                return prefs.digestEnabled;
+            case "SYSTEM":
+                return prefs.systemEnabled;
+            case "RELATIONSHIP_CREATED":
+            case "RELATIONSHIP_RECIPROCATED":
+            case "TIER_CHANGED":
+            case "ENTITY_RELATIONSHIP_PROPOSED":
+            case "ENTITY_RELATIONSHIP_CONFIRMED":
+            case "CONNECTION_CODE_REDEEMED":
+                return prefs.relationshipEnabled;
+            // SAFETY_ALERT and PARENTAL_LINK are handled before this check
+            default:
+                return true;
+        }
+    }
+    /**
+     * Check if current time falls within user's quiet hours.
+     */
+    isInQuietHours(user) {
+        if (!user.quietHoursEnabled ||
+            user.quietHoursStart == null ||
+            user.quietHoursEnd == null) {
+            return false;
+        }
+        const now = new Date();
+        const minutesSinceMidnight = now.getHours() * 60 + now.getMinutes();
+        const start = user.quietHoursStart;
+        const end = user.quietHoursEnd;
+        // Handle overnight quiet hours (e.g., 22:00 to 07:00)
+        if (start > end) {
+            return minutesSinceMidnight >= start || minutesSinceMidnight < end;
+        }
+        // Same-day quiet hours (e.g., 13:00 to 15:00)
+        return minutesSinceMidnight >= start && minutesSinceMidnight < end;
+    }
+}
+exports.NotificationHandler = NotificationHandler;
+class NotificationNotFoundError extends Error {
+    constructor(notificationId) {
+        super(`Notification ${notificationId} not found`);
+        this.name = "NotificationNotFoundError";
+    }
+}
+exports.NotificationNotFoundError = NotificationNotFoundError;
+//# sourceMappingURL=notification-handler.js.map

package/dist/lib/notification-handler.js.map

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

package/dist/lib/notification-preferences-handler.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Notification Preferences Handler
+ *
+ * Manages user notification preferences. CHILD users cannot edit
+ * their own preferences (must be managed by guardian).
+ * Part of Stream C: Notifications.
+ */
+import type { Env } from "../env";
+export interface NotificationPreferenceInput {
+    dmEnabled: boolean;
+    followEnabled: boolean;
+    digestEnabled: boolean;
+    systemEnabled: boolean;
+}
+export declare class NotificationPreferencesHandler {
+    /**
+     * Get notification preferences for a user.
+     * Returns defaults if no stored preferences exist.
+     */
+    getPreferences(userId: string, env: Env): Promise<Response>;
+    /**
+     * Update notification preferences.
+     * CHILD users cannot edit their own preferences (403).
+     */
+    updatePreferences(userId: string, ageTier: string, preferences: Partial<NotificationPreferenceInput>, env: Env): Promise<Response>;
+}
+//# sourceMappingURL=notification-preferences-handler.d.ts.map

package/dist/lib/notification-preferences-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-preferences-handler.d.ts","sourceRoot":"","sources":["../../src/lib/notification-preferences-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAIlC,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACxB;AASD,qBAAa,8BAA8B;IACzC;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiCjE;;;OAGG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,OAAO,CAAC,2BAA2B,CAAC,EACjD,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,QAAQ,CAAC;CAgFrB"}