@codiac.io/codiac-cli 1.2.18

package/lib/cli-common/argument-manager.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgumentManager = exports.PROMPT_ME_DESIGNATOR = void 0;
+const tslib_1 = require("tslib");
+const _ = require("lodash");
+const command_base_1 = require("./command-base"); // Circular ref... lovely.
+/** The value provided as input that indicates
+ * a user's desire to be prompted with a list from which choose the value(s),
+ * instead of entering them manually or taking a default. */
+exports.PROMPT_ME_DESIGNATOR = "?";
+/** Persists and retrieves memorized command arguments. */
+class ArgumentManager {
+    constructor(commandName, projCfg, projCfgRepo, logger, _ui) {
+        this.commandName = commandName;
+        this.projCfg = projCfg;
+        this.projCfgRepo = projCfgRepo;
+        this.logger = logger;
+        this._ui = _ui;
+    }
+    runWithDefaults(input, handler) {
+        return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                if (input.flags.unremember) {
+                    yield this.unmemorizeCommand(this.commandName, input.flags.unremember);
+                }
+                else {
+                    if (!input.flags.withoutdefaults) {
+                        yield this.setDefaults(input.args, input.flags);
+                    }
+                    yield handler(input.args, input.flags);
+                }
+                if (input.flags.remember || input.flags.rememberAs) {
+                    // this.memorizeCommand_old(this.commandName, this.argv, flags.rememberAs);
+                    yield this.memorizeCommand(this.commandName, input.args, input.flags, input.flags.rememberAs);
+                }
+                resolve();
+            }
+            catch (err) {
+                reject(err);
+            }
+        }));
+    }
+    /** Mutates the args and flags with default values. */
+    setDefaults(args, flags) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c, _d;
+                try {
+                    // did they invoke a memorized call?
+                    if (flags.as) {
+                        if (((_a = this.projCfg) === null || _a === void 0 ? void 0 : _a.namedCalls) && ((_b = this.projCfg) === null || _b === void 0 ? void 0 : _b.namedCalls[this.commandName])) {
+                            let namedCall;
+                            if (flags.as === exports.PROMPT_ME_DESIGNATOR) {
+                                let calls = _.keys(this.projCfg.namedCalls[this.commandName]).sort();
+                                namedCall = (yield this._ui.promptSelect("namedCall", "Select a build command:", calls));
+                                flags.as = namedCall;
+                            }
+                            else {
+                                namedCall = flags.as;
+                            }
+                            let defaults = this.projCfg.namedCalls[this.commandName][namedCall];
+                            if (defaults) {
+                                if (defaults.args)
+                                    _.defaults(args, defaults.args);
+                                if (defaults.flags)
+                                    _.defaults(flags, defaults.flags);
+                                this.logger.debug(`Argument defaults were provided from memorized call in project config: [${namedCall}].`);
+                                this.logger.debug(JSON.stringify(defaults));
+                            }
+                            else
+                                throw new Error(`Could not find named call: [${namedCall}]`);
+                        }
+                        else
+                            throw new Error(`There are no named calls memorized.`);
+                    }
+                    // DO we have defaults?
+                    if (((_c = this.projCfg) === null || _c === void 0 ? void 0 : _c.namedCalls) && ((_d = this.projCfg) === null || _d === void 0 ? void 0 : _d.namedCalls[this.commandName])) {
+                        let defaults = this.projCfg.namedCalls[this.commandName].default;
+                        if (defaults) {
+                            if (defaults.args)
+                                _.defaults(args, defaults.args);
+                            if (defaults.flags)
+                                _.defaults(flags, defaults.flags);
+                            this.logger.debug(`Argument defaults provided from project config.`);
+                            this.logger.debug(JSON.stringify(defaults));
+                        }
+                    }
+                    this.logger.debug(`Ultimate argument values: ${JSON.stringify(Object.assign(Object.assign({}, args), flags))}`);
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    memorizeCommand(commandName, args, flags, givenName = "default") {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    // We dont want to remember these flags...
+                    let omitList = [
+                        command_base_1.commandBase.globalFlags.as.name,
+                        command_base_1.commandBase.globalFlags.remember.name,
+                        command_base_1.commandBase.globalFlags.rememberAs.name,
+                        command_base_1.commandBase.globalFlags.unremember.name,
+                        command_base_1.commandBase.globalFlags.withoutdefaults.name
+                    ];
+                    this.logger.debug(`Memorizing [${commandName}] argument list as: ${givenName}...`);
+                    let calls = {};
+                    if (this.projCfg && this.projCfgRepo) {
+                        if (!this.projCfg.namedCalls)
+                            this.projCfg.namedCalls = {};
+                        calls = this.projCfg.namedCalls[commandName] || {};
+                    }
+                    // for (let arg in args) {
+                    //   if (omitList.indexOf(arg) > 0)
+                    // }
+                    let trimmed = Object.assign({}, flags);
+                    for (let unmemorable in omitList) {
+                        _.unset(trimmed, omitList[unmemorable]);
+                    }
+                    // let call = "";
+                    // // Add args
+                    // for (let name in args) {
+                    //   if (call != "") call = call.concat(" ");
+                    //   let val: string = args[name];
+                    //   val = (val.match && val.match(/\s/)) ? this.inQuotes(val) : val;
+                    //   call = call.concat(val);  // for args, we dont want the arg name, just the value
+                    // }
+                    // // Add flags
+                    // for (let flagName in trimmed) {
+                    //   if (call != "") call = call.concat(" ");
+                    //   call = call.concat("--", flagName);
+                    //   if (trimmed[flagName]) {
+                    //     let flagVal: string = trimmed[flagName];
+                    //     flagVal = (flagVal.match && flagVal.match(/\s/)) ? this.inQuotes(flagVal) : flagVal;
+                    //     call = call.concat(" ", flagVal);
+                    //   }
+                    // }
+                    calls[givenName] = { args: args, flags: trimmed };
+                    // Write to project config
+                    if (this.projCfg && this.projCfgRepo) {
+                        if (!this.projCfg.namedCalls)
+                            this.projCfg.namedCalls = {};
+                        this.projCfg.namedCalls[commandName] = calls;
+                        yield this.projCfgRepo.updateProjectConfigFile(this.projCfg);
+                        this.logger.notice("Successfully remembered for the project.");
+                    }
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    inQuotes(original) {
+        let escaped = original.replace("\"", "\\\"");
+        return `"${original}"`;
+    }
+    isEmpty(obj) {
+        // this.logger.trace(`obj has ${Object.keys(obj).length} keys.`);
+        return Object.keys(obj).length == 0;
+    }
+    unmemorizeCommand(commandName, givenName = "default") {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                var _a;
+                try {
+                    this.logger.debug(`Removing memorized [${commandName}] argument list: ${givenName}...`);
+                    if (this.projCfgRepo && ((_a = this.projCfg) === null || _a === void 0 ? void 0 : _a.namedCalls)
+                        && this.projCfg.namedCalls[commandName]
+                        && this.projCfg.namedCalls[commandName][givenName]) {
+                        _.unset(this.projCfg.namedCalls[commandName], givenName);
+                        if (this.isEmpty(this.projCfg.namedCalls[commandName])) {
+                            _.unset(this.projCfg.namedCalls, commandName);
+                            if (this.isEmpty(this.projCfg.namedCalls)) {
+                                _.unset(this.projCfg, "namedCalls");
+                            }
+                        }
+                        yield this.projCfgRepo.updateProjectConfigFile(this.projCfg);
+                        this.logger.notice("Successfully removed.");
+                    }
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+}
+exports.ArgumentManager = ArgumentManager;
+//# sourceMappingURL=argument-manager.js.map

package/lib/cli-common/argument-manager.js.map

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

package/lib/cli-common/built-in-cli-user-input.d.ts

@@ -0,0 +1,18 @@
+import { IUserInputProvider, EntryValue, choice, FileSelectionOptions, FolderSelectionOptions, IEntryValidator } from "@codiac.io/codiac-ops-common";
+/** Uses cli-ux and inquirer libraries to retrieve values from the user.
+ * Requires a TTY console.
+ * @see https://www.npmjs.com/package/inquirer
+ */
+export declare class BuiltInCliUserInput implements IUserInputProvider {
+    constructor();
+    userMessage(message: string): void;
+    prompt<T extends EntryValue>(id: string, prompt: string, required?: boolean, defaultValue?: T | undefined, validator?: IEntryValidator<T>): Promise<T | undefined>;
+    promptPassword(id: string, prompt: string, defaultValue?: string, validator?: IEntryValidator<string>): Promise<string>;
+    promptConfirm(id: string, prompt: string, defaultValue?: boolean): Promise<boolean>;
+    promptSelect<T extends EntryValue>(id: string, prompt: string, choices: choice<T>[], multiSelect?: boolean | undefined, loop?: boolean | undefined): Promise<T | undefined>;
+    promptSelectFile(id: string, prompt: string, fileOptions: FileSelectionOptions): Promise<string>;
+    promptSelectFolder(id: string, prompt: string, folderOptions: FolderSelectionOptions): Promise<string>;
+    openUrl(url: string): Promise<void>;
+    startSpinner(userMessage: string): void;
+    stopSpinner(userMessage: string): void;
+}

package/lib/cli-common/built-in-cli-user-input.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuiltInCliUserInput = void 0;
+const tslib_1 = require("tslib");
+const path = require("path");
+const core_1 = require("@oclif/core");
+const inquirer = require("inquirer");
+const file_selector_1 = require("./file-selector");
+const inversify_1 = require("inversify");
+// // Moved to ops-common
+// export class FolderSelectionOptions {
+//   /** The path under which the user is allowed to navigate (optional: Defaults to the current path).
+//    * This path is also acts as the parent folder from which any relative path gets derived. */
+//   public root?: string
+//   /** The folder to begin the search within (optional: defaults to the current path) */
+//   public startingPath?: string;
+//   /** Causes the selection to be returned as a path relative to "root" (optional: defaults to false).  */
+//   public asRelative?: boolean;
+// }
+// // Moved to ops-common
+// export class FileSelectionOptions extends FolderSelectionOptions {
+//   /** List of file extensions (without the period '.') on which to filter the available files. */
+//   public extensions?: string[];
+// }
+// /** Just documenting the options arg from cli-select-file, cuz they dont have a type def. */
+// type CliSelectFileOptions = {
+//   /** integer, Default value is 10 */
+//   pageSize?: number,
+//   /** Defaults to true to allow for selection of multiple files */
+//   multi?: boolean,
+//   /** Files that will initially be selected */
+//   selectedFiles?: string[],
+//   /** Defaults to true */
+//   clearConsole?: boolean,
+//   /** Where the user will initially be prompted to select files
+//   Defaults to process.cwd() */
+//   startingPath?: string,
+//   /** The top level directory the user has access to
+//   Defaults to process.cwd() */
+//   root?: string,
+//   /** Return false for any directory that you do not want to appear in the cli 
+//   ```
+//   directoryFilter?: (directoryName) => {
+//       return !/node_modules$/gi.test(directoryName);
+//   },
+//   ```
+//   */
+//   directoryFilter?: (directoryName: string) => boolean,
+//   /** Return false for any file that you do not want to appear in the cli 
+//     ```
+//     fileFilter: (fileName) => {
+//       return !/index.js$/gi.test(fileName);
+//     },
+//     ```
+//   */
+//   fileFilter?: (fileName: string) => boolean
+// } 
+// type CLISelectFileResult = {
+//   selectedFiles: string[],
+//   status: string
+// }
+/** Uses cli-ux and inquirer libraries to retrieve values from the user.
+ * Requires a TTY console.
+ * @see https://www.npmjs.com/package/inquirer
+ */
+let BuiltInCliUserInput = class BuiltInCliUserInput {
+    constructor() {
+    }
+    // ----------------------------------------------------
+    // ALSO:   Consider using this lib...
+    //         "prompts"
+    //         https://www.npmjs.com/package/prompts
+    //         (good docs, adoption, interface, and smooth ux)
+    //         * text
+    //         * password
+    //         * invisible
+    //         * number
+    //         * confirm
+    //         * list
+    //         * toggle
+    //         * select
+    //         * multiselect
+    //         * autocompleteMultiselect
+    //         * autocomplete
+    //         * date
+    // ----------------------------------------------------
+    // ----------------------------------------------------
+    // For spinners...
+    //        "ora"           https://www.npmjs.com/package/ora
+    //        "cli-spinners"  https://www.npmjs.com/package/cli-spinners (components for ora)
+    //        "nanospinner"   https://www.npmjs.com/package/nanospinner
+    //        "tinyspinner"   https://www.npmjs.com/package/tiny-spinner
+    // ----------------------------------------------------
+    // ----------------------------------------------------
+    // For tables...
+    //        "list-it"       https://www.npmjs.com/package/list-it
+    //        "easy-table"    https://www.npmjs.com/package/easy-table
+    // ----------------------------------------------------
+    userMessage(message) {
+        core_1.CliUx.ux.log(message);
+    }
+    prompt(id, prompt, required = false, defaultValue, validator) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                var _a;
+                try {
+                    let output;
+                    // "Required" is not supported here.
+                    if (validator === undefined) {
+                        let result = yield inquirer.prompt({ type: "input", name: id, message: prompt, default: defaultValue });
+                        output = (result[id]); // <--- mind this!
+                    }
+                    else {
+                        let validation;
+                        let candidate;
+                        while (candidate === undefined || (validation === null || validation === void 0 ? void 0 : validation.isValid) !== true) {
+                            let promptRes = yield inquirer.prompt({ type: "input", name: id, message: prompt, default: defaultValue });
+                            candidate = (promptRes[id]); // <--- mind this!
+                            validation = validator.isValid(candidate);
+                            if (!validation.isValid) {
+                                this.userMessage(`INVALID: ${(_a = validation.whyInvalid) !== null && _a !== void 0 ? _a : ""}`);
+                            }
+                        }
+                        output = candidate;
+                    }
+                    resolve(output);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+            // // Prompts using cli-ux
+            // let options = <IPromptOptions>{ prompt: prompt };
+            //     if (required) options.required = required;
+            //     if (defaultValue) options.default = <any>defaultValue;  // this doesnt work
+            // return cli.prompt("myField", options);
+        });
+    }
+    promptPassword(id, prompt, defaultValue, validator) {
+        var _a;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // Prompts using cli-ux
+            let options = { prompt: prompt, type: "hide", required: true };
+            if (validator === undefined) {
+                return core_1.CliUx.ux.prompt(id, options);
+            }
+            else {
+                let validation;
+                let candidate;
+                while (candidate === undefined || (validation === null || validation === void 0 ? void 0 : validation.isValid) !== true) {
+                    candidate = yield core_1.CliUx.ux.prompt(id, options);
+                    validation = validator.isValid(candidate);
+                    if (!validation.isValid) {
+                        this.userMessage(`INVALID: ${(_a = validation.whyInvalid) !== null && _a !== void 0 ? _a : ""}`);
+                    }
+                }
+                return candidate;
+            }
+        });
+    }
+    promptConfirm(id, prompt, defaultValue = true) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    let defaultChoice = (defaultValue == undefined) ? false : defaultValue;
+                    let result = yield inquirer.prompt({ type: 'confirm', name: id, message: prompt, default: defaultChoice });
+                    let output = (result[id]);
+                    resolve(output);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    // TODO:  Add param for FuzzyAutoSelect 
+    promptSelect(id, prompt, choices, multiSelect, loop) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    let inqChoices = choices.map(c => {
+                        var _a;
+                        return {
+                            name: (typeof c == "string") ? c : c.name,
+                            value: (typeof c == "string") ? c : ((_a = c.value) !== null && _a !== void 0 ? _a : c.name)
+                        };
+                    });
+                    let promptModule = { type: 'list', name: 'mySelectField', message: prompt, choices: inqChoices };
+                    if (loop !== undefined)
+                        promptModule.loop = loop;
+                    let result = yield inquirer.prompt(promptModule);
+                    let selected = result.mySelectField;
+                    resolve(selected);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    promptSelectFile(id, prompt, fileOptions) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                var _a;
+                try {
+                    // see https://www.npmjs.com/package/select-files-cli
+                    let selectorOptions = {
+                        clearConsole: false,
+                        multi: false
+                    };
+                    if (fileOptions.root)
+                        selectorOptions.root = fileOptions.root;
+                    if (fileOptions.startingPath) {
+                        if (fileOptions.root && !fileOptions.startingPath.startsWith(fileOptions.root)) {
+                            throw new Error(`Starting path for file selection [${fileOptions.startingPath}] was not inside the folder specified as "root" [${fileOptions.root}].`);
+                        }
+                        selectorOptions.startingPath = fileOptions.startingPath;
+                    }
+                    if (fileOptions.extensions && fileOptions.extensions.length > 0) {
+                        let ptn = `\\.(${fileOptions.extensions.join("|")})$`;
+                        let rx = new RegExp(ptn, "i");
+                        selectorOptions.fileFilter = (fileName) => rx.test(fileName);
+                    }
+                    // WAIT FOR USER TO NAVIAGATE AND MAKE A SELECTION...
+                    let result = yield (0, file_selector_1.selectFiles)(selectorOptions);
+                    // console.dir(result);
+                    let selected;
+                    if (result.status == file_selector_1.COMPLETED && result.selectedFiles && result.selectedFiles.length > 0) {
+                        selected = result.selectedFiles[0];
+                        if (fileOptions.asRelative) {
+                            let root = (_a = fileOptions.root) !== null && _a !== void 0 ? _a : process.cwd();
+                            selected = path.relative(root, selected);
+                        }
+                    }
+                    else {
+                        throw new Error(`Cancelled file selection.`);
+                    }
+                    resolve(selected);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    promptSelectFolder(id, prompt, folderOptions) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                var _a;
+                try {
+                    // see https://www.npmjs.com/package/select-files-cli
+                    let selectorOptions = {
+                        clearConsole: false,
+                        multi: false,
+                        mode: file_selector_1.EnumRetrievalMode.directory
+                    };
+                    if (folderOptions.root)
+                        selectorOptions.root = folderOptions.root;
+                    if (folderOptions.startingPath) {
+                        if (folderOptions.root && !folderOptions.startingPath.startsWith(folderOptions.root)) {
+                            throw new Error(`Starting path for file selection [${folderOptions.startingPath}] was not inside the folder specified as "root" [${folderOptions.root}].`);
+                        }
+                        selectorOptions.startingPath = folderOptions.startingPath;
+                    }
+                    // WAIT FOR USER TO NAVIAGATE AND MAKE A SELECTION...
+                    let result = yield (0, file_selector_1.selectFiles)(selectorOptions);
+                    // console.dir(result);
+                    let selected;
+                    if (result.status == file_selector_1.COMPLETED && result.selectedFiles && result.selectedFiles.length > 0) {
+                        selected = result.selectedFiles[0];
+                        if (folderOptions.asRelative) {
+                            let root = (_a = folderOptions.root) !== null && _a !== void 0 ? _a : process.cwd();
+                            selected = path.relative(root, selected);
+                        }
+                    }
+                    else {
+                        throw new Error(`Cancelled folder selection.`);
+                    }
+                    resolve(selected);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    openUrl(url) {
+        return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                console.log(`Cannot open url[${url}]: OpenUrl is not yet implemented for BuiltInCliUserInput`);
+                resolve();
+            }
+            catch (err) {
+                reject(err);
+            }
+        }));
+    }
+    startSpinner(userMessage) {
+        core_1.CliUx.ux.action.start(userMessage); // (this._styler.hilite(userMessage));
+    }
+    stopSpinner(userMessage) {
+        core_1.CliUx.ux.action.stop(userMessage);
+    }
+};
+BuiltInCliUserInput = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__metadata("design:paramtypes", [])
+], BuiltInCliUserInput);
+exports.BuiltInCliUserInput = BuiltInCliUserInput;
+//# sourceMappingURL=built-in-cli-user-input.js.map

package/lib/cli-common/built-in-cli-user-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-cli-user-input.js","sourceRoot":"","sources":["../../src/cli-common/built-in-cli-user-input.ts"],"names":[],"mappings":"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"}

package/lib/cli-common/cli-interfaces.js

@@ -0,0 +1,7 @@
+"use strict";
+// Commented out bc: Moved to ops-common as INTERFACES_OPS
+// export const INTERFACES_CLI = {
+//   IUserInputProvider: "IUserInputProvider",
+//   IStringValidator: "IStringValidator"
+// } as const
+//# sourceMappingURL=cli-interfaces.js.map

package/lib/cli-common/cli-interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-interfaces.js","sourceRoot":"","sources":["../../src/cli-common/cli-interfaces.ts"],"names":[],"mappings":";AAAA,0DAA0D;AAC1D,kCAAkC;AAClC,8CAA8C;AAC9C,yCAAyC;AACzC,aAAa"}

package/lib/cli-common/command-base.d.ts

@@ -0,0 +1,74 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import "reflect-metadata";
+import { Container } from 'inversify';
+import { Command, Config } from '@oclif/core';
+import * as fs from 'fs';
+import { exec as nodeExec } from 'child_process';
+import { IBetterLogger } from '@codiac.io/codiac-common/IBetterLogger';
+import { IUserInputProvider, IOutputStyler } from "@codiac.io/codiac-ops-common";
+import { CliGlobalConfigRepo, CliConfig } from '../ops';
+export declare interface IGlobalFlags {
+    as?: string | undefined;
+    remember?: boolean;
+    rememberAs?: string | undefined;
+    unremember?: string | undefined;
+    withoutdefaults?: boolean;
+}
+export declare abstract class commandBase extends Command {
+    protected static dependencyTargetingFlags: {
+        only: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        includeDeps: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    protected static dependencyTargetingArg: {
+        name: string;
+        require: boolean;
+        description: string;
+    };
+    /** Flags that can be available to multiple commands.
+     *  Support them in a command by extending the flags object with this property using a spread operator.
+     * eg:  static flags = { ...commandBase.globalFlags, myflag: flags.boolean(yadayada) }
+     */
+    static globalFlags: {
+        as: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
+        remember: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        rememberAs: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
+        unremember: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
+        withoutdefaults: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    /** (optional: defaults to false) Declares whether this command must be called from within a folder (or subfolder) of an initialized codiac project (ie: requires that a codiac.json file exists in the path of the current folder). */
+    protected requiresProjectScope: boolean | undefined;
+    protected static isBootstrapped: boolean;
+    /** Initializes ioc (mutates it) with typical cli/codiac project entities. */
+    protected static bootstrap(ioc: Container, oclifConfig: Config, requiresProjectScope: boolean): void;
+    /**
+     * You must call the following command in the body of your bootstrap method implementation...
+     * ```
+     * commandBase.bootstrap(this.ioc, this.config, this.requiresProjectScope);
+     * ```
+     */
+    protected abstract bootstrap(): void;
+    protected get ioc(): Container;
+    private __ioc;
+    protected get logger(): IBetterLogger;
+    private __logger;
+    protected get _cfgRepo(): CliGlobalConfigRepo;
+    private __cfgRepo;
+    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
+    get _cliCfg(): CliConfig;
+    private __cliCfg;
+    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
+    protected get _ui(): IUserInputProvider;
+    protected __ui: IUserInputProvider | undefined;
+    /** Deprecated: use ioc instead.  This getter Lazyloads from ioc. */
+    protected get _styler(): IOutputStyler;
+    protected __styler: IOutputStyler | undefined;
+    protected execAsync: typeof nodeExec.__promisify__;
+    protected copyAsync: typeof fs.copyFile.__promisify__;
+    abstract run(): Promise<void>;
+    /** Call this from the catch block of your command handler.
+     * Writes the error message appropriately to the console,
+     * minding stderr and stdout as required. */
+    protected handleError(err: any): void;
+}