@codiac.io/codiac-cli 1.2.217 → 1.2.221

package/dist/commands/config/settings/get.js

@@ -0,0 +1,297 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const YAML = require("yaml");
+const _ = require("lodash");
+const contracts_1 = require("@codiac.io/codiac-common/contracts");
+const codiac_common_1 = require("@codiac.io/codiac-common");
+const contracts_2 = require("../../../apis/codiac-api/contracts");
+const command_base_enterprise_1 = require("../../../command-base-enterprise");
+const render = require("../../../uilogic/render-methods");
+const render_methods_1 = require("../../../uilogic/render-methods");
+const config_ui_utils_1 = require("../../../uilogic/config-ui-utils");
+class ConfigSettingsGet extends command_base_enterprise_1.CommandBaseEnterprise {
+    constructor() {
+        super(...arguments);
+        // protected takeDefaults: boolean = false;
+        /** CLI Command-line string to rerun this execution as a non-TTY script. */
+        this.cmd = ["cod", "config", "settings", "get", "--silent"];
+    }
+    // --------------------------------------------------------------------
+    // Lazy-loaded properties
+    get configUtils() {
+        if (this._configUtils_backer === undefined) {
+            this._configUtils_backer = this.ioc.get(config_ui_utils_1.ConfigUiUtils);
+        }
+        return this._configUtils_backer;
+    }
+    // --------------------------------------------------------------------
+    bootstrap() {
+        super.bootstrap();
+        this.ioc.bind(config_ui_utils_1.ConfigUiUtils).toSelf();
+    }
+    run() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            this.bootstrap();
+            yield this.readStdin();
+            try {
+                // 0. SET DEFAULTS
+                this._userCntx = yield this.establishTenantContext(this._userCntx);
+                let currentEnterprise = (yield this.establishEnterpriseContext()).enterprise; // We only need this bc the RootMap requires it.
+                // 1. CAPTURE ARGS
+                let [partial, interactionMode, outputFormat] = yield this.captureArgs(currentEnterprise);
+                // 2. VALIDATE AND ACQUIRE INPUT
+                let rootMap = yield this.getRootMap(partial.enterprise);
+                let candidate;
+                if (interactionMode == config_ui_utils_1.InteractionModes.silent) {
+                    candidate = this.buildCandidate_silently(partial, rootMap);
+                }
+                else {
+                    candidate = yield this.buildCandidate_interactively(partial, rootMap);
+                }
+                // In case we're hanging waiting for piped-in data that doesnt exist... 
+                if (!process.stdin.destroyed)
+                    process.stdin.destroy();
+                if (candidate == undefined) {
+                    this.logger.notice(`Operation cancelled. No work was done.`);
+                    this._ui.userMessage(`Operation cancelled. No work was done.`);
+                    this.exit(0);
+                }
+                else {
+                    // 3. RENDER COMMAND STRING
+                    if (interactionMode != undefined && [config_ui_utils_1.InteractionModes.echo, config_ui_utils_1.InteractionModes.toscript].includes(interactionMode)) {
+                        this.cmd = this.buildCommandString(candidate, outputFormat, this.cmd);
+                        this._ui.userMessage(this.cmd.join(" "));
+                    }
+                    if (interactionMode != config_ui_utils_1.InteractionModes.toscript) {
+                        // 4. EXECUTE THE MAIN TASK
+                        yield this.executeTask(candidate, outputFormat);
+                    }
+                }
+                return;
+            }
+            catch (err) {
+                // throw err;
+                this.handleError(err);
+            }
+        });
+    }
+    captureArgs(currentEnterprise) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { args, flags } = yield this.parse(ConfigSettingsGet);
+            let partial = {};
+            partial.enterprise = (_a = flags.enterprise) !== null && _a !== void 0 ? _a : currentEnterprise.code;
+            partial.asset = flags.asset;
+            if (flags.type) {
+                partial.configType = Object.values(config_ui_utils_1.SpecialConfigTypes).find(x => x.toString() == flags.type);
+                if (partial.configType == undefined)
+                    delete partial.configType;
+            }
+            else if (flags.file) {
+                partial.targetFile = flags.file;
+            }
+            partial.scope =
+                (_c = (_b = (flags['enterprise-scope'] ? contracts_2.ScopeLevel.enterprise : undefined)) !== null && _b !== void 0 ? _b : (flags.enviro ? contracts_2.ScopeLevel.environment : undefined)) !== null && _c !== void 0 ? _c : (flags.cabinet ? contracts_2.ScopeLevel.cabinet : undefined);
+            partial.target =
+                (_e = (_d = (flags['enterprise-scope'] ? partial.enterprise : undefined)) !== null && _d !== void 0 ? _d : flags.enviro) !== null && _e !== void 0 ? _e : flags.cabinet;
+            if (flags.setting)
+                partial.setting = flags.setting;
+            if (flags.value)
+                partial.value = flags.value;
+            const interactionMode = (_g = (_f = (flags.echo ? config_ui_utils_1.InteractionModes.echo : undefined)) !== null && _f !== void 0 ? _f : (flags["to-script"] ? config_ui_utils_1.InteractionModes.toscript : undefined)) !== null && _g !== void 0 ? _g : (flags.silent ? config_ui_utils_1.InteractionModes.silent : undefined);
+            // this.takeDefaults = flags["--take-defaults"] ?? false;
+            let outputFormat = (flags.output) ? render_methods_1.OutputFormatsEnum[flags.output] : render_methods_1.OutputFormatsEnum.json;
+            return [partial, interactionMode, outputFormat];
+        });
+    }
+    buildCandidate_silently(partial, rootMap) {
+        let output;
+        try {
+            if (partial.enterprise == undefined)
+                throw new Error("Must specify the enterprise of the asset.");
+            let ent = rootMap.enterprises.find(x => x.name === partial.enterprise);
+            if (ent == undefined)
+                throw new Error(`No enterprise was found with that name.`);
+            if (partial.asset == undefined)
+                throw new Error("Must specify the asset.");
+            let asset = ent.assets.find(x => x.name === partial.asset);
+            if (asset === undefined)
+                throw new Error(`No asset was found with that name.`);
+            if (partial.targetFile == undefined && partial.configType == undefined)
+                throw new Error("Must specify the file or type.");
+            // output = {
+            //   enterprise: partial.enterprise,
+            //   asset: partial.asset,
+            //   targetFile: partial.targetFile,
+            //   scope: partial.scope,
+            //   target: partial.target
+            // };
+            output = partial;
+            return output;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    buildCandidate_interactively(partial, rootMap) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            let output;
+            try {
+                // Enterprise
+                let ent = yield this.configUtils.promptForEnterprise(partial, rootMap);
+                partial.enterprise = ent.name; // This is just for TS context (the method above already set this).
+                // Asset
+                let assetChanged;
+                [partial.asset, assetChanged] = yield this.configUtils.promptForAsset(ent.assets, partial.asset);
+                // Type/File
+                // TODO: Can we include the configDefs in the RootMap?
+                let typeFileChanged;
+                let existingSettings;
+                [partial.configType, partial.targetFile, existingSettings, typeFileChanged] = yield this.configUtils.promptForTypeAndFile(partial.enterprise, partial.asset, partial.configType, partial.targetFile);
+                // Scope
+                let targetChanged = false;
+                [partial.scope, partial.target, targetChanged] = yield this.configUtils.validateAndPromptForScope(rootMap, partial.enterprise, partial.scope, partial.target, existingSettings, false);
+                // Setting names?
+                // Setting values?
+                // value vs Secret/Ref?
+                output = partial;
+                return output;
+            }
+            catch (err) {
+                throw err;
+            }
+        });
+    }
+    buildCommandString(ultimate, outputFormat, cmd) {
+        cmd.push("-o", outputFormat);
+        cmd.push("--enterprise", ultimate.enterprise);
+        cmd.push("-a", ultimate.asset);
+        if (ultimate.configType) {
+            cmd.push("-t", ultimate.configType);
+        }
+        else {
+            cmd.push("-f", ultimate.targetFile); // assertion is ok bc we forced one or the other just above ^.
+        }
+        if (ultimate.scope) {
+            if (ultimate.scope == contracts_2.ScopeLevel.enterprise) {
+                cmd.push("--enterprise-scope");
+            }
+            else if (ultimate.target) {
+                if (ultimate.scope == contracts_2.ScopeLevel.environment)
+                    cmd.push("-e", ultimate.target);
+                if (ultimate.scope == contracts_2.ScopeLevel.cabinet)
+                    cmd.push("-c", ultimate.target);
+            }
+        }
+        if (ultimate.setting)
+            cmd.push("--setting", ultimate.setting);
+        if (ultimate.value)
+            cmd.push("--value", ultimate.value);
+        return cmd;
+    }
+    executeTask(candidate, outputFormat) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // 4. RETRIEVE 
+            let settings = yield this.fetch(candidate, outputFormat);
+            // 5. RENDER
+            this.render(settings, outputFormat);
+        });
+    }
+    fetch(candidate, outputFormat) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                if ([render_methods_1.OutputFormatsEnum.json, render_methods_1.OutputFormatsEnum.yaml].includes(outputFormat) === false)
+                    this._ui.startSpinner("Retrieving");
+                let crit = {};
+                crit.enterprise = new contracts_1.StringFilter();
+                crit.enterprise.$eq = candidate.enterprise;
+                crit.asset = new contracts_1.StringFilter();
+                crit.asset.$eq = candidate.asset;
+                crit.targetFile = new contracts_1.StringFilter();
+                crit.targetFile.$eq = candidate.targetFile;
+                if (candidate.scope && !_.isEmpty(candidate.scope))
+                    crit.scope = candidate.scope;
+                if (candidate.target && !_.isEmpty(candidate.target))
+                    crit.target = candidate.target;
+                if ((candidate.setting != undefined) && (!_.isEmpty(candidate.setting))) {
+                    crit.setting = candidate.setting;
+                }
+                // if ((candidate.value != undefined) && (!_.isEmpty(candidate.value))) {
+                //   crit.value = candidate.value;
+                // }
+                // crit.sort = ["enterprise", "asset", "targetFile", "setting", "scope"];
+                let prjxn = { pathsIncluded: ["setting", "value", "source"], pathsExcluded: [] };
+                let settings = yield this._codiacApi.ScopedSetting.readMany(crit, { throwNotFound: false, projection: prjxn });
+                settings = _.sortBy(settings, x => x.enterprise, x => x.asset, x => x.targetFile, x => x.setting); // TODO: sort in the crit
+                // TODO: COnsider moving this into the api?
+                settings.forEach(s => {
+                    delete s.id;
+                    if (s.source != undefined && !_.isEmpty(s.source)) {
+                        s.value = `#REF|${s.source.type}|${s.source.name}|${s.source.key}`;
+                        delete s.source;
+                    }
+                    else if (_.isEmpty(s.source))
+                        delete s.source;
+                });
+                if ([render_methods_1.OutputFormatsEnum.json, render_methods_1.OutputFormatsEnum.yaml].includes(outputFormat) === false)
+                    this._ui.stopSpinner(`found ${settings.length}`);
+                return settings;
+            }
+            catch (err) {
+                throw err;
+            }
+        });
+    }
+    /** Renders the given settings as a hierarchical config doc (NOT a list of key-value pairs) */
+    render(settings, outputFormat) {
+        let output = "";
+        // Unflatten into a config doc
+        let doc = {};
+        for (let setting of settings) {
+            doc[setting.setting] = setting.value;
+        }
+        doc = codiac_common_1.ObjectFlattener.unflatten(doc);
+        switch (outputFormat) {
+            case render_methods_1.OutputFormatsEnum.yaml:
+                output = YAML.stringify(doc, { indent: 2 });
+                break;
+            case render_methods_1.OutputFormatsEnum.json:
+                output = JSON.stringify(doc, undefined, 2);
+                break;
+            case render_methods_1.OutputFormatsEnum.text:
+                let list = settings.map(s => `${this._styler.dim(s.setting)}:  ${s.value}`);
+                output = render.renderStringList(list);
+                break;
+            case render_methods_1.OutputFormatsEnum.tree:
+            default:
+                let tree = this.configUtils.buildConfigTree(settings);
+                output = render.renderStringTree(tree);
+                break;
+        }
+        this._ui.userMessage(output);
+    }
+}
+exports.default = ConfigSettingsGet;
+ConfigSettingsGet.description = 'Shows the list of clusters.';
+ConfigSettingsGet.aliases = ["cluster:list"];
+ConfigSettingsGet.flags = {
+    enterprise: core_1.Flags.string({ char: 'n', description: '(required only when more than one enterprise exists) The name of the enterprise containing the asset.' }),
+    asset: core_1.Flags.string({ char: 'a', description: 'The name of the asset to which the settings belong.' }),
+    file: core_1.Flags.string({ char: 'f', exclusive: ["type"], description: 'The path-name to the file to which the settings belong, relative to the root of the container image.' }),
+    type: core_1.Flags.string({ char: 't', exclusive: ["file"], options: Object.keys(config_ui_utils_1.SpecialConfigTypes), description: 'Filters for the settings types that do not land in a config file (such as... env: OS environment variables, footprint: container footprint specs, and helm: helm chart settings).' }),
+    "enterprise-scope": core_1.Flags.boolean({ char: 's', exclusive: ["enviro", "cabinet"], description: 'Filters for settings scoped at the enterprise level.' }),
+    enviro: core_1.Flags.string({ char: 'e', exclusive: ["enterprise-scope", "cabinet"], description: 'Filters for settings scoped to the given environment name.' }),
+    cabinet: core_1.Flags.string({ char: 'c', exclusive: ["enterprise-scope", "enviro"], description: 'Filters for settings scoped to the given cabinet name.' }),
+    setting: core_1.Flags.string({ description: 'Glob for settings names. Filters for individual settings with matching names.' }),
+    value: core_1.Flags.string({ description: 'Glob for settings values. Filters for individual settings with matching values.' }),
+    output: core_1.Flags.string({ char: 'o', default: render_methods_1.OutputFormatsEnum.json, description: "format in which to render the data.", options: Object.keys(render_methods_1.OutputFormatsEnum) }),
+    silent: core_1.Flags.boolean({ exclusive: ["echo", "to-script"], description: 'Non-Interactive mode; executes without any user interaction and fails on any missing or invalid arguments.' }),
+    echo: core_1.Flags.boolean({ exclusive: ["to-script", "silent"], description: 'Echo interaction mode; renders the equivalent non-interactive cli command for future use before final execution.' }),
+    "to-script": core_1.Flags.boolean({ exclusive: ["echo", "silent"], description: 'Toscript interaction mode; renders the equivalent non-interactive cli command WITHOUT any execution.' }),
+    "take-defaults": core_1.Flags.boolean({ exclusive: ["silent"], description: "Prevents prompting for confirmation on parameters that were passed in or were set to default values." }),
+    help: core_1.Flags.help({ char: 'h', description: 'Displays the help document for this command.' })
+};
+ConfigSettingsGet.args = {};
+//# sourceMappingURL=get.js.map

package/dist/commands/config/settings/get.js.map

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

package/dist/uilogic/config-ui-utils.d.ts

@@ -0,0 +1,112 @@
+import { AtLeast } from "@codiac.io/codiac-common/contracts";
+import { IOutputStyler, IUserInputProvider } from "@codiac.io/codiac-ops-common";
+import { CodiacClient } from "../apis/codiac-api";
+import { CabinetClusterRoot, ConfigDef, EnterpriseRoot, EnvironmentRoot, RootMap, ScopedSetting, ScopeLevel } from "../apis/codiac-api/contracts";
+export type TextValueParent = {
+    text: string;
+    value: string;
+    children?: TextValueParent[];
+};
+export declare enum SpecialConfigTypes {
+    "env" = "env",
+    "footprint" = "footprint",
+    "helm" = "helm"
+}
+export declare enum InteractionModes {
+    "echo" = "echo",
+    "toscript" = "toscript",
+    "silent" = "silent"
+}
+export declare class ConfigUiUtils {
+    private _ui;
+    private _styler;
+    private _codiacApi;
+    buildConfigTree(settings: Pick<ScopedSetting, "setting" | "value">[]): TextValueParent[];
+    constructor(_ui: IUserInputProvider, _styler: IOutputStyler, _codiacApi: CodiacClient);
+    /** Validates the candidate's current value,
+     * prompts the user if necessary,
+     * mutates the candidate as needed,
+     * and returns the applicable enterprise obj from the RootMap.
+     *
+     * Throws when unable to assign one,
+     * so otherwise, candidate SHALL ALWAYS end up with an enterprise assigned.*/
+    promptForEnterprise<TCandidate extends {
+        enterprise?: string | undefined;
+    }>(candidate: TCandidate, rootMap: RootMap): Promise<EnterpriseRoot>;
+    /** Returns the ultiamate asset name and the flag telling whether the original user input was changed. */
+    promptForAsset(assets: {
+        name: string;
+    }[], current?: string | undefined): Promise<[string, boolean]>;
+    promptForTypeAndFile(enterprise: string, asset: string, configType?: SpecialConfigTypes | undefined, targetFile?: string | undefined, existingConfigDefs?: Pick<ConfigDef, "type" | "targetFile">[] | undefined): Promise<[SpecialConfigTypes | undefined, string | undefined, ScopedSetting[] | undefined, boolean]>;
+    /** Prompts for a single setting name.
+   *
+   * TODO: Add ability to select branches of settings (globbed dot-paths)
+   * so user can delete entire sections at a time (eg: database-settings.*).
+   *
+   *
+   * Use this inquirer plugin for navigating the object structure:
+   *    https://github.com/insightfuls/inquirer-tree-prompt
+   *
+   * See if this file tree selector could be fashioned to do the same:
+   *    https://github.com/anc95/inquirer-file-tree-selection
+   *
+   * @param existing The list of existing settings to choose from.
+   * @param mode Set this to `write` only if you want the user to be able to add new settings.  Indicates whether "Add New" (mode: `write`) or "All" (mode: `read`) options will be provided.
+   * @param given A prompt gets invoked in `read` mode only if none match any existing settings, and in `write` mode only if none are given at all.
+   */
+    promptForOneSetting(existing: ScopedSetting[], mode?: "read" | "write", given?: string | undefined): Promise<[string, ScopedSetting[], boolean]>;
+    /** Prompts for one or many setting names.  Includes an `ALL` but NOT an `ADDNEW` option.
+     *
+     * TODO: Add ability to select branches of settings (globbed dot-paths)
+     * so user can delete entire sections at a time (eg: database-settings.*).
+     *
+     *
+     * Use this inquirer plugin for navigating the object structure:
+     *    https://github.com/insightfuls/inquirer-tree-prompt
+     *
+     * See if this file tree selector could be fashioned to do the same:
+     *    https://github.com/anc95/inquirer-file-tree-selection
+     *
+     * @param existing
+     * @param given A prompt gets invoked only if no givens match any existing settings.
+     */
+    promptForManySettings(existing: ScopedSetting[], given?: string | string[] | undefined, multi?: boolean): Promise<[string[], ScopedSetting[], boolean]>;
+    /** Searches out availables that match ANY of the given specs.
+     * @param availables: setting objects to search for.
+     * @param matchSpecs: each can be either a distinct setting name (eg `shoe-size`) or a glob (eg `api-settings.*`).
+     */
+    private static matchMultipleWithGlobbing;
+    /** Determines if the two collections have ANY different concrete values,
+     * regardless of order or string/array/undefined/empty)
+     *
+     * ```
+     * DIFFERENT IF:
+     * any of A not in B
+     * AND
+     * any of B not in A
+     * ```
+     * */
+    private static areDifferent;
+    validateAndPromptForScope(rootMap: RootMap, enterprise: string, scope?: ScopeLevel | undefined, target?: string | undefined, existings?: AtLeast<ScopedSetting, "scope" | "target">[], allowEverywhere?: boolean): Promise<[(ScopeLevel | undefined), (string | undefined), boolean]>;
+    promptForScope(enterprise: string, rootMap: RootMap, existings?: AtLeast<ScopedSetting, "scope" | "target">[], allowEverywhere?: boolean, prompt?: string): Promise<Pick<ScopedSetting, "scope" | "target"> | undefined>;
+    /** sets each value to "scope|target".
+   * */
+    buildCabinetTree(rootMap: RootMap, existings?: AtLeast<ScopedSetting, "scope" | "target">[]): TextValueParent[];
+    /** Truncates the string to the given length with an ellipses as suffix */
+    private ellipsis;
+    private buildSelectChoicesFrom;
+    /** Determines the format of the string that was piped in,
+   * and parses it into an object in memory.
+   *
+   * Supports formats:  json, yaml
+   */
+    parseInputString(input: string): {
+        setting: string;
+        value: any;
+    }[];
+}
+/** Finds the object in the rootmap (ent, env, or cab) specified by the given scope.
+*
+* Returns undefined if the scope/target combination does not exist.
+*/
+export declare function findScopeTarget(rootMap: RootMap, scope: ScopeLevel, target: string): EnterpriseRoot | EnvironmentRoot | CabinetClusterRoot | undefined;