@ryanstark24/sfgraph-core 1.1.0

package/dist/extractors/filesystem/__tests__/filesystem.test.js

@@ -0,0 +1,96 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { FilesystemMetadataSource } from "../index.js";
+let workDir;
+beforeEach(() => {
+    workDir = mkdtempSync(path.join(tmpdir(), "sfg-fs-"));
+});
+afterEach(() => {
+    rmSync(workDir, { recursive: true, force: true });
+});
+function w(rel, content) {
+    const abs = path.join(workDir, rel);
+    mkdirSync(path.dirname(abs), { recursive: true });
+    writeFileSync(abs, content, "utf8");
+}
+async function collect(src) {
+    const out = [];
+    for await (const m of src.iter()) {
+        out.push({
+            type: m.ref.memberType,
+            name: m.ref.memberName,
+            content: m.content,
+            uri: m.ref.sourceUri,
+        });
+    }
+    return out;
+}
+describe("FilesystemMetadataSource", () => {
+    it("walks ApexClass and Flow", async () => {
+        w("force-app/main/default/classes/Foo.cls", "public class Foo {}");
+        w("force-app/main/default/classes/Foo.cls-meta.xml", "<xml/>");
+        w("force-app/main/default/flows/Bar.flow-meta.xml", "<Flow/>");
+        const src = new FilesystemMetadataSource(workDir);
+        const members = await collect(src);
+        const types = members.map((m) => m.type).sort();
+        expect(types).toEqual(["ApexClass", "Flow"]);
+    });
+    it("bundles LWC files into one RawMember", async () => {
+        w("force-app/main/default/lwc/accountTile/accountTile.js", "export default class {}");
+        w("force-app/main/default/lwc/accountTile/accountTile.html", "<template></template>");
+        w("force-app/main/default/lwc/accountTile/accountTile.js-meta.xml", "<meta/>");
+        const src = new FilesystemMetadataSource(workDir);
+        const members = await collect(src);
+        expect(members.length).toBe(1);
+        expect(members[0]?.type).toBe("LightningComponentBundle");
+        const payload = JSON.parse(members[0]?.content ?? "{}");
+        expect(payload.bundleName).toBe("accountTile");
+        expect(Object.keys(payload.files).sort()).toEqual([
+            "accountTile.html",
+            "accountTile.js",
+            "accountTile.js-meta.xml",
+        ]);
+    });
+    it("bundles CustomObject dir with fields", async () => {
+        w("force-app/main/default/objects/Account/Account.object-meta.xml", "<CustomObject/>");
+        w("force-app/main/default/objects/Account/fields/Status__c.field-meta.xml", "<CustomField/>");
+        const src = new FilesystemMetadataSource(workDir);
+        const members = await collect(src);
+        const obj = members.find((m) => m.type === "CustomObject");
+        expect(obj).toBeTruthy();
+        expect(obj?.name).toBe("Account");
+        const payload = JSON.parse(obj?.content ?? "{}");
+        expect(payload.apiName).toBe("Account");
+        expect(payload.fields).toHaveProperty("Status__c");
+    });
+    it("tolerates missing subdirs", async () => {
+        w("force-app/main/default/classes/Solo.cls", "public class Solo {}");
+        const src = new FilesystemMetadataSource(workDir);
+        const members = await collect(src);
+        expect(members.length).toBe(1);
+        expect(members[0]?.type).toBe("ApexClass");
+    });
+    it("skips node_modules, .git, dist", async () => {
+        w("force-app/main/default/classes/Real.cls", "public class Real {}");
+        w("force-app/node_modules/foo/classes/Fake.cls", "fake");
+        w("force-app/.git/classes/Fake2.cls", "fake");
+        w("force-app/dist/classes/Fake3.cls", "fake");
+        const src = new FilesystemMetadataSource(workDir);
+        const members = await collect(src);
+        expect(members.length).toBe(1);
+        expect(members[0]?.name).toBe("Real");
+    });
+    it("fromProjectRoot honors sfdx-project.json packageDirectories", async () => {
+        w("sfdx-project.json", JSON.stringify({ packageDirectories: [{ path: "custom-pkg" }] }));
+        w("custom-pkg/main/default/classes/Custom.cls", "public class Custom {}");
+        w("force-app/main/default/classes/ShouldBeSkipped.cls", "public class X {}");
+        const src = FilesystemMetadataSource.fromProjectRoot(workDir);
+        const members = await collect(src);
+        const names = members.map((m) => m.name);
+        expect(names).toContain("Custom");
+        expect(names).not.toContain("ShouldBeSkipped");
+    });
+});
+//# sourceMappingURL=filesystem.test.js.map

package/dist/extractors/filesystem/__tests__/filesystem.test.js.map

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

package/dist/extractors/filesystem/index.d.ts

@@ -0,0 +1,20 @@
+import type { MetadataSource, RawMember } from "../interfaces/metadata-source.js";
+/**
+ * Filesystem-based metadata source. Walks an sfdx source-format tree and
+ * yields RawMember records for each known metadata file/bundle.
+ *
+ * Strictly read-only: parses the layout to seed in-memory parsers; never
+ * writes to disk or to the persisted graph.
+ */
+export declare class FilesystemMetadataSource implements MetadataSource {
+    readonly rootDir: string;
+    readonly packageDirs: string[];
+    constructor(rootDir: string, packageDirs?: string[]);
+    /**
+     * Build a source by reading `sfdx-project.json` for packageDirectories.
+     * Falls back to `force-app` if the file is missing or malformed.
+     */
+    static fromProjectRoot(root: string): FilesystemMetadataSource;
+    iter(): AsyncIterable<RawMember>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/extractors/filesystem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extractors/filesystem/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,cAAc,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAI7F;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAKnD;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB;IAmBvD,IAAI,IAAI,aAAa,CAAC,SAAS,CAAC;CAOxC"}

package/dist/extractors/filesystem/index.js

@@ -0,0 +1,378 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { METADATA_CATEGORY } from "../../domain/metadata-category.js";
+const SKIP_DIR_NAMES = new Set(["node_modules", ".git", "dist", "coverage", ".sfdx", ".sf"]);
+/**
+ * Filesystem-based metadata source. Walks an sfdx source-format tree and
+ * yields RawMember records for each known metadata file/bundle.
+ *
+ * Strictly read-only: parses the layout to seed in-memory parsers; never
+ * writes to disk or to the persisted graph.
+ */
+export class FilesystemMetadataSource {
+    rootDir;
+    packageDirs;
+    constructor(rootDir, packageDirs) {
+        this.rootDir = rootDir;
+        this.packageDirs = packageDirs && packageDirs.length > 0 ? packageDirs : ["force-app"];
+    }
+    /**
+     * Build a source by reading `sfdx-project.json` for packageDirectories.
+     * Falls back to `force-app` if the file is missing or malformed.
+     */
+    static fromProjectRoot(root) {
+        const projectFile = path.join(root, "sfdx-project.json");
+        let dirs;
+        try {
+            if (fs.existsSync(projectFile)) {
+                const raw = fs.readFileSync(projectFile, "utf8");
+                const parsed = JSON.parse(raw);
+                const arr = Array.isArray(parsed.packageDirectories) ? parsed.packageDirectories : [];
+                dirs = arr
+                    .map((d) => d.path)
+                    .filter((p) => typeof p === "string" && p.length > 0);
+            }
+        }
+        catch {
+            // tolerate malformed sfdx-project.json — fall back to default
+            dirs = undefined;
+        }
+        return new FilesystemMetadataSource(root, dirs);
+    }
+    async *iter() {
+        for (const pkg of this.packageDirs) {
+            const pkgRoot = path.resolve(this.rootDir, pkg);
+            if (!safeIsDir(pkgRoot))
+                continue;
+            yield* walkPackage(pkgRoot);
+        }
+    }
+}
+function safeIsDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function safeReadFile(p) {
+    try {
+        return fs.readFileSync(p, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+function mtimeIso(p) {
+    try {
+        return fs.statSync(p).mtime.toISOString();
+    }
+    catch {
+        return null;
+    }
+}
+const LEAF_SPECS = [
+    {
+        segment: "classes",
+        suffix: ".cls",
+        memberType: "ApexClass",
+        category: METADATA_CATEGORY.APEX_CLASS,
+    },
+    {
+        segment: "triggers",
+        suffix: ".trigger",
+        memberType: "ApexTrigger",
+        category: METADATA_CATEGORY.APEX_TRIGGER,
+    },
+    {
+        segment: "flows",
+        suffix: ".flow-meta.xml",
+        memberType: "Flow",
+        category: METADATA_CATEGORY.FLOW,
+    },
+    {
+        segment: "profiles",
+        suffix: ".profile-meta.xml",
+        memberType: "Profile",
+        category: METADATA_CATEGORY.PROFILE,
+    },
+    {
+        segment: "permissionsets",
+        suffix: ".permissionset-meta.xml",
+        memberType: "PermissionSet",
+        category: METADATA_CATEGORY.PERMISSION_SET,
+    },
+    {
+        segment: "permissionsetgroups",
+        suffix: ".permissionsetgroup-meta.xml",
+        memberType: "PermissionSetGroup",
+        category: METADATA_CATEGORY.PERMISSION_SET_GROUP,
+    },
+    {
+        segment: "sharingRules",
+        suffix: ".sharingRules-meta.xml",
+        memberType: "SharingRules",
+        category: METADATA_CATEGORY.SHARING_RULE,
+    },
+    {
+        segment: "namedCredentials",
+        suffix: ".namedCredential-meta.xml",
+        memberType: "NamedCredential",
+        category: METADATA_CATEGORY.NAMED_CREDENTIAL,
+    },
+    {
+        segment: "externalServiceRegistrations",
+        suffix: ".externalServiceRegistration-meta.xml",
+        memberType: "ExternalServiceRegistration",
+        category: METADATA_CATEGORY.EXTERNAL_SERVICE_REGISTRATION,
+    },
+    {
+        segment: "pages",
+        suffix: ".page",
+        memberType: "ApexPage",
+        category: METADATA_CATEGORY.APEX_PAGE,
+    },
+    {
+        segment: "components",
+        suffix: ".component",
+        memberType: "ApexComponent",
+        category: METADATA_CATEGORY.APEX_COMPONENT,
+    },
+    {
+        segment: "layouts",
+        suffix: ".layout-meta.xml",
+        memberType: "Layout",
+        category: METADATA_CATEGORY.LAYOUT,
+    },
+    {
+        segment: "flexipages",
+        suffix: ".flexipage-meta.xml",
+        memberType: "FlexiPage",
+        category: METADATA_CATEGORY.LIGHTNING_PAGE,
+    },
+    {
+        segment: "customMetadata",
+        suffix: ".md-meta.xml",
+        memberType: "CustomMetadata",
+        category: METADATA_CATEGORY.CUSTOM_METADATA,
+    },
+    {
+        segment: "labels",
+        suffix: ".labels-meta.xml",
+        memberType: "CustomLabels",
+        category: METADATA_CATEGORY.CUSTOM_LABEL,
+    },
+    {
+        segment: "workflows",
+        suffix: ".workflow-meta.xml",
+        memberType: "Workflow",
+        category: METADATA_CATEGORY.WORKFLOW,
+    },
+    {
+        segment: "approvalProcesses",
+        suffix: ".approvalProcess-meta.xml",
+        memberType: "ApprovalProcess",
+        category: METADATA_CATEGORY.APPROVAL_PROCESS,
+    },
+    {
+        segment: "duplicateRules",
+        suffix: ".duplicateRule-meta.xml",
+        memberType: "DuplicateRule",
+        category: METADATA_CATEGORY.DUPLICATE_RULE,
+    },
+];
+async function* walkPackage(pkgRoot) {
+    // sfdx source-format usually has `main/default` (and sometimes other subroots).
+    // We walk every subdirectory of pkgRoot (besides skip-list) looking for
+    // canonical metadata folders.
+    const queue = [pkgRoot];
+    const mdRoots = [];
+    while (queue.length > 0) {
+        const dir = queue.shift();
+        if (!dir)
+            break;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        let foundMdFolder = false;
+        for (const e of entries) {
+            if (!e.isDirectory())
+                continue;
+            if (SKIP_DIR_NAMES.has(e.name))
+                continue;
+            const full = path.join(dir, e.name);
+            // Heuristic: a "main" or "default" subdir suggests we keep descending.
+            if (e.name === "main" || e.name === "default") {
+                queue.push(full);
+                continue;
+            }
+            // Recognized leaf folders trigger handling at this level.
+            if (e.name === "classes" ||
+                e.name === "triggers" ||
+                e.name === "lwc" ||
+                e.name === "aura" ||
+                e.name === "flows" ||
+                e.name === "objects" ||
+                e.name === "profiles" ||
+                e.name === "permissionsets" ||
+                e.name === "permissionsetgroups" ||
+                e.name === "sharingRules" ||
+                e.name === "namedCredentials" ||
+                e.name === "externalServiceRegistrations" ||
+                e.name === "pages" ||
+                e.name === "components" ||
+                e.name === "layouts" ||
+                e.name === "flexipages" ||
+                e.name === "customMetadata" ||
+                e.name === "labels" ||
+                e.name === "workflows" ||
+                e.name === "approvalProcesses" ||
+                e.name === "duplicateRules") {
+                foundMdFolder = true;
+            }
+        }
+        if (foundMdFolder) {
+            mdRoots.push(dir);
+        }
+    }
+    if (mdRoots.length === 0) {
+        // Treat pkgRoot itself as md root (e.g. tests passing in flat layout).
+        mdRoots.push(pkgRoot);
+    }
+    for (const root of mdRoots) {
+        // Walk leaf specs
+        for (const spec of LEAF_SPECS) {
+            const dir = path.join(root, spec.segment);
+            if (!safeIsDir(dir))
+                continue;
+            let files;
+            try {
+                files = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const f of files) {
+                if (!f.isFile())
+                    continue;
+                if (!f.name.endsWith(spec.suffix))
+                    continue;
+                const full = path.join(dir, f.name);
+                const memberName = f.name.slice(0, -spec.suffix.length);
+                yield {
+                    ref: makeRef(spec.category, spec.memberType, memberName, full),
+                    content: safeReadFile(full),
+                };
+            }
+        }
+        // LWC bundles
+        const lwcDir = path.join(root, "lwc");
+        if (safeIsDir(lwcDir)) {
+            let bundles;
+            try {
+                bundles = fs.readdirSync(lwcDir, { withFileTypes: true });
+            }
+            catch {
+                bundles = [];
+            }
+            for (const b of bundles) {
+                if (!b.isDirectory())
+                    continue;
+                if (SKIP_DIR_NAMES.has(b.name))
+                    continue;
+                const bundleDir = path.join(lwcDir, b.name);
+                const files = {};
+                let bundleFiles;
+                try {
+                    bundleFiles = fs.readdirSync(bundleDir, { withFileTypes: true });
+                }
+                catch {
+                    continue;
+                }
+                for (const bf of bundleFiles) {
+                    if (!bf.isFile())
+                        continue;
+                    const fp = path.join(bundleDir, bf.name);
+                    files[bf.name] = safeReadFile(fp);
+                }
+                if (Object.keys(files).length === 0)
+                    continue;
+                yield {
+                    ref: makeRef(METADATA_CATEGORY.LWC, "LightningComponentBundle", b.name, bundleDir),
+                    content: JSON.stringify({ bundleName: b.name, files }),
+                };
+            }
+        }
+        // CustomObject bundles (folder per object)
+        const objectsDir = path.join(root, "objects");
+        if (safeIsDir(objectsDir)) {
+            let objs;
+            try {
+                objs = fs.readdirSync(objectsDir, { withFileTypes: true });
+            }
+            catch {
+                objs = [];
+            }
+            for (const o of objs) {
+                if (!o.isDirectory())
+                    continue;
+                const objDir = path.join(objectsDir, o.name);
+                const objectXmlPath = path.join(objDir, `${o.name}.object-meta.xml`);
+                if (!fs.existsSync(objectXmlPath))
+                    continue;
+                const objectXml = safeReadFile(objectXmlPath);
+                const fields = readSubMap(path.join(objDir, "fields"), ".field-meta.xml");
+                const recordTypes = readSubMap(path.join(objDir, "recordTypes"), ".recordType-meta.xml");
+                const validationRules = readSubMap(path.join(objDir, "validationRules"), ".validationRule-meta.xml");
+                const content = JSON.stringify({
+                    apiName: o.name,
+                    objectXml,
+                    fields,
+                    recordTypes,
+                    validationRules,
+                });
+                yield {
+                    ref: makeRef(METADATA_CATEGORY.OBJECT, "CustomObject", o.name, objectXmlPath),
+                    content,
+                };
+            }
+        }
+    }
+}
+function readSubMap(dir, suffix) {
+    const out = {};
+    if (!safeIsDir(dir))
+        return out;
+    let files;
+    try {
+        files = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const f of files) {
+        if (!f.isFile())
+            continue;
+        if (!f.name.endsWith(suffix))
+            continue;
+        const apiName = f.name.slice(0, -suffix.length);
+        out[apiName] = safeReadFile(path.join(dir, f.name));
+    }
+    return out;
+}
+function makeRef(category, memberType, memberName, absPath) {
+    return {
+        category,
+        memberType,
+        memberName,
+        lastModifiedAt: mtimeIso(absPath),
+        sourceUri: `file://${absPath}`,
+        namespace: null,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/extractors/filesystem/index.js.map

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

package/dist/extractors/interfaces/metadata-source.d.ts

@@ -0,0 +1,21 @@
+import type { MetadataCategory } from "../../domain/index.js";
+export interface MemberRef {
+    category: MetadataCategory;
+    memberType: string;
+    memberName: string;
+    lastModifiedAt: string | null;
+    sourceUri: string;
+    /** Set true for incremental deletions (SourceMember.IsNameObsolete = true). */
+    obsolete?: boolean;
+    /** Optional namespace prefix (e.g. "vlocity_cmt"). */
+    namespace?: string | null;
+}
+export interface RawMember {
+    ref: MemberRef;
+    /** Serialized content for the parser (XML / JSON / source). May be empty for deletions. */
+    content: string;
+}
+export interface MetadataSource {
+    iter(): AsyncIterable<RawMember>;
+}
+//# sourceMappingURL=metadata-source.d.ts.map

package/dist/extractors/interfaces/metadata-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-source.d.ts","sourceRoot":"","sources":["../../../src/extractors/interfaces/metadata-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,SAAS,CAAC;IACf,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;CAClC"}

package/dist/extractors/interfaces/metadata-source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metadata-source.js.map

package/dist/extractors/interfaces/metadata-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-source.js","sourceRoot":"","sources":["../../../src/extractors/interfaces/metadata-source.ts"],"names":[],"mappings":""}

package/dist/extractors/live-org/__tests__/_jsforce-mock.d.ts

@@ -0,0 +1,38 @@
+export interface MockJsforceOpts {
+    queryResults?: Record<string, {
+        records: any[];
+        done?: boolean;
+        nextRecordsUrl?: string;
+    }>;
+    toolingQueryResults?: Record<string, {
+        records: any[];
+        done?: boolean;
+        nextRecordsUrl?: string;
+    }>;
+    describeResults?: Record<string, boolean>;
+    toolingDescribeResults?: Record<string, boolean>;
+    metadataList?: Record<string, any[]>;
+    metadataRead?: Record<string, (names: string[]) => any[]>;
+    /** Items returned by conn.metadata.describe(). When omitted, describe throws. */
+    metadataDescribe?: Array<{
+        xmlName: string;
+        suffix?: string;
+        directoryName?: string;
+        childXmlNames?: string[];
+        inFolder?: boolean;
+        metaFile?: boolean;
+    }>;
+    apiVersion?: string;
+    instanceUrl?: string;
+    userInfo?: {
+        organizationId?: string;
+    };
+    /** Increment writeCounter whenever a write method is called (proxy should block before this triggers). */
+    writeCounter?: {
+        count: number;
+    };
+    /** Throw on first call, succeed afterwards (for retry tests). */
+    queryThrowOnce?: () => Error | null;
+}
+export declare function buildJsforceMock(opts?: MockJsforceOpts): any;
+//# sourceMappingURL=_jsforce-mock.d.ts.map

package/dist/extractors/live-org/__tests__/_jsforce-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_jsforce-mock.d.ts","sourceRoot":"","sources":["../../../../src/extractors/live-org/__tests__/_jsforce-mock.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3F,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClG,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAC1D,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,0GAA0G;IAC1G,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,KAAK,GAAG,IAAI,CAAC;CACrC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,eAAoB,GAAG,GAAG,CA0FhE"}