@microsoft/teamsfx-core 1.3.0 → 1.3.1-alpha.59b5e7c6.0

package/build/core/pvm/broker.d.ts

@@ -0,0 +1,24 @@
+/**
+ *
+ * Basic C.R.U.D operations for plugins.
+ *
+ * Data is persisted in '${ProjectRoot}/${TeamsFx}/package.json'
+ *
+ */
+import { Plugins } from "./type";
+/**
+ * Broker is stateless which means all api should know about the path of
+ * target project.
+ *
+ * All method will throw InvalidProjectError if project is invalid.
+ */
+export declare class Broker {
+    private static configPath;
+    /**
+     * both create & update
+     */
+    static save(root: string, plugins: Plugins): Promise<void>;
+    static list(root: string): Promise<Plugins>;
+    static remove(root: string, plugins: string[]): Promise<void>;
+}
+//# sourceMappingURL=broker.d.ts.map

package/build/core/pvm/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../src/core/pvm/broker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AA4BjC;;;;;GAKG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB;;OAEG;WAEU,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;WAWnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAMpC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CASpE"}

package/build/core/pvm/broker.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ *
+ * Basic C.R.U.D operations for plugins.
+ *
+ * Data is persisted in '${ProjectRoot}/${TeamsFx}/package.json'
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Broker = void 0;
+const tslib_1 = require("tslib");
+const constant_1 = require("./constant");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const error_1 = require("../error");
+const utility_1 = require("./utility");
+/**
+ * make sure all necessary files/folders are existed.
+ * Otherwise, throw exception.
+ */
+const validate = () => {
+    /* eslint-disable  @typescript-eslint/no-explicit-any */
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const root = args[0];
+            if (!(await fs_extra_1.pathExists(root))) {
+                throw error_1.InvalidProjectError();
+            }
+            await fs_extra_1.ensureDir(path_1.join(root, teamsfx_api_1.ConfigFolderName));
+            if (!(await fs_extra_1.pathExists(path_1.join(root, teamsfx_api_1.ConfigFolderName, constant_1.PLUGIN_DOT_JSON)))) {
+                await fs_extra_1.writeFile(path_1.join(root, teamsfx_api_1.ConfigFolderName, constant_1.PLUGIN_DOT_JSON), utility_1.jsonStringifyElegantly({}));
+            }
+            const result = originalMethod.apply(this, args);
+            return result;
+        };
+    };
+};
+/**
+ * Broker is stateless which means all api should know about the path of
+ * target project.
+ *
+ * All method will throw InvalidProjectError if project is invalid.
+ */
+class Broker {
+    static configPath(root) {
+        return path_1.join(root, teamsfx_api_1.ConfigFolderName, constant_1.PLUGIN_DOT_JSON);
+    }
+    /**
+     * both create & update
+     */
+    static async save(root, plugins) {
+        const config = (await fs_extra_1.readJSON(Broker.configPath(root)));
+        for (const name in plugins) {
+            config[name] = plugins[name];
+        }
+        await fs_extra_1.writeFile(Broker.configPath(root), utility_1.jsonStringifyElegantly(config));
+        return;
+    }
+    static async list(root) {
+        const config = (await fs_extra_1.readJSON(Broker.configPath(root)));
+        return config;
+    }
+    static async remove(root, plugins) {
+        const config = (await fs_extra_1.readJSON(Broker.configPath(root)));
+        for (const i in plugins) {
+            delete config[plugins[i]];
+        }
+        await fs_extra_1.writeFile(Broker.configPath(root), utility_1.jsonStringifyElegantly(config));
+        return;
+    }
+}
+tslib_1.__decorate([
+    validate(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], Broker, "save", null);
+tslib_1.__decorate([
+    validate(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], Broker, "list", null);
+tslib_1.__decorate([
+    validate(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Array]),
+    tslib_1.__metadata("design:returntype", Promise)
+], Broker, "remove", null);
+exports.Broker = Broker;
+//# sourceMappingURL=broker.js.map

package/build/core/pvm/broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../../src/core/pvm/broker.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;AAEH,yCAA6C;AAC7C,wDAA0D;AAC1D,uCAAsE;AACtE,+BAA4B;AAC5B,oCAA+C;AAE/C,uCAAmD;AAEnD;;;GAGG;AACH,MAAM,QAAQ,GAAG,GAAG,EAAE;IACpB,wDAAwD;IACxD,OAAO,CAAC,MAAW,EAAE,WAAmB,EAAE,UAA8B,EAAE,EAAE;QAC1E,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QACxC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAW;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,CAAC,MAAM,qBAAU,CAAC,IAAI,CAAC,CAAC,EAAE;gBAC7B,MAAM,2BAAmB,EAAE,CAAC;aAC7B;YAED,MAAM,oBAAS,CAAC,WAAI,CAAC,IAAI,EAAE,8BAAgB,CAAC,CAAC,CAAC;YAE9C,IAAI,CAAC,CAAC,MAAM,qBAAU,CAAC,WAAI,CAAC,IAAI,EAAE,8BAAgB,EAAE,0BAAe,CAAC,CAAC,CAAC,EAAE;gBACtE,MAAM,oBAAS,CAAC,WAAI,CAAC,IAAI,EAAE,8BAAgB,EAAE,0BAAe,CAAC,EAAE,gCAAsB,CAAC,EAAE,CAAC,CAAC,CAAC;aAC5F;YACD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAa,MAAM;IACT,MAAM,CAAC,UAAU,CAAC,IAAY;QACpC,OAAO,WAAI,CAAC,IAAI,EAAE,8BAAgB,EAAE,0BAAe,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IAEH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAAgB;QAC9C,MAAM,MAAM,GAAG,CAAC,MAAM,mBAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAY,CAAC;QAEpE,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE;YAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;SAC9B;QACD,MAAM,oBAAS,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,gCAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IAGD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY;QAC5B,MAAM,MAAM,GAAG,CAAC,MAAM,mBAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAY,CAAC;QACpE,OAAO,MAAM,CAAC;IAChB,CAAC;IAGD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAAiB;QACjD,MAAM,MAAM,GAAG,CAAC,MAAM,mBAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAY,CAAC;QAEpE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;YACvB,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B;QACD,MAAM,oBAAS,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,gCAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;CACF;AA1BC;IADC,QAAQ,EAAE;;;;wBASV;AAGD;IADC,QAAQ,EAAE;;;;wBAIV;AAGD;IADC,QAAQ,EAAE;;;;0BASV;AAlCH,wBAmCC"}

package/build/core/pvm/constant.d.ts

@@ -0,0 +1,11 @@
+/**
+ * current version of pvm
+ */
+export declare const PVM_SPEC_VERSION = "1.0.0";
+export declare const PACKAGE_DOT_JSON = "package.json";
+export declare const PLUGIN_DOT_JSON = "plugin.json";
+export declare const MANIFEST_DOT_JSON = "manifest.json";
+export declare const PLUGINS_FOLDER = "plugins";
+export declare const NODE_MODULES = "node_modules";
+export declare const UNDERTERMINED = "undertermined";
+//# sourceMappingURL=constant.d.ts.map

package/build/core/pvm/constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../../../src/core/pvm/constant.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,eAAO,MAAM,aAAa,kBAAkB,CAAC"}

package/build/core/pvm/constant.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNDERTERMINED = exports.NODE_MODULES = exports.PLUGINS_FOLDER = exports.MANIFEST_DOT_JSON = exports.PLUGIN_DOT_JSON = exports.PACKAGE_DOT_JSON = exports.PVM_SPEC_VERSION = void 0;
+/**
+ * current version of pvm
+ */
+exports.PVM_SPEC_VERSION = "1.0.0";
+exports.PACKAGE_DOT_JSON = "package.json";
+exports.PLUGIN_DOT_JSON = "plugin.json";
+exports.MANIFEST_DOT_JSON = "manifest.json";
+exports.PLUGINS_FOLDER = "plugins";
+exports.NODE_MODULES = "node_modules";
+exports.UNDERTERMINED = "undertermined";
+//# sourceMappingURL=constant.js.map

package/build/core/pvm/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../../src/core/pvm/constant.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,gBAAgB,GAAG,OAAO,CAAC;AAE3B,QAAA,gBAAgB,GAAG,cAAc,CAAC;AAElC,QAAA,eAAe,GAAG,aAAa,CAAC;AAEhC,QAAA,iBAAiB,GAAG,eAAe,CAAC;AAEpC,QAAA,cAAc,GAAG,SAAS,CAAC;AAE3B,QAAA,YAAY,GAAG,cAAc,CAAC;AAE9B,QAAA,aAAa,GAAG,eAAe,CAAC"}

package/build/core/pvm/depot.d.ts

@@ -0,0 +1,43 @@
+import { FxError, Result } from "@microsoft/teamsfx-api";
+import { PluginName, Plugins, PluginVersion, PluginPath, PluginURI } from "./type";
+/**
+ * manifest is a structure to describe the details of all loaded plugins.
+ * version is a reserved property.
+ */
+interface Manifest {
+    version: string;
+    plugins: Record<PluginName, PluginVersion[]>;
+}
+export declare class Depot {
+    /**
+     * only support two kinds of package
+     * 1. local path
+     * 2. semantic version
+     *
+     * @param packages - the URI of a package
+     * @returns True if validation passed
+     *
+     * TODO use json-schema to validate
+     */
+    private static validate;
+    /**
+     * This is a wrapper of 'npm install' and store all packages in address.
+     *
+     * npm install {@link https://docs.npmjs.com/cli/v8/commands/npm-install}
+     *
+     * @param packages - the URI of a package
+     * @returns paths of dynamic plugins. If exceptions, return FxError
+     */
+    static install(packages: Plugins): Promise<Result<Record<PluginName, PluginPath>, FxError>>;
+    static getManifest(): Promise<Manifest>;
+    /**
+     * @param name - plugin's name
+     * @param version - if set, check specific version of plugin
+     *
+     * @returns whether plugin is existed or not
+     */
+    static has(name: PluginName, uri?: PluginURI): Promise<boolean>;
+    private static saveManifest;
+}
+export {};
+//# sourceMappingURL=depot.d.ts.map

package/build/core/pvm/depot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depot.d.ts","sourceRoot":"","sources":["../../../src/core/pvm/depot.ts"],"names":[],"mappings":"AAoCA,OAAO,EAIL,OAAO,EAGP,MAAM,EACP,MAAM,wBAAwB,CAAC;AAYhC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAInF;;;GAGG;AACH,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;CAC9C;AA8CD,qBAAa,KAAK;IAChB;;;;;;;;;OASG;mBACkB,QAAQ;IAc7B;;;;;;;OAOG;WAEiB,OAAO,CACzB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;WAiEvC,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAOpD;;;;;OAKG;WAEiB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;mBAevD,YAAY;CAqBlC"}

package/build/core/pvm/depot.js

@@ -0,0 +1,243 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Depot = void 0;
+const tslib_1 = require("tslib");
+/**
+ * As plugins are developed by TS/JS and packed into NPM package, Depot will
+ * act like npm but with several differences:
+ *
+ * 1. Depot will hold all versions of each plugin once loaded.
+ * 2. All plugins will be stored in '${home}/${TeamsFx}'.
+ *
+ *  @example
+ *  ~/.fx
+ *  ├── manifest.json
+ *  └── plugins
+ *      ├── bot
+ *      │   ├── 1.0.0
+ *      │   │   └── node_modules
+ *      │   │       └── bot
+ *      │   └── 1.1.0
+ *      │       └── node_modules
+ *      │           └── bot
+ *      ├── function
+ *      │   └── 1.1.0
+ *      │       └── node_modules
+ *      │           └── function
+ *      ├── keyvault
+ *      │   └── 2.0.0
+ *      │       └── node_modules
+ *      │           └── keyvault
+ *      └── ...
+ *
+ * If there's a resident process, depot will keep all of them in memory. Otherwise,
+ * there will be a manifest to optimize performance like an index.
+ */
+const path_1 = require("path");
+const os_1 = require("os");
+const fs_extra_1 = require("fs-extra");
+const proper_lockfile_1 = require("proper-lockfile");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const tools_1 = require("../../common/tools");
+const error_1 = require("../error");
+const constant_1 = require("./constant");
+const utility_1 = require("./utility");
+const semver_1 = require("semver");
+/**
+ * Path is the address of depot to store plugins. Make it static because
+ * this property should be immutable.
+ */
+const DEPOT_ADDR = path_1.join(os_1.homedir(), `.${teamsfx_api_1.ConfigFolderName}`);
+/**
+ * Write plugins as dependencies in package.json file to execute npm install
+ */
+async function writePackageJson(targetFolder, plugins) {
+    await fs_extra_1.ensureDir(targetFolder);
+    const rawData = {
+        // name & version are required in package.json
+        name: teamsfx_api_1.ProductName,
+        version: constant_1.PVM_SPEC_VERSION,
+        dependencies: plugins,
+    };
+    await fs_extra_1.writeFile(path_1.join(targetFolder, constant_1.PACKAGE_DOT_JSON), utility_1.jsonStringifyElegantly(rawData));
+}
+/**
+ * make sure all necessary files/folders are existed.
+ */
+const ensureDepot = () => {
+    /* eslint-disable  @typescript-eslint/no-explicit-any */
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            await fs_extra_1.ensureDir(DEPOT_ADDR);
+            await fs_extra_1.ensureDir(path_1.join(DEPOT_ADDR, constant_1.PLUGINS_FOLDER));
+            if (!(await fs_extra_1.pathExists(path_1.join(DEPOT_ADDR, constant_1.MANIFEST_DOT_JSON)))) {
+                const rawData = {
+                    // name & version are required in package.json
+                    version: constant_1.PVM_SPEC_VERSION,
+                    plugins: {},
+                };
+                await fs_extra_1.writeFile(path_1.join(DEPOT_ADDR, constant_1.MANIFEST_DOT_JSON), utility_1.jsonStringifyElegantly(rawData));
+            }
+            const result = originalMethod.apply(this, args);
+            return result;
+        };
+    };
+};
+class Depot {
+    /**
+     * only support two kinds of package
+     * 1. local path
+     * 2. semantic version
+     *
+     * @param packages - the URI of a package
+     * @returns True if validation passed
+     *
+     * TODO use json-schema to validate
+     */
+    static async validate(plugins) {
+        for (const name in plugins) {
+            const uri = plugins[name];
+            if (semver_1.valid(uri)) {
+                continue;
+            }
+            if (await fs_extra_1.pathExists(path_1.resolve(uri))) {
+                continue;
+            }
+            return false;
+        }
+        return true;
+    }
+    /**
+     * This is a wrapper of 'npm install' and store all packages in address.
+     *
+     * npm install {@link https://docs.npmjs.com/cli/v8/commands/npm-install}
+     *
+     * @param packages - the URI of a package
+     * @returns paths of dynamic plugins. If exceptions, return FxError
+     */
+    static async install(packages) {
+        if (!(await Depot.validate(packages))) {
+            return teamsfx_api_1.err(error_1.InvalidInputError(Object.keys(packages).toString()));
+        }
+        const paths = {};
+        const versions = {};
+        /**
+         * lock is necesscary because there might be several process loading plugins.
+         */
+        try {
+            await proper_lockfile_1.lock(DEPOT_ADDR);
+        }
+        catch (e) {
+            return teamsfx_api_1.err(new teamsfx_api_1.ConcurrentError(error_1.CoreSource));
+        }
+        try {
+            for (const name in packages) {
+                const uri = packages[name];
+                if (await Depot.has(name, uri)) {
+                    continue;
+                }
+                const co = path_1.join(DEPOT_ADDR, constant_1.PLUGINS_FOLDER, name);
+                const plugin = {};
+                plugin[name] = packages[name];
+                // set as "undertermined" and rename after installing
+                const source = path_1.join(co, constant_1.UNDERTERMINED);
+                await writePackageJson(source, plugin);
+                // --prefix set the target diretory of npm package
+                // --no-save will not gen package-lock.json
+                await tools_1.Executor.execCommandAsync(`npm install --prefix ${source} --cwd ${source} --no-save`);
+                // rename the folder by version in node_modules/${name}/package.json
+                const config = await fs_extra_1.readJSON(path_1.join(source, constant_1.NODE_MODULES, name, constant_1.PACKAGE_DOT_JSON));
+                const version = config.version;
+                const destination = path_1.join(co, version);
+                // if already installed, overwrite.
+                if (await fs_extra_1.pathExists(destination)) {
+                    await fs_extra_1.rmdir(destination, { recursive: true });
+                }
+                await fs_extra_1.move(source, destination);
+                // remove temporary package.json
+                await fs_extra_1.remove(path_1.join(destination, constant_1.PACKAGE_DOT_JSON));
+                paths[name] = destination;
+                versions[name] = version;
+            }
+            // sync to manifest
+            Depot.saveManifest(versions);
+        }
+        catch (e) {
+            console.log(e);
+            await proper_lockfile_1.unlock(DEPOT_ADDR);
+            return teamsfx_api_1.err(error_1.LoadPluginError());
+        }
+        await proper_lockfile_1.unlock(DEPOT_ADDR);
+        return teamsfx_api_1.ok(paths);
+    }
+    static async getManifest() {
+        // sync to manifest
+        const manifestPath = path_1.join(DEPOT_ADDR, constant_1.MANIFEST_DOT_JSON);
+        const manifest = (await fs_extra_1.readJSON(manifestPath));
+        return manifest;
+    }
+    /**
+     * @param name - plugin's name
+     * @param version - if set, check specific version of plugin
+     *
+     * @returns whether plugin is existed or not
+     */
+    static async has(name, uri) {
+        const manifest = await Depot.getManifest();
+        if (manifest.plugins[name]) {
+            if (uri) {
+                const vers = manifest.plugins[name];
+                if (vers && vers.includes(uri)) {
+                    return true;
+                }
+            }
+            else {
+                return true;
+            }
+        }
+        return false;
+    }
+    static async saveManifest(plugins) {
+        // sync to manifest
+        const manifestPath = path_1.join(DEPOT_ADDR, constant_1.MANIFEST_DOT_JSON);
+        const manifest = (await fs_extra_1.readJSON(manifestPath));
+        for (const name in plugins) {
+            const version = plugins[name];
+            if (manifest.plugins[name]) {
+                const vers = manifest.plugins[name];
+                if (vers && !vers.includes(version)) {
+                    vers.push(plugins[name]);
+                    manifest.plugins[name] = vers;
+                }
+                else {
+                    manifest.plugins[name] = [version];
+                }
+            }
+            else {
+                manifest.plugins[name] = [version];
+            }
+        }
+        await fs_extra_1.writeFile(manifestPath, utility_1.jsonStringifyElegantly(manifest));
+    }
+}
+tslib_1.__decorate([
+    ensureDepot(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], Depot, "install", null);
+tslib_1.__decorate([
+    ensureDepot(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], Depot, "getManifest", null);
+tslib_1.__decorate([
+    ensureDepot(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], Depot, "has", null);
+exports.Depot = Depot;
+//# sourceMappingURL=depot.js.map

package/build/core/pvm/depot.js.map

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

package/build/core/pvm/pvm.d.ts

@@ -0,0 +1,49 @@
+/**
+ *
+ * PVM(Plugin Version Manager)
+ *
+ * ....................     ....................
+ * .. Project Config ..     .. Dynamic Plugin ..
+ * ....................     ....................
+ *          |                        |
+ *          v                        v
+ *     ............             ...........
+ *     .. Broker ..             .. Depot ..
+ *     ............             ...........
+ *          ^                        ^
+ *          |                        |
+ *          v                        v
+ * .............................................           ...................
+ * ..       PVM(Plugin Version Manager)       .. <-------> .. Static Plugin ..
+ * .............................................           ...................
+ *                    ^
+ *                    |
+ *                    v
+ *                ..........
+ *                .. Core ..
+ *                ..........
+ *
+ * We're gonna setup a community for developers to contribute plugin together, which
+ * means Core should have capability to manage and load plugin dynamically.
+ *
+ * This component will act as:
+ * 1. A depot which holds all plugins with varieties of versions.
+ * 2. A broker which provides C.R.U.D operation of plugin for core.
+ * 3. A coordinator which combines build-in plugins and dynamic plugins.
+ *
+ * PVM will store all plugins with the pattern '${home}/.fx/${plugin}/${version}/'
+ *
+ */
+import { FxError, Result } from "@microsoft/teamsfx-api";
+import { PluginName } from "./type";
+export default class PVM {
+    /**
+     * core should use this api to load plugins of a specific project dynamically
+     *
+     * @param root - target project root path.
+     * @returns error on requiring plugins.
+     */
+    static load(root: string): Promise<Result<PluginName[], FxError>>;
+}
+export declare const BuiltInFeaturePluginNames: string[];
+//# sourceMappingURL=pvm.d.ts.map

package/build/core/pvm/pvm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pvm.d.ts","sourceRoot":"","sources":["../../../src/core/pvm/pvm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAO,OAAO,EAAM,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAKlE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,CAAC,OAAO,OAAO,GAAG;IACtB;;;;;OAKG;WACiB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;CAoB/E;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,EAO7C,CAAC"}

package/build/core/pvm/pvm.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ *
+ * PVM(Plugin Version Manager)
+ *
+ * ....................     ....................
+ * .. Project Config ..     .. Dynamic Plugin ..
+ * ....................     ....................
+ *          |                        |
+ *          v                        v
+ *     ............             ...........
+ *     .. Broker ..             .. Depot ..
+ *     ............             ...........
+ *          ^                        ^
+ *          |                        |
+ *          v                        v
+ * .............................................           ...................
+ * ..       PVM(Plugin Version Manager)       .. <-------> .. Static Plugin ..
+ * .............................................           ...................
+ *                    ^
+ *                    |
+ *                    v
+ *                ..........
+ *                .. Core ..
+ *                ..........
+ *
+ * We're gonna setup a community for developers to contribute plugin together, which
+ * means Core should have capability to manage and load plugin dynamically.
+ *
+ * This component will act as:
+ * 1. A depot which holds all plugins with varieties of versions.
+ * 2. A broker which provides C.R.U.D operation of plugin for core.
+ * 3. A coordinator which combines build-in plugins and dynamic plugins.
+ *
+ * PVM will store all plugins with the pattern '${home}/.fx/${plugin}/${version}/'
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuiltInFeaturePluginNames = void 0;
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const error_1 = require("../error");
+const depot_1 = require("./depot");
+const broker_1 = require("./broker");
+class PVM {
+    /**
+     * core should use this api to load plugins of a specific project dynamically
+     *
+     * @param root - target project root path.
+     * @returns error on requiring plugins.
+     */
+    static async load(root) {
+        const config = await broker_1.Broker.list(root);
+        const result = await depot_1.Depot.install(config);
+        if (result.isOk()) {
+            const plugins = result.value;
+            try {
+                for (const name in plugins) {
+                    await require(name);
+                }
+            }
+            catch (e) {
+                return teamsfx_api_1.err(error_1.LoadPluginError());
+            }
+            const dynamicPlugins = Object.keys(plugins);
+            const allPlugins = [...dynamicPlugins, ...exports.BuiltInFeaturePluginNames];
+            return teamsfx_api_1.ok(allPlugins);
+        }
+        else {
+            return teamsfx_api_1.err(result.error);
+        }
+    }
+}
+exports.default = PVM;
+exports.BuiltInFeaturePluginNames = [
+    "fx-resource-appstudio",
+    "fx-resource-aad",
+    "fx-resource-bot",
+    "fx-resource-azure-web-app",
+    "fx-resource-frontend-hosting",
+    "fx-resource-spfx",
+];
+//# sourceMappingURL=pvm.js.map

package/build/core/pvm/pvm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pvm.js","sourceRoot":"","sources":["../../../src/core/pvm/pvm.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;;;AAEH,wDAAkE;AAElE,oCAA2C;AAC3C,mCAAgC;AAChC,qCAAkC;AAGlC,MAAqB,GAAG;IACtB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY;QACnC,MAAM,MAAM,GAAG,MAAM,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,aAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE;YACjB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;YAC7B,IAAI;gBACF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE;oBAC1B,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;iBACrB;aACF;YAAC,OAAO,CAAC,EAAE;gBACV,OAAO,iBAAG,CAAC,uBAAe,EAAE,CAAC,CAAC;aAC/B;YACD,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,UAAU,GAAG,CAAC,GAAG,cAAc,EAAE,GAAG,iCAAyB,CAAiB,CAAC;YACrF,OAAO,gBAAE,CAAC,UAAU,CAAC,CAAC;SACvB;aAAM;YACL,OAAO,iBAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAC1B;IACH,CAAC;CACF;AA3BD,sBA2BC;AAEY,QAAA,yBAAyB,GAAa;IACjD,uBAAuB;IACvB,iBAAiB;IACjB,iBAAiB;IACjB,2BAA2B;IAC3B,8BAA8B;IAC9B,kBAAkB;CACnB,CAAC"}

package/build/core/pvm/type.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Actually, you can just use `type xx = string` to create an alias for a type.
+ * This kind of implement just makes the code more readable and easy to index.
+ */
+export declare type alias<T> = T;
+export declare type PluginName = alias<string>;
+export declare type PluginURI = alias<string>;
+export declare type PluginVersion = alias<string>;
+export declare type PluginPath = alias<string>;
+export declare type Plugins = alias<Record<PluginName, PluginURI>>;
+//# sourceMappingURL=type.d.ts.map

package/build/core/pvm/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../src/core/pvm/type.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;AAEzB,oBAAY,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AACvC,oBAAY,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AACtC,oBAAY,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAC1C,oBAAY,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAEvC,oBAAY,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC"}

package/build/{plugins/resource/apim/interfaces/IApimResource.js → core/pvm/type.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=IApimResource.js.map
+//# sourceMappingURL=type.js.map

package/build/core/pvm/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../src/core/pvm/type.ts"],"names":[],"mappings":""}

package/build/core/pvm/utility.d.ts

@@ -0,0 +1,2 @@
+export declare function jsonStringifyElegantly(v: any): string;
+//# sourceMappingURL=utility.d.ts.map

package/build/core/pvm/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../../src/core/pvm/utility.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAErD"}

package/build/core/pvm/utility.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonStringifyElegantly = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
+function jsonStringifyElegantly(v) {
+    return JSON.stringify(v, null, 2);
+}
+exports.jsonStringifyElegantly = jsonStringifyElegantly;
+//# sourceMappingURL=utility.js.map

package/build/core/pvm/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../src/core/pvm/utility.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AACvD,sEAAsE;AACtE,SAAgB,sBAAsB,CAAC,CAAM;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC;AAFD,wDAEC"}