@camera.ui/server 0.0.70 → 0.0.71-dev.0

package/dist/server/src/manager/notificationManager.js

@@ -0,0 +1,334 @@
+import { hasCapability, PluginCapability, Severity } from '@camera.ui/sdk';
+import { container } from 'tsyringe';
+import { v4 as uuidv4 } from 'uuid';
+import { NotificationsService } from '../api/services/notifications.service.js';
+import { PluginsService } from '../api/services/plugins.service.js';
+import { RemoteService } from '../api/services/remote.service.js';
+import { UsersService } from '../api/services/users.service.js';
+import { NamespaceManager } from '../rpc/namespaces.js';
+import { SYSTEM_NOTIFICATION_TYPES } from './types.js';
+const HISTORY_LIMIT = 100;
+export class NotificationManager {
+    history = [];
+    proxyServer;
+    logger;
+    notificationsService;
+    pluginsService;
+    remoteService;
+    usersService;
+    closePublishUnsub;
+    constructor() {
+        this.proxyServer = container.resolve('proxy');
+        this.logger = container.resolve('logger');
+        this.notificationsService = new NotificationsService();
+        this.pluginsService = new PluginsService();
+        this.remoteService = new RemoteService();
+        this.usersService = new UsersService();
+    }
+    async register() {
+        await this.subscribePublishTopic();
+    }
+    async destroy() {
+        this.closePublishUnsub?.();
+    }
+    async listAllDevices(userId) {
+        const plugins = this.getNotifierPlugins();
+        if (plugins.length === 0)
+            return [];
+        const results = await Promise.allSettled(plugins.map(async (plugin) => {
+            try {
+                const raw = (await this.getProxyFor(plugin).getDevices(userId ? [userId] : [])) ?? [];
+                return raw.map((d) => ({
+                    ...d,
+                    pluginId: plugin.id,
+                    pluginName: plugin.pluginName,
+                }));
+            }
+            catch (err) {
+                this.logger.warn(`getDevices failed for "${plugin.pluginName}": ${err.message}`);
+                return [];
+            }
+        }));
+        const devices = [];
+        for (const r of results) {
+            if (r.status === 'fulfilled' && r.value)
+                devices.push(...r.value);
+        }
+        return devices;
+    }
+    listSources(userRole) {
+        const publisherPlugins = this.pluginsService.listPlugins().filter((p) => hasCapability(p.contract, PluginCapability.PublishNotifications));
+        const systemTypes = userRole === 'master' || userRole === 'admin' ? [...SYSTEM_NOTIFICATION_TYPES] : [];
+        return {
+            plugins: publisherPlugins.map((p) => ({ id: p.id, name: p.pluginName })),
+            system: systemTypes,
+        };
+    }
+    getHistory() {
+        return [...this.history];
+    }
+    clearHistory() {
+        this.history = [];
+        this.broadcastHistory();
+    }
+    removeByTag(tag) {
+        const before = this.history.length;
+        this.history = this.history.filter((n) => n.tag !== tag);
+        if (this.history.length === before)
+            return false;
+        this.broadcastHistory();
+        return true;
+    }
+    async notify(opts) {
+        const { source, targets } = opts;
+        // Source-kind-specific permission checks.
+        if (source.kind === 'plugin') {
+            const plugin = this.pluginsService.getPluginById(source.id);
+            if (!plugin) {
+                this.logger.warn(`notify: plugin "${source.id}" not found, dropping`);
+                return [];
+            }
+            if (!hasCapability(plugin.contract, PluginCapability.PublishNotifications)) {
+                this.logger.error(`Plugin "${plugin.pluginName}" called Publish() without "publishNotifications" capability — declare it in your contract.`);
+                return [];
+            }
+        }
+        const userIds = await this.findRecipientUserIds(source, opts.notification.adminOnly ?? false);
+        if (userIds.length === 0)
+            return [];
+        // Stamp the notification once — same id/createdAt go to UI and external
+        // delivery so any client-side dedup matches across channels.
+        const cloud = this.remoteService.getCloud();
+        const originData = {};
+        if (cloud.oauth?.server_id)
+            originData.originServerId = cloud.oauth.server_id;
+        if (cloud.name)
+            originData.originName = cloud.name;
+        const resolved = {
+            ...opts.notification,
+            severity: opts.notification.severity ?? Severity.Info,
+            id: uuidv4(),
+            createdAt: Date.now(),
+            source,
+            data: { ...opts.notification.data, ...originData },
+        };
+        // Per-user filtering (settings / source / quiet-hours / history) is
+        // genuinely per recipient; delivery is batched per notifier afterwards.
+        const eligibleUserIds = [];
+        for (const userId of userIds) {
+            const settings = await this.notificationsService.getSettings(userId);
+            if (!settings.enabled)
+                continue;
+            if (source.kind === 'plugin' && settings.sources?.[source.id] === false)
+                continue;
+            if (source.kind === 'system' && settings.systemTypes?.[source.id] === false)
+                continue;
+            // UI broadcast happens before the quiet-hours check — quiet hours
+            // suppress disruption (push/sound), not the in-app history entry.
+            this.appendHistory(resolved);
+            // Quiet-hours suppress external delivery (except critical bypass).
+            if (resolved.severity !== Severity.Critical && this.inQuietHours(settings))
+                continue;
+            eligibleUserIds.push(userId);
+        }
+        // Explicit-targets path: deliver to the given device ids directly.
+        if (targets && targets.length > 0) {
+            const results = await Promise.all(targets.map((deviceId) => this.dispatchToDevice(deviceId, resolved)));
+            return results;
+        }
+        if (eligibleUserIds.length === 0)
+            return [];
+        // Batched fan-out: one getDevices + one sendNotification per notifier.
+        const eligibleSet = new Set(eligibleUserIds);
+        const tasks = [];
+        for (const plugin of this.getNotifierPlugins()) {
+            const proxy = this.getProxyFor(plugin);
+            let devices;
+            try {
+                devices = await proxy.getDevices(eligibleUserIds);
+            }
+            catch (err) {
+                this.logger.warn(`getDevices failed for "${plugin.pluginName}": ${err.message}`);
+                continue;
+            }
+            const deviceIds = devices.filter((d) => d.active && eligibleSet.has(d.ownerUserId)).map((d) => d.id);
+            if (deviceIds.length > 0) {
+                tasks.push(this.dispatchBatch(plugin.pluginName, proxy, deviceIds, resolved));
+            }
+        }
+        return (await Promise.all(tasks)).flat();
+    }
+    async registerDevice(pluginName, ownerUserId, input) {
+        const plugin = this.resolvePlugin(pluginName);
+        if (!plugin) {
+            throw new Error(`Plugin "${pluginName}" not found`);
+        }
+        const ifaces = plugin.contract.interfaces ?? [];
+        if (!ifaces.includes('Notifier')) {
+            throw new Error(`Plugin "${plugin.pluginName}" does not implement the Notifier interface`);
+        }
+        if (!plugin.worker.isRunning()) {
+            throw new Error(`Plugin "${plugin.pluginName}" is not running`);
+        }
+        return this.getProxyFor(plugin).registerDevice(ownerUserId, input);
+    }
+    async revokeDevice(deviceId) {
+        for (const plugin of this.getNotifierPlugins()) {
+            const proxy = this.getProxyFor(plugin);
+            try {
+                const device = await proxy.getDevice(deviceId);
+                if (device) {
+                    await proxy.revokeDevice(deviceId);
+                    return;
+                }
+            }
+            catch {
+                // getDevice may legitimately throw on unknown ids — try next plugin.
+            }
+        }
+    }
+    async updateDevice(deviceId, patch) {
+        for (const plugin of this.getNotifierPlugins()) {
+            try {
+                const updated = await this.getProxyFor(plugin).updateDevice(deviceId, patch);
+                if (updated)
+                    return updated;
+            }
+            catch (err) {
+                this.logger.warn(`updateDevice("${plugin.pluginName}", "${deviceId}") failed: ${err.message}`);
+            }
+        }
+        throw new Error(`Device not found: ${deviceId}`);
+    }
+    getNotifierPlugins() {
+        return this.pluginsService.listPlugins().filter((p) => {
+            const ifaces = p.contract.interfaces ?? [];
+            return ifaces.includes('Notifier') && p.worker.isRunning();
+        });
+    }
+    getProxyFor(plugin) {
+        const ns = NamespaceManager.pluginNamespaces(plugin.id).pluginChildRpc;
+        return this.proxyServer.proxy.createProxy(ns);
+    }
+    resolvePlugin(idOrName) {
+        return (this.pluginsService.getPluginById(idOrName) ??
+            this.pluginsService.getPluginByName(idOrName) ??
+            this.pluginsService.listPlugins().find((p) => p.pluginName.split('/').pop() === idOrName) ??
+            null);
+    }
+    async dispatchBatch(pluginName, proxy, deviceIds, n) {
+        try {
+            await proxy.sendNotification(deviceIds, n);
+            return deviceIds.map((deviceId) => ({ pluginName, deviceId, ok: true }));
+        }
+        catch (err) {
+            const message = err?.message ?? String(err);
+            this.logger.warn(`sendNotification("${pluginName}", ${deviceIds.length} devices) failed: ${message}`);
+            return deviceIds.map((deviceId) => ({ pluginName, deviceId, ok: false, error: message }));
+        }
+    }
+    async dispatchToDevice(deviceId, n) {
+        for (const plugin of this.getNotifierPlugins()) {
+            const proxy = this.getProxyFor(plugin);
+            try {
+                const device = await proxy.getDevice(deviceId);
+                if (device) {
+                    const [result] = await this.dispatchBatch(plugin.pluginName, proxy, [deviceId], n);
+                    return result;
+                }
+            }
+            catch {
+                // getDevice may legitimately throw on unknown ids — try next plugin.
+            }
+        }
+        return { pluginName: '', deviceId, ok: false, error: 'device not found' };
+    }
+    inQuietHours(settings) {
+        const qh = settings.quietHours;
+        if (!qh)
+            return false;
+        try {
+            const now = new Date(new Date().toLocaleString('en-US', { timeZone: qh.timezone }));
+            const minutes = now.getHours() * 60 + now.getMinutes();
+            const fromMin = parseHHmm(qh.from);
+            const toMin = parseHHmm(qh.to);
+            if (fromMin === null || toMin === null)
+                return false;
+            return fromMin <= toMin ? minutes >= fromMin && minutes < toMin : minutes >= fromMin || minutes < toMin;
+        }
+        catch {
+            return false;
+        }
+    }
+    async findRecipientUserIds(source, adminOnly) {
+        const users = this.usersService.list();
+        if (source.kind === 'system' || adminOnly) {
+            return users.filter((u) => u.role === 'master' || u.role === 'admin').map((u) => u._id);
+        }
+        return users.map((u) => u._id);
+    }
+    async subscribePublishTopic() {
+        const subject = NamespaceManager.notificationManagerNamespaces().notificationsPublishSubject;
+        try {
+            this.closePublishUnsub = await this.proxyServer.proxy.subscribe(subject, (msg) => {
+                if (!msg?.notification || !msg.pluginId)
+                    return;
+                // Synchronous handler — slow notify() must not backpressure the
+                // NATS consumer. Errors are logged inside notify().
+                this.notify({
+                    notification: msg.notification,
+                    source: { kind: 'plugin', id: msg.pluginId },
+                }).catch((err) => {
+                    this.logger.warn(`notify(publish from "${msg.pluginName}") failed: ${err.message}`);
+                });
+            });
+        }
+        catch (err) {
+            this.logger.warn(`Failed to subscribe to ${subject}: ${err.message}`);
+        }
+    }
+    appendHistory(n) {
+        const uiCopy = { ...n, thumbnail: undefined };
+        if (uiCopy.tag) {
+            const existing = this.history.findIndex((h) => h.tag === uiCopy.tag);
+            if (existing !== -1)
+                this.history.splice(existing, 1);
+        }
+        this.history.unshift(uiCopy);
+        if (this.history.length > HISTORY_LIMIT) {
+            this.history.length = HISTORY_LIMIT;
+        }
+        this.broadcastNew(uiCopy);
+    }
+    broadcastNew(n) {
+        try {
+            const socketService = container.resolve('socketService');
+            socketService.io.of('/notifications').emit('notification', n);
+        }
+        catch (err) {
+            this.logger.warn(`UI broadcast failed: ${err.message}`);
+        }
+    }
+    broadcastHistory() {
+        try {
+            const socketService = container.resolve('socketService');
+            socketService.io.of('/notifications').emit('history', this.history);
+        }
+        catch (err) {
+            this.logger.warn(`UI history broadcast failed: ${err.message}`);
+        }
+    }
+}
+function parseHHmm(s) {
+    const m = /^(\d{1,2}):(\d{2})$/.exec(s);
+    if (!m)
+        return null;
+    const h = Number(m[1]);
+    const min = Number(m[2]);
+    if (!Number.isFinite(h) || !Number.isFinite(min))
+        return null;
+    if (h < 0 || h > 23 || min < 0 || min > 59)
+        return null;
+    return h * 60 + min;
+}
+//# sourceMappingURL=notificationManager.js.map

package/dist/server/src/manager/notificationManager.js.map

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

package/dist/server/src/manager/terminalManager.d.ts

@@ -0,0 +1,27 @@
+import type { TerminalManagerInterface, TerminalManagerProxyEvents, TerminalOptions, TerminalSessionInfo } from '../rpc/interfaces/terminal.js';
+export declare class TerminalManager implements TerminalManagerInterface {
+    private proxyServer;
+    private logger;
+    private sessions;
+    private namespaces;
+    private closeProxy?;
+    private static readonly BACKPRESSURE_THRESHOLD;
+    private static readonly SESSION_TIMEOUT_MS;
+    private static readonly CLEANUP_INTERVAL_MS;
+    private static readonly ALLOWED_SHELLS;
+    private cleanupInterval?;
+    constructor();
+    register(): Promise<void>;
+    destroy(): Promise<void>;
+    publishTerminalManagerEvent<K extends keyof TerminalManagerProxyEvents>(type: K, data: TerminalManagerProxyEvents[K]): void;
+    createSession(options?: TerminalOptions): Promise<TerminalSessionInfo>;
+    generateOutput(sessionId: string): AsyncGenerator<Uint8Array>;
+    writeInput(sessionId: string, data: string): Promise<void>;
+    resize(sessionId: string, dimensions: {
+        cols: number;
+        rows: number;
+    }): Promise<void>;
+    closeSession(sessionId: string): Promise<void>;
+    private getDefaultShell;
+    private cleanupInactiveSessions;
+}

package/dist/server/src/manager/terminalManager.js

@@ -0,0 +1,239 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var TerminalManager_1;
+import { RPCClass, RPCMethod } from '@camera.ui/rpc';
+import pty from '@scrypted/node-pty';
+import { container } from 'tsyringe';
+import { NamespaceManager } from '../rpc/namespaces.js';
+class AsyncQueue {
+    queue = [];
+    resolvers = [];
+    closed = false;
+    async enqueue(item) {
+        if (this.closed)
+            return;
+        if (this.resolvers.length > 0) {
+            const resolve = this.resolvers.shift();
+            resolve({ value: item, done: false });
+        }
+        else {
+            this.queue.push(item);
+        }
+    }
+    end() {
+        this.closed = true;
+        for (const resolve of this.resolvers) {
+            resolve({ value: undefined, done: true });
+        }
+        this.resolvers = [];
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.queue.length > 0) {
+                    return Promise.resolve({ value: this.queue.shift(), done: false });
+                }
+                if (this.closed) {
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise((resolve) => {
+                    this.resolvers.push(resolve);
+                });
+            },
+        };
+    }
+}
+let TerminalManager = class TerminalManager {
+    static { TerminalManager_1 = this; }
+    proxyServer;
+    logger;
+    sessions = new Map();
+    namespaces = NamespaceManager.terminalManagerNamespaces();
+    closeProxy;
+    static BACKPRESSURE_THRESHOLD = 64 * 1024;
+    static SESSION_TIMEOUT_MS = 30 * 60 * 1000;
+    static CLEANUP_INTERVAL_MS = 5 * 60 * 1000;
+    static ALLOWED_SHELLS = process.platform === 'win32'
+        ? new Set(['cmd.exe', 'powershell.exe', 'pwsh.exe'])
+        : new Set(['/bin/bash', '/bin/sh', '/bin/zsh', '/usr/bin/bash', '/usr/bin/sh', '/usr/bin/zsh', '/usr/bin/fish']);
+    cleanupInterval;
+    constructor() {
+        this.proxyServer = container.resolve('proxy');
+        this.logger = container.resolve('logger');
+    }
+    async register() {
+        this.closeProxy = await this.proxyServer.proxy.registerHandler(this.namespaces.terminalManagerRpc, this);
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupInactiveSessions();
+        }, TerminalManager_1.CLEANUP_INTERVAL_MS);
+    }
+    async destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+        }
+        for (const [sessionId] of this.sessions) {
+            await this.closeSession(sessionId);
+        }
+        await this.closeProxy?.();
+    }
+    publishTerminalManagerEvent(type, data) {
+        const event = { type, data };
+        this.proxyServer.proxy.publish(this.namespaces.terminalManagerSubject, event);
+    }
+    async createSession(options) {
+        if (options?.shell && !TerminalManager_1.ALLOWED_SHELLS.has(options.shell)) {
+            throw new Error(`Shell not allowed: ${options.shell}`);
+        }
+        const sessionId = crypto.randomUUID();
+        const shell = options?.shell ?? this.getDefaultShell();
+        const cols = options?.cols ?? 80;
+        const rows = options?.rows ?? 24;
+        this.logger.trace(`Creating terminal session ${sessionId} with shell: ${shell}`);
+        const ptyProcess = pty.spawn(shell, [], {
+            name: 'xterm-256color',
+            cols,
+            rows,
+            cwd: options?.cwd ?? process.cwd(),
+            env: {
+                ...process.env,
+                ...options?.env,
+                COLORTERM: 'truecolor',
+                TERM: 'xterm-256color',
+            },
+        });
+        const outputQueue = new AsyncQueue();
+        let bufferedLength = 0;
+        let isPaused = false;
+        const session = {
+            sessionId,
+            pty: ptyProcess,
+            outputQueue,
+            dimensions: { cols, rows },
+            closed: false,
+            lastActivity: new Date(),
+        };
+        ptyProcess.onData((data) => {
+            if (session.closed)
+                return;
+            const buffer = Buffer.from(data);
+            bufferedLength += buffer.length;
+            outputQueue.enqueue(buffer).then(() => {
+                bufferedLength -= buffer.length;
+                if (isPaused && bufferedLength < TerminalManager_1.BACKPRESSURE_THRESHOLD / 2) {
+                    isPaused = false;
+                    ptyProcess.resume?.();
+                }
+            });
+            if (!isPaused && bufferedLength >= TerminalManager_1.BACKPRESSURE_THRESHOLD) {
+                isPaused = true;
+                ptyProcess.pause?.();
+            }
+        });
+        ptyProcess.onExit(({ exitCode }) => {
+            this.logger.trace(`Terminal session ${sessionId} exited with code ${exitCode}`);
+            session.closed = true;
+            outputQueue.end();
+            this.sessions.delete(sessionId);
+            this.publishTerminalManagerEvent('sessionClosed', { sessionId });
+        });
+        this.sessions.set(sessionId, session);
+        return {
+            sessionId,
+            pid: ptyProcess.pid,
+            dimensions: { cols, rows },
+        };
+    }
+    async *generateOutput(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        for await (const chunk of session.outputQueue) {
+            yield chunk;
+        }
+    }
+    async writeInput(sessionId, data) {
+        const session = this.sessions.get(sessionId);
+        if (!session || session.closed) {
+            throw new Error(`Session not found or closed: ${sessionId}`);
+        }
+        session.lastActivity = new Date();
+        session.pty.write(data);
+    }
+    async resize(sessionId, dimensions) {
+        const session = this.sessions.get(sessionId);
+        if (!session || session.closed)
+            return;
+        session.pty.resize(dimensions.cols, dimensions.rows);
+        session.dimensions = dimensions;
+    }
+    async closeSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        this.logger.trace(`Closing terminal session ${sessionId}`);
+        session.closed = true;
+        session.pty.kill();
+        session.outputQueue.end();
+        this.sessions.delete(sessionId);
+    }
+    getDefaultShell() {
+        if (process.platform === 'win32') {
+            return process.env.COMSPEC ?? 'cmd.exe';
+        }
+        return process.env.SHELL ?? '/bin/bash';
+    }
+    cleanupInactiveSessions() {
+        const now = Date.now();
+        for (const [sessionId, session] of this.sessions) {
+            const inactiveTime = now - session.lastActivity.getTime();
+            if (inactiveTime > TerminalManager_1.SESSION_TIMEOUT_MS) {
+                this.logger.trace(`Cleaning up inactive terminal session ${sessionId} (inactive for ${Math.round(inactiveTime / 1000 / 60)} minutes)`);
+                this.closeSession(sessionId);
+            }
+        }
+    }
+};
+__decorate([
+    RPCMethod,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], TerminalManager.prototype, "createSession", null);
+__decorate([
+    RPCMethod,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Object)
+], TerminalManager.prototype, "generateOutput", null);
+__decorate([
+    RPCMethod,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], TerminalManager.prototype, "writeInput", null);
+__decorate([
+    RPCMethod,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], TerminalManager.prototype, "resize", null);
+__decorate([
+    RPCMethod,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], TerminalManager.prototype, "closeSession", null);
+TerminalManager = TerminalManager_1 = __decorate([
+    RPCClass,
+    __metadata("design:paramtypes", [])
+], TerminalManager);
+export { TerminalManager };
+//# sourceMappingURL=terminalManager.js.map

package/dist/server/src/manager/terminalManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalManager.js","sourceRoot":"","sources":["../../../../src/manager/terminalManager.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,GAAG,MAAM,oBAAoB,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAaxD,MAAM,UAAU;IACN,KAAK,GAAQ,EAAE,CAAC;IAChB,SAAS,GAA2C,EAAE,CAAC;IACvD,MAAM,GAAG,KAAK,CAAC;IAEvB,KAAK,CAAC,OAAO,CAAC,IAAO;QACnB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC;YACxC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,GAAG;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,GAA+B,EAAE;gBACrC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACtE,CAAC;gBAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAyB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC3E,CAAC;gBAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;oBAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC/B,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAYM,IAAM,eAAe,GAArB,MAAM,eAAe;;IAClB,WAAW,CAAc;IACzB,MAAM,CAAgB;IAEtB,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC9C,UAAU,GAAG,gBAAgB,CAAC,yBAAyB,EAAE,CAAC;IAC1D,UAAU,CAAuB;IAEjC,MAAM,CAAU,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC;IACnD,MAAM,CAAU,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACpD,MAAM,CAAU,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAEpD,MAAM,CAAU,cAAc,GACpC,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;QACpD,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;IAE7G,eAAe,CAAkB;IAEzC;QACE,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC,OAAO,CAAc,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,OAAO,CAAgB,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;QAEzG,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACjC,CAAC,EAAE,iBAAe,CAAC,mBAAmB,CAAC,CAAC;IAC1C,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACtC,CAAC;QAED,KAAK,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;IAC5B,CAAC;IAEM,2BAA2B,CAA6C,IAAO,EAAE,IAAmC;QACzH,MAAM,KAAK,GAAwC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAClE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IAChF,CAAC;IAGY,AAAN,KAAK,CAAC,aAAa,CAAC,OAAyB;QAClD,IAAI,OAAO,EAAE,KAAK,IAAI,CAAC,iBAAe,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QAEjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,SAAS,gBAAgB,KAAK,EAAE,CAAC,CAAC;QAEjF,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE;YACtC,IAAI,EAAE,gBAAgB;YACtB,IAAI;YACJ,IAAI;YACJ,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YAClC,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,GAAG,OAAO,EAAE,GAAG;gBACf,SAAS,EAAE,WAAW;gBACtB,IAAI,EAAE,gBAAgB;aACvB;SACF,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,IAAI,UAAU,EAAc,CAAC;QACjD,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,OAAO,GAAoB;YAC/B,SAAS;YACT,GAAG,EAAE,UAAU;YACf,WAAW;YACX,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;YAC1B,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,IAAI,IAAI,EAAE;SACzB,CAAC;QAEF,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,OAAO,CAAC,MAAM;gBAAE,OAAO;YAE3B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC;YAEhC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;gBACpC,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC;gBAEhC,IAAI,QAAQ,IAAI,cAAc,GAAG,iBAAe,CAAC,sBAAsB,GAAG,CAAC,EAAE,CAAC;oBAC5E,QAAQ,GAAG,KAAK,CAAC;oBACjB,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;gBACxB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,IAAI,cAAc,IAAI,iBAAe,CAAC,sBAAsB,EAAE,CAAC;gBAC1E,QAAQ,GAAG,IAAI,CAAC;gBAChB,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,SAAS,qBAAqB,QAAQ,EAAE,CAAC,CAAC;YAChF,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YACtB,WAAW,CAAC,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,2BAA2B,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEtC,OAAO;YACL,SAAS;YACT,GAAG,EAAE,UAAU,CAAC,GAAG;YACnB,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;SAC3B,CAAC;IACJ,CAAC;IAGa,AAAP,KAAK,CAAC,CAAC,cAAc,CAAC,SAAiB;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAGY,AAAN,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,IAAY;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAGY,AAAN,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,UAA0C;QAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO;QAEvC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;IAClC,CAAC;IAGY,AAAN,KAAK,CAAC,YAAY,CAAC,SAAiB;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAEO,eAAe;QACrB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC;IAC1C,CAAC;IAEO,uBAAuB;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjD,MAAM,YAAY,GAAG,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAE1D,IAAI,YAAY,GAAG,iBAAe,CAAC,kBAAkB,EAAE,CAAC;gBACtD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,SAAS,kBAAkB,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;gBACvI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;;AA1IY;IADZ,SAAS;;;;oDA2ET;AAGa;IADb,SAAS;;;;qDAUT;AAGY;IADZ,SAAS;;;;iDAST;AAGY;IADZ,SAAS;;;;6CAOT;AAGY;IADZ,SAAS;;;;mDAUT;AAxKU,eAAe;IAD3B,QAAQ;;GACI,eAAe,CA6L3B"}