@codiac.io/codiac-cli 1.2.175 → 1.2.202

package/dist/commands/deploy.js

@@ -0,0 +1,386 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMPT_ME_DESIGNATOR_MACOS = exports.PROMPT_ME_DESIGNATOR = void 0;
+const tslib_1 = require("tslib");
+require("reflect-metadata");
+const core_1 = require("@oclif/core");
+const inquirer = require("inquirer");
+const _ = require("lodash");
+const autocomplete = require("inquirer-autocomplete-prompt");
+const fuzzy = require("fuzzy");
+const contracts_1 = require("@codiac.io/codiac-common/contracts");
+const codiac_ops_common_1 = require("@codiac.io/codiac-ops-common");
+const command_base_enterprise_1 = require("../command-base-enterprise");
+const cloud_provider_contextualizer_1 = require("../uilogic/cloud-provider-contextualizer");
+let assetVersions = [];
+/** 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 = "?";
+exports.PROMPT_ME_DESIGNATOR_MACOS = "??";
+class Deploy extends command_base_enterprise_1.CommandBaseEnterprise {
+    // private get helmClient(): HelmController {
+    //     if (this.__helmClient === undefined) {
+    //         this.__helmClient = new HelmController(this._ui, this.logger);
+    //     }
+    //     return this.__helmClient;
+    // };
+    // private __helmClient: HelmController | undefined;
+    bootstrap() {
+        super.bootstrap();
+        cloud_provider_contextualizer_1.CloudProviderContextualizer.bootstrap(this.ioc);
+    }
+    run() {
+        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.bootstrap();
+                    const { args, flags } = yield this.parse(Deploy);
+                    (_a = this._relayContainer) === null || _a === void 0 ? void 0 : _a.ready$.subscribe(() => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                        var _b;
+                        try {
+                            if (flags.silent === true)
+                                this.__ui = new codiac_ops_common_1.ThrowingUserInputProvider(this.logger);
+                            this._userCntx = yield this.establishTenantContext(this._userCntx);
+                            let enterprise = (yield this.establishEnterpriseContext(flags.enterpriseCode)).enterprise;
+                            let enterpriseCode = enterprise.code;
+                            let rootMap = yield this.getRootMap(enterpriseCode);
+                            // Select the asset(s) to deploy
+                            let assetVersions;
+                            if (flags.asset == exports.PROMPT_ME_DESIGNATOR
+                                || flags.asset == exports.PROMPT_ME_DESIGNATOR_MACOS
+                                || flags.asset
+                                || this._projCfg === undefined) {
+                                if (flags.silent && flags.asset && flags.version)
+                                    assetVersions = [{ a: flags.asset, v: flags.version }];
+                                else {
+                                    let asset = yield this.promptForAsset(enterpriseCode, (flags.asset == exports.PROMPT_ME_DESIGNATOR || flags.asset == exports.PROMPT_ME_DESIGNATOR_MACOS) ? undefined : flags.asset);
+                                    let selected = yield this.promptForVersion(enterpriseCode, asset, flags.version);
+                                    // if (flags.tags && flags.tags.length > 0) selected.t = flags.tags;  // ?? this.promptForTags()
+                                    // if (flags.labels && flags.labels.length > 0) selected.l = this.parseToDictionary(flags.labels); // ?? this.promptForLabels()
+                                    assetVersions = [selected];
+                                }
+                            }
+                            else {
+                                // USE ASSET IN PROJECT SCOPE
+                                // Update sync codiac with what we've got here in the project.
+                                let requestedAssets = yield this.establishAssetContext(enterprise, flags.silent);
+                                let versions = yield this.declareAssetVersions(requestedAssets, enterpriseCode, this._projCfg.codeVersion);
+                                // We've updated Codiac.  Now trigger the deploy.
+                                assetVersions = requestedAssets.map(a => {
+                                    let version = versions.find(v => v.assetName == a);
+                                    let av = { a: a, v: version ? version.assetVersion : undefined };
+                                    // if (flags.tags && flags.tags.length > 0) av.t = flags.tags;
+                                    // if (flags.labels && flags.labels.length > 0) av.l = this.parseToDictionary(flags.labels); // ?? this.promptForLabels()
+                                    return av;
+                                });
+                            }
+                            let cabinet = yield this.establishCabinet(flags.cabinetName, flags.silent);
+                            // let cabCntx = new CabinetScope(cabinet.enterpriseCode, cabinet.environment, cabinet.name);
+                            let cabCntx = { enterprise: cabinet.enterpriseCode, environment: cabinet.environment, cabinet: cabinet.name };
+                            // Get the clusterdef so we can get cloud pvd creds
+                            let cluster = (_b = cabinet.cluster) !== null && _b !== void 0 ? _b : ((rootMap.clusters.length === 1) ? rootMap.clusters[0].name : undefined); // fall back to the one and only.
+                            if (cluster === undefined) {
+                                this.logger.warn(`Cannot confirm cloud provider credentials: cabinet has no cluster specified. Process will rely on cached credentials.`);
+                                // throw new Error(`Cannot determine cloud provider: cabinet has no cluster specified.`);
+                            }
+                            else {
+                                yield this.establishCloudProviderCreds(rootMap, cluster, flags.silent, flags.providerUserName, flags.providerPassword);
+                            }
+                            // COMMENTED OUT BC the relay service uses the k8s api client, which isnt bound to the singleton kubeconfig file.
+                            // if (!cabinet.cluster) throw new Error(`The current cabinet record [${cabinet.name}] does not have a cluster reference.`);
+                            // let kubeCntx = await this.establishK8sContext(cabinet.cluster);
+                            yield this._ui.startSpinner(`Deploying to cabinet [${cabinet.enterpriseCode}/${cabinet.environment}/${this._styler.hilite(cabinet.name)}]...`);
+                            // let result: Result = await this.relayClient.deployAssets(cabCntx, assetVersions);
+                            let result = yield this.genRelayClient.Call.postExecuteDeployment({ assets: assetVersions, target: cabCntx });
+                            yield this._ui.stopSpinner(result.success ? "SUCCESS" : (result.error ? "ERROR" : "FAILED"));
+                            if (result.success) {
+                                this._ui.userMessage(`${this._styler.colorGood("SUCCESS")}: ${result.message}`);
+                            }
+                            else if (result.error) {
+                                this._ui.userMessage(`${this._styler.colorCritical("ERROR")}: ${result.message}`);
+                                throw result.error;
+                            }
+                            else {
+                                this._ui.userMessage(`FAILED: ${result.message}`);
+                                throw result.error;
+                            }
+                            resolve();
+                        }
+                        catch (err) {
+                            this.handleError(err);
+                            reject(err);
+                        }
+                    }));
+                }
+                catch (err) {
+                    this.handleError(err);
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** Expands a string list of key=value into properties on an object.
+     *
+     * @param theseEqualThose Array of Key-value pairs in format: `this=that`, eg: `["favorite-color=blue", "age=36"]`
+     */
+    parseToDictionary(theseEqualThose) {
+        if (theseEqualThose && theseEqualThose.length > 0) {
+            let labels = {};
+            theseEqualThose.forEach(x => {
+                const [key, val] = x.split("=");
+                labels[key] = val;
+            });
+            return labels;
+        }
+        else {
+            return {};
+        }
+    }
+    promptForAsset(enterprise, assetSearch) {
+        return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                // let ecrit = new EnterpriseCriteria();
+                // ecrit.code = new StringFilter();
+                // ecrit.code.$eq = enterprise;
+                let ecrit = { code: enterprise };
+                let enterprises = yield this._codiacApi.Enterprise.readMany(ecrit, { throwNotFound: false });
+                if (!enterprises || enterprises.length == 0) {
+                    throw new Error(`Could not find enterprise [${enterprise}].`);
+                }
+                else if (!enterprises[0].assets || enterprises[0].assets.length == 0) {
+                    throw new Error(`The current enterprise [${enterprise}] has no assets defined.`);
+                }
+                // console.log(`${readResult.output[0].assets.length} assets found`)
+                // Select from assets in the current enterprise
+                let assets = enterprises[0].assets;
+                if (assetSearch && assetSearch != exports.PROMPT_ME_DESIGNATOR) {
+                    assets = assets.filter(a => a.name.startsWith(assetSearch));
+                }
+                // console.log(`${assets.length} assets found`)
+                let selectedAss = yield this._ui.promptSelect('asset', 'Select an Asset:', assets.map(a => a.name).sort());
+                let selected = assets.find(a => a.name == selectedAss);
+                if (!selected)
+                    throw new Error(`User failed to select a valid asset to deploy.`);
+                resolve(selected);
+            }
+            catch (err) {
+                reject(err);
+            }
+        }));
+    }
+    promptForVersion(enterpriseCode, asset, versionSearch) {
+        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 cspUserName = yield this.cspContextualizer.promptForCloudProviderCreds(this.ioc, asset.image.registry.provider);
+                    this._ui.startSpinner("Loading versions...");
+                    let sorted = yield this.relayClient.fetchVersions(asset.image, asset.type, versionSearch);
+                    let latest = sorted[0];
+                    assetVersions = sorted.map(v => { return { value: v, name: v }; });
+                    this._ui.stopSpinner(`found ${assetVersions.length}`);
+                    // Without autocomplete...
+                    // let verSelect = await inquirer.prompt({ type: 'list', name: 'version', message: 'Select the asset version:', choices: versions, default: latest });
+                    // With fuzzy autocomplete...
+                    inquirer.registerPrompt('autocomplete', autocomplete);
+                    let verSelect = yield inquirer.prompt([{ type: 'autocomplete', name: 'version', message: 'Select the asset version:', source: this.searchVersions, default: latest }]);
+                    resolve({ a: asset.name, v: verSelect.version });
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    // async promptForVersionConfig_NOTUSED(enterpriseCode: string, asset: Asset, versionSearch?: string): Promise<AssetVersion> {
+    //   return new Promise<AssetVersion>(async (resolve,reject) => {
+    //     try {
+    //       let crit = <VersionConfigCriteria>{ enterprise: enterpriseCode, assetName: asset.name };
+    //       let versionFetch = await this._codiacApi.VersionConfig.tryReadMany(crit);
+    //       if (!versionFetch.output || versionFetch.output.length == 0) {
+    //         throw new Error(`No versions found for the asset [${asset.name}].`);
+    //       }
+    //       let versions: { value: string, name: string }[] = [];
+    //       // let latest = new Date("2000-01-01T00:00:00.999Z");
+    //       let latest = _.maxBy(versionFetch.output, v => v.created);
+    //       let sorted = _.orderBy(versionFetch.output, v => v.created, 'desc');
+    //       if (versionSearch) {
+    //         sorted = sorted.filter(v => v.assetVersion.indexOf(versionSearch) >= 0);
+    //       }
+    //       if (sorted.length == 0) {
+    //         throw new Error(`No versions like '${versionSearch}' found for the asset [${asset.name}].`);
+    //       }
+    //       for (let v of sorted) {
+    //         let marker = (latest && v.assetVersion == latest.assetVersion) ? " (latest)" : "";
+    //         versions.push({
+    //           value: v.assetVersion,
+    //           name: `${v.assetVersion}  ${this._styler.dim(new Date(v.created).toLocaleDateString())} ${marker}`
+    //         });
+    //       }
+    //       // Without autocomplete...
+    //       // let verSelect = await inquirer.prompt({ type: 'list', name: 'version', message: 'Select the asset version:', choices: versions, default: latest });
+    //       // With fuzzy autocomplete...
+    //       inquirer.registerPrompt('autocomplete', autocomplete);
+    //       assetVersions = versions;
+    //       let verSelect = await inquirer.prompt([{ type: 'autocomplete', name: 'version', message: 'Select the asset version:', source: this.searchVersions, default: latest }]);
+    //       resolve({ a: asset.name, v: verSelect.version });
+    //     } catch (err) {
+    //       reject(err);
+    //     }
+    //   });
+    // }
+    // private async fetchVersions(image: Image, assetType: AssetTypesEnum | undefined, versionSearch?: string): Promise<string[]> {
+    //     return new Promise<string[]>(async (resolve, reject) => {
+    //         try {
+    //             let versionsFetch: string[];
+    //             if (assetType == AssetTypesEnum.helm) {
+    //                 let chartName = image.name;
+    //                 let repoName = image.registry.code;
+    //                 let chartRegisryUrl = image.registry.url;
+    //                 let chartVersions = await this.helmClient.getVersionsOf(chartName, repoName, chartRegisryUrl);
+    //                 versionsFetch = chartVersions.output?.map(x => x.version) || [];
+    //             } else {
+    //                 let result = await this.relayClient.tryReadImageTags(image.registry.url, (image.scope) ? `${image.scope}/${image.name}` : image.name);  // is scope already prefixing the name?
+    //                 versionsFetch = result.output;
+    //             }
+    //             if (!versionsFetch || versionsFetch.length == 0) {
+    //                 throw new Error(`No versions found for the ${assetType} [${image.name}].`);
+    //             }
+    //             // let sorted = versionsFetch.filter(v => semver.clean(v)).sort(semver.rcompare);
+    //             versionsFetch = versionsFetch.filter(av => av !== null && av !== undefined);  // Ignore untagged images
+    //             let semvers = _.remove(versionsFetch, v => semver.clean(v)).sort(semver.rcompare); // removes semvers so they can be sorted uniquely
+    //             let sorted = semvers.concat(versionsFetch.sort().reverse());
+    //             // let sorted = versionsFetch.reverse();  // the reg client shd do this for us...
+    //             if (versionSearch) {
+    //                 sorted = sorted.filter(v => v.indexOf(versionSearch) >= 0);  // this will give too many results - it shd be an equals not a contains
+    //             }
+    //             if (sorted.length == 0) {
+    //                 throw new Error(`No versions like '${versionSearch}' found for the ${assetType} [${image.name}].`);
+    //             }
+    //             // TODO:  It would be nice to mark versions with their dates or their canonical tags (latest, stable, etc)
+    //             //  eg:  name = `${v.assetVersion}  ${this._styler.dim(new Date(v.created).toLocaleDateString())} (latest)`;
+    //             resolve(sorted);
+    //         } catch (err) {
+    //             reject(err);
+    //         }
+    //     });
+    // }
+    searchVersions(answers, input) {
+        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 {
+                    // Whatever voodoo they're doing inside the autocomplete plugin,
+                    // they're redefining "this", so we cant use it here.
+                    // Great, we'll just HACK UP a fucking module scoped variable to hold onto the goddamn list then.
+                    // let vers = this.getVersions();
+                    input = input || "";
+                    setTimeout(() => {
+                        let options = { extract: (ver) => { return ver.value; } };
+                        let results = fuzzy.filter(input, assetVersions, options);
+                        let filtered = results.map((fr) => fr.original);
+                        resolve(filtered);
+                    }, _.random(30, 500)); // why a random number?
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** Writes Asset versions to the Codiac Api. */
+    declareAssetVersions(assets, enterpriseCode, versionToUse) {
+        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 versions = [];
+                    let newVersions = [];
+                    for (let asset of assets) {
+                        let thisVersion = versionToUse;
+                        let versionName = `${asset}-${thisVersion}`;
+                        let vc = Object.assign({ name: versionName, enterprise: enterpriseCode, assetName: asset, assetVersion: thisVersion }, this.createAuditable());
+                        // Making a call over the wire for every iteration in this loop JUST PLAIN SUCKS, but
+                        // there's not currently a way to spec the following:
+                        /*
+                        filterDef = {
+                          enterprise: cabCntx.enterprise,
+                          labels: [
+                            { cabinet: cabCntx.cabinet }
+                          ],
+                          $or: [
+                            { assetName: a1.assetName, version: a1.version },
+                            { assetName: a2.assetName, version: a2.version },
+                            ...
+                            { assetName: aN.assetName, version: aN.version }
+                          ]
+                        }
+                        */
+                        let crit = {
+                            enterprise: vc.enterprise,
+                            assetName: vc.assetName,
+                            assetVersion: vc.assetVersion
+                        };
+                        let check = yield this._codiacApi.VersionConfig.tryReadMany(crit);
+                        if (check.error) {
+                            this.logger.debug(`Error checking existence of VersionConfig: [${vc.assetName}, v${vc.assetVersion}]: ${check.message || ""}; ${check.error.stack}`);
+                        }
+                        else if (check.count == 0) {
+                            // Idempotence: create this version config only if doesnt already exist
+                            newVersions.push(vc);
+                        }
+                        else {
+                            versions.push(...check.output);
+                            this.logger.debug(`Skipping version declaration for [${vc.assetName}:${vc.assetVersion}]: VersionConfig already exists [created: ${vc.created.toUTCString()}].`);
+                        }
+                    }
+                    if (newVersions && newVersions.length > 0) {
+                        let result = yield this._codiacApi.VersionConfig.tryCreateMany(newVersions);
+                        if (result.success) {
+                            versions.push(...result.successes);
+                            this.logger.debug(`Asset versions successfully declared: [${newVersions.map(v => v.assetName + ':' + v.assetVersion).join(", ")}].`);
+                        }
+                        else {
+                            // Throw, even on partial successes.
+                            if (result.successes && result.successes.length > 0) {
+                                this.logger.debug(`Some Asset version declarations succeeded: ${result.successes.map(v => v.assetName + ':' + v.assetVersion).join(", ")}.`);
+                            }
+                            if (result.failures && result.failures.length > 0) {
+                                this.logger.debug(`Asset version declaration failures: ${result.failures.map(f => f.message)}`);
+                            }
+                            let failureCount = (result.failures) ? result.failures.length : 0;
+                            let successCount = (result.successes) ? result.successes.length : 0;
+                            if (result.error) {
+                                throw new contracts_1.CodiacError(`Error declaring version configs for [${assets.join(",")}]: ${result.message || ""}; ${result.error.message}`, result.error);
+                            }
+                            else {
+                                throw new contracts_1.CodiacError(`Partial failure declaring version configs  [${successCount} succeeded, ${failureCount} failed] for ${assets.join(",")}: ${result.message}`);
+                            }
+                        }
+                    }
+                    resolve(versions);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+}
+exports.default = Deploy;
+Deploy.description = 'Deploys a given asset to a given cabinet.  Defaults to current version.';
+Deploy.dependsOn = ["enterpriseCode", "cabinetName"];
+Deploy.flags = {
+    // ...commandBase.globalFlags,
+    help: core_1.Flags.help({ char: 'h' }),
+    enterpriseCode: core_1.Flags.string({ char: 'e', required: false, description: `Code (name) of the enterprise to deploy` }),
+    cabinetName: core_1.Flags.string({ char: 'c', required: false, description: `Target cabinet name you want deploy` }),
+    asset: core_1.Flags.string({ char: 'a', required: false, description: `Search string for the name of the asset to deploy (use ${exports.PROMPT_ME_DESIGNATOR} or ${exports.PROMPT_ME_DESIGNATOR_MACOS} to be prompted).` }),
+    version: core_1.Flags.string({ char: 'u', required: false, description: `Search string for the version of the asset to deploy  (use ${exports.PROMPT_ME_DESIGNATOR} or ${exports.PROMPT_ME_DESIGNATOR_MACOS} to be prompted).` }),
+    // tags: Flags.string({ char: 't', multiple: true, required: false, description: `Tags to apply to the selected asset version.` }),
+    // labels: Flags.string({ char: 'l', multiple: true, required: false, description: `Labels (aka: key-value pairs) to apply to the selected asset version.  Additive; any labels applied here will be added (but not duplicated) to any existing labels on the asset version.  Must be provided in format: key=value, eg: -l workitem=abc123 -l sprint=Sprint15` }),
+    providerUserName: core_1.Flags.string({ char: 'n', required: false, description: `OPTIONAL: For silent/scripted calls, bring cloud creds to auth against` }),
+    providerPassword: core_1.Flags.string({ char: 'p', required: false, description: `OPTIONAL: For silent/scripted calls, bring cloud creds to auth against` }),
+    silent: core_1.Flags.boolean({ char: 'y', dependsOn: Deploy.dependsOn, required: false, description: `(Optional: defaults to false) Prevents confirmations of user-values that are remembered from prior runs. Requires: ${Deploy.dependsOn}` })
+};
+Deploy.args = {};
+//# sourceMappingURL=deploy.js.map

package/dist/commands/enterprise/create.d.ts

@@ -0,0 +1,20 @@
+import "reflect-metadata";
+import { CommandBaseEnterprise } from '../../command-base-enterprise';
+export declare class MyTenantRequest {
+}
+export default class EnterpriseCreate extends CommandBaseEnterprise {
+    static description: string;
+    static args: {
+        code: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        as: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        remember: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        rememberAs: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        unremember: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        withoutdefaults: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/enterprise/create.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MyTenantRequest = void 0;
+const tslib_1 = require("tslib");
+require("reflect-metadata");
+const core_1 = require("@oclif/core");
+const cli_common_1 = require("../../cli-common");
+const command_base_enterprise_1 = require("../../command-base-enterprise");
+const cloud_provider_contextualizer_1 = require("../../uilogic/cloud-provider-contextualizer");
+// import { MyTenantRequest } from "@codiac.io/codiac-auth-contracts";
+class MyTenantRequest {
+}
+exports.MyTenantRequest = MyTenantRequest;
+class EnterpriseCreate extends command_base_enterprise_1.CommandBaseEnterprise {
+    run() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                this.bootstrap();
+                let params = yield this.parse(EnterpriseCreate);
+                return this.exec.runWithDefaults(params, (args, flags) => 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 {
+                            (_a = this._relayContainer) === null || _a === void 0 ? void 0 : _a.ready$.subscribe(() => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                                var _b, _c, _d, _e;
+                                cloud_provider_contextualizer_1.CloudProviderContextualizer.bootstrap(this.ioc);
+                                // TODO:  Ensure that if the projCfg has a tenantCode, that establishTenantContext enforced it with the user authentication.
+                                // THAT IS:  Boot 'em if they're not part of this project's tenant.
+                                this._userCntx = yield this.establishTenantContext(this._userCntx);
+                                // let currentEnterprise = (await this.establishEnterpriseContext()).enterprise;
+                                // let enterpriseCode = currentEnterprise.code;  // NOTE: We could also pull this from:  this._projUserCfg.enterprise.enterpriseCode;
+                                let partial = {};
+                                // ENTER CODE:
+                                let defaultCode = "main";
+                                partial.code = (_b = args.code) !== null && _b !== void 0 ? _b : (yield this._ui.prompt("code", "Enterprise code (no spaces): ", true, defaultCode));
+                                partial.code = (_c = partial.code) === null || _c === void 0 ? void 0 : _c.replace(" ", "");
+                                // validate that it doesnt already exist
+                                let found;
+                                do {
+                                    let existings = yield this._codiacApi.Enterprise.readMany({ code: { $eq: partial.code } });
+                                    found = existings.find(e => e.code === partial.code);
+                                    if ((existings === null || existings === void 0 ? void 0 : existings.length) > 0) {
+                                        this._ui.userMessage(`${this._styler.colorWarning("INVALID: ")} An enterprise with that name already exists for this tenant.`);
+                                        partial.code = (yield this._ui.prompt("name", "Enterprise name (no spaces): ", true, partial.code));
+                                        partial.code = (_d = partial.code) === null || _d === void 0 ? void 0 : _d.replace(" ", "");
+                                    }
+                                } while (found !== undefined);
+                                // Assemble and write
+                                // httpRestVerb.GET, "/auth/my-tenant(/)"
+                                let tenantResult = yield this._codiacApi.get(MyTenantRequest, {}); // , tenantCode: this._userCntx.currentTenantCode
+                                // let tenantResult = await this._codiacApi.Subscription.tryReadMany({ all: true }, { forAnyTenant: true });  // , tenantCode: this._userCntx.currentTenantCode
+                                if (tenantResult.output === undefined) {
+                                    throw new Error(`Cannot read the current tenant record [${this._userCntx.currentTenantCode}].`);
+                                }
+                                let subxId = (_e = tenantResult.output.currentSubscription) === null || _e === void 0 ? void 0 : _e.id; // This assertion operator is legit cuz we're pulling from a db read.
+                                let candidate = Object.assign({ code: partial.code, subscription: subxId, assets: [], products: [], domains: [] }, this.createAuditable());
+                                this._ui.startSpinner(`Creating new enterprise [${candidate.code}]...`);
+                                // let result = await this.relayClient.enterpriseCreate(partial.code!);
+                                let result = yield this._codiacApi.Enterprise.tryCreate(candidate);
+                                this._ui.stopSpinner("");
+                                if (result.error) {
+                                    this.logger.error(`Error creating enterprise: ${result.message || ""}; ${result.error.message}`, result.error);
+                                    this._ui.userMessage(`Error creating enterprise: ${result.message || ""}; ${result.error.message}`);
+                                }
+                                else if (!result.success) {
+                                    this.logger.notice(`Enterprise creation failed without error.  ${result.message}`);
+                                    this._ui.userMessage(`Enterprise creation failed without error.  ${result.message}`);
+                                }
+                                else if (result.output) {
+                                    let saved = result.output;
+                                    this.logger.notice(`${this._styler.colorGood("Success!")} Enterprise [${this._styler.hilite(saved.code)}] created for tenannt [${this._userCntx.currentTenantCode}]`);
+                                    this._ui.userMessage(`${this._styler.colorGood("Success!")} Enterprise [${this._styler.hilite(saved.code)}] created for tenannt [${this._userCntx.currentTenantCode}]`);
+                                }
+                            }));
+                        }
+                        catch (err) {
+                            this.handleError(err);
+                            reject(err);
+                        }
+                    }));
+                }));
+            }
+            catch (err) {
+                this.logger.error(`Error parsing arguments: ${err}`);
+                this.logger.debug(err.stack);
+                return new Promise((res, rej) => tslib_1.__awaiter(this, void 0, void 0, function* () { return res(); }));
+                // return new Promise<void>(async (res,rej) => rej(new Error(`Error parsing arguments: ${err}`)));
+            }
+        });
+    }
+}
+exports.default = EnterpriseCreate;
+EnterpriseCreate.description = 'Creates a new enterprise under the current tenant.';
+EnterpriseCreate.args = {
+    code: core_1.Args.string({ required: false, description: 'The unique human-readable identitifer to use for the enterprise (must be alphanunmeric with no spaces).' })
+};
+EnterpriseCreate.flags = Object.assign(Object.assign({}, cli_common_1.commandBase.globalFlags), { help: core_1.Flags.help({ char: 'h' }) });
+//# sourceMappingURL=create.js.map

package/dist/commands/enterprise/list.d.ts

@@ -0,0 +1,14 @@
+import { CommandBaseEnterprise } from '../../command-base-enterprise';
+export declare type FlatEnterprise = {
+    name: string;
+};
+export default class EnterpriseList extends CommandBaseEnterprise {
+    static description: string;
+    static aliases: string[];
+    static flags: {
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+    };
+    static args: {};
+    run(): Promise<void>;
+}

package/dist/commands/enterprise/list.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const YAML = require("yaml");
+const command_base_enterprise_1 = require("../../command-base-enterprise");
+const _ = require("lodash");
+const render = require("../../uilogic/render-methods");
+const render_methods_1 = require("../../uilogic/render-methods");
+class EnterpriseList extends command_base_enterprise_1.CommandBaseEnterprise {
+    run() {
+        var _a, _b, _c, _d, _e;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            this.bootstrap();
+            const { args, flags } = yield this.parse(EnterpriseList);
+            try {
+                this._userCntx = yield this.establishTenantContext(this._userCntx);
+                // RETRIEVE 
+                let outputFormat = (_a = render_methods_1.OutputFormatsEnum[flags.output]) !== null && _a !== void 0 ? _a : render_methods_1.OutputFormatsEnum.tree;
+                if ([render_methods_1.OutputFormatsEnum.json, render_methods_1.OutputFormatsEnum.yaml].includes(outputFormat) === false)
+                    this._ui.startSpinner("Retrieving");
+                let enterprises = yield this._codiacApi.Enterprise.readMany({ all: true });
+                let entCount = enterprises.length;
+                if ([render_methods_1.OutputFormatsEnum.json, render_methods_1.OutputFormatsEnum.yaml].includes(outputFormat) === false)
+                    this._ui.stopSpinner(`found ${entCount}`);
+                // RENDER
+                let output = "";
+                switch (outputFormat) {
+                    case render_methods_1.OutputFormatsEnum.json:
+                        let listForJson = (_b = enterprises.map(ent => { return { name: ent.code }; })) !== null && _b !== void 0 ? _b : [];
+                        listForJson = _.sortBy(listForJson, e => e.name);
+                        output = JSON.stringify(listForJson, undefined, 2);
+                        this._ui.userMessage(output);
+                        break;
+                    case render_methods_1.OutputFormatsEnum.yaml:
+                        let listForYaml = (_c = enterprises.map(ent => { return { name: ent.code }; })) !== null && _c !== void 0 ? _c : [];
+                        listForYaml = _.sortBy(listForYaml, c => c.name);
+                        output = YAML.stringify(listForYaml, { indent: 2 });
+                        this._ui.userMessage(output);
+                        break;
+                    case render_methods_1.OutputFormatsEnum.text:
+                        let flatList = (_d = enterprises.map(ent => { return { name: ent.code }; })) !== null && _d !== void 0 ? _d : [];
+                        flatList = _.sortBy(flatList, c => c.name);
+                        let listForText = flatList.map(ent => ent.name);
+                        output = render.renderStringList(listForText);
+                        this._ui.userMessage(output);
+                        break;
+                    // TODO:
+                    // case OutputFormatsEnum.table:
+                    // case OutputFormatsEnum.tsv:
+                    //   break;
+                    case render_methods_1.OutputFormatsEnum.tree:
+                    default:
+                        let entTree = (_e = enterprises.map(ent => { return { text: ent.code }; })) !== null && _e !== void 0 ? _e : [];
+                        let out = render.renderStringTree(entTree); //, this._ui.userMessage);
+                        this._ui.userMessage(out);
+                        break;
+                }
+                // if ([OutputFormatsEnum.tree].includes(outputFormat)) {
+                //   let cabTree = this.buildCabinetTree(rootMap);
+                //   let out = this.renderStringTree(cabTree); //, this._ui.userMessage);
+                //   this._ui.userMessage(out);
+                // } else {
+                //   let flatList: FlatCabinet[] = this.FlattenCabinets(rootMap);
+                //   flatList = _.sortBy(flatList, c => c.enterprise, c => c.env, c => c.name)
+                //   this.renderCabinets(flatList, outputFormat);
+                // }
+                return;
+            }
+            catch (err) {
+                throw err;
+            }
+        });
+    }
+}
+exports.default = EnterpriseList;
+EnterpriseList.description = 'Shows the list of enterprises.';
+EnterpriseList.aliases = ["ent:list"];
+EnterpriseList.flags = {
+    output: core_1.Flags.string({ char: 'o', default: render_methods_1.OutputFormatsEnum.tree, description: "format in which to render the data.", options: [render_methods_1.OutputFormatsEnum.json, render_methods_1.OutputFormatsEnum.yaml, render_methods_1.OutputFormatsEnum.tree, render_methods_1.OutputFormatsEnum.text] }),
+    help: core_1.Flags.help({ char: 'h', description: 'Displays the help document for this command.' })
+};
+EnterpriseList.args = {};
+//# sourceMappingURL=list.js.map

package/dist/commands/env/add.d.ts

@@ -0,0 +1,22 @@
+import { ScopeLevel } from '@codiac.io/codiac-relay-contracts';
+import { CommandBaseEnterprise } from '../../command-base-enterprise';
+export default class EnvAdd extends CommandBaseEnterprise {
+    static description: string;
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        setting: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        value: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        enterprise: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        cabinet: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static args: {
+        setting: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    private _envConfig;
+    run(): Promise<void>;
+    writeSetting_Api(enterprise: string, assetName: string, configName: string, setting: string, scopeLevel: ScopeLevel, scopeName: string, val: any): Promise<void>;
+    writeSettingEnv_local(setting: string, value: any): void;
+    /** Retrieves the list of settings from the env schema that are not yet explicitly declared. */
+    getAvailableSettings(): Promise<string[]>;
+}