@warlock.js/core 4.0.5 → 4.0.10

package/esm/mail/mail.d.ts

@@ -0,0 +1,175 @@
+/// <reference types="node" />
+import type React from "react";
+import type { MailAddress, MailAttachment, MailConfigurations, MailEvents, MailOptions, MailPriority, MailResult } from "./types";
+/**
+ * Fluent Mail Builder
+ *
+ * Provides a chainable API for building and sending emails.
+ *
+ * @example
+ * ```typescript
+ * await Mail.to("user@example.com")
+ *   .subject("Welcome!")
+ *   .component(<WelcomeEmail name="John" />)
+ *   .send();
+ *
+ * // With attachments
+ * await Mail.to("user@example.com")
+ *   .cc("manager@example.com")
+ *   .subject("Invoice")
+ *   .component(<InvoiceEmail order={order} />)
+ *   .attach(pdfBuffer, "invoice.pdf")
+ *   .send();
+ *
+ * // Multi-tenant
+ * await Mail.config(tenant.mailSettings)
+ *   .to("user@example.com")
+ *   .subject("Hello")
+ *   .html("<p>World</p>")
+ *   .send();
+ * ```
+ */
+export declare class Mail {
+    private options;
+    /**
+     * Private constructor - use static factory methods
+     */
+    private constructor();
+    /**
+     * Create a new mail with recipient
+     */
+    static to(recipient: string | string[]): Mail;
+    /**
+     * Create a new mail with custom configuration (multi-tenant)
+     */
+    static config(config: MailConfigurations): Mail;
+    /**
+     * Create a new mail with named mailer
+     */
+    static mailer(name: string): Mail;
+    /**
+     * Set recipient(s)
+     */
+    to(recipient: string | string[]): this;
+    /**
+     * Set CC recipient(s)
+     */
+    cc(recipient: string | string[]): this;
+    /**
+     * Set BCC recipient(s)
+     */
+    bcc(recipient: string | string[]): this;
+    /**
+     * Set reply-to address
+     */
+    replyTo(address: string): this;
+    /**
+     * Set from address
+     */
+    from(address: MailAddress): this;
+    /**
+     * Set subject
+     */
+    subject(subject: string): this;
+    /**
+     * Set HTML content
+     */
+    html(content: string): this;
+    /**
+     * Set plain text content
+     */
+    text(content: string): this;
+    /**
+     * Set React component as content
+     */
+    component(element: React.ReactElement): this;
+    /**
+     * Add attachment
+     */
+    attach(content: Buffer | string, filename: string, contentType?: string): this;
+    /**
+     * Add multiple attachments
+     */
+    attachments(attachments: MailAttachment[]): this;
+    /**
+     * Attach a file by path
+     *
+     * The file will be read automatically when the email is sent.
+     *
+     * @param path Path to the file
+     * @param filename Optional custom filename (defaults to basename of path)
+     * @param contentType Optional MIME type
+     *
+     * @example
+     * ```typescript
+     * Mail.to("user@example.com")
+     *   .subject("Invoice")
+     *   .html("<p>Please see attached</p>")
+     *   .attachFile("./invoices/2024-001.pdf")
+     *   .attachFile("./terms.pdf", "terms-and-conditions.pdf")
+     *   .send();
+     * ```
+     */
+    attachFile(path: string, filename?: string, contentType?: string): this;
+    /**
+     * Set priority
+     */
+    priority(level: MailPriority): this;
+    /**
+     * Set custom headers
+     */
+    headers(headers: Record<string, string>): this;
+    /**
+     * Add a custom header
+     */
+    header(name: string, value: string): this;
+    /**
+     * Set tags for categorization
+     */
+    tags(tags: string[]): this;
+    /**
+     * Add a tag
+     */
+    tag(tag: string): this;
+    /**
+     * Set correlation ID for tracking
+     */
+    correlationId(id: string): this;
+    /**
+     * Set configuration (multi-tenant)
+     */
+    withConfig(config: MailConfigurations): this;
+    /**
+     * Set named mailer
+     */
+    withMailer(name: string): this;
+    /**
+     * Set beforeSending event handler
+     */
+    beforeSending(handler: MailEvents["beforeSending"]): this;
+    /**
+     * Set onSent event handler
+     */
+    onSent(handler: MailEvents["onSent"]): this;
+    /**
+     * Set onSuccess event handler
+     */
+    onSuccess(handler: MailEvents["onSuccess"]): this;
+    /**
+     * Set onError event handler
+     */
+    onError(handler: MailEvents["onError"]): this;
+    /**
+     * Get the built options (for debugging)
+     */
+    getOptions(): Partial<MailOptions>;
+    /**
+     * Validate the mail before sending
+     */
+    private validate;
+    /**
+     * Send the email
+     */
+    send(): Promise<MailResult>;
+}
+//# sourceMappingURL=mail.d.ts.map

package/esm/mail/mail.d.ts.map

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

package/esm/mail/mail.js

@@ -0,0 +1,286 @@
+import {sendMail}from'./send-mail.js';/**
+ * Fluent Mail Builder
+ *
+ * Provides a chainable API for building and sending emails.
+ *
+ * @example
+ * ```typescript
+ * await Mail.to("user@example.com")
+ *   .subject("Welcome!")
+ *   .component(<WelcomeEmail name="John" />)
+ *   .send();
+ *
+ * // With attachments
+ * await Mail.to("user@example.com")
+ *   .cc("manager@example.com")
+ *   .subject("Invoice")
+ *   .component(<InvoiceEmail order={order} />)
+ *   .attach(pdfBuffer, "invoice.pdf")
+ *   .send();
+ *
+ * // Multi-tenant
+ * await Mail.config(tenant.mailSettings)
+ *   .to("user@example.com")
+ *   .subject("Hello")
+ *   .html("<p>World</p>")
+ *   .send();
+ * ```
+ */
+class Mail {
+    options = {};
+    /**
+     * Private constructor - use static factory methods
+     */
+    constructor() { }
+    /**
+     * Create a new mail with recipient
+     */
+    static to(recipient) {
+        const mail = new Mail();
+        mail.options.to = recipient;
+        return mail;
+    }
+    /**
+     * Create a new mail with custom configuration (multi-tenant)
+     */
+    static config(config) {
+        const mail = new Mail();
+        mail.options.config = config;
+        return mail;
+    }
+    /**
+     * Create a new mail with named mailer
+     */
+    static mailer(name) {
+        const mail = new Mail();
+        mail.options.mailer = name;
+        return mail;
+    }
+    /**
+     * Set recipient(s)
+     */
+    to(recipient) {
+        this.options.to = recipient;
+        return this;
+    }
+    /**
+     * Set CC recipient(s)
+     */
+    cc(recipient) {
+        this.options.cc = recipient;
+        return this;
+    }
+    /**
+     * Set BCC recipient(s)
+     */
+    bcc(recipient) {
+        this.options.bcc = recipient;
+        return this;
+    }
+    /**
+     * Set reply-to address
+     */
+    replyTo(address) {
+        this.options.replyTo = address;
+        return this;
+    }
+    /**
+     * Set from address
+     */
+    from(address) {
+        this.options.from = address;
+        return this;
+    }
+    /**
+     * Set subject
+     */
+    subject(subject) {
+        this.options.subject = subject;
+        return this;
+    }
+    /**
+     * Set HTML content
+     */
+    html(content) {
+        this.options.html = content;
+        return this;
+    }
+    /**
+     * Set plain text content
+     */
+    text(content) {
+        this.options.text = content;
+        return this;
+    }
+    /**
+     * Set React component as content
+     */
+    component(element) {
+        this.options.component = element;
+        return this;
+    }
+    /**
+     * Add attachment
+     */
+    attach(content, filename, contentType) {
+        if (!this.options.attachments) {
+            this.options.attachments = [];
+        }
+        this.options.attachments.push({
+            filename,
+            content,
+            contentType,
+        });
+        return this;
+    }
+    /**
+     * Add multiple attachments
+     */
+    attachments(attachments) {
+        this.options.attachments = [...(this.options.attachments || []), ...attachments];
+        return this;
+    }
+    /**
+     * Attach a file by path
+     *
+     * The file will be read automatically when the email is sent.
+     *
+     * @param path Path to the file
+     * @param filename Optional custom filename (defaults to basename of path)
+     * @param contentType Optional MIME type
+     *
+     * @example
+     * ```typescript
+     * Mail.to("user@example.com")
+     *   .subject("Invoice")
+     *   .html("<p>Please see attached</p>")
+     *   .attachFile("./invoices/2024-001.pdf")
+     *   .attachFile("./terms.pdf", "terms-and-conditions.pdf")
+     *   .send();
+     * ```
+     */
+    attachFile(path, filename, contentType) {
+        if (!this.options.attachments) {
+            this.options.attachments = [];
+        }
+        // Extract filename from path if not provided
+        const resolvedFilename = filename || path.split(/[/\\]/).pop() || "attachment";
+        this.options.attachments.push({
+            path,
+            filename: resolvedFilename,
+            contentType,
+        });
+        return this;
+    }
+    /**
+     * Set priority
+     */
+    priority(level) {
+        this.options.priority = level;
+        return this;
+    }
+    /**
+     * Set custom headers
+     */
+    headers(headers) {
+        this.options.headers = { ...this.options.headers, ...headers };
+        return this;
+    }
+    /**
+     * Add a custom header
+     */
+    header(name, value) {
+        this.options.headers = { ...this.options.headers, [name]: value };
+        return this;
+    }
+    /**
+     * Set tags for categorization
+     */
+    tags(tags) {
+        this.options.tags = tags;
+        return this;
+    }
+    /**
+     * Add a tag
+     */
+    tag(tag) {
+        this.options.tags = [...(this.options.tags || []), tag];
+        return this;
+    }
+    /**
+     * Set correlation ID for tracking
+     */
+    correlationId(id) {
+        this.options.correlationId = id;
+        return this;
+    }
+    /**
+     * Set configuration (multi-tenant)
+     */
+    withConfig(config) {
+        this.options.config = config;
+        return this;
+    }
+    /**
+     * Set named mailer
+     */
+    withMailer(name) {
+        this.options.mailer = name;
+        return this;
+    }
+    /**
+     * Set beforeSending event handler
+     */
+    beforeSending(handler) {
+        this.options.beforeSending = handler;
+        return this;
+    }
+    /**
+     * Set onSent event handler
+     */
+    onSent(handler) {
+        this.options.onSent = handler;
+        return this;
+    }
+    /**
+     * Set onSuccess event handler
+     */
+    onSuccess(handler) {
+        this.options.onSuccess = handler;
+        return this;
+    }
+    /**
+     * Set onError event handler
+     */
+    onError(handler) {
+        this.options.onError = handler;
+        return this;
+    }
+    /**
+     * Get the built options (for debugging)
+     */
+    getOptions() {
+        return { ...this.options };
+    }
+    /**
+     * Validate the mail before sending
+     */
+    validate() {
+        if (!this.options.to) {
+            throw new Error("Mail recipient (to) is required");
+        }
+        if (!this.options.subject) {
+            throw new Error("Mail subject is required");
+        }
+        if (!this.options.html && !this.options.text && !this.options.component) {
+            throw new Error("Mail content (html, text, or component) is required");
+        }
+    }
+    /**
+     * Send the email
+     */
+    async send() {
+        this.validate();
+        return sendMail(this.options);
+    }
+}export{Mail};//# sourceMappingURL=mail.js.map

package/esm/mail/mail.js.map

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

package/esm/mail/mailer-pool.d.ts

@@ -0,0 +1,26 @@
+import { type Transporter } from "nodemailer";
+import type { MailConfigurations } from "./types";
+/**
+ * Get or create a mailer transporter from the pool
+ */
+export declare function getMailer(config: MailConfigurations): Transporter;
+/**
+ * Verify a mailer connection
+ */
+export declare function verifyMailer(config: MailConfigurations): Promise<boolean>;
+/**
+ * Close a specific mailer connection
+ */
+export declare function closeMailer(config: MailConfigurations): void;
+/**
+ * Close all mailer connections
+ */
+export declare function closeAllMailers(): void;
+/**
+ * Get pool statistics
+ */
+export declare function getPoolStats(): {
+    size: number;
+    hashes: string[];
+};
+//# sourceMappingURL=mailer-pool.d.ts.map

package/esm/mail/mailer-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailer-pool.d.ts","sourceRoot":"","sources":["../../src/mail/mailer-pool.ts"],"names":[],"mappings":"AACA,OAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAgClD;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,WAAW,CA4BjE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAS/E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAS5D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAOtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAKjE"}

package/esm/mail/mailer-pool.js

@@ -0,0 +1,95 @@
+import {log}from'@warlock.js/logger';import nodemailer from'nodemailer';/**
+ * Mailer pool for connection reuse
+ * Maps config hash to transporter instance
+ */
+const mailerPool = new Map();
+/**
+ * Create a hash from mail configuration for pooling
+ */
+function createConfigHash(config) {
+    const key = JSON.stringify({
+        host: config.host,
+        port: config.port,
+        secure: config.secure,
+        auth: config.auth,
+        username: config.username,
+        password: config.password,
+    });
+    // Simple hash function
+    let hash = 0;
+    for (let i = 0; i < key.length; i++) {
+        const char = key.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash;
+    }
+    return `mailer_${hash}`;
+}
+/**
+ * Get or create a mailer transporter from the pool
+ */
+function getMailer(config) {
+    const hash = createConfigHash(config);
+    // Return existing transporter if available
+    let transporter = mailerPool.get(hash);
+    if (transporter) {
+        return transporter;
+    }
+    // Create new transporter
+    log.info("mail", "pool", `Creating new mailer transport (pool size: ${mailerPool.size + 1})`);
+    const { auth, username, password, requireTLS, tls, ...transportConfig } = config;
+    transporter = nodemailer.createTransport({
+        requireTLS: requireTLS ?? tls,
+        auth: auth ?? {
+            user: username,
+            pass: password,
+        },
+        ...transportConfig,
+    });
+    // Store in pool
+    mailerPool.set(hash, transporter);
+    return transporter;
+}
+/**
+ * Verify a mailer connection
+ */
+async function verifyMailer(config) {
+    const transporter = getMailer(config);
+    try {
+        await transporter.verify();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Close a specific mailer connection
+ */
+function closeMailer(config) {
+    const hash = createConfigHash(config);
+    const transporter = mailerPool.get(hash);
+    if (transporter) {
+        transporter.close();
+        mailerPool.delete(hash);
+        log.info("mail", "pool", `Closed mailer transport (pool size: ${mailerPool.size})`);
+    }
+}
+/**
+ * Close all mailer connections
+ */
+function closeAllMailers() {
+    for (const [hash, transporter] of mailerPool) {
+        transporter.close();
+        mailerPool.delete(hash);
+    }
+    log.info("mail", "pool", "Closed all mailer transports");
+}
+/**
+ * Get pool statistics
+ */
+function getPoolStats() {
+    return {
+        size: mailerPool.size,
+        hashes: Array.from(mailerPool.keys()),
+    };
+}export{closeAllMailers,closeMailer,getMailer,getPoolStats,verifyMailer};//# sourceMappingURL=mailer-pool.js.map

package/esm/mail/mailer-pool.js.map

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

package/esm/mail/react-mail.d.ts

@@ -1,3 +1,6 @@
 import type React from "react";
-export declare function renderReactMail(reactElement: React.ReactElement | React.ComponentType): string;
+/**
+ * Render a React element to HTML for email
+ */
+export declare function renderReactMail(element: React.ReactElement | React.ComponentType): string;
 //# sourceMappingURL=react-mail.d.ts.map

package/esm/mail/react-mail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-mail.d.ts","sourceRoot":"","sources":["../../src/mail/react-mail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqB/B,wBAAgB,eAAe,CAC7B,YAAY,EAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,aAAa,UAKvD"}
+{"version":3,"file":"react-mail.d.ts","sourceRoot":"","sources":["../../src/mail/react-mail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAwB/B;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,aAAa,GAAG,MAAM,CAIzF"}

package/esm/mail/react-mail.js

@@ -1,4 +1,7 @@
-import {renderReact}from'../react/index.js';function createHtmlPage(html) {
+import {renderReact}from'../react/index.js';/**
+ * Create a complete HTML page from rendered content
+ */
+function createHtmlPage(html) {
     const styles = [];
     const links = [];
     const body = html.replace(/<style.*?<\/style>|<link.*?>/gims, (match) => {
@@ -13,7 +16,10 @@ import {renderReact}from'../react/index.js';function createHtmlPage(html) {
     const head = `<head>${links.join("")}${styles.join("")}</head>`;
     return `<!doctype html><html>${head}<body>${body}</body></html>`;
 }
-function renderReactMail(reactElement) {
-    const content = renderReact(reactElement);
+/**
+ * Render a React element to HTML for email
+ */
+function renderReactMail(element) {
+    const content = renderReact(element);
     return createHtmlPage(content);
 }export{renderReactMail};//# sourceMappingURL=react-mail.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"react-mail.js","sources":["../../src/mail/react-mail.ts"],"sourcesContent":[null],"names":[],"mappings":"4CAGA,SAAS,cAAc,CAAC,IAAY,EAAA;IAClC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CACvB,kCAAkC,EAClC,CAAC,KAAa,KAAI;AAChB,QAAA,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;AAC9B,YAAA,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpB,SAAA;AAAM,aAAA;AACL,YAAA,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnB,SAAA;AACD,QAAA,OAAO,EAAE,CAAC;AACZ,KAAC,CACF,CAAC;AACF,IAAA,MAAM,IAAI,GAAG,CAAA,MAAA,EAAS,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA,EAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC;AAChE,IAAA,OAAO,CAAwB,qBAAA,EAAA,IAAI,CAAS,MAAA,EAAA,IAAI,gBAAgB,CAAC;AACnE,CAAC;AAEK,SAAU,eAAe,CAC7B,YAAsD,EAAA;AAEtD,IAAA,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAE1C,IAAA,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC"}
+{"version":3,"file":"react-mail.js","sources":["../../src/mail/react-mail.ts"],"sourcesContent":[null],"names":[],"mappings":"4CAGA;;AAEG;AACH,SAAS,cAAc,CAAC,IAAY,EAAA;IAClC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kCAAkC,EAAE,CAAC,KAAa,KAAI;AAC9E,QAAA,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;AAC9B,YAAA,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpB,SAAA;AAAM,aAAA;AACL,YAAA,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnB,SAAA;AACD,QAAA,OAAO,EAAE,CAAC;AACZ,KAAC,CAAC,CAAC;AAEH,IAAA,MAAM,IAAI,GAAG,CAAA,MAAA,EAAS,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA,EAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC;AAEhE,IAAA,OAAO,CAAwB,qBAAA,EAAA,IAAI,CAAS,MAAA,EAAA,IAAI,gBAAgB,CAAC;AACnE,CAAC;AAED;;AAEG;AACG,SAAU,eAAe,CAAC,OAAiD,EAAA;AAC/E,IAAA,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAErC,IAAA,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC"}

package/esm/mail/send-mail.d.ts

@@ -0,0 +1,33 @@
+import { type MailOptions, type MailResult } from "./types";
+/**
+ * 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: "..." });
+ * ```
+ */
+export declare function sendMail(options: MailOptions): Promise<MailResult>;
+//# sourceMappingURL=send-mail.d.ts.map

package/esm/mail/send-mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-mail.d.ts","sourceRoot":"","sources":["../../src/mail/send-mail.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,WAAW,EAEhB,KAAK,UAAU,EAEhB,MAAM,SAAS,CAAC;AAwMjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA8JxE"}