@webda/core 4.0.0-beta.1 → 4.0.0-beta.3

package/lib/application/unpackedapplication.js

@@ -0,0 +1,492 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { deepmerge } from "deepmerge-ts";
+import * as fs from "fs";
+import { Application } from "./application.js";
+import { SectionEnum } from "./iconfiguration.js";
+import { FileUtils } from "@webda/utils";
+import { getMachineId } from "../core/hooks.js";
+import { join, resolve, relative, dirname } from "path";
+import { ProcessCache } from "../cache/cache.js";
+/**
+ * Empty git information
+ */
+export const EmptyGitInformation = {
+    branch: "",
+    commit: "",
+    short: "",
+    tag: "",
+    tags: [],
+    version: ""
+};
+/**
+ * An unpacked application load dynamically all webda.module.json
+ * And load also all the package description
+ *
+ * The normal Application is designed to load all this information from
+ * the cachedModule to avoid any unecessary action within a production environment
+ */
+let UnpackedApplication = (() => {
+    let _classSuper = Application;
+    let _staticExtraInitializers = [];
+    let _static_findModulesFiles_decorators;
+    return class UnpackedApplication extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _static_findModulesFiles_decorators = [ProcessCache()];
+            __esDecorate(this, null, _static_findModulesFiles_decorators, { kind: "method", name: "findModulesFiles", static: true, private: false, access: { has: obj => "findModulesFiles" in obj, get: obj => obj.findModulesFiles }, metadata: _metadata }, null, _staticExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(this, _staticExtraInitializers);
+        }
+        /** Create a new UnpackedApplication
+         * @param file - file path or partial configuration
+         * @param logger - the logger instance
+         */
+        constructor(file, logger) {
+            super(typeof file === "string"
+                ? file
+                : {
+                    version: 4,
+                    application: {},
+                    services: {},
+                    parameters: {},
+                    ...file
+                }, logger);
+            if (typeof file !== "string") {
+                this.baseConfiguration = this.completeConfiguration(this.baseConfiguration);
+            }
+        }
+        /**
+         * Ensure default configuration after load
+         * @returns the result
+         */
+        async load() {
+            await super.load();
+            // Ensuring default configuration after loadModule as we do auto-type guess and needs the Modda
+            // We only do it in UnpackedApplication as Application should be optimized for startup
+            // Application should have a webda.config.json optimized by the builder
+            // webda config > webda.config.json
+            this.ensureDefaultConfiguration(this.baseConfiguration);
+            return this;
+        }
+        /**
+         * Ensure default parameters are set on our application
+         * Creating the default services if they do not exist
+         *
+         * Might want to have only this in unpackaged application as Application should
+         * have a perfectly valid configuration
+         * @param configuration - the configuration
+         */
+        ensureDefaultConfiguration(configuration) {
+            configuration.services ??= {};
+            configuration.parameters ??= {};
+            configuration.parameters.apiUrl ??= "http://localhost:18080";
+            configuration.parameters.metrics ??= {};
+            if (configuration.parameters.metrics) {
+                configuration.parameters.metrics.labels ??= {};
+                configuration.parameters.metrics.config ??= {};
+                configuration.parameters.metrics.prefix ??= "";
+            }
+            configuration.parameters.configurationService ??= "Configuration";
+            configuration.parameters.defaultStore ??= "Registry";
+            const autoRegistry = configuration.services["Registry"] === undefined;
+            configuration.services["Router"] ??= {
+                type: "Webda/Router"
+            };
+            // Registry by default
+            configuration.services["Registry"] ??= {
+                type: "Webda/MemoryStore",
+                persistence: {
+                    path: ".registry",
+                    key: getMachineId()
+                }
+            };
+            // CryptoService by default
+            configuration.services["CryptoService"] ??= {
+                type: "Webda/CryptoService",
+                autoRotate: autoRegistry ? 30 : undefined,
+                autoCreate: true
+            };
+            // By default use CookieSessionManager
+            // TODO Should not be added here as it is only for HTTP
+            configuration.services["SessionManager"] ??= {
+                type: "Webda/CookieSessionManager"
+            };
+            // Ensure type is set to default
+            for (const serviceName in configuration.services) {
+                if (configuration.services[serviceName].type !== undefined) {
+                    continue;
+                }
+                if (this.moddas[this.completeNamespace(serviceName)]) {
+                    configuration.services[serviceName].type = this.completeNamespace(serviceName);
+                    continue;
+                }
+                if (!serviceName.includes("/") && this.moddas[`Webda/${serviceName}`]) {
+                    configuration.services[serviceName].type = `Webda/${serviceName}`;
+                }
+            }
+        }
+        /**
+         * Load full configuration
+         *
+         * webda.config.json and complete the cachedModule
+         *
+         * @param file - the file path
+         * @returns the result
+         */
+        async loadConfiguration(file) {
+            if (!file && this.baseConfiguration) {
+                this.baseConfiguration = this.completeConfiguration({ version: 4, ...this.baseConfiguration });
+            }
+            else if (!fs.existsSync(file)) {
+                this.baseConfiguration = this.completeConfiguration({ version: 4, parameters: {} });
+            }
+            else {
+                this.baseConfiguration = this.completeConfiguration(FileUtils.load(file));
+            }
+            // If cachedModules is defined we do not recompute
+            if (!this.baseConfiguration.cachedModules) {
+                this.baseConfiguration.cachedModules = {
+                    project: this.loadProjectInformation(),
+                    beans: {},
+                    deployers: {},
+                    models: {},
+                    schemas: {},
+                    moddas: {}
+                };
+                this.log("DEBUG", "Merging modules into configuration");
+                await this.mergeModules(this.baseConfiguration);
+            }
+        }
+        /**
+         * Add Moddas, Models and Deployers definitions
+         * It also add the project metadata
+         *
+         * @param configuration - the configuration
+         * @returns the result
+         */
+        completeConfiguration(configuration) {
+            // Only one level of includes is permitted
+            const imports = configuration.$import || [];
+            const effectiveImports = [];
+            for (const importFile of imports) {
+                if (!fs.existsSync(this.getPath(importFile))) {
+                    this.log("WARN", `Cannot import configuration '${importFile}'`);
+                    continue;
+                }
+                effectiveImports.push(importFile);
+                const includeConfiguration = FileUtils.load(this.getPath(importFile));
+                if (includeConfiguration.imports?.length) {
+                    this.log("WARN", `Imported configuration '${importFile}' has nested imports that will be skipped`);
+                }
+                configuration = deepmerge(includeConfiguration, configuration);
+            }
+            configuration.$import = effectiveImports;
+            // Ensure default values
+            return configuration;
+        }
+        /**
+         * @param _name - the name to use
+         * @param _version - the version string
+         * @returns empty git information
+         */
+        getGitInformation(_name, _version) {
+            return {
+                branch: "",
+                commit: "",
+                short: "",
+                tag: "",
+                tags: [],
+                version: ""
+            };
+        }
+        /** Upgrade a v3 configuration to v4 format */
+        upgradeConfigToV4() {
+            /*
+            // Move to router
+          
+            trustedProxies
+            csrfOrigins
+            website
+            static
+            apiUrl
+            requestLimit
+            requestTimeout
+            defaultHeaders
+        
+            // Move to Core
+            configurationService
+            defaultStore
+            ignoreBeans
+        
+            // metrics??
+            */
+        }
+        /**
+         * Check package.json
+         * @returns the result
+         */
+        loadProjectInformation() {
+            const info = {
+                deployment: {
+                    name: ""
+                },
+                package: {
+                    name: "",
+                    version: ""
+                },
+                git: EmptyGitInformation,
+                webda: {}
+            };
+            let packageJson = join(this.applicationPath, "package.json");
+            if (fs.existsSync(packageJson)) {
+                info.package = FileUtils.load(packageJson);
+            }
+            info.git = this.getGitInformation(info.package?.name, info.package?.version);
+            info.webda = info.package.webda || {};
+            let parent = join(this.applicationPath, "..");
+            do {
+                packageJson = join(parent, "package.json");
+                if (fs.existsSync(packageJson)) {
+                    const currentInfo = FileUtils.load(packageJson);
+                    if (currentInfo.workspaces) {
+                        this.log("DEBUG", "Application is running within a workspace");
+                        // Replace any relative path by absolute one
+                        for (const i in currentInfo.webda) {
+                            if (currentInfo.webda[i].startsWith("./")) {
+                                currentInfo.webda[i] = join(resolve(parent), currentInfo.webda[i].substr(2));
+                            }
+                        }
+                        info.webda = deepmerge(currentInfo.webda || {}, info.webda);
+                        info.webda.workspaces = {
+                            packages: currentInfo.workspaces,
+                            parent: currentInfo,
+                            path: resolve(parent)
+                        };
+                        break;
+                    }
+                }
+                parent = resolve(join(parent, ".."));
+            } while (parent !== resolve(join(parent, "..")));
+            // Check modules
+            return info;
+        }
+        /**
+         * Search the node_modules structure for webda.module.json files
+         *
+         * @param path - the path
+         * @returns the result
+         */
+        static async findModulesFiles(path) {
+            if (!path.endsWith("node_modules") || !fs.existsSync(path)) {
+                return [];
+            }
+            // Track visited directories (by realpath) to prevent infinite loops
+            // caused by pnpm's symlink structure where workspace packages
+            // reference each other through nested node_modules
+            const visited = new Set();
+            const scanNodeModules = async (nmPath) => {
+                const realNmPath = await fs.promises.realpath(nmPath).catch(() => nmPath);
+                if (visited.has(realNmPath)) {
+                    return [];
+                }
+                visited.add(realNmPath);
+                if (!fs.existsSync(nmPath)) {
+                    return [];
+                }
+                const files = new Set();
+                const checkFolder = async (filepath) => {
+                    if (fs.existsSync(join(filepath, "webda.module.json"))) {
+                        files.add(join(filepath, "webda.module.json"));
+                    }
+                    if (fs.existsSync(join(filepath, "node_modules"))) {
+                        (await scanNodeModules(join(filepath, "node_modules"))).forEach(f => files.add(f));
+                    }
+                };
+                const recursiveSearch = async (dirpath, depth = 0) => {
+                    await Promise.all((await fs.promises.readdir(dirpath, { withFileTypes: true })).map(async (file) => {
+                        if (file.name.startsWith(".")) {
+                            return;
+                        }
+                        const filepath = join(dirpath, file.name);
+                        if (file.isDirectory() && file.name.startsWith("@") && depth === 0) {
+                            // One recursion
+                            await recursiveSearch(filepath, depth + 1);
+                        }
+                        else if (file.isDirectory()) {
+                            await checkFolder(filepath);
+                        }
+                        else if (file.isSymbolicLink()) {
+                            // We want to follow symbolic links w/o increasing depth
+                            let realPath;
+                            try {
+                                // realpathSync will throw if the symlink is broken
+                                realPath = await fs.promises.realpath(filepath);
+                            }
+                            catch (err) {
+                                return;
+                            }
+                            await checkFolder(realPath);
+                        }
+                    }));
+                };
+                await recursiveSearch(nmPath, 0);
+                return [...files];
+            };
+            return scanNodeModules(path);
+        }
+        /**
+         * Load all imported modules and current module
+         * It will compile module
+         * Generate the current module file
+         * Load any imported webda.module.json
+         * @param module - the module to load
+         * @returns the list of results
+         */
+        async findModules(module) {
+            const appPath = this.getPath();
+            // Modules should be cached on deploy
+            const files = [];
+            const currentModule = this.getPath("webda.module.json");
+            if (fs.existsSync(currentModule)) {
+                files.push(currentModule);
+            }
+            this.log("TRACE", "Searching for modules in", this.getPath("node_modules"));
+            files.push(...(await UnpackedApplication.findModulesFiles(this.getPath("node_modules"))));
+            // Search workspace for webda.module.json
+            if (module.project.webda.workspaces && module.project.webda.workspaces.path !== "") {
+                this.log("TRACE", "Searching for modules in", join(module.project.webda.workspaces.path, "node_modules"));
+                files.push(...(await UnpackedApplication.findModulesFiles(join(module.project.webda.workspaces.path, "node_modules"))));
+            }
+            // Ensure we are not adding many times the same modules
+            // App's own module always included, filterModule only applies to dependencies
+            const currentModuleReal = fs.existsSync(currentModule) ? fs.realpathSync(currentModule) : undefined;
+            const moduleInfo = Array.from(new Set(files.map(n => fs.realpathSync(n)))).filter(f => f === currentModuleReal || this.filterModule(f));
+            this.log("TRACE", "Found modules", moduleInfo, "for", appPath);
+            return moduleInfo;
+        }
+        /**
+         * Only allow local and core module and sample-app
+         * @param _filename - the filename
+         * @returns true if the condition is met
+         */
+        filterModule(_filename) {
+            return true;
+        }
+        /**
+         * Load a webda.module.json file
+         * Resolve the linked file to current application
+         *
+         * @param moduleFile to load
+         * @returns the result
+         */
+        loadWebdaModule(moduleFile) {
+            const module = FileUtils.load(moduleFile);
+            if (!module.$schema?.endsWith("/webda.module.v4.json")) {
+                this.log("WARN", `Module '${moduleFile}' is not a v4 format, skipping module`);
+                return {
+                    models: {},
+                    schemas: {},
+                    beans: {},
+                    deployers: {},
+                    moddas: {},
+                    project: undefined
+                };
+            }
+            Object.keys(SectionEnum)
+                .filter(k => Number.isNaN(+k))
+                .forEach(p => {
+                // Do not keep Beans from other modules
+                if (this.getPath("webda.module.json") !== moduleFile && SectionEnum[p] === "beans") {
+                    delete module[SectionEnum[p]];
+                    return;
+                }
+                for (const key in module[SectionEnum[p]]) {
+                    const relBase = relative(this.getPath(), dirname(moduleFile));
+                    module[SectionEnum[p]][key].Import = join(relBase, module[SectionEnum[p]][key].Import);
+                    if (module[SectionEnum[p]][key].Configuration) {
+                        module[SectionEnum[p]][key].Configuration = join(relBase, module[SectionEnum[p]][key].Configuration);
+                    }
+                }
+            });
+            return module;
+        }
+        /**
+         * Merge all modules into one cached module
+         *
+         * @param module - the module to load
+         * @param configuration - the configuration
+         * @returns the result
+         */
+        async mergeModules(configuration) {
+            const module = configuration.cachedModules;
+            const appModule = this.getPath("webda.module.json");
+            const files = await this.findModules(module);
+            const value = files
+                .map(f => {
+                const currentModule = this.loadWebdaModule(f);
+                // We only take the Beans from current application
+                if (appModule !== f) {
+                    this.log("DEBUG", `Load module without beans '${f}'`);
+                    delete currentModule.beans;
+                }
+                else {
+                    this.log("DEBUG", `Load module with beans '${f}'`);
+                }
+                return currentModule;
+            })
+                .reduce((prev, val) => {
+                return deepmerge(prev, val);
+            }, module);
+            Object.keys(SectionEnum)
+                .filter(k => Number.isNaN(+k))
+                .forEach(p => {
+                module[SectionEnum[p]] = value[SectionEnum[p]];
+            });
+            // Copying schemas, capabilities, and behaviors. `behaviors` lives outside
+            // SectionEnum because Behavior classes are intentionally not models /
+            // moddas / beans / deployers — but the merged value must still flow
+            // through to the runtime so DomainService.addBehaviorOperations sees them.
+            module.schemas = value.schemas;
+            module.capabilities = value.capabilities;
+            module.behaviors = value.behaviors;
+            this.log("DEBUG", "Merged modules", module);
+            await this.loadModule(module);
+            return module;
+        }
+    };
+})();
+export { UnpackedApplication };
+//# sourceMappingURL=unpackedapplication.js.map

package/lib/application/unpackedapplication.js.map

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

package/lib/bin/cli-phase.d.ts

@@ -0,0 +1,28 @@
+import type { Core } from "../core/core.js";
+import type { ServiceCommandInfo } from "../services/servicecommands.js";
+/**
+ * Decide which Core lifecycle phase a CLI command should run at, based on the
+ * phases declared by every service that provides the command.
+ *
+ * Rule:
+ * - All declared phases `"resolved"` → run `Core.resolve()` only (no service.init()).
+ * - All `undefined` or `"initialized"` → run `Core.init()` (full initialization).
+ * - Mixed → throw with an error naming the command and conflicting phases.
+ * - Empty array → `"initialized"` (no providers = safest fallback).
+ *
+ * `undefined` in the input is treated as `"initialized"` (a service declaring no
+ * phase means "no opinion — use the default, full init").
+ * @param phases - per-provider phase declarations collected by `collectServiceCommands`.
+ * @param cmdName - name of the command, included in the mixed-phase error for diagnosability.
+ * @returns the lifecycle phase Core should run at for this command.
+ */
+export declare function selectPhase(phases: Array<"resolved" | "initialized" | undefined>, cmdName?: string): "resolved" | "initialized";
+/**
+ * Boot a Core instance up to the phase required by the given command. Shared
+ * entry point for every cli.ts site that dispatches a `@Command`.
+ * @param core - a freshly-constructed `Core` instance (not yet resolved or initialized).
+ * @param cmdName - name of the command being dispatched.
+ * @param cmdInfo - merged command info from `collectServiceCommands`.
+ */
+export declare function bootCoreForCommand(core: Core, cmdName: string, cmdInfo: ServiceCommandInfo): Promise<void>;
+//# sourceMappingURL=cli-phase.d.ts.map

package/lib/bin/cli-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-phase.d.ts","sourceRoot":"","sources":["../../src/bin/cli-phase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,KAAK,CAAC,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC,EACrD,OAAO,GAAE,MAAoB,GAC5B,UAAU,GAAG,aAAa,CAW5B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/lib/bin/cli-phase.js

@@ -0,0 +1,44 @@
+/**
+ * Decide which Core lifecycle phase a CLI command should run at, based on the
+ * phases declared by every service that provides the command.
+ *
+ * Rule:
+ * - All declared phases `"resolved"` → run `Core.resolve()` only (no service.init()).
+ * - All `undefined` or `"initialized"` → run `Core.init()` (full initialization).
+ * - Mixed → throw with an error naming the command and conflicting phases.
+ * - Empty array → `"initialized"` (no providers = safest fallback).
+ *
+ * `undefined` in the input is treated as `"initialized"` (a service declaring no
+ * phase means "no opinion — use the default, full init").
+ * @param phases - per-provider phase declarations collected by `collectServiceCommands`.
+ * @param cmdName - name of the command, included in the mixed-phase error for diagnosability.
+ * @returns the lifecycle phase Core should run at for this command.
+ */
+export function selectPhase(phases, cmdName = "<unknown>") {
+    if (phases.length === 0)
+        return "initialized";
+    const normalized = phases.map(p => p ?? "initialized");
+    const unique = new Set(normalized);
+    if (unique.size === 1) {
+        return normalized[0];
+    }
+    throw new Error(`Command '${cmdName}' has inconsistent phases across services: ${[...unique].join(", ")}. ` +
+        `All services declaring a command must agree on phase.`);
+}
+/**
+ * Boot a Core instance up to the phase required by the given command. Shared
+ * entry point for every cli.ts site that dispatches a `@Command`.
+ * @param core - a freshly-constructed `Core` instance (not yet resolved or initialized).
+ * @param cmdName - name of the command being dispatched.
+ * @param cmdInfo - merged command info from `collectServiceCommands`.
+ */
+export async function bootCoreForCommand(core, cmdName, cmdInfo) {
+    const phase = selectPhase(cmdInfo.phases, cmdName);
+    if (phase === "resolved") {
+        await core.resolve();
+    }
+    else {
+        await core.init();
+    }
+}
+//# sourceMappingURL=cli-phase.js.map

package/lib/bin/cli-phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-phase.js","sourceRoot":"","sources":["../../src/bin/cli-phase.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CACzB,MAAqD,EACrD,OAAO,GAAW,WAAW;IAE7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,8CAA8C,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACzF,uDAAuD,CAC1D,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAU,EACV,OAAe,EACf,OAA2B;IAE3B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}