@rovela-ai/sdk 0.1.2 → 0.1.4

package/dist/emails/send/orders.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * @rovela/sdk/emails/send/orders
+ *
+ * Send functions for order-related emails.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendOrderConfirmation = sendOrderConfirmation;
+exports.sendOrderConfirmationAsync = sendOrderConfirmationAsync;
+exports.sendOrderShipped = sendOrderShipped;
+exports.sendOrderShippedAsync = sendOrderShippedAsync;
+exports.sendOrderDelivered = sendOrderDelivered;
+exports.sendOrderDeliveredAsync = sendOrderDeliveredAsync;
+exports.sendOrderCancelled = sendOrderCancelled;
+exports.sendOrderCancelledAsync = sendOrderCancelledAsync;
+exports.sendRefundProcessed = sendRefundProcessed;
+exports.sendRefundProcessedAsync = sendRefundProcessedAsync;
+const sender_1 = require("../sender");
+const config_1 = require("../config");
+const templates_1 = require("../templates");
+/**
+ * Send an order confirmation email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderConfirmation } from '@rovela/sdk/emails'
+ *
+ * await sendOrderConfirmation({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   orderDate: 'November 28, 2025',
+ *   paymentStatus: 'Paid',
+ *   items: [{ name: 'Product', quantity: 1, price: '$29.99' }],
+ *   subtotal: '$29.99',
+ *   shippingCost: '$5.00',
+ *   tax: '$2.80',
+ *   total: '$37.79',
+ *   shippingAddress: { name: 'John Doe', ... },
+ *   orderTrackingUrl: 'https://store.com/orders/12345',
+ * })
+ * ```
+ */
+async function sendOrderConfirmation(params) {
+    const config = (0, config_1.getEmailConfig)();
+    const storeName = (0, config_1.getStoreName)();
+    const html = (0, templates_1.renderOrderConfirmation)({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        orderDate: params.orderDate,
+        paymentStatus: params.paymentStatus,
+        items: params.items,
+        subtotal: params.subtotal,
+        shippingCost: params.shippingCost,
+        tax: params.tax,
+        total: params.total,
+        shippingAddress: params.shippingAddress,
+        orderTrackingUrl: params.orderTrackingUrl,
+    });
+    return (0, sender_1.sendEmail)({
+        to: params.to,
+        subject: (0, templates_1.getOrderConfirmationSubject)(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send order confirmation without waiting (fire-and-forget).
+ * Use this in webhooks to not block the response.
+ */
+function sendOrderConfirmationAsync(params) {
+    sendOrderConfirmation(params).catch((err) => {
+        console.error('[Email] Failed to send order confirmation:', err);
+    });
+}
+/**
+ * Send an order shipped email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderShipped } from '@rovela/sdk/emails'
+ *
+ * await sendOrderShipped({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   trackingNumber: '1Z999AA10123456784',
+ *   carrierName: 'UPS',
+ *   estimatedDeliveryDate: 'December 3, 2025',
+ *   shippingAddress: { name: 'John Doe', ... },
+ *   trackingUrl: 'https://ups.com/track/...',
+ * })
+ * ```
+ */
+async function sendOrderShipped(params) {
+    const config = (0, config_1.getEmailConfig)();
+    const storeName = (0, config_1.getStoreName)();
+    const html = (0, templates_1.renderOrderShipped)({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        trackingNumber: params.trackingNumber,
+        carrierName: params.carrierName,
+        estimatedDeliveryDate: params.estimatedDeliveryDate,
+        shippingAddress: params.shippingAddress,
+        trackingUrl: params.trackingUrl,
+    });
+    return (0, sender_1.sendEmail)({
+        to: params.to,
+        subject: (0, templates_1.getOrderShippedSubject)(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send order shipped without waiting (fire-and-forget).
+ */
+function sendOrderShippedAsync(params) {
+    sendOrderShipped(params).catch((err) => {
+        console.error('[Email] Failed to send order shipped email:', err);
+    });
+}
+/**
+ * Send an order delivered email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderDelivered } from '@rovela/sdk/emails'
+ *
+ * await sendOrderDelivered({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   deliveryDate: 'December 3, 2025',
+ *   deliveryLocation: 'Front Door',
+ *   reviewUrl: 'https://store.com/review/12345',
+ *   returnCenterUrl: 'https://store.com/returns',
+ * })
+ * ```
+ */
+async function sendOrderDelivered(params) {
+    const config = (0, config_1.getEmailConfig)();
+    const storeName = (0, config_1.getStoreName)();
+    const html = (0, templates_1.renderOrderDelivered)({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        deliveryDate: params.deliveryDate,
+        deliveryLocation: params.deliveryLocation,
+        reviewUrl: params.reviewUrl,
+        returnCenterUrl: params.returnCenterUrl,
+    });
+    return (0, sender_1.sendEmail)({
+        to: params.to,
+        subject: (0, templates_1.getOrderDeliveredSubject)(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send order delivered without waiting (fire-and-forget).
+ */
+function sendOrderDeliveredAsync(params) {
+    sendOrderDelivered(params).catch((err) => {
+        console.error('[Email] Failed to send order delivered email:', err);
+    });
+}
+/**
+ * Send an order cancelled email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderCancelled } from '@rovela/sdk/emails'
+ *
+ * await sendOrderCancelled({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   cancellationReason: 'Customer requested cancellation.',
+ *   cancellationDate: 'November 28, 2025',
+ *   refundMessage: 'Your refund will be processed within 3-5 business days.',
+ * })
+ * ```
+ */
+async function sendOrderCancelled(params) {
+    const config = (0, config_1.getEmailConfig)();
+    const storeName = (0, config_1.getStoreName)();
+    const html = (0, templates_1.renderOrderCancelled)({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        cancellationReason: params.cancellationReason,
+        cancellationDate: params.cancellationDate,
+        refundMessage: params.refundMessage,
+    });
+    return (0, sender_1.sendEmail)({
+        to: params.to,
+        subject: (0, templates_1.getOrderCancelledSubject)(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send order cancelled without waiting (fire-and-forget).
+ */
+function sendOrderCancelledAsync(params) {
+    sendOrderCancelled(params).catch((err) => {
+        console.error('[Email] Failed to send order cancelled email:', err);
+    });
+}
+/**
+ * Send a refund processed email.
+ *
+ * @example
+ * ```typescript
+ * import { sendRefundProcessed } from '@rovela/sdk/emails'
+ *
+ * await sendRefundProcessed({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   refundAmount: '$99.00',
+ *   refundDate: 'November 28, 2025',
+ *   paymentMethod: 'Visa ending in 4242',
+ *   estimatedArrival: '3-5 business days',
+ *   businessDays: '3-5',
+ * })
+ * ```
+ */
+async function sendRefundProcessed(params) {
+    const config = (0, config_1.getEmailConfig)();
+    const storeName = (0, config_1.getStoreName)();
+    const html = (0, templates_1.renderRefundProcessed)({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        refundAmount: params.refundAmount,
+        refundDate: params.refundDate,
+        paymentMethod: params.paymentMethod,
+        estimatedArrival: params.estimatedArrival,
+        businessDays: params.businessDays,
+    });
+    return (0, sender_1.sendEmail)({
+        to: params.to,
+        subject: (0, templates_1.getRefundProcessedSubject)(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send refund processed without waiting (fire-and-forget).
+ */
+function sendRefundProcessedAsync(params) {
+    sendRefundProcessed(params).catch((err) => {
+        console.error('[Email] Failed to send refund processed email:', err);
+    });
+}
+//# sourceMappingURL=orders.js.map

package/dist/emails/send/orders.js.map

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

package/dist/emails/sender.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @rovela/sdk/emails/sender
+ *
+ * Core email sending functionality using Resend.
+ */
+import type { SendEmailOptions, SendEmailResult } from './types';
+/**
+ * Send an email via Resend.
+ *
+ * This is the core sending function used by all email templates.
+ * It handles error catching and returns a result object.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmail } from '@rovela/sdk/emails'
+ *
+ * const result = await sendEmail({
+ *   to: 'customer@example.com',
+ *   subject: 'Order Confirmation',
+ *   html: '<html>...</html>',
+ * })
+ *
+ * if (result.success) {
+ *   console.log('Email sent:', result.messageId)
+ * } else {
+ *   console.error('Email failed:', result.error)
+ * }
+ * ```
+ */
+export declare function sendEmail(options: SendEmailOptions): Promise<SendEmailResult>;
+/**
+ * Send an email without waiting for the result (fire-and-forget).
+ *
+ * Use this when you don't want to block the main flow on email delivery.
+ * Errors are logged but not thrown.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmailAsync } from '@rovela/sdk/emails'
+ *
+ * // In a webhook handler - don't block on email
+ * sendEmailAsync({
+ *   to: 'customer@example.com',
+ *   subject: 'Order Shipped',
+ *   html: orderShippedHtml,
+ * })
+ *
+ * // Continue processing immediately
+ * return Response.json({ received: true })
+ * ```
+ */
+export declare function sendEmailAsync(options: SendEmailOptions): void;
+/**
+ * Send multiple emails in parallel.
+ *
+ * Returns results for all emails, even if some fail.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmailBatch } from '@rovela/sdk/emails'
+ *
+ * const results = await sendEmailBatch([
+ *   { to: 'user1@example.com', subject: 'Hello', html: '...' },
+ *   { to: 'user2@example.com', subject: 'Hello', html: '...' },
+ * ])
+ *
+ * const successful = results.filter(r => r.success).length
+ * console.log(`Sent ${successful}/${results.length} emails`)
+ * ```
+ */
+export declare function sendEmailBatch(emails: SendEmailOptions[]): Promise<SendEmailResult[]>;
+//# sourceMappingURL=sender.d.ts.map

package/dist/emails/sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../src/emails/sender.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAMhE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAmC1B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAI9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EAAE,GACzB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B"}

package/dist/emails/sender.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * @rovela/sdk/emails/sender
+ *
+ * Core email sending functionality using Resend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendEmail = sendEmail;
+exports.sendEmailAsync = sendEmailAsync;
+exports.sendEmailBatch = sendEmailBatch;
+const config_1 = require("./config");
+// =============================================================================
+// Email Sender
+// =============================================================================
+/**
+ * Send an email via Resend.
+ *
+ * This is the core sending function used by all email templates.
+ * It handles error catching and returns a result object.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmail } from '@rovela/sdk/emails'
+ *
+ * const result = await sendEmail({
+ *   to: 'customer@example.com',
+ *   subject: 'Order Confirmation',
+ *   html: '<html>...</html>',
+ * })
+ *
+ * if (result.success) {
+ *   console.log('Email sent:', result.messageId)
+ * } else {
+ *   console.error('Email failed:', result.error)
+ * }
+ * ```
+ */
+async function sendEmail(options) {
+    try {
+        const resend = (0, config_1.getResend)();
+        const from = (0, config_1.getFromEmail)();
+        const { data, error } = await resend.emails.send({
+            from,
+            to: options.to,
+            subject: options.subject,
+            html: options.html,
+            replyTo: options.replyTo || (0, config_1.getSupportEmail)(),
+        });
+        if (error) {
+            console.error('[Email] Resend error:', error);
+            return {
+                success: false,
+                error: error.message || 'Failed to send email',
+            };
+        }
+        console.log('[Email] Sent successfully:', data?.id, 'to:', options.to);
+        return {
+            success: true,
+            messageId: data?.id,
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : 'Unknown error sending email';
+        console.error('[Email] Exception:', errorMessage);
+        return {
+            success: false,
+            error: errorMessage,
+        };
+    }
+}
+/**
+ * Send an email without waiting for the result (fire-and-forget).
+ *
+ * Use this when you don't want to block the main flow on email delivery.
+ * Errors are logged but not thrown.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmailAsync } from '@rovela/sdk/emails'
+ *
+ * // In a webhook handler - don't block on email
+ * sendEmailAsync({
+ *   to: 'customer@example.com',
+ *   subject: 'Order Shipped',
+ *   html: orderShippedHtml,
+ * })
+ *
+ * // Continue processing immediately
+ * return Response.json({ received: true })
+ * ```
+ */
+function sendEmailAsync(options) {
+    sendEmail(options).catch((err) => {
+        console.error('[Email] Async send failed:', err);
+    });
+}
+/**
+ * Send multiple emails in parallel.
+ *
+ * Returns results for all emails, even if some fail.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmailBatch } from '@rovela/sdk/emails'
+ *
+ * const results = await sendEmailBatch([
+ *   { to: 'user1@example.com', subject: 'Hello', html: '...' },
+ *   { to: 'user2@example.com', subject: 'Hello', html: '...' },
+ * ])
+ *
+ * const successful = results.filter(r => r.success).length
+ * console.log(`Sent ${successful}/${results.length} emails`)
+ * ```
+ */
+async function sendEmailBatch(emails) {
+    return Promise.all(emails.map(sendEmail));
+}
+//# sourceMappingURL=sender.js.map

package/dist/emails/sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.js","sourceRoot":"","sources":["../../src/emails/sender.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAgCH,8BAqCC;AAuBD,wCAIC;AAoBD,wCAIC;AAtHD,qCAAmE;AAGnE,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,KAAK,UAAU,SAAS,CAC7B,OAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAA;QAC1B,MAAM,IAAI,GAAG,IAAA,qBAAY,GAAE,CAAA;QAE3B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YAC/C,IAAI;YACJ,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAA,wBAAe,GAAE;SAC9C,CAAC,CAAA;QAEF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAA;YAC7C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,sBAAsB;aAC/C,CAAA;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;QACtE,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,EAAE,EAAE;SACpB,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAChB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAA;QACpE,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAA;QACjD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,YAAY;SACpB,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,cAAc,CAAC,OAAyB;IACtD,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC/B,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,cAAc,CAClC,MAA0B;IAE1B,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAA;AAC3C,CAAC"}

package/dist/emails/templates/base.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @rovela/sdk/emails/templates/base
+ *
+ * Base email layout used by all email templates.
+ * Provides consistent styling and structure.
+ */
+import type { EmailConfig } from '../types';
+declare const STYLES: {
+    readonly fontFamily: "'Plus Jakarta Sans', system-ui, sans-serif";
+    readonly backgroundColor: "#F7F7F7";
+    readonly cardBackground: "#FFFFFF";
+    readonly cardBorder: "#E8DFD3";
+    readonly footerBackground: "#FBF8F5";
+    readonly primaryColor: "#0CAF7D";
+    readonly textPrimary: "#0A0A0A";
+    readonly textSecondary: "#78716C";
+    readonly textMuted: "#1C1917";
+};
+export interface BaseLayoutOptions {
+    config: EmailConfig;
+    title: string;
+    content: string;
+}
+/**
+ * Wrap email content in the base layout.
+ * All email templates should use this function.
+ *
+ * @example
+ * ```typescript
+ * const html = baseLayout({
+ *   config: emailConfig,
+ *   title: 'Order Confirmation',
+ *   content: '<h1>Thank you for your order!</h1>...',
+ * })
+ * ```
+ */
+export declare function baseLayout({ config, title, content }: BaseLayoutOptions): string;
+/**
+ * Render a primary CTA button.
+ */
+export declare function primaryButton(text: string, href: string): string;
+/**
+ * Render a heading (h1).
+ */
+export declare function heading(text: string): string;
+/**
+ * Render a paragraph of text.
+ */
+export declare function paragraph(text: string, marginBottom?: string): string;
+/**
+ * Render an info box (muted background).
+ */
+export declare function infoBox(content: string): string;
+/**
+ * Render a link with fallback text.
+ */
+export declare function linkFallback(href: string): string;
+/**
+ * Render a detail box with label-value pairs.
+ */
+export declare function detailBox(title: string, details: Array<{
+    label: string;
+    value: string;
+}>): string;
+/**
+ * Render a success status badge.
+ */
+export declare function statusBadge(text: string, emoji?: string): string;
+/**
+ * Render a labeled value row.
+ */
+export declare function labeledValue(label: string, value: string, options?: {
+    valueColor?: string;
+    valueSize?: string;
+    borderTop?: boolean;
+    borderBottom?: boolean;
+}): string;
+/**
+ * Render a two-column labeled value row.
+ */
+export declare function labeledValueRow(left: {
+    label: string;
+    value: string;
+}, right: {
+    label: string;
+    value: string;
+}, borderBottom?: boolean): string;
+/**
+ * Render a highlighted box (green tinted).
+ */
+export declare function highlightBox(content: string): string;
+/**
+ * Render a secondary/outline button.
+ */
+export declare function secondaryButton(text: string, href: string): string;
+/**
+ * Render address section.
+ */
+export declare function addressSection(title: string, addressHtml: string): string;
+/**
+ * Render a section heading.
+ */
+export declare function sectionHeading(text: string): string;
+export { STYLES };
+//# sourceMappingURL=base.d.ts.map

package/dist/emails/templates/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/emails/templates/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAO3C,QAAA,MAAM,MAAM;;;;;;;;;;CAUF,CAAA;AAoDV,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,MAAM,CA6BhF;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUhE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,GAAE,MAAe,GAAG,MAAM,CAE7E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/C,MAAM,CAiBR;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAahE;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;CAClB,GACL,MAAM,CAmBR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACtC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACvC,YAAY,CAAC,EAAE,OAAO,GACrB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAGD,OAAO,EAAE,MAAM,EAAE,CAAA"}