@warlock.js/core 4.0.6 → 4.0.10

package/esm/mail/send-mail.js

@@ -0,0 +1,309 @@
+import {log}from'@warlock.js/logger';import {readFile}from'node:fs/promises';import {isTestMode,isDevelopmentMode,resolveMailConfig}from'./config.js';import {generateMailId,mailEvents}from'./events.js';import {getMailer}from'./mailer-pool.js';import {renderReactMail}from'./react-mail.js';import {captureMail}from'./test-mailbox.js';import {MailError}from'./types.js';/**
+ * Normalize email address to string
+ */
+function addressToString(address) {
+    if (typeof address === "string") {
+        return address;
+    }
+    return `"${address.name}" <${address.address}>`;
+}
+/**
+ * Normalize recipients to array
+ */
+function normalizeRecipients(recipients) {
+    if (!recipients) {
+        return [];
+    }
+    return Array.isArray(recipients) ? recipients : [recipients];
+}
+/**
+ * Map priority to nodemailer format
+ */
+function mapPriority(priority) {
+    return priority;
+}
+/**
+ * Normalize mail options to internal format
+ */
+function normalizeMail(options) {
+    const config = resolveMailConfig(options);
+    return {
+        to: normalizeRecipients(options.to),
+        cc: normalizeRecipients(options.cc),
+        bcc: normalizeRecipients(options.bcc),
+        replyTo: options.replyTo,
+        from: options.from || config.from || { name: "No Reply", address: "noreply@localhost" },
+        subject: options.subject,
+        html: options.html,
+        text: options.text,
+        attachments: options.attachments || [],
+        priority: options.priority || "normal",
+        headers: options.headers || {},
+        tags: options.tags || [],
+        correlationId: options.correlationId,
+    };
+}
+/**
+ * Resolve attachment - read file if path is provided
+ */
+async function resolveAttachment(attachment) {
+    // If path is provided, read the file
+    if (attachment.path) {
+        try {
+            const content = await readFile(attachment.path);
+            return {
+                filename: attachment.filename,
+                content,
+                contentType: attachment.contentType,
+                encoding: attachment.encoding,
+                cid: attachment.cid,
+            };
+        }
+        catch (error) {
+            throw new MailError(`Failed to read attachment file "${attachment.path}": ${error instanceof Error ? error.message : "Unknown error"}`, "CONFIG_ERROR", error instanceof Error ? error : undefined);
+        }
+    }
+    // Already has content
+    return {
+        filename: attachment.filename,
+        content: attachment.content,
+        contentType: attachment.contentType,
+        encoding: attachment.encoding,
+        cid: attachment.cid,
+    };
+}
+/**
+ * Build nodemailer options from normalized mail
+ */
+async function buildNodemailerOptions(normalized) {
+    const options = {
+        to: normalized.to,
+        from: addressToString(normalized.from),
+        subject: normalized.subject,
+        priority: mapPriority(normalized.priority),
+    };
+    if (normalized.cc.length > 0) {
+        options.cc = normalized.cc;
+    }
+    if (normalized.bcc.length > 0) {
+        options.bcc = normalized.bcc;
+    }
+    if (normalized.replyTo) {
+        options.replyTo = normalized.replyTo;
+    }
+    if (normalized.html) {
+        options.html = normalized.html;
+    }
+    if (normalized.text) {
+        options.text = normalized.text;
+    }
+    if (normalized.attachments.length > 0) {
+        // Resolve all attachments (read files if needed)
+        const resolvedAttachments = await Promise.all(normalized.attachments.map((att) => resolveAttachment(att)));
+        options.attachments = resolvedAttachments.map((att) => ({
+            filename: att.filename,
+            content: att.content,
+            contentType: att.contentType,
+            encoding: att.encoding,
+            cid: att.cid,
+        }));
+    }
+    if (Object.keys(normalized.headers).length > 0) {
+        options.headers = normalized.headers;
+    }
+    return options;
+}
+/**
+ * Run per-mail event handler
+ */
+async function runMailEvent(handler, ...args) {
+    if (!handler) {
+        return undefined;
+    }
+    try {
+        return await handler(...args);
+    }
+    catch (error) {
+        log.error("mail", "event", `Per-mail event handler error: ${error}`);
+        return undefined;
+    }
+}
+/**
+ * Trigger both global and mail-specific events
+ */
+async function triggerEvents(mailId, event, ...args) {
+    try {
+        // Trigger global event (e.g., mail.success)
+        const globalEventName = event === "beforeSending"
+            ? "BEFORE_SENDING"
+            : event === "sent"
+                ? "SENT"
+                : event === "success"
+                    ? "SUCCESS"
+                    : "ERROR";
+        const globalResults = await mailEvents.trigger(globalEventName, ...args);
+        // Trigger mail-specific event (e.g., mail.$id.success)
+        const specificResults = await mailEvents.triggerForMail(mailId, event, ...args);
+        return [...globalResults, ...specificResults];
+    }
+    catch (error) {
+        log.error("mail", "event", `Event handler error: ${error}`);
+        return [];
+    }
+}
+/**
+ * Send an email
+ *
+ * @param options Mail options including recipients, content, and configuration
+ * @returns Result containing success status, message ID, and accepted/rejected recipients
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * await sendMail({
+ *   to: "user@example.com",
+ *   subject: "Hello",
+ *   html: "<p>World</p>",
+ * });
+ *
+ * // With React component
+ * await sendMail({
+ *   to: "user@example.com",
+ *   subject: "Welcome!",
+ *   component: <WelcomeEmail name="John" />,
+ * });
+ *
+ * // Track specific mail with events
+ * const mailId = generateMailId();
+ * mailEvents.onMailSuccess(mailId, (mail, result) => {
+ *   console.log("This specific mail was sent!");
+ * });
+ * await sendMail({ id: mailId, to: "...", subject: "...", html: "..." });
+ * ```
+ */
+async function sendMail(options) {
+    // Generate or use provided mail ID
+    const mailId = options.id || generateMailId();
+    // Render React component if provided
+    if (options.component) {
+        try {
+            options.html = renderReactMail(options.component);
+        }
+        catch (error) {
+            const mailError = new MailError(`Failed to render React component: ${error instanceof Error ? error.message : "Unknown error"}`, "RENDER_ERROR", error instanceof Error ? error : undefined);
+            await runMailEvent(options.onError, options, mailError);
+            await triggerEvents(mailId, "error", options, mailError);
+            throw mailError;
+        }
+    }
+    // Normalize mail
+    const normalized = normalizeMail(options);
+    // Run beforeSending event (per-mail, global, and mail-specific)
+    const beforeResult = await runMailEvent(options.beforeSending, options);
+    const globalBeforeResults = await triggerEvents(mailId, "beforeSending", options);
+    // If any returns false, cancel sending
+    if (beforeResult === false || globalBeforeResults.some((r) => r === false)) {
+        log.info("mail", "cancelled", "Mail sending cancelled by beforeSending event");
+        const result = {
+            success: false,
+            accepted: [],
+            rejected: normalized.to,
+            response: "Cancelled by beforeSending event",
+        };
+        return result;
+    }
+    // Test mode - capture without sending
+    if (isTestMode()) {
+        log.info("mail", "test", `[TEST MODE] Captured mail to: ${normalized.to.join(", ")}`);
+        const result = {
+            success: true,
+            messageId: `test-${mailId}@localhost`,
+            accepted: normalized.to,
+            rejected: [],
+            response: "Test mode - mail captured",
+        };
+        const captured = {
+            options,
+            normalized,
+            timestamp: new Date(),
+            result,
+        };
+        captureMail(captured);
+        await runMailEvent(options.onSuccess, options, result);
+        await triggerEvents(mailId, "success", options, result);
+        await runMailEvent(options.onSent, options, result, null);
+        await triggerEvents(mailId, "sent", options, result, null);
+        return result;
+    }
+    // Development mode - log without sending
+    if (isDevelopmentMode()) {
+        log.info("mail", "dev", `[DEV MODE] Would send mail to: ${normalized.to.join(", ")}`);
+        log.info("mail", "dev", `Subject: ${normalized.subject}`);
+        if (normalized.html) {
+            log.info("mail", "dev", `HTML length: ${normalized.html.length} chars`);
+        }
+        const result = {
+            success: true,
+            messageId: `dev-${mailId}@localhost`,
+            accepted: normalized.to,
+            rejected: [],
+            response: "Development mode - mail logged",
+        };
+        await runMailEvent(options.onSuccess, options, result);
+        await triggerEvents(mailId, "success", options, result);
+        await runMailEvent(options.onSent, options, result, null);
+        await triggerEvents(mailId, "sent", options, result, null);
+        return result;
+    }
+    // Production mode - actually send
+    try {
+        const config = resolveMailConfig(options);
+        const mailer = getMailer(config);
+        const nodemailerOptions = await buildNodemailerOptions(normalized);
+        log.info("mail", "send", `Sending mail to: ${normalized.to.join(", ")}`);
+        const output = await mailer.sendMail(nodemailerOptions);
+        const result = {
+            success: output.accepted.length > 0,
+            messageId: output.messageId,
+            accepted: output.accepted,
+            rejected: output.rejected,
+            response: output.response,
+            envelope: output.envelope,
+        };
+        if (result.success) {
+            log.success("mail", "sent", `Mail sent successfully (ID: ${result.messageId})`);
+            await runMailEvent(options.onSuccess, options, result);
+            await triggerEvents(mailId, "success", options, result);
+        }
+        else {
+            log.warn("mail", "partial", `Mail partially rejected: ${result.rejected.join(", ")}`);
+        }
+        await runMailEvent(options.onSent, options, result, null);
+        await triggerEvents(mailId, "sent", options, result, null);
+        return result;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        let code = "UNKNOWN";
+        // Detect error type
+        if (errorMessage.includes("ECONNREFUSED") || errorMessage.includes("ENOTFOUND")) {
+            code = "CONNECTION_ERROR";
+        }
+        else if (errorMessage.includes("authentication") || errorMessage.includes("auth")) {
+            code = "AUTH_ERROR";
+        }
+        else if (errorMessage.includes("timeout") || errorMessage.includes("ETIMEDOUT")) {
+            code = "TIMEOUT";
+        }
+        else if (errorMessage.includes("rate") || errorMessage.includes("limit")) {
+            code = "RATE_LIMIT";
+        }
+        const mailError = new MailError(`Failed to send mail: ${errorMessage}`, code, error instanceof Error ? error : undefined);
+        log.error("mail", "error", mailError.message);
+        await runMailEvent(options.onError, options, mailError);
+        await triggerEvents(mailId, "error", options, mailError);
+        await runMailEvent(options.onSent, options, null, mailError);
+        await triggerEvents(mailId, "sent", options, null, mailError);
+        throw mailError;
+    }
+}export{sendMail};//# sourceMappingURL=send-mail.js.map

package/esm/mail/send-mail.js.map

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

package/esm/mail/test-mailbox.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Test Mailbox for Mail v2
+ *
+ * Provides utilities for capturing and asserting sent emails in test mode.
+ *
+ * ## Setup
+ *
+ * ```typescript
+ * import { setMailMode, clearTestMailbox } from "@warlock.js/core/mail/v2";
+ *
+ * beforeEach(() => {
+ *   setMailMode("test");
+ *   clearTestMailbox();
+ * });
+ * ```
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { sendMail, getTestMailbox, findMailsTo } from "@warlock.js/core/mail/v2";
+ *
+ * // Send email in test mode
+ * await sendMail({
+ *   to: "user@example.com",
+ *   subject: "Welcome!",
+ *   html: "<p>Hello</p>",
+ * });
+ *
+ * // Get all captured mails
+ * const mails = getTestMailbox();
+ * expect(mails).toHaveLength(1);
+ * expect(mails[0].options.subject).toBe("Welcome!");
+ *
+ * // Find specific mails
+ * const userMails = findMailsTo("user@example.com");
+ * expect(userMails).toHaveLength(1);
+ *
+ * // Check if mail was sent
+ * expect(wasMailSentTo("user@example.com")).toBe(true);
+ * expect(wasMailSentWithSubject("Welcome!")).toBe(true);
+ * ```
+ *
+ * ## Assertion Helpers
+ *
+ * ```typescript
+ * // Assert a mail matching a predicate was sent
+ * const mail = assertMailSent(m => m.options.to === "user@example.com");
+ * expect(mail.options.subject).toBe("Welcome!");
+ *
+ * // Assert exact count
+ * assertMailCount(2); // throws if count doesn't match
+ * ```
+ *
+ * ## Captured Mail Structure
+ *
+ * Each captured mail contains:
+ * - `options` - Original MailOptions passed to sendMail
+ * - `normalized` - Normalized mail data (arrays, addresses resolved)
+ * - `timestamp` - When the mail was captured
+ * - `result` - MailResult (in test mode, always success)
+ * - `error` - MailError if sending failed (null in test mode)
+ *
+ * @module test-mailbox
+ */
+import type { CapturedMail } from "./types";
+/**
+ * Add a mail to the test mailbox
+ */
+export declare function captureMail(mail: CapturedMail): void;
+/**
+ * Get all captured mails
+ */
+export declare function getTestMailbox(): CapturedMail[];
+/**
+ * Get the last captured mail
+ */
+export declare function getLastMail(): CapturedMail | undefined;
+/**
+ * Find mails by recipient
+ */
+export declare function findMailsTo(email: string): CapturedMail[];
+/**
+ * Find mails by subject (partial match)
+ */
+export declare function findMailsBySubject(subject: string): CapturedMail[];
+/**
+ * Check if a mail was sent to a specific recipient
+ */
+export declare function wasMailSentTo(email: string): boolean;
+/**
+ * Check if a mail with specific subject was sent
+ */
+export declare function wasMailSentWithSubject(subject: string): boolean;
+/**
+ * Get mailbox size
+ */
+export declare function getMailboxSize(): number;
+/**
+ * Clear the test mailbox
+ */
+export declare function clearTestMailbox(): void;
+/**
+ * Assert helper for testing
+ */
+export declare function assertMailSent(predicate: (mail: CapturedMail) => boolean): CapturedMail;
+/**
+ * Assert that a specific number of mails were sent
+ */
+export declare function assertMailCount(count: number): void;
+//# sourceMappingURL=test-mailbox.d.ts.map

package/esm/mail/test-mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-mailbox.d.ts","sourceRoot":"","sources":["../../src/mail/test-mailbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAO5C;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAE/C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,YAAY,GAAG,SAAS,CAEtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAKzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAElE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,GAAG,YAAY,CAQvF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAInD"}

package/esm/mail/test-mailbox.js

@@ -0,0 +1,143 @@
+/**
+ * Test Mailbox for Mail v2
+ *
+ * Provides utilities for capturing and asserting sent emails in test mode.
+ *
+ * ## Setup
+ *
+ * ```typescript
+ * import { setMailMode, clearTestMailbox } from "@warlock.js/core/mail/v2";
+ *
+ * beforeEach(() => {
+ *   setMailMode("test");
+ *   clearTestMailbox();
+ * });
+ * ```
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { sendMail, getTestMailbox, findMailsTo } from "@warlock.js/core/mail/v2";
+ *
+ * // Send email in test mode
+ * await sendMail({
+ *   to: "user@example.com",
+ *   subject: "Welcome!",
+ *   html: "<p>Hello</p>",
+ * });
+ *
+ * // Get all captured mails
+ * const mails = getTestMailbox();
+ * expect(mails).toHaveLength(1);
+ * expect(mails[0].options.subject).toBe("Welcome!");
+ *
+ * // Find specific mails
+ * const userMails = findMailsTo("user@example.com");
+ * expect(userMails).toHaveLength(1);
+ *
+ * // Check if mail was sent
+ * expect(wasMailSentTo("user@example.com")).toBe(true);
+ * expect(wasMailSentWithSubject("Welcome!")).toBe(true);
+ * ```
+ *
+ * ## Assertion Helpers
+ *
+ * ```typescript
+ * // Assert a mail matching a predicate was sent
+ * const mail = assertMailSent(m => m.options.to === "user@example.com");
+ * expect(mail.options.subject).toBe("Welcome!");
+ *
+ * // Assert exact count
+ * assertMailCount(2); // throws if count doesn't match
+ * ```
+ *
+ * ## Captured Mail Structure
+ *
+ * Each captured mail contains:
+ * - `options` - Original MailOptions passed to sendMail
+ * - `normalized` - Normalized mail data (arrays, addresses resolved)
+ * - `timestamp` - When the mail was captured
+ * - `result` - MailResult (in test mode, always success)
+ * - `error` - MailError if sending failed (null in test mode)
+ *
+ * @module test-mailbox
+ */
+/**
+ * Test mailbox for capturing sent emails in test mode
+ */
+let testMailbox = [];
+/**
+ * Add a mail to the test mailbox
+ */
+function captureMail(mail) {
+    testMailbox.push(mail);
+}
+/**
+ * Get all captured mails
+ */
+function getTestMailbox() {
+    return [...testMailbox];
+}
+/**
+ * Get the last captured mail
+ */
+function getLastMail() {
+    return testMailbox[testMailbox.length - 1];
+}
+/**
+ * Find mails by recipient
+ */
+function findMailsTo(email) {
+    return testMailbox.filter((mail) => {
+        const to = Array.isArray(mail.options.to) ? mail.options.to : [mail.options.to];
+        return to.includes(email);
+    });
+}
+/**
+ * Find mails by subject (partial match)
+ */
+function findMailsBySubject(subject) {
+    return testMailbox.filter((mail) => mail.options.subject.includes(subject));
+}
+/**
+ * Check if a mail was sent to a specific recipient
+ */
+function wasMailSentTo(email) {
+    return findMailsTo(email).length > 0;
+}
+/**
+ * Check if a mail with specific subject was sent
+ */
+function wasMailSentWithSubject(subject) {
+    return testMailbox.some((mail) => mail.options.subject === subject);
+}
+/**
+ * Get mailbox size
+ */
+function getMailboxSize() {
+    return testMailbox.length;
+}
+/**
+ * Clear the test mailbox
+ */
+function clearTestMailbox() {
+    testMailbox = [];
+}
+/**
+ * Assert helper for testing
+ */
+function assertMailSent(predicate) {
+    const mail = testMailbox.find(predicate);
+    if (!mail) {
+        throw new Error("No mail matching the predicate was found in the test mailbox");
+    }
+    return mail;
+}
+/**
+ * Assert that a specific number of mails were sent
+ */
+function assertMailCount(count) {
+    if (testMailbox.length !== count) {
+        throw new Error(`Expected ${count} mails to be sent, but found ${testMailbox.length}`);
+    }
+}export{assertMailCount,assertMailSent,captureMail,clearTestMailbox,findMailsBySubject,findMailsTo,getLastMail,getMailboxSize,getTestMailbox,wasMailSentTo,wasMailSentWithSubject};//# sourceMappingURL=test-mailbox.js.map

package/esm/mail/test-mailbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-mailbox.js","sources":["../../src/mail/test-mailbox.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DG;AAIH;;AAEG;AACH,IAAI,WAAW,GAAmB,EAAE,CAAC;AAErC;;AAEG;AACG,SAAU,WAAW,CAAC,IAAkB,EAAA;AAC5C,IAAA,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;AAEG;SACa,cAAc,GAAA;AAC5B,IAAA,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;AAC1B,CAAC;AAED;;AAEG;SACa,WAAW,GAAA;IACzB,OAAO,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;AAEG;AACG,SAAU,WAAW,CAAC,KAAa,EAAA;AACvC,IAAA,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,KAAI;AACjC,QAAA,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAChF,QAAA,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5B,KAAC,CAAC,CAAC;AACL,CAAC;AAED;;AAEG;AACG,SAAU,kBAAkB,CAAC,OAAe,EAAA;IAChD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;AAEG;AACG,SAAU,aAAa,CAAC,KAAa,EAAA;IACzC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;AAEG;AACG,SAAU,sBAAsB,CAAC,OAAe,EAAA;AACpD,IAAA,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;AACtE,CAAC;AAED;;AAEG;SACa,cAAc,GAAA;IAC5B,OAAO,WAAW,CAAC,MAAM,CAAC;AAC5B,CAAC;AAED;;AAEG;SACa,gBAAgB,GAAA;IAC9B,WAAW,GAAG,EAAE,CAAC;AACnB,CAAC;AAED;;AAEG;AACG,SAAU,cAAc,CAAC,SAA0C,EAAA;IACvE,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEzC,IAAI,CAAC,IAAI,EAAE;AACT,QAAA,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;AACjF,KAAA;AAED,IAAA,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;AAEG;AACG,SAAU,eAAe,CAAC,KAAa,EAAA;AAC3C,IAAA,IAAI,WAAW,CAAC,MAAM,KAAK,KAAK,EAAE;QAChC,MAAM,IAAI,KAAK,CAAC,CAAY,SAAA,EAAA,KAAK,CAAgC,6BAAA,EAAA,WAAW,CAAC,MAAM,CAAE,CAAA,CAAC,CAAC;AACxF,KAAA;AACH"}