@struktoai/mirage-node 0.0.5-alpha.1 → 0.0.6

package/dist/core/disk/watch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/disk/watch/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/dist/core/disk/watch/walk.d.ts

@@ -0,0 +1,22 @@
+import type { PathSpec, WalkEntry } from '@struktoai/mirage-core/types';
+import { type DeltaHook } from '@struktoai/mirage-core/watch/index';
+import type { DiskAccessor } from '../../../accessor/disk.ts';
+/**
+ * Recursive directory walk feeding the generic listing differ.
+ *
+ * Reads the filesystem directly, never through mirage's caches, as the
+ * DeltaHook contract requires. Fingerprints on mtime, the same value `disk`
+ * stat reports, so an editor that rewrites identical bytes still registers as
+ * an UPDATE. That is the local filesystem's own resolution, not a mirage
+ * choice: nothing cheaper than hashing every file can tell those two apart.
+ *
+ * Symlinks are not followed, matching every other disk walk in the repo and
+ * keeping a link loop from hanging the poll.
+ */
+export declare class DiskWalk {
+    private readonly accessor;
+    constructor(accessor: DiskAccessor);
+    walk(root: PathSpec): AsyncGenerator<WalkEntry>;
+}
+export declare function buildDeltaHook(accessor: DiskAccessor): DeltaHook;
+//# sourceMappingURL=walk.d.ts.map

package/dist/core/disk/watch/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../../../src/core/disk/watch/walk.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAEvE,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,oCAAoC,CAAA;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAgD7D;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;gBAE3B,QAAQ,EAAE,YAAY;IAI3B,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC;CAUvD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAGhE"}

package/dist/core/disk/watch/walk.js

@@ -0,0 +1,100 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { ListingDeltaHook, statFingerprint, } from '@struktoai/mirage-core/watch/index';
+import { lstat, readdir } from 'node:fs/promises';
+import path from 'node:path';
+import { resolveSafe } from "../utils.js";
+async function* descend(root, full) {
+    let listing;
+    try {
+        listing = await readdir(full, { withFileTypes: true });
+    }
+    catch (error) {
+        // Absence is the one error a walk may swallow: the directory went
+        // away between the parent listing and this one, and the next pull
+        // reports the DELETE from the snapshot diff. Anything else (EACCES,
+        // EIO) means the subtree is unreadable, not empty, and returning
+        // here would diff a partial listing into a DELETE for every child
+        // plus a CREATE for each when access came back. Aborting the pull
+        // keeps the prior checkpoint, which is what IncompleteWalkError
+        // exists to protect.
+        if (error.code !== 'ENOENT')
+            throw error;
+        return;
+    }
+    for (const entry of listing) {
+        const child = path.join(full, entry.name);
+        const virtual = '/' + path.relative(root, child).split(path.sep).join('/');
+        if (entry.isDirectory()) {
+            yield { virtual, isDir: true, fingerprint: null };
+            yield* descend(root, child);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        let info;
+        try {
+            info = await lstat(child);
+        }
+        catch (error) {
+            // Same rule one entry down: a vanished file is a DELETE the next
+            // pull reports, an unreadable one is not.
+            if (error.code !== 'ENOENT')
+                throw error;
+            continue;
+        }
+        const modified = info.mtime.toISOString();
+        yield {
+            virtual,
+            isDir: false,
+            fingerprint: statFingerprint(null, modified, info.size),
+            size: info.size,
+            modified,
+        };
+    }
+}
+/**
+ * Recursive directory walk feeding the generic listing differ.
+ *
+ * Reads the filesystem directly, never through mirage's caches, as the
+ * DeltaHook contract requires. Fingerprints on mtime, the same value `disk`
+ * stat reports, so an editor that rewrites identical bytes still registers as
+ * an UPDATE. That is the local filesystem's own resolution, not a mirage
+ * choice: nothing cheaper than hashing every file can tell those two apart.
+ *
+ * Symlinks are not followed, matching every other disk walk in the repo and
+ * keeping a link loop from hanging the poll.
+ */
+export class DiskWalk {
+    accessor;
+    constructor(accessor) {
+        this.accessor = accessor;
+    }
+    async *walk(root) {
+        const prefix = mountPrefixOf(root.virtual, root.resourcePath);
+        const start = resolveSafe(this.accessor.root, root.mountPath);
+        for await (const entry of descend(this.accessor.root, start)) {
+            yield {
+                ...entry,
+                virtual: prefix !== '' ? `${prefix}${entry.virtual}` : entry.virtual,
+            };
+        }
+    }
+}
+export function buildDeltaHook(accessor) {
+    const walk = new DiskWalk(accessor);
+    return new ListingDeltaHook(walk.walk.bind(walk));
+}
+//# sourceMappingURL=walk.js.map

package/dist/core/disk/watch/walk.js.map

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

package/dist/core/disk/write.d.ts

@@ -0,0 +1,4 @@
+import type { DiskAccessor } from '../../accessor/disk.ts';
+import type { PathSpec } from '@struktoai/mirage-core/types';
+export declare function writeBytes(accessor: DiskAccessor, p: PathSpec, data: Uint8Array): Promise<void>;
+//# sourceMappingURL=write.d.ts.map

package/dist/core/disk/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/disk/write.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAK1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,YAAY,EACtB,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/core/disk/write.js

@@ -0,0 +1,36 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { writeFile } from 'node:fs/promises';
+import { invalidateAfterWrite } from '@struktoai/mirage-core/cache/context';
+import { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { ResourceName } from '@struktoai/mirage-core/types';
+import { diskError } from "./errors.js";
+import { resolveSafe } from "./utils.js";
+export async function writeBytes(accessor, p, data) {
+    const timer = startOp();
+    const virtual = p.mountPath;
+    const full = resolveSafe(accessor.root, virtual);
+    // A write is not `mkdir -p`: GNU reports ENOENT on a missing parent
+    // rather than building the chain, and the store-backed backends refuse
+    // the same way. Only the virtual path may reach a stderr line.
+    try {
+        await writeFile(full, data);
+    }
+    catch (err) {
+        throw diskError(err, p);
+    }
+    record('write', virtual, ResourceName.DISK, data.byteLength, timer);
+    await invalidateAfterWrite(p);
+}
+//# sourceMappingURL=write.js.map

package/dist/core/disk/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/disk/write.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAsB,EACtB,CAAW,EACX,IAAgB;IAEhB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,CAAC,CAAC,SAAS,CAAA;IAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAChD,oEAAoE;IACpE,uEAAuE;IACvE,+DAA+D;IAC/D,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IACzB,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IACnE,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAA;AAC/B,CAAC"}

package/dist/core/email/_parse.d.ts

@@ -0,0 +1,32 @@
+interface EmailAddress {
+    name: string;
+    email: string;
+}
+interface ParsedAttachment {
+    filename: string;
+    content_type: string;
+    size: number;
+}
+interface ParsedAttachmentWithPayload extends ParsedAttachment {
+    payload: Uint8Array;
+}
+export interface ParsedRfc822 {
+    from: EmailAddress;
+    reply_to: EmailAddress[];
+    to: EmailAddress[];
+    cc: EmailAddress[];
+    subject: string;
+    date: string;
+    body_text: string;
+    body_html: string;
+    snippet: string;
+    message_id: string;
+    in_reply_to: string | null;
+    references: string[];
+    has_attachments: boolean;
+    attachments: ParsedAttachment[];
+}
+export declare function parseRfc822(raw: Uint8Array, headersOnly?: boolean): Promise<ParsedRfc822>;
+export declare function parseWithPayloads(raw: Uint8Array): Promise<ParsedAttachmentWithPayload[]>;
+export {};
+//# sourceMappingURL=_parse.d.ts.map

package/dist/core/email/_parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_parse.d.ts","sourceRoot":"","sources":["../../../src/core/email/_parse.ts"],"names":[],"mappings":"AAsBA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,UAAU,2BAA4B,SAAQ,gBAAgB;IAC5D,OAAO,EAAE,UAAU,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,EAAE,EAAE,YAAY,EAAE,CAAA;IAClB,EAAE,EAAE,YAAY,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,eAAe,EAAE,OAAO,CAAA;IACxB,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAChC;AAsED,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAI7F;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAS/F"}

package/dist/core/email/_parse.js

@@ -0,0 +1,87 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { loadOptionalPeer } from '@struktoai/mirage-core/utils/optional_peer';
+let parserPromise = null;
+async function getParser() {
+    parserPromise ??= (async () => {
+        const mod = await loadOptionalPeer(() => import('mailparser'), { feature: 'parseRfc822', packageName: 'mailparser' });
+        return mod.simpleParser;
+    })();
+    return parserPromise;
+}
+function toAddr(a) {
+    if (a === undefined)
+        return { name: '', email: '' };
+    return { name: a.name, email: a.address ?? '' };
+}
+function toAddrList(list) {
+    if (list === undefined)
+        return [];
+    const objs = Array.isArray(list) ? list : [list];
+    return objs.flatMap((obj) => obj.value.map((a) => toAddr(a)));
+}
+// The rendered date must be the raw Date header text (python serves the
+// header untouched); mailparser's parsed.date would re-format it.
+function rawDateHeader(parsed) {
+    const found = parsed.headerLines.find((h) => h.key === 'date');
+    if (found === undefined)
+        return '';
+    const colon = found.line.indexOf(':');
+    return colon === -1 ? '' : found.line.slice(colon + 1).trim();
+}
+function fromParsed(parsed, headersOnly) {
+    const text = headersOnly ? '' : (parsed.text ?? '');
+    const html = headersOnly ? '' : typeof parsed.html === 'string' ? parsed.html : '';
+    const attachments = headersOnly
+        ? []
+        : parsed.attachments.map((a) => ({
+            filename: a.filename ?? 'unnamed',
+            content_type: a.contentType,
+            size: a.size,
+        }));
+    const refsRaw = parsed.references;
+    const references = typeof refsRaw === 'string' ? refsRaw.split(/\s+/).filter((s) => s !== '') : (refsRaw ?? []);
+    return {
+        from: toAddr(parsed.from?.value[0]),
+        reply_to: toAddrList(parsed.replyTo),
+        to: toAddrList(parsed.to),
+        cc: toAddrList(parsed.cc),
+        subject: parsed.subject ?? '',
+        date: rawDateHeader(parsed),
+        body_text: text,
+        body_html: html,
+        snippet: text.slice(0, 100),
+        message_id: parsed.messageId ?? '',
+        in_reply_to: typeof parsed.inReplyTo === 'string' && parsed.inReplyTo !== '' ? parsed.inReplyTo : null,
+        references,
+        has_attachments: attachments.length > 0,
+        attachments,
+    };
+}
+export async function parseRfc822(raw, headersOnly = false) {
+    const parser = await getParser();
+    const parsed = await parser(Buffer.from(raw), { skipHtmlToText: false });
+    return fromParsed(parsed, headersOnly);
+}
+export async function parseWithPayloads(raw) {
+    const parser = await getParser();
+    const parsed = await parser(Buffer.from(raw));
+    return parsed.attachments.map((a) => ({
+        filename: a.filename ?? 'unnamed',
+        content_type: a.contentType,
+        size: a.size,
+        payload: new Uint8Array(a.content),
+    }));
+}
+//# sourceMappingURL=_parse.js.map

package/dist/core/email/_parse.js.map

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

package/dist/core/email/client.d.ts

@@ -0,0 +1,58 @@
+import type { ImapFlow, MailboxLockObject } from 'imapflow';
+import type { EmailAccessor } from '../../accessor/email.ts';
+import { type ParsedRfc822 } from './_parse.ts';
+export interface FetchedMessage extends ParsedRfc822 {
+    uid: string;
+    flags: string[];
+    /** IMAP's own arrival stamp, ISO-8601, empty when the server omits it. */
+    internalDate: string;
+}
+export interface FolderEntry {
+    name: string;
+    /** The RFC 6154 special-use attribute the server tagged it with. */
+    specialUse: string | null;
+}
+export declare function listFolderEntries(accessor: EmailAccessor): Promise<FolderEntry[]>;
+export declare function listFolders(accessor: EmailAccessor): Promise<string[]>;
+/**
+ * Selects and locks a mailbox, failing loudly when it does not exist.
+ *
+ * imapflow reports every refused command as a bare "Command failed" and
+ * keeps the server's own words on `responseText`, so a missing mailbox
+ * arrives naming neither itself nor the problem. A `responseText` means
+ * the server answered and refused, which is the same condition python
+ * checks through the SELECT response code.
+ */
+export declare function lockMailbox(imap: ImapFlow, folder: string): Promise<MailboxLockObject>;
+export declare function listMessageUids(accessor: EmailAccessor, folder: string, searchCriteria?: string, maxResults?: number | null): Promise<string[]>;
+/**
+ * imapflow's search object. AND is expressed by several keys on one
+ * object; `or` and `not` nest further objects.
+ */
+export interface SearchQuery {
+    all?: boolean;
+    seen?: boolean;
+    answered?: boolean;
+    flagged?: boolean;
+    draft?: boolean;
+    deleted?: boolean;
+    body?: string;
+    text?: string;
+    subject?: string;
+    from?: string;
+    to?: string;
+    on?: Date;
+    since?: Date;
+    before?: Date;
+    sentOn?: Date;
+    sentSince?: Date;
+    sentBefore?: Date;
+    not?: SearchQuery;
+    or?: SearchQuery[];
+}
+export declare function parseSearchCriteria(criteria: string): SearchQuery;
+export declare function fetchRawMessage(accessor: EmailAccessor, folder: string, uid: string): Promise<Uint8Array>;
+export declare function fetchMessage(accessor: EmailAccessor, folder: string, uid: string): Promise<FetchedMessage>;
+export declare function fetchHeaders(accessor: EmailAccessor, folder: string, uids: readonly string[]): Promise<FetchedMessage[]>;
+export declare function fetchAttachment(accessor: EmailAccessor, folder: string, uid: string, filename: string): Promise<Uint8Array | null>;
+//# sourceMappingURL=client.d.ts.map

package/dist/core/email/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/email/client.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/E,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAA;CACrB;AAQD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAIvF;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAQ5F;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,cAAc,SAAQ,EACtB,UAAU,GAAE,MAAM,GAAG,IAAW,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBnB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,IAAI,CAAA;IACT,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,UAAU,CAAC,EAAE,IAAI,CAAA;IACjB,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAA;CACnB;AAwGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAGjE;AAiED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAYrB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAuBzB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC,cAAc,EAAE,CAAC,CA4B3B;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAe5B"}