@buenojs/bueno 0.8.10 → 0.8.11

package/dist/notification/channels/push.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Push Notification Channel Service
+ *
+ * Sends notifications via push through various drivers
+ * (Firebase, APNS, custom)
+ */
+import type { PushChannelConfig, PushNotificationMessage } from "../types";
+import { BaseChannelService } from "./base";
+export declare class PushNotificationChannelService extends BaseChannelService<PushNotificationMessage> {
+    readonly name = "push";
+    private config;
+    private sentCount;
+    private failureCount;
+    constructor(config: PushChannelConfig);
+    /**
+     * Validate push notification message structure
+     */
+    validate(message: unknown): asserts message is PushNotificationMessage;
+    /**
+     * Send push notification message
+     */
+    send(message: PushNotificationMessage): Promise<string | undefined>;
+    /**
+     * Get push channel metrics
+     */
+    getMetrics(): {
+        sent: number;
+        failed: number;
+        total: number;
+        successRate: number;
+    };
+    /**
+     * Generate a message ID
+     */
+    private _generateMessageId;
+}
+//# sourceMappingURL=push.d.ts.map

package/dist/notification/channels/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/notification/channels/push.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAI5C,qBAAa,8BAA+B,SAAQ,kBAAkB,CAAC,uBAAuB,CAAC;IAC9F,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,iBAAiB;IAKrC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,uBAAuB;IA0BtE;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA2BzE;;OAEG;IACH,UAAU;;;;;;IAUV;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK1B"}

package/dist/notification/channels/push.js

@@ -0,0 +1,84 @@
+/**
+ * Push Notification Channel Service
+ *
+ * Sends notifications via push through various drivers
+ * (Firebase, APNS, custom)
+ */
+import { BaseChannelService } from "./base";
+// ============= Push Notification Channel Service =============
+export class PushNotificationChannelService extends BaseChannelService {
+    name = "push";
+    config;
+    sentCount = 0;
+    failureCount = 0;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Validate push notification message structure
+     */
+    validate(message) {
+        if (typeof message !== "object" || message === null) {
+            throw new Error("Invalid push message: must be an object");
+        }
+        const msg = message;
+        if (msg.channel !== "push") {
+            throw new Error('Invalid push message: channel must be "push"');
+        }
+        if (typeof msg.recipient !== "string" || msg.recipient.length === 0) {
+            throw new Error("Invalid push message: recipient (device token) is required");
+        }
+        if (typeof msg.title !== "string" || msg.title.length === 0) {
+            throw new Error("Invalid push message: title is required");
+        }
+        if (typeof msg.body !== "string" || msg.body.length === 0) {
+            throw new Error("Invalid push message: body is required");
+        }
+    }
+    /**
+     * Send push notification message
+     */
+    async send(message) {
+        try {
+            if (this.config.dryRun) {
+                console.log(`[PushChannel] Would send push to: ${message.recipient}`);
+                console.log(`  Title: ${message.title}`);
+                console.log(`  Body: ${message.body}`);
+                this.sentCount++;
+                return this._generateMessageId();
+            }
+            // In a real implementation, delegate to appropriate driver
+            // For now, simulate sending
+            const messageId = this._generateMessageId();
+            console.log(`[PushChannel] Push sent: ${messageId} to ${message.recipient}`);
+            this.sentCount++;
+            return messageId;
+        }
+        catch (error) {
+            this.failureCount++;
+            throw new Error(`Failed to send push: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get push channel metrics
+     */
+    getMetrics() {
+        const total = this.sentCount + this.failureCount;
+        return {
+            sent: this.sentCount,
+            failed: this.failureCount,
+            total,
+            successRate: total > 0 ? this.sentCount / total : 0,
+        };
+    }
+    /**
+     * Generate a message ID
+     */
+    _generateMessageId() {
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 15);
+        return `push_${timestamp}_${random}`;
+    }
+}
+//# sourceMappingURL=push.js.map

package/dist/notification/channels/push.js.map

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

package/dist/notification/channels/sms.d.ts

@@ -0,0 +1,37 @@
+/**
+ * SMS Channel Service
+ *
+ * Sends notifications via SMS through various drivers
+ * (Twilio, AWS SNS, custom)
+ */
+import type { SMSChannelConfig, SMSMessage } from "../types";
+import { BaseChannelService } from "./base";
+export declare class SMSChannelService extends BaseChannelService<SMSMessage> {
+    readonly name = "sms";
+    private config;
+    private sentCount;
+    private failureCount;
+    constructor(config: SMSChannelConfig);
+    /**
+     * Validate SMS message structure
+     */
+    validate(message: unknown): asserts message is SMSMessage;
+    /**
+     * Send SMS message
+     */
+    send(message: SMSMessage): Promise<string | undefined>;
+    /**
+     * Get SMS channel metrics
+     */
+    getMetrics(): {
+        sent: number;
+        failed: number;
+        total: number;
+        successRate: number;
+    };
+    /**
+     * Generate a message ID
+     */
+    private _generateMessageId;
+}
+//# sourceMappingURL=sms.d.ts.map

package/dist/notification/channels/sms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms.d.ts","sourceRoot":"","sources":["../../../src/notification/channels/sms.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAI5C,qBAAa,iBAAkB,SAAQ,kBAAkB,CAAC,UAAU,CAAC;IACpE,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,gBAAgB;IAKpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU;IA4BzD;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA0B5D;;OAEG;IACH,UAAU;;;;;;IAUV;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK1B"}

package/dist/notification/channels/sms.js

@@ -0,0 +1,83 @@
+/**
+ * SMS Channel Service
+ *
+ * Sends notifications via SMS through various drivers
+ * (Twilio, AWS SNS, custom)
+ */
+import { BaseChannelService } from "./base";
+// ============= SMS Channel Service =============
+export class SMSChannelService extends BaseChannelService {
+    name = "sms";
+    config;
+    sentCount = 0;
+    failureCount = 0;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Validate SMS message structure
+     */
+    validate(message) {
+        if (typeof message !== "object" || message === null) {
+            throw new Error("Invalid SMS message: must be an object");
+        }
+        const msg = message;
+        if (msg.channel !== "sms") {
+            throw new Error('Invalid SMS message: channel must be "sms"');
+        }
+        if (typeof msg.recipient !== "string" || msg.recipient.length === 0) {
+            throw new Error("Invalid SMS message: recipient (phone number) is required");
+        }
+        if (typeof msg.message !== "string" || msg.message.length === 0) {
+            throw new Error("Invalid SMS message: message is required");
+        }
+        if (msg.message.length > 160) {
+            console.warn(`SMS message exceeds 160 characters (${msg.message.length}), will be split`);
+        }
+    }
+    /**
+     * Send SMS message
+     */
+    async send(message) {
+        try {
+            if (this.config.dryRun) {
+                console.log(`[SMSChannel] Would send SMS to: ${message.recipient}`);
+                console.log(`  Message: ${message.message.substring(0, 50)}...`);
+                this.sentCount++;
+                return this._generateMessageId();
+            }
+            // In a real implementation, delegate to appropriate driver
+            // For now, simulate sending
+            const messageId = this._generateMessageId();
+            console.log(`[SMSChannel] SMS sent: ${messageId} to ${message.recipient}`);
+            this.sentCount++;
+            return messageId;
+        }
+        catch (error) {
+            this.failureCount++;
+            throw new Error(`Failed to send SMS: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get SMS channel metrics
+     */
+    getMetrics() {
+        const total = this.sentCount + this.failureCount;
+        return {
+            sent: this.sentCount,
+            failed: this.failureCount,
+            total,
+            successRate: total > 0 ? this.sentCount / total : 0,
+        };
+    }
+    /**
+     * Generate a message ID
+     */
+    _generateMessageId() {
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 15);
+        return `sms_${timestamp}_${random}`;
+    }
+}
+//# sourceMappingURL=sms.js.map

package/dist/notification/channels/sms.js.map

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

package/dist/notification/channels/whatsapp.d.ts

@@ -0,0 +1,37 @@
+/**
+ * WhatsApp Channel Service
+ *
+ * Sends notifications via WhatsApp through various drivers
+ * (Twilio, custom)
+ */
+import type { WhatsAppChannelConfig, WhatsAppMessage } from "../types";
+import { BaseChannelService } from "./base";
+export declare class WhatsAppChannelService extends BaseChannelService<WhatsAppMessage> {
+    readonly name = "whatsapp";
+    private config;
+    private sentCount;
+    private failureCount;
+    constructor(config: WhatsAppChannelConfig);
+    /**
+     * Validate WhatsApp message structure
+     */
+    validate(message: unknown): asserts message is WhatsAppMessage;
+    /**
+     * Send WhatsApp message
+     */
+    send(message: WhatsAppMessage): Promise<string | undefined>;
+    /**
+     * Get WhatsApp channel metrics
+     */
+    getMetrics(): {
+        sent: number;
+        failed: number;
+        total: number;
+        successRate: number;
+    };
+    /**
+     * Generate a message ID
+     */
+    private _generateMessageId;
+}
+//# sourceMappingURL=whatsapp.d.ts.map

package/dist/notification/channels/whatsapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../../src/notification/channels/whatsapp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAI5C,qBAAa,sBAAuB,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IAC9E,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,qBAAqB;IAKzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe;IAsB9D;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA+BjE;;OAEG;IACH,UAAU;;;;;;IAUV;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK1B"}

package/dist/notification/channels/whatsapp.js

@@ -0,0 +1,81 @@
+/**
+ * WhatsApp Channel Service
+ *
+ * Sends notifications via WhatsApp through various drivers
+ * (Twilio, custom)
+ */
+import { BaseChannelService } from "./base";
+// ============= WhatsApp Channel Service =============
+export class WhatsAppChannelService extends BaseChannelService {
+    name = "whatsapp";
+    config;
+    sentCount = 0;
+    failureCount = 0;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Validate WhatsApp message structure
+     */
+    validate(message) {
+        if (typeof message !== "object" || message === null) {
+            throw new Error("Invalid WhatsApp message: must be an object");
+        }
+        const msg = message;
+        if (msg.channel !== "whatsapp") {
+            throw new Error('Invalid WhatsApp message: channel must be "whatsapp"');
+        }
+        if (typeof msg.recipient !== "string" || msg.recipient.length === 0) {
+            throw new Error("Invalid WhatsApp message: recipient (phone number) is required");
+        }
+        if (typeof msg.templateId !== "string" || msg.templateId.length === 0) {
+            throw new Error("Invalid WhatsApp message: templateId is required");
+        }
+    }
+    /**
+     * Send WhatsApp message
+     */
+    async send(message) {
+        try {
+            if (this.config.dryRun) {
+                console.log(`[WhatsAppChannel] Would send WhatsApp to: ${message.recipient}`);
+                console.log(`  Template: ${message.templateId}`);
+                console.log(`  Parameters: ${JSON.stringify(message.parameters || {})}`);
+                this.sentCount++;
+                return this._generateMessageId();
+            }
+            // In a real implementation, delegate to appropriate driver
+            // For now, simulate sending
+            const messageId = this._generateMessageId();
+            console.log(`[WhatsAppChannel] WhatsApp sent: ${messageId} to ${message.recipient}`);
+            this.sentCount++;
+            return messageId;
+        }
+        catch (error) {
+            this.failureCount++;
+            throw new Error(`Failed to send WhatsApp: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get WhatsApp channel metrics
+     */
+    getMetrics() {
+        const total = this.sentCount + this.failureCount;
+        return {
+            sent: this.sentCount,
+            failed: this.failureCount,
+            total,
+            successRate: total > 0 ? this.sentCount / total : 0,
+        };
+    }
+    /**
+     * Generate a message ID
+     */
+    _generateMessageId() {
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 15);
+        return `wa_${timestamp}_${random}`;
+    }
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/notification/channels/whatsapp.js.map

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

package/dist/notification/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Notification Module
+ *
+ * Multi-channel notification system with support for email, SMS, WhatsApp,
+ * push notifications, and custom channels. Uses registry pattern for
+ * dynamic channel registration.
+ */
+export type { NotificationChannel, NotificationMessage, EmailRecipient, EmailRecipients, EmailAttachment, EmailMessage, SMSMessage, WhatsAppMessage, PushNotificationMessage, BuiltInNotification, Notifiable, ChannelHealth, ChannelService, BaseChannelConfig, EmailChannelConfig, SMSChannelConfig, WhatsAppChannelConfig, PushChannelConfig, ChannelConfig, NotificationServiceConfig, ChannelMetrics, NotificationEvent, NotificationEventType, NotificationValidationResult, StandardSchema, } from "./types";
+export { NotificationService, createNotificationService } from "./service";
+export { BaseChannelService } from "./channels/base";
+export { EmailChannelService } from "./channels/email";
+export { SMSChannelService } from "./channels/sms";
+export { WhatsAppChannelService } from "./channels/whatsapp";
+export { PushNotificationChannelService } from "./channels/push";
+//# sourceMappingURL=index.d.ts.map

package/dist/notification/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notification/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,UAAU,EACV,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,yBAAyB,EACzB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC5B,cAAc,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAG3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/notification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notification/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAE3E,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,2BAA2B;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/notification/service.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Notification Service
+ *
+ * Core notification service with registry-based channel management.
+ * Supports dynamic channel registration and multi-channel notification sending.
+ */
+import type { ChannelHealth, ChannelMetrics, ChannelService, Notifiable, NotificationChannel, NotificationMessage, NotificationServiceConfig } from "./types";
+export declare class NotificationService {
+    private channels;
+    private config;
+    private metrics;
+    constructor(config?: NotificationServiceConfig);
+    /**
+     * Register a channel service
+     * @param service Channel service to register
+     * @throws Error if channel is already registered
+     */
+    registerChannel<T extends NotificationMessage>(service: ChannelService<T>): void;
+    /**
+     * Unregister a channel service
+     * @param channelName Name of the channel to unregister
+     */
+    unregisterChannel(channelName: NotificationChannel): void;
+    /**
+     * Get a registered channel service
+     * @param channelName Name of the channel
+     * @returns Channel service or null if not found
+     */
+    getChannel(channelName: NotificationChannel): ChannelService | null;
+    /**
+     * Get all registered channel names
+     */
+    getChannels(): NotificationChannel[];
+    /**
+     * Check if a channel is registered
+     */
+    hasChannel(channelName: NotificationChannel): boolean;
+    /**
+     * Send a notification via specified channel
+     * @param message Notification message
+     * @returns Message ID or undefined
+     * @throws Error if channel not found or message invalid
+     */
+    send(message: NotificationMessage): Promise<string | undefined>;
+    /**
+     * Send multiple notifications (potentially different channels)
+     * @param messages Array of notification messages
+     * @returns Array of message IDs
+     */
+    sendBatch(messages: NotificationMessage[]): Promise<(string | undefined)[]>;
+    /**
+     * Send a notification from a Notifiable
+     * @param notifiable Notifiable instance
+     * @param channel Optional specific channel (otherwise uses buildAll or default)
+     * @returns Message ID(s)
+     */
+    sendNotifiable(notifiable: Notifiable, channel?: NotificationChannel): Promise<string | undefined>;
+    /**
+     * Queue a notification for async sending (requires job queue integration)
+     * @param message Notification message
+     * @returns Job ID or undefined
+     */
+    queue(message: NotificationMessage): Promise<string | undefined>;
+    /**
+     * Get health status for a channel
+     * @param channelName Name of the channel
+     */
+    getChannelHealth(channelName: NotificationChannel): Promise<ChannelHealth | null>;
+    /**
+     * Get health status for all channels
+     */
+    getHealthStatus(): Promise<Record<NotificationChannel, ChannelHealth>>;
+    /**
+     * Get metrics for a specific channel
+     * @param channelName Name of the channel
+     */
+    getChannelMetrics(channelName: NotificationChannel): ChannelMetrics | null;
+    /**
+     * Get metrics for all channels
+     */
+    getAllMetrics(): Record<NotificationChannel, ChannelMetrics>;
+    /**
+     * Resolve TemplateRef objects in message fields to rendered strings
+     */
+    private _resolveTemplates;
+    /**
+     * Assert that no TemplateRef fields exist in the message
+     * Throws if a TemplateRef is found but no templateEngine is configured
+     */
+    private _assertNoTemplateRefs;
+    /**
+     * Update metrics for a channel
+     */
+    private _updateMetrics;
+}
+/**
+ * Factory function to create notification service
+ */
+export declare function createNotificationService(config?: NotificationServiceConfig): NotificationService;
+//# sourceMappingURL=service.d.ts.map

package/dist/notification/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/notification/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EAEzB,MAAM,SAAS,CAAC;AAKjB,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAuD;IACvE,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAuD;gBAE1D,MAAM,GAAE,yBAA8B;IAIlD;;;;OAIG;IACH,eAAe,CAAC,CAAC,SAAS,mBAAmB,EAC5C,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,IAAI;IAmBP;;;OAGG;IACH,iBAAiB,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAKzD;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,mBAAmB,GAAG,cAAc,GAAG,IAAI;IAInE;;OAEG;IACH,WAAW,IAAI,mBAAmB,EAAE;IAIpC;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO;IAIrD;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAkCrE;;;;OAIG;IACG,SAAS,CACd,QAAQ,EAAE,mBAAmB,EAAE,GAC7B,OAAO,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAelC;;;;;OAKG;IACG,cAAc,CACnB,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuB9B;;;;OAIG;IACG,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAMtE;;;OAGG;IACG,gBAAgB,CACrB,WAAW,EAAE,mBAAmB,GAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAahC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;IAa5E;;;OAGG;IACH,iBAAiB,CAAC,WAAW,EAAE,mBAAmB,GAAG,cAAc,GAAG,IAAI;IAI1E;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,mBAAmB,EAAE,cAAc,CAAC;IAU5D;;OAEG;YACW,iBAAiB;IAsD/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,cAAc;CAqBtB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,CAAC,EAAE,yBAAyB,GAChC,mBAAmB,CAErB"}