ugly-app 0.1.0

package/dist/server/FeedbackReport.js

@@ -0,0 +1,94 @@
+import { nanoid } from 'nanoid';
+import { ResolveFeedbackInput, SubmitFeedbackInput, } from '../shared/FeedbackReport.js';
+import { getDbName, getMongoClient } from './DB.js';
+export function createSubmitFeedbackHandler(db) {
+    return async (input) => {
+        const now = Date.now();
+        const id = nanoid();
+        const doc = {
+            id,
+            userId: input.userId,
+            type: input.type,
+            message: input.message,
+            url: input.url,
+            screenshotUri: input.screenshotUri,
+            context: input.context,
+            status: 'pending',
+            version: 1,
+            created: now,
+            updated: now,
+        };
+        await db
+            .collection('feedbackReport')
+            .insertOne({ ...doc, _id: id });
+        return { id };
+    };
+}
+export function createResolveFeedbackHandler(db) {
+    return async (input) => {
+        const now = Date.now();
+        const result = await db.collection('feedbackReport').updateOne({ id: input.feedbackId }, {
+            $set: {
+                status: input.status,
+                resolution: input.resolution,
+                resolvedAt: now,
+                updated: now,
+            },
+        });
+        if (result.matchedCount === 0)
+            throw new Error(`Feedback not found: ${input.feedbackId}`);
+    };
+}
+export async function getMyFeedbackMarkdown(db, userId) {
+    // Mark pending → captured on read (so maintain bot doesn't double-process)
+    await db
+        .collection('feedbackReport')
+        .updateMany({ userId, status: 'pending' }, { $set: { status: 'captured', updated: Date.now() } });
+    const docs = (await db
+        .collection('feedbackReport')
+        .find({ userId })
+        .sort({ created: -1 })
+        .limit(100)
+        .toArray());
+    if (docs.length === 0)
+        return '# My Feedback\n\nNo feedback submitted yet.\n';
+    const lines = ['# My Feedback\n'];
+    for (const doc of docs) {
+        const date = new Date(doc.created).toISOString().split('T')[0];
+        lines.push(`## [${date}] ${doc.message} — ${doc.type}`);
+        lines.push(`**Status:** ${doc.status}`);
+        if (doc.resolution)
+            lines.push(`**Response:** ${doc.resolution}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function registerFeedbackHandlers(router, maintainBotUserId) {
+    router.registerFunction('submitFeedback', async (ctx, input) => {
+        // Use getMongoClient() directly — ctx.db is a typed wrapper, not a raw Mongo Db
+        const client = await getMongoClient();
+        const db = client.db(getDbName());
+        const handler = createSubmitFeedbackHandler(db);
+        return handler({
+            userId: ctx.userId,
+            ...input,
+        });
+    }, {
+        _input: undefined,
+        _output: undefined,
+        inputSchema: SubmitFeedbackInput,
+    });
+    router.registerFunction('resolveFeedback', async (ctx, input) => {
+        if (ctx.userId !== maintainBotUserId)
+            throw new Error('Not authorized');
+        const client = await getMongoClient();
+        const db = client.db(getDbName());
+        const handler = createResolveFeedbackHandler(db);
+        return handler(input);
+    }, {
+        _input: undefined,
+        _output: undefined,
+        inputSchema: ResolveFeedbackInput,
+    });
+}
+//# sourceMappingURL=FeedbackReport.js.map

package/dist/server/FeedbackReport.js.map

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

package/dist/server/ImageGen.d.ts

@@ -0,0 +1,5 @@
+import './ai/index.js';
+export { createImageGenClient as createImageGen } from './ai/ImageGenClient.js';
+export type { ImageGenClient } from './ai/ImageGenClient.js';
+export type { ImageGenOptions } from './ai/types.js';
+//# sourceMappingURL=ImageGen.d.ts.map

package/dist/server/ImageGen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageGen.d.ts","sourceRoot":"","sources":["../../src/server/ImageGen.ts"],"names":[],"mappings":"AAEA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/ImageGen.js

@@ -0,0 +1,5 @@
+// src/server/ImageGen.ts
+// Thin re-export — image gen lives in src/server/ai/
+import './ai/index.js';
+export { createImageGenClient as createImageGen } from './ai/ImageGenClient.js';
+//# sourceMappingURL=ImageGen.js.map

package/dist/server/ImageGen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageGen.js","sourceRoot":"","sources":["../../src/server/ImageGen.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,qDAAqD;AACrD,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/server/Logging.d.ts

@@ -0,0 +1,59 @@
+import type { TypedDB } from '../shared/DB.js';
+import type { StorageClient } from './Storage.js';
+export type LogLevel = 'log' | 'info' | 'warn' | 'error' | 'debug';
+export interface Logger {
+    error(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    perf(operation: string): () => void;
+    feedback(input: {
+        type: 'bug' | 'design' | 'feature';
+        message: string;
+        screenshotTempKey?: string;
+    }): Promise<void>;
+}
+export declare function createLogger(userId: string, storage: StorageClient, db: TypedDB<any>): Logger;
+export declare function initServerErrorCapture(): void;
+export interface DevLogEntry {
+    timestamp: string;
+    level: LogLevel;
+    category: string | undefined;
+    message: string;
+    args: unknown[];
+    source: 'server' | 'browser';
+}
+/** Write a log entry to the dev JSONL file. source defaults to 'browser'. */
+export declare function writeClientLogEntry(entry: {
+    level: string;
+    message: string;
+    args?: unknown[];
+    source?: 'browser' | 'server';
+}): void;
+/**
+ * Register a pattern string as an "expected" error.
+ * If any captured error message contains this pattern it will be classified as
+ * expected and only logged to the console — not persisted to MongoDB.
+ */
+export declare function registerExpectedErrorPattern(pattern: string): void;
+/**
+ * Classify an error message as expected or unexpected based on registered patterns.
+ * @returns 'expected' if the message matches any registered pattern, 'unexpected' otherwise
+ */
+export declare function classifyError(message: string): 'expected' | 'unexpected';
+/**
+ * Capture a server-side error.
+ *
+ * - Expected errors (matched by a registered pattern) are written to console.error only.
+ * - Unexpected errors are also persisted to the MongoDB `errorLog` collection.
+ *   Documents are deduplicated by hash: repeated errors increment `count` instead of
+ *   inserting a duplicate record.
+ *
+ * @param message  A const string following the pattern '[Area] Description of cause'
+ * @param error    The caught value (typically an Error instance)
+ * @param context  Optional key/value pairs for structured diagnostics
+ */
+export declare function captureServerError(message: string, error: unknown, context?: Record<string, unknown>): void;
+/** Override console.* globally to capture all output to JSONL in dev mode */
+export declare function initDevLogs(): void;
+//# sourceMappingURL=Logging.d.ts.map

package/dist/server/Logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logging.d.ts","sourceRoot":"","sources":["../../src/server/Logging.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE;QACd,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAGD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,EACtB,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,GACf,MAAM,CAuFR;AAGD,wBAAgB,sBAAsB,IAAI,IAAI,CA+B7C;AAID,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC9B;AAsED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC/B,GAAG,IAAI,CAQP;AAUD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAKxE;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CA6CN;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,IAAI,CAsClC"}

package/dist/server/Logging.js

@@ -0,0 +1,293 @@
+import { nanoid } from 'nanoid';
+import crypto from 'node:crypto';
+import fsSync from 'node:fs';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { BUILTIN_DEFS, dbDefaults } from '../shared/DB.js';
+import { getDbName, getMongoClient } from './DB.js';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function createLogger(userId, storage, db) {
+    function writeErrorLog(level, message, meta) {
+        const doc = {
+            ...dbDefaults(),
+            id: nanoid(),
+            level,
+            message,
+            source: 'server',
+            userId,
+            meta: meta ?? null,
+        };
+        // Fire-and-forget — logging should never throw in handler context
+        db.setDoc(BUILTIN_DEFS.errorLog, doc).catch((e) => console.error('[Logger] Failed to write log', e));
+    }
+    function writeConsoleLog(level, message, meta) {
+        const doc = {
+            ...dbDefaults(),
+            id: nanoid(),
+            level,
+            message,
+            userId,
+            meta: meta ?? null,
+        };
+        // Fire-and-forget — logging should never throw in handler context
+        db.setDoc(BUILTIN_DEFS.consoleLog, doc).catch((e) => console.error('[Logger] Failed to write log', e));
+    }
+    return {
+        error: (msg, meta) => writeErrorLog('error', msg, meta),
+        warn: (msg, meta) => writeConsoleLog('warn', msg, meta),
+        info: (msg, meta) => writeConsoleLog('info', msg, meta),
+        debug: (msg, meta) => writeConsoleLog('debug', msg, meta),
+        perf(operation) {
+            const start = Date.now();
+            return () => {
+                const durationMs = Date.now() - start;
+                const doc = {
+                    ...dbDefaults(),
+                    id: nanoid(),
+                    operation,
+                    durationMs,
+                    userId,
+                };
+                db.setDoc(BUILTIN_DEFS.perfLog, doc).catch((e) => console.error('[Logger] Failed to write perf log', e));
+            };
+        },
+        async feedback({ type, message, screenshotTempKey }) {
+            let screenshotUrl = null;
+            if (screenshotTempKey) {
+                try {
+                    const destKey = `feedback/${nanoid()}.png`;
+                    screenshotUrl = await storage.moveToPublic(screenshotTempKey, destKey);
+                }
+                catch (e) {
+                    console.error('[Logger] Failed to promote feedback screenshot', e);
+                }
+            }
+            const doc = {
+                ...dbDefaults(),
+                id: nanoid(),
+                type,
+                message,
+                screenshotUrl,
+                userId,
+            };
+            await db.setDoc(BUILTIN_DEFS.feedbackLog, doc);
+        },
+    };
+}
+// Auto-capture unhandled server exceptions — uses raw mongo since these run outside request context
+export function initServerErrorCapture() {
+    const writeErrorLog = (message, stack) => {
+        const id = nanoid();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const doc = {
+            _id: id,
+            id,
+            version: 1,
+            created: new Date(),
+            updated: new Date(),
+            level: 'error',
+            message,
+            stack,
+            source: 'server',
+            userId: null,
+        };
+        getMongoClient()
+            .then((client) => client.db(getDbName()).collection('errorLog').insertOne(doc))
+            .catch(() => { });
+    };
+    process.on('uncaughtException', (err) => {
+        writeErrorLog(err.message, err.stack ?? null);
+    });
+    process.on('unhandledRejection', (reason) => {
+        const msg = reason instanceof Error ? reason.message : String(reason);
+        const stack = reason instanceof Error ? reason.stack ?? null : null;
+        writeErrorLog(msg, stack);
+    });
+}
+function extractCategory(message) {
+    const match = /^\[([A-Z][A-Za-z0-9]*)\]/.exec(message);
+    return match?.[1];
+}
+function getLogFilePath() {
+    const date = new Date().toISOString().split('T')[0]; // YYYY-MM-DD
+    return path.join(process.cwd(), 'logs', `dev-${date}.jsonl`);
+}
+function serializeArg(arg) {
+    if (arg instanceof Error) {
+        return { __error: true, message: arg.message, stack: arg.stack };
+    }
+    return arg;
+}
+function writeLogEntry(level, args, source = 'server') {
+    try {
+        const firstString = args.find((a) => typeof a === 'string');
+        const message = firstString ?? '';
+        const category = extractCategory(message);
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            category,
+            message,
+            args: args.map(serializeArg),
+            source,
+        };
+        const line = JSON.stringify(entry) + '\n';
+        const filePath = getLogFilePath();
+        // Ensure directory exists synchronously and append; use sync to avoid event-loop issues in console overrides
+        try {
+            fsSync.mkdirSync(path.dirname(filePath), { recursive: true });
+        }
+        catch {
+            // Already exists
+        }
+        fsSync.appendFileSync(filePath, line, 'utf-8');
+    }
+    catch {
+        // Never throw from logging — it would cause infinite recursion
+    }
+}
+async function cleanupOldLogs() {
+    const logsDir = path.join(process.cwd(), 'logs');
+    try {
+        const files = await fs.readdir(logsDir);
+        const cutoff = Date.now() - 7 * 24 * 60 * 60 * 1000;
+        for (const file of files) {
+            if (!file.startsWith('dev-') || !file.endsWith('.jsonl'))
+                continue;
+            const filePath = path.join(logsDir, file);
+            const stat = await fs.stat(filePath);
+            if (stat.mtimeMs < cutoff) {
+                await fs.unlink(filePath);
+            }
+        }
+    }
+    catch {
+        // Logs dir doesn't exist yet — that's fine
+    }
+}
+/** Write a log entry to the dev JSONL file. source defaults to 'browser'. */
+export function writeClientLogEntry(entry) {
+    if (process.env['NODE_ENV'] !== 'development')
+        return;
+    const level = entry.level ?? 'log';
+    writeLogEntry(level, [entry.message, ...(entry.args ?? [])], entry.source ?? 'browser');
+}
+// ─── Error Classification & Capture ──────────────────────────────────────────
+/**
+ * Registry of expected error patterns. Populated at startup by consuming apps
+ * via registerExpectedErrorPattern().
+ */
+const expectedErrorPatterns = [];
+/**
+ * Register a pattern string as an "expected" error.
+ * If any captured error message contains this pattern it will be classified as
+ * expected and only logged to the console — not persisted to MongoDB.
+ */
+export function registerExpectedErrorPattern(pattern) {
+    expectedErrorPatterns.push(pattern);
+}
+/**
+ * Classify an error message as expected or unexpected based on registered patterns.
+ * @returns 'expected' if the message matches any registered pattern, 'unexpected' otherwise
+ */
+export function classifyError(message) {
+    for (const pattern of expectedErrorPatterns) {
+        if (message.includes(pattern))
+            return 'expected';
+    }
+    return 'unexpected';
+}
+/**
+ * Generate an MD5 hash over (message + normalizedStack) for error grouping.
+ * Uses Node's built-in crypto — no additional dependencies.
+ */
+function generateErrorHash(message, stack) {
+    const normalizedStack = (stack ?? '').substring(0, 500);
+    return crypto
+        .createHash('md5')
+        .update(`${message}:${normalizedStack}`)
+        .digest('hex');
+}
+/**
+ * Capture a server-side error.
+ *
+ * - Expected errors (matched by a registered pattern) are written to console.error only.
+ * - Unexpected errors are also persisted to the MongoDB `errorLog` collection.
+ *   Documents are deduplicated by hash: repeated errors increment `count` instead of
+ *   inserting a duplicate record.
+ *
+ * @param message  A const string following the pattern '[Area] Description of cause'
+ * @param error    The caught value (typically an Error instance)
+ * @param context  Optional key/value pairs for structured diagnostics
+ */
+export function captureServerError(message, error, context) {
+    const stack = error instanceof Error ? error.stack : undefined;
+    const classification = classifyError(message);
+    console.error('[captureServerError]', message, {
+        context,
+        stack,
+        classification,
+    });
+    if (classification === 'expected')
+        return;
+    // Persist unexpected errors asynchronously — never throw from here
+    const hash = generateErrorHash(message, stack);
+    const timestamp = Date.now();
+    getMongoClient()
+        .then((client) => {
+        const collection = client.db(getDbName()).collection('errorLog');
+        return collection.updateOne({ hash }, {
+            $inc: { count: 1 },
+            $set: {
+                message,
+                stack: stack ?? null,
+                context: context ?? {},
+                updatedAt: timestamp,
+            },
+            $setOnInsert: {
+                _id: nanoid(),
+                hash,
+                timestamp,
+                count: 0, // $inc will make this 1 on insert
+            },
+        }, { upsert: true });
+    })
+        .catch((e) => {
+        console.error('[captureServerError] Failed to persist error to MongoDB', e);
+    });
+}
+/** Override console.* globally to capture all output to JSONL in dev mode */
+export function initDevLogs() {
+    if (process.env['NODE_ENV'] !== 'development')
+        return;
+    // Start cleanup in background
+    cleanupOldLogs().catch(() => { });
+    const original = {
+        log: console.log.bind(console),
+        info: console.info.bind(console),
+        warn: console.warn.bind(console),
+        error: console.error.bind(console),
+        debug: console.debug.bind(console),
+    };
+    console.log = (...args) => {
+        original.log(...args);
+        writeLogEntry('log', args);
+    };
+    console.info = (...args) => {
+        original.info(...args);
+        writeLogEntry('info', args);
+    };
+    console.warn = (...args) => {
+        original.warn(...args);
+        writeLogEntry('warn', args);
+    };
+    console.error = (...args) => {
+        original.error(...args);
+        writeLogEntry('error', args);
+    };
+    // console.debug: captured to JSONL but NOT printed to stdout
+    console.debug = (...args) => {
+        writeLogEntry('debug', args);
+    };
+}
+//# sourceMappingURL=Logging.js.map

package/dist/server/Logging.js.map

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

package/dist/server/Nats.d.ts

@@ -0,0 +1,56 @@
+import { JetStreamClient, NatsConnection, RetentionPolicy } from 'nats';
+export interface NatsConfig {
+    url?: string;
+    creds?: string;
+}
+/**
+ * Connect to NATS. Called once at server startup.
+ * Development: connects to localhost:4222
+ * Production: uses NATS_URL env var (and NATS_CREDS for Synadia Cloud)
+ */
+export declare function connectNats(config?: NatsConfig): Promise<NatsConnection>;
+/**
+ * Get the active NATS connection. Throws if not connected.
+ */
+export declare function getNatsConnection(): NatsConnection;
+/**
+ * Publish a message to a NATS subject.
+ * @param subject - NATS subject (e.g. 'user.updates.abc123')
+ * @param payload - JSON-serializable payload
+ */
+export declare function natsPublish(subject: string, payload: unknown): void;
+/**
+ * Subscribe to a NATS subject.
+ * Returns an unsubscribe function — ALWAYS call it when done to prevent leaks.
+ *
+ * @example
+ * const unsub = await natsSubscribe('user.updates.*', (msg) => {
+ *   console.log(msg.subject, msg.data);
+ * });
+ * // Later:
+ * unsub();
+ */
+export declare function natsSubscribe(subject: string, handler: (msg: {
+    subject: string;
+    data: unknown;
+}) => void | Promise<void>): Promise<() => void>;
+/**
+ * Get the JetStream client for durable queues.
+ * JetStream must be enabled on the NATS server (pass -js flag).
+ */
+export declare function getJetStream(): Promise<JetStreamClient>;
+/**
+ * Ensure a JetStream stream exists (idempotent).
+ * Creates the stream if it doesn't exist; updates if config differs.
+ */
+export declare function ensureStream(config: {
+    name: string;
+    subjects: string[];
+    retentionPolicy?: RetentionPolicy;
+}): Promise<void>;
+/**
+ * Gracefully close the NATS connection.
+ * Call during server shutdown.
+ */
+export declare function closeNats(): Promise<void>;
+//# sourceMappingURL=Nats.d.ts.map

package/dist/server/Nats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nats.d.ts","sourceRoot":"","sources":["../../src/server/Nats.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEf,cAAc,EACd,eAAe,EAEhB,MAAM,MAAM,CAAC;AAed,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAGnE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,GAAG,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzE,OAAO,CAAC,MAAM,IAAI,CAAC,CA8CrB;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAM7D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhB;AAED;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAM/C"}