@nindroidsystems/pluginator 2.3.0

package/dist/core/schedule/notifications.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Schedule Notifications
+ *
+ * Notification system for scheduled update events.
+ * Supports terminal, desktop, and webhook channels.
+ *
+ * @since v1.51.3
+ */
+import type { QueueProcessResult } from './update-queue.js';
+/**
+ * Notification event types
+ */
+export type NotificationEventType = 'update_started' | 'update_completed' | 'update_failed';
+/**
+ * Plugin update status in notification
+ */
+export interface NotificationPluginStatus {
+    name: string;
+    oldVersion: string;
+    newVersion: string;
+    status: 'success' | 'failed' | 'skipped';
+    error?: string;
+}
+/**
+ * Notification event payload
+ */
+export interface NotificationEvent {
+    type: NotificationEventType;
+    timestamp: string;
+    server?: string;
+    plugins: NotificationPluginStatus[];
+    summary: {
+        total: number;
+        successful: number;
+        failed: number;
+        skipped: number;
+    };
+    backupPath?: string;
+    error?: string;
+}
+/**
+ * Notification channel types
+ */
+export type NotificationChannel = 'terminal' | 'desktop' | 'webhook';
+/**
+ * Notification configuration
+ */
+export interface NotificationConfig {
+    /** Whether notifications are enabled */
+    enabled: boolean;
+    /** Channels to send notifications to */
+    channels: NotificationChannel[];
+    /** Webhook URL for Discord/Slack notifications */
+    webhookUrl?: string;
+    /** Path to store terminal notifications for next session */
+    notificationStorePath?: string;
+}
+/**
+ * Stored notification for terminal display
+ */
+export interface StoredNotification {
+    id: string;
+    event: NotificationEvent;
+    read: boolean;
+    createdAt: string;
+}
+/**
+ * Default notification configuration
+ */
+export declare const DEFAULT_NOTIFICATION_CONFIG: NotificationConfig;
+/**
+ * Schedule Notifier
+ *
+ * Sends notifications through configured channels.
+ */
+export declare class ScheduleNotifier {
+    private config;
+    constructor(config?: Partial<NotificationConfig>);
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<NotificationConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): NotificationConfig;
+    /**
+     * Send notification for an event
+     */
+    notify(event: NotificationEvent): Promise<{
+        success: boolean;
+        errors: string[];
+    }>;
+    /**
+     * Create notification event from execution result
+     */
+    createEventFromResult(result: QueueProcessResult, type: NotificationEventType, options?: {
+        server?: string;
+        backupPath?: string;
+        error?: string;
+    }): NotificationEvent;
+    /**
+     * Send terminal notification (stored for next session)
+     */
+    private sendTerminalNotification;
+    /**
+     * Send desktop notification
+     * Uses execFile with argument arrays to prevent command injection
+     */
+    private sendDesktopNotification;
+    /**
+     * Redact webhook URL for logging (hides auth tokens)
+     */
+    private redactWebhookUrl;
+    /**
+     * Send webhook notification (Discord/Slack compatible)
+     */
+    private sendWebhookNotification;
+    /**
+     * Create Discord-compatible webhook payload
+     */
+    private createWebhookPayload;
+    /**
+     * Get notification title based on event type
+     */
+    private getNotificationTitle;
+    /**
+     * Get notification message based on event
+     */
+    private getNotificationMessage;
+    /**
+     * Get notification description for webhook
+     */
+    private getNotificationDescription;
+    /**
+     * Get notification color for webhook (Discord format)
+     */
+    private getNotificationColor;
+    /**
+     * Get unread terminal notifications
+     */
+    getUnreadNotifications(): Promise<StoredNotification[]>;
+    /**
+     * Mark notifications as read
+     */
+    markAsRead(ids: string[]): Promise<void>;
+    /**
+     * Clear all notifications
+     */
+    clearNotifications(): Promise<void>;
+}
+/**
+ * Get the singleton notifier instance
+ */
+export declare function getScheduleNotifier(): ScheduleNotifier | null;
+/**
+ * Initialize the schedule notifier
+ */
+export declare function initScheduleNotifier(config?: Partial<NotificationConfig>): ScheduleNotifier;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetScheduleNotifier(): void;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/core/schedule/notifications.d.ts.map

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

package/dist/core/schedule/plugin-schedule.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Per-Plugin Schedule Configuration
+ *
+ * Manages plugin-specific schedule overrides and blackout dates.
+ *
+ * @since v1.51.4
+ */
+import type { TimeWindow } from './schedule-executor.js';
+/**
+ * Per-plugin schedule configuration
+ */
+export interface PluginScheduleConfig {
+    /** Override global time window for this plugin */
+    window?: TimeWindow;
+    /** Disable scheduled updates for this plugin */
+    disabled?: boolean;
+    /** Delay updates for this many days after release */
+    delayDays?: number;
+    /** Auto-approve major version updates for this plugin */
+    autoApproveMajor?: boolean;
+}
+/**
+ * Schedule overrides configuration
+ */
+export interface ScheduleOverrides {
+    /** Blackout dates (ISO format YYYY-MM-DD) when no updates should run */
+    blackoutDates: string[];
+    /** Per-plugin schedule configurations */
+    plugins: Record<string, PluginScheduleConfig>;
+    /** Auto-approve major version updates globally */
+    autoApproveMajor: boolean;
+}
+/**
+ * Default schedule overrides
+ */
+export declare const DEFAULT_SCHEDULE_OVERRIDES: ScheduleOverrides;
+/**
+ * Plugin Schedule Manager
+ *
+ * Manages per-plugin schedule configurations and blackout dates.
+ */
+export declare class PluginScheduleManager {
+    private filePath;
+    private overrides;
+    constructor(filePath: string);
+    /**
+     * Load overrides from file
+     */
+    load(): Promise<void>;
+    /**
+     * Save overrides to file
+     */
+    save(): Promise<void>;
+    /**
+     * Get all overrides
+     */
+    getOverrides(): ScheduleOverrides;
+    /**
+     * Check if today is a blackout date
+     */
+    isBlackoutDate(date?: Date): boolean;
+    /**
+     * Add a blackout date
+     */
+    addBlackoutDate(date: string): Promise<void>;
+    /**
+     * Remove a blackout date
+     */
+    removeBlackoutDate(date: string): Promise<void>;
+    /**
+     * Get blackout dates
+     */
+    getBlackoutDates(): string[];
+    /**
+     * Clear expired blackout dates (dates in the past)
+     */
+    clearExpiredBlackoutDates(): Promise<string[]>;
+    /**
+     * Get plugin schedule config
+     */
+    getPluginConfig(pluginId: string): PluginScheduleConfig;
+    /**
+     * Set plugin schedule config
+     */
+    setPluginConfig(pluginId: string, config: PluginScheduleConfig): Promise<void>;
+    /**
+     * Update plugin schedule config (merge with existing)
+     */
+    updatePluginConfig(pluginId: string, config: Partial<PluginScheduleConfig>): Promise<void>;
+    /**
+     * Remove plugin schedule config
+     */
+    removePluginConfig(pluginId: string): Promise<void>;
+    /**
+     * Check if plugin is disabled for scheduling
+     */
+    isPluginDisabled(pluginId: string): boolean;
+    /**
+     * Get plugin's custom time window (or undefined for global window)
+     */
+    getPluginWindow(pluginId: string): TimeWindow | undefined;
+    /**
+     * Get plugin's delay days (or 0 for immediate)
+     */
+    getPluginDelayDays(pluginId: string): number;
+    /**
+     * Check if update should be delayed based on release date
+     *
+     * @param pluginId - Plugin identifier
+     * @param releaseDate - Release date of the update
+     * @returns true if update should wait, false if ready
+     */
+    shouldDelayUpdate(pluginId: string, releaseDate: Date): boolean;
+    /**
+     * Get when a delayed update will be ready
+     */
+    getDelayedUpdateReadyDate(pluginId: string, releaseDate: Date): Date;
+    /**
+     * Check if major version update should be auto-approved
+     */
+    shouldAutoApproveMajor(pluginId: string): boolean;
+    /**
+     * Set global auto-approve major setting
+     */
+    setAutoApproveMajor(value: boolean): Promise<void>;
+    /**
+     * Get global auto-approve major setting
+     */
+    getAutoApproveMajor(): boolean;
+    /**
+     * Get list of plugins with custom configurations
+     */
+    getConfiguredPlugins(): string[];
+    /**
+     * Format date as YYYY-MM-DD
+     */
+    private formatDate;
+    /**
+     * Validate date format (YYYY-MM-DD)
+     */
+    private isValidDateFormat;
+}
+/**
+ * Get the singleton plugin schedule manager
+ */
+export declare function getPluginScheduleManager(): PluginScheduleManager | null;
+/**
+ * Initialize the plugin schedule manager
+ */
+export declare function initPluginScheduleManager(filePath: string): PluginScheduleManager;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetPluginScheduleManager(): void;
+//# sourceMappingURL=plugin-schedule.d.ts.map

package/dist/core/schedule/plugin-schedule.d.ts.map

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

package/dist/core/schedule/schedule-daemon.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Schedule Daemon
+ *
+ * Background service that periodically checks and executes queued updates.
+ * Manages its own lifecycle with PID file and graceful shutdown.
+ *
+ * @since v1.51.1
+ */
+import type { ExecutionResult, ScheduleExecutor } from './schedule-executor.js';
+/**
+ * Daemon status
+ */
+export type DaemonStatus = 'stopped' | 'starting' | 'running' | 'stopping';
+/**
+ * Daemon configuration
+ */
+export interface DaemonConfig {
+    /** Check interval in milliseconds (default: 5 minutes) */
+    checkIntervalMs: number;
+    /** Path to PID file */
+    pidFile: string;
+    /** Path to daemon log file */
+    logFile: string;
+    /** Maximum log file size in bytes before rotation (default: 10MB) */
+    maxLogSize: number;
+    /** Number of log files to keep (default: 5) */
+    maxLogFiles: number;
+}
+/**
+ * Daemon state persisted to disk
+ */
+export interface DaemonState {
+    /** Process ID */
+    pid: number;
+    /** Start timestamp */
+    startedAt: string;
+    /** Last check timestamp */
+    lastCheckAt: string | null;
+    /** Last execution result */
+    lastResult: ExecutionResult | null;
+    /** Total executions */
+    totalExecutions: number;
+    /** Total updates applied */
+    totalUpdatesApplied: number;
+    /** Total errors */
+    totalErrors: number;
+}
+/**
+ * Default daemon configuration
+ */
+export declare const DEFAULT_DAEMON_CONFIG: DaemonConfig;
+/**
+ * Schedule Daemon
+ *
+ * Runs in the background and periodically executes the schedule executor.
+ */
+export declare class ScheduleDaemon {
+    private config;
+    private executor;
+    private status;
+    private checkTimer;
+    private state;
+    private shutdownHandlers;
+    constructor(executor: ScheduleExecutor, config: Partial<DaemonConfig> & {
+        pidFile: string;
+        logFile: string;
+    });
+    /**
+     * Get current daemon status
+     */
+    getStatus(): DaemonStatus;
+    /**
+     * Get daemon state
+     */
+    getState(): DaemonState;
+    /**
+     * Check if daemon is running (based on PID file)
+     */
+    isRunning(): Promise<boolean>;
+    /**
+     * Get PID from PID file
+     */
+    getPid(): Promise<number | null>;
+    /**
+     * Start the daemon
+     */
+    start(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Stop the daemon
+     */
+    stop(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Run a single check cycle
+     */
+    private runCheck;
+    /**
+     * Write PID file
+     */
+    private writePidFile;
+    /**
+     * Remove PID file
+     */
+    private removePidFile;
+    /**
+     * Set up signal handlers for graceful shutdown
+     */
+    private setupSignalHandlers;
+    /**
+     * Remove signal handlers
+     */
+    private removeSignalHandlers;
+    /**
+     * Log a message to the daemon log file
+     */
+    private log;
+    /**
+     * Rotate log file if it exceeds max size
+     */
+    private rotateLogIfNeeded;
+    /**
+     * Get status summary
+     */
+    getStatusSummary(): Promise<{
+        status: DaemonStatus;
+        pid: number | null;
+        uptime: number | null;
+        lastCheck: string | null;
+        totalExecutions: number;
+        totalUpdatesApplied: number;
+        totalErrors: number;
+        nextCheck: Date | null;
+    }>;
+    /**
+     * Format uptime for display
+     */
+    static formatUptime(ms: number): string;
+}
+/**
+ * Get the singleton daemon instance
+ */
+export declare function getScheduleDaemon(): ScheduleDaemon | null;
+/**
+ * Initialize the schedule daemon
+ */
+export declare function initScheduleDaemon(executor: ScheduleExecutor, config: Partial<DaemonConfig> & {
+    pidFile: string;
+    logFile: string;
+}): ScheduleDaemon;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetScheduleDaemon(): void;
+//# sourceMappingURL=schedule-daemon.d.ts.map

package/dist/core/schedule/schedule-daemon.d.ts.map

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

package/dist/core/schedule/schedule-executor.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Schedule Executor
+ *
+ * Executes queued updates within scheduled time windows.
+ * Coordinates between ScheduleService and UpdateQueue.
+ *
+ * @since v1.51.0
+ * @since v1.51.2 - Added auto-backup before updates
+ */
+import type { ScheduleService } from './schedule-service.js';
+import type { QueueProcessResult, QueuedUpdate, UpdateQueue } from './update-queue.js';
+/**
+ * Execution mode
+ */
+export type ExecutionMode = 'immediate' | 'scheduled';
+/**
+ * Time window configuration
+ */
+export interface TimeWindow {
+    /** Start time in 24h format (e.g., "02:00") */
+    start: string;
+    /** End time in 24h format (e.g., "04:00") */
+    end: string;
+}
+/**
+ * Auto-backup configuration
+ */
+export interface AutoBackupConfig {
+    /** Whether to create a backup before executing updates */
+    enabled: boolean;
+    /** Directory to store backups */
+    backupDir: string;
+    /** Directory containing plugins to backup */
+    pluginsDir: string;
+    /** Number of days to keep pre-update backups (0 = keep forever) */
+    retentionDays: number;
+    /** Maximum number of pre-update backups to keep */
+    maxBackups: number;
+}
+/**
+ * Schedule executor configuration
+ */
+export interface ScheduleExecutorConfig {
+    /** Whether scheduled execution is enabled */
+    enabled: boolean;
+    /** Time window for scheduled updates */
+    window: TimeWindow;
+    /** Timezone for window calculations (IANA format, e.g., "America/New_York") */
+    timezone: string;
+    /** Days of week to run (0 = Sunday, 6 = Saturday) */
+    daysOfWeek: number[];
+    /** Skip major version updates in scheduled mode */
+    skipMajorUpdates: boolean;
+    /** Maximum updates per execution */
+    maxUpdatesPerRun: number;
+    /** Auto-backup configuration */
+    autoBackup?: AutoBackupConfig;
+}
+/**
+ * Execution result
+ */
+export interface ExecutionResult {
+    /** Whether execution was successful */
+    success: boolean;
+    /** Execution mode used */
+    mode: ExecutionMode;
+    /** Queue processing result */
+    result?: QueueProcessResult;
+    /** Reason if execution was skipped */
+    skipReason?: string;
+    /** Start timestamp */
+    startedAt: string;
+    /** End timestamp */
+    completedAt: string;
+    /** Path to backup created before update (if auto-backup enabled) */
+    backupPath?: string;
+}
+/**
+ * Default executor configuration
+ */
+export declare const DEFAULT_EXECUTOR_CONFIG: ScheduleExecutorConfig;
+/**
+ * Schedule Executor
+ *
+ * Executes queued updates based on schedule configuration.
+ */
+export declare class ScheduleExecutor {
+    private config;
+    private queue;
+    private scheduleService;
+    private updateHandler;
+    constructor(queue: UpdateQueue, scheduleService: ScheduleService, updateHandler: (update: QueuedUpdate) => Promise<{
+        success: boolean;
+        error?: string;
+    }>, config?: Partial<ScheduleExecutorConfig>);
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<ScheduleExecutorConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): ScheduleExecutorConfig;
+    /**
+     * Check if current time is within the execution window
+     */
+    isWithinWindow(): boolean;
+    /**
+     * Check if today is a valid execution day
+     */
+    shouldProcessToday(): boolean;
+    /**
+     * Check if execution can proceed in scheduled mode
+     */
+    canExecuteScheduled(): boolean;
+    /**
+     * Get the next execution window start time
+     */
+    getNextWindowStart(): Date;
+    /**
+     * Execute queued updates
+     *
+     * @param mode - 'immediate' bypasses time window checks, 'scheduled' respects them
+     */
+    execute(mode?: ExecutionMode): Promise<ExecutionResult>;
+    /**
+     * Execute immediately (bypasses time window checks)
+     */
+    executeImmediate(): Promise<ExecutionResult>;
+    /**
+     * Execute if within scheduled window
+     */
+    executeScheduled(): Promise<ExecutionResult>;
+    /**
+     * Get execution status summary
+     */
+    getStatus(): {
+        enabled: boolean;
+        withinWindow: boolean;
+        validDay: boolean;
+        pendingUpdates: number;
+        nextWindow: Date;
+        config: ScheduleExecutorConfig;
+    };
+    /**
+     * Create a pre-update backup
+     *
+     * @returns Path to the created backup, or null if backup is disabled or failed
+     */
+    createPreUpdateBackup(): Promise<string | null>;
+    /**
+     * Clean up old pre-update backups based on retention policy
+     */
+    cleanupOldBackups(): Promise<string[]>;
+    /**
+     * List pre-update backups
+     */
+    listPreUpdateBackups(): Promise<Array<{
+        filename: string;
+        path: string;
+        created: Date;
+        size: number;
+    }>>;
+}
+/**
+ * Get the singleton schedule executor
+ */
+export declare function getScheduleExecutor(): ScheduleExecutor | null;
+/**
+ * Initialize the schedule executor
+ */
+export declare function initScheduleExecutor(queue: UpdateQueue, scheduleService: ScheduleService, updateHandler: (update: QueuedUpdate) => Promise<{
+    success: boolean;
+    error?: string;
+}>, config?: Partial<ScheduleExecutorConfig>): ScheduleExecutor;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetScheduleExecutor(): void;
+//# sourceMappingURL=schedule-executor.d.ts.map

package/dist/core/schedule/schedule-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-executor.d.ts","sourceRoot":"","sources":["../../../src/core/schedule/schedule-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIvF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,EAAE,UAAU,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mDAAmD;IACnD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,sBAOrC,CAAC;AA+CF;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAA0E;gBAEnF,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAOlM;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,SAAS,IAAI,sBAAsB;IAInC;;OAEG;IACH,cAAc,IAAI,OAAO;IAoBzB;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAM7B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAgB9B;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAuB1B;;;;OAIG;IACG,OAAO,CAAC,IAAI,GAAE,aAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;IA0H1E;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC;IAIlD;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC;IAIlD;;OAEG;IACH,SAAS,IAAI;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,OAAO,CAAC;QACtB,QAAQ,EAAE,OAAO,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,IAAI,CAAC;QACjB,MAAM,EAAE,sBAAsB,CAAC;KAChC;IAWD;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4CrD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAmE5C;;OAEG;IACG,oBAAoB,IAAI,OAAO,CACnC,KAAK,CAAC;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,IAAI,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CACH;CAsCF;AAKD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAClB,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACtF,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACvC,gBAAgB,CAGlB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}