@codiac.io/codiac-cli 1.2.216 → 1.2.219

package/lib/command-base-enterprise.d.ts

@@ -0,0 +1,121 @@
+import "reflect-metadata";
+import { CabinetScope, CodiacLocalConfig, ProjectConfig, ProjectUserConfig, UserContext } from "@codiac.io/codiac-relay-contracts";
+import { RelayContainer } from "./relay/relay-container";
+import { CodiacClient } from './apis/codiac-api';
+import { RelayClient as GenRelayClient } from "./apis/codiac-relay";
+import { commandBase } from './cli-common';
+import { Cabinet, CabinetClusterRoot, Enterprise, Environment, RootMap } from './apis/codiac-api/contracts';
+import { EnterpriseContextualizer } from './uilogic/enterprise-contextualizer';
+import { ClusterConfiguratorFactory, TenantContextualizer } from "./uilogic";
+import { LocalOps, ProjectContextRepo } from './ops';
+import { ArgumentManager } from "./cli-common/argument-manager";
+import { UserContextManager } from "./user-context-loader";
+import { ExtendedRelayClient } from "./relay/extended-relay-client";
+import { IAuditable } from "@codiac.io/codiac-common";
+import { CloudProviderContextualizer } from "./uilogic/cloud-provider-contextualizer";
+/** Ensures tenant context and k8s context.
+ *  For use with commands that operate on enterprise records or on an existing cluster.
+ */
+export declare abstract class CommandBaseEnterprise extends commandBase {
+    protected bootstrap(): void;
+    /** Prompts for Cloud Provider credentials. */
+    protected get cspContextualizer(): CloudProviderContextualizer;
+    private __cspContextualizer;
+    /** Prompts for Cloud Provider credentials. */
+    protected get cspUiFactory(): ClusterConfiguratorFactory;
+    private __cspConfiguratorfactory;
+    /** TODO: move this to commandBase
+     *
+     * Fully qualified path to the app config folder on the local machine. */
+    protected get localConfigPath(): string;
+    private __localConfigPath;
+    /** The Codiac Local config overrides (shared with the relay). */
+    protected get localConfig(): CodiacLocalConfig | undefined;
+    private __localConfig;
+    private __localConfigIsLoaded;
+    protected set _userCntx(cntx: UserContext);
+    protected get _userCntx(): UserContext;
+    private __userCntx;
+    protected get codiacApiUrl(): string;
+    private __codiacApiUrl;
+    /**  TODO:  Get this out of the CLI.  Any calls to the codiac api should be made from the relay. */
+    protected get _codiacApi(): CodiacClient;
+    private __codiacApi;
+    protected get relayClient(): ExtendedRelayClient;
+    private __relayClient;
+    protected get genRelayClient(): GenRelayClient;
+    private __genRelayClient;
+    protected set _relayContainer(rc: RelayContainer);
+    protected get _relayContainer(): RelayContainer;
+    private __relayContainer;
+    protected get _userContextManager(): UserContextManager;
+    private __userContextManager;
+    /** NOTE:  This property MUST ONLY be accessed from within a project folder.
+   * It requires project scoped objects
+   * such as: `projectRoot`, `projectConfig`, `projectUserConfig`, and `ProjectContextRepo`.
+   *
+   * It lazy-loads them, and its methods will fail without them.
+  */
+    protected get _ops(): LocalOps;
+    private __ops;
+    protected get enterpriseContextor(): EnterpriseContextualizer;
+    private __enterpriseContextor;
+    protected get exec(): ArgumentManager;
+    private __exec;
+    /** This getter Lazyloads from ioc. */
+    protected get projCfgRepo(): ProjectContextRepo | undefined;
+    private __projCfgRepo;
+    private __projCfgRepo_isSet;
+    /** This getter Lazyloads from ioc. */
+    protected get _projCfg(): ProjectConfig | undefined;
+    private __projCfg;
+    private __projCfg_isSet;
+    /** This getter Lazyloads from ioc. */
+    protected get _projUserCfg(): ProjectUserConfig | undefined;
+    private __projUserCfg;
+    private __projUserCfg_isSet;
+    /** Lazyloads the project root folder path by walking up the current path to find a project config file. */
+    protected get _projectRoot(): string | undefined;
+    private __projectRoot;
+    private __projectRoot_isSet;
+    /** Currently just coincides with projectRoot. */
+    protected get _dockerRoot(): string | undefined;
+    /**
+     *
+     * @deprecated Use `establishTenantContext()` instead.
+     */
+    protected loadCodiacContext(): Promise<UserContext>;
+    protected getCabinetInfrx(enterprise: string, environment: string, cabinet: string, rootMap: RootMap): CabinetClusterRoot;
+    /** Retrieves "all-the-things" from the api for the given enterprise. Throws not found or on error. */
+    protected getRootMap(enterpriseCode: string): Promise<RootMap>;
+    protected createAuditable(): IAuditable;
+    /** Logs the user in as needed, and persists the new context object to the local machine. */
+    protected establishTenantContext(currentContext: UserContext, tenantContextualizer?: TenantContextualizer): Promise<UserContext>;
+    /** Acquires and adopts the identity of a single enterprise for the current project
+     * (DOES NOT establish an AssetBinding for the current tenant).
+     * TODO: Move this to commandBase
+     */
+    protected establishEnterpriseContext(enterpriseCode?: string): Promise<{
+        enterprise: Enterprise;
+    }>;
+    /** Acquires and adopts the identity of a single enterprise (and asset) for the current project
+     * (aka: establishes an AssetBinding for the current tenant).
+     * TODO: return undefined to mean for "all in enterprise"
+     * TODO: Move this to commandBase
+     *
+     * @param suppressConfirmations (Optional: defaults to false) Prevents confirmations of user-values that are remembered from prior runs.
+     */
+    protected establishAssetContext(enterprise: Enterprise, suppressConfirmations?: boolean): Promise<string[]>;
+    /** Defaults to the cabinet declared in the project user config.
+     * NOTE:  Run EstablishEnterpriseContext() before calling this method!!  It throws if no enterprise has been establiashed.
+    */
+    protected establishCabinetContext(requestedCabinet?: string, requestedEnviro?: string): Promise<CabinetScope>;
+    /** This is only here so we can get the cluster name.
+     * Defaults to the cabinet declared in the project user config.
+     * NOTE:  Run EstablishEnterpriseContext() before calling this method!!  It throws if no enterprise has been establiashed.
+    */
+    protected establishCabinet(requestedCabinet?: string, suppressConfirmations?: boolean): Promise<Cabinet>;
+    /** UI dialogue to acquire a valid environment under the current tenant.  */
+    protected establishEnvironment(requestedEnv?: string): Promise<Environment>;
+    protected establishCloudProviderCreds(rootMap: RootMap, clusterName: string, suppressConfirmations?: boolean, providedUserName?: string, providedSecret?: string): Promise<void>;
+}

package/lib/command-base-enterprise.js

@@ -0,0 +1,524 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandBaseEnterprise = void 0;
+const tslib_1 = require("tslib");
+require("reflect-metadata");
+const path = require("path");
+const codiac_relay_contracts_1 = require("@codiac.io/codiac-relay-contracts");
+const relay_container_1 = require("./relay/relay-container");
+// import { CodiacClient, CodiacClient as AuthClient, ThrowingCodiacClient } from '@codiac.io/codiac-api-client';
+const codiac_api_1 = require("./apis/codiac-api");
+const codiac_relay_1 = require("./apis/codiac-relay");
+const cli_common_1 = require("./cli-common");
+const enterprise_contextualizer_1 = require("./uilogic/enterprise-contextualizer");
+const environment_contextualizer_1 = require("./uilogic/environment-contextualizer");
+const codiac_ops_common_1 = require("@codiac.io/codiac-ops-common");
+const uilogic_1 = require("./uilogic");
+const ops_1 = require("./ops");
+const argument_manager_1 = require("./cli-common/argument-manager");
+const user_context_loader_1 = require("./user-context-loader");
+// import { ApiUserCreds } from "@codiac.io/codiac-api-client/common/api-user-creds";
+const api_user_creds_1 = require("./apis/codiac-api/common/api-user-creds");
+const extended_relay_client_1 = require("./relay/extended-relay-client");
+const codiac_common_1 = require("@codiac.io/codiac-common");
+const cloud_provider_contextualizer_1 = require("./uilogic/cloud-provider-contextualizer");
+const log4js_logger_1 = require("./log4js-logger");
+const codiac_constants_1 = require("./codiac-constants");
+const relay_websocket_client_1 = require("./relay/wsclient/relay-websocket-client");
+/** Ensures tenant context and k8s context.
+ *  For use with commands that operate on enterprise records or on an existing cluster.
+ */
+class CommandBaseEnterprise extends cli_common_1.commandBase {
+    constructor() {
+        // constructor(argv: string[], config: Config, requiresProjectScope?: boolean) {
+        //   super(argv, config, requiresProjectScope);
+        // }
+        super(...arguments);
+        this.__localConfigIsLoaded = false;
+    }
+    bootstrap() {
+        if (CommandBaseEnterprise.isBootstrapped !== true) {
+            this.requiresProjectScope = false;
+            cli_common_1.commandBase.bootstrap(this.ioc, this.config, false);
+            // TODO: move this to commandBase
+            log4js_logger_1.Log4jsLogger.bootstrap(this.ioc, {
+                appenders: {
+                    "console": { type: "console" },
+                    "applog": { type: "file", maxLogSize: "2M", backups: 3, compress: false, keepFileExt: true, filename: path.posix.join(this.localConfigPath, "logs", "cli.log") },
+                    "errlog": { type: "file", maxLogSize: "2M", backups: 3, compress: false, keepFileExt: true, filename: path.posix.join(this.localConfigPath, "logs", "cli-error.log") }
+                },
+                categories: {
+                    default: { appenders: ["applog"], level: "trace" },
+                    errors: { appenders: ["errlog"], level: "error" },
+                    console: { appenders: ["console"], level: "off" }
+                }
+            });
+            codiac_api_1.CodiacClient.bootstrap();
+            // Cant do it this way until we make ApiUserCreds.token nullable.
+            // this.ioc.bind<CodiacClientConfig>(CodiacClientConfig).toConstantValue({ apiBaseUrl: this.codiacApiUrl });
+            // this.ioc.bind(ApiUserCreds).toConstantValue(undefined);  // <--- ILLEGAL!
+            // host.ioc.bind<CodiacClient>(CodiacClient).toSelf();
+            let authToken = (this._userCntx) ? this._userCntx.currentToken : undefined;
+            this.ioc.bind(codiac_api_1.CodiacClient).toDynamicValue((ctx) => codiac_api_1.CodiacClient.create(this.logger, this.codiacApiUrl, authToken)); // 
+            codiac_relay_1.RelayClient.bootstrap();
+            this.ioc.bind(codiac_relay_1.RelayClient).toDynamicValue(ctx => codiac_relay_1.RelayClient.create(this.logger, undefined, authToken));
+            // this.ioc.bind(ThrowingCodiacClient).toSelf();
+            // this.ioc.bind<UserContextLoader>(UserContextLoader).toSelf();
+            // this.ioc.bind<UserContext>(UserContext).toDynamicValue(ctx => {
+            //   let logger = ctx.container.get<IBetterLogger>(INTERFACES.IBetterLogger);
+            //   let projCfg = ctx.container.get<ProjectConfig>(ProjectConfig);
+            //   let userLoader = new UserContextLoader(logger);
+            //   let userCntx = userLoader.loadUserContext(projCfg?.tenantCode) ?? new UserContext();
+            //   return userCntx;
+            // })
+            this.ioc.bind(uilogic_1.INTERFACES_CLI_ENTERPRISE.IContainerManager).toDynamicValue(ctx => {
+                var _a;
+                let relayCtrSettings = {
+                    healthCheckUrl: undefined,
+                    retryTimeout: undefined
+                };
+                let relayContainer = new relay_container_1.RelayContainer(ctx.container.get(codiac_ops_common_1.INTERFACES_OPS.IOutputStyler), ctx.container.get(codiac_common_1.INTERFACES.IBetterLogger), relayCtrSettings.healthCheckUrl, relayCtrSettings.retryTimeout, (_a = ctx.container.get(ops_1.ProjectEnviro)) === null || _a === void 0 ? void 0 : _a.projectRoot);
+                return relayContainer;
+            });
+            this.ioc.bind(extended_relay_client_1.ExtendedRelayClient).toDynamicValue(ctx => {
+                // let apiRootUrl: string | undefined;
+                let relayAuthToken;
+                let relayClient = new extended_relay_client_1.ExtendedRelayClient(ctx.container, ctx.container.get(codiac_relay_contracts_1.UserContext), ctx.container.get(uilogic_1.INTERFACES_CLI_ENTERPRISE.IContainerManager), ctx.container.get(codiac_ops_common_1.INTERFACES_OPS.IOutputStyler), ctx.container.get(codiac_common_1.INTERFACES.IBetterLogger), ctx.container.get(codiac_api_1.CodiacClient), this.codiacApiUrl /* Careful! This property relies on the rest of the bootstrapping to already be done */, relayAuthToken);
+                return relayClient;
+            });
+            // RelaySocketListener.bootstrap(this.ioc);
+            relay_websocket_client_1.RelayWebsocketClient.bootstrap(this.ioc);
+            CommandBaseEnterprise.isBootstrapped = true;
+        }
+    }
+    // protected loadClusterSpecSub: Subject<temp.Cluster> = new Subject();
+    // public get loadClusterSpec$(): Observable<temp.Cluster> {
+    //   return this.loadClusterSpecSub.asObservable();
+    // }
+    // protected acquireK8sContextSub: Subject<k8s.KubeConfig> = new Subject();
+    // public get acquireK8sContext$(): Observable<k8s.KubeConfig> {
+    //   return this.acquireK8sContextSub.asObservable();
+    // }
+    // protected _ui: IUserInputProvider;
+    // /** Assembles the full specification for the operation that is to be performed on the cluster.  */
+    // protected abstract async loadOperationInput( userCntx: UserContext, assetCntx: AssetContext): Promise<TOperationInput>;
+    // /** Performs the actual intended work within the cluster. */
+    // protected abstract async executeMainOperation(input: TOperationInput): Promise<void>;
+    /* ==================================================================================================
+     *     _                       _                     _
+     *    | |                     | |                   | |
+     *    | |     __ _ _____   _  | |     ___   __ _  __| |___
+     *    | |    / _` |_  / | | | | |    / _ \ / _` |/ _` / __|
+     *    | |___| (_| |/ /| |_| | | |___| (_) | (_| | (_| \__ \
+     *    \_____/\__,_/___|\__, | \_____/\___/ \__,_|\__,_|___/
+     *                      __/ |
+     *                     |___/
+     * ================================================================================================== */
+    /** Prompts for Cloud Provider credentials. */
+    get cspContextualizer() {
+        if (this.__cspContextualizer === undefined) {
+            cloud_provider_contextualizer_1.CloudProviderContextualizer.bootstrap(this.ioc); // Consider moving this to this.bootstrap().  Leaving it here is only saving us microseconds off the class' bootstrap method.
+            this.__cspContextualizer = this.ioc.get(cloud_provider_contextualizer_1.CloudProviderContextualizer);
+        }
+        return this.__cspContextualizer;
+    }
+    // let cspContextualizer = this.cspContextualizer; // hack: gotta trigger the bootstrap before we pull from factory.
+    // let factory = new ClusterConfiguratorFactory(); //this._codiacApi, this._ui, this.logger);
+    /** Prompts for Cloud Provider credentials. */
+    get cspUiFactory() {
+        if (this.__cspConfiguratorfactory === undefined) {
+            // Consider moving these bootstrap calls to this.bootstrap().  Leaving them here is only saving us microseconds off the class' bootstrap method.
+            cloud_provider_contextualizer_1.CloudProviderContextualizer.bootstrap(this.ioc); // (idempotent) this is a dependency of the configurators
+            uilogic_1.ClusterConfiguratorFactory.bootstrap(this.ioc);
+            this.__cspConfiguratorfactory = this.ioc.get(uilogic_1.ClusterConfiguratorFactory);
+        }
+        return this.__cspConfiguratorfactory;
+    }
+    /** TODO: move this to commandBase
+     *
+     * Fully qualified path to the app config folder on the local machine. */
+    get localConfigPath() {
+        if (this.__localConfigPath === undefined) {
+            this.__localConfigPath = path.normalize(codiac_ops_common_1.OpsUtils.resolveHomeDir(path.posix.join("~", codiac_constants_1.CliConstants.LOCAL_CONFIG_FOLDER_NAME)));
+        }
+        return this.__localConfigPath;
+    }
+    /** The Codiac Local config overrides (shared with the relay). */
+    get localConfig() {
+        if (this.__localConfigIsLoaded !== true) {
+            let localOverridesPathname = path.posix.join(this.localConfigPath, "codiac-local.json");
+            this.__localConfig = codiac_ops_common_1.JsonUtils.deserializeJsonFile(localOverridesPathname);
+            this.__localConfigIsLoaded = true;
+        }
+        return this.__localConfig;
+    }
+    set _userCntx(cntx) {
+        this.__userCntx = cntx;
+    }
+    get _userCntx() {
+        var _a, _b;
+        if (this.__userCntx === undefined) {
+            let userLoader = new user_context_loader_1.UserContextLoader(this.logger);
+            this.__userCntx = (_b = userLoader.loadUserContext((_a = this._projCfg) === null || _a === void 0 ? void 0 : _a.tenantCode)) !== null && _b !== void 0 ? _b : new codiac_relay_contracts_1.UserContext();
+        }
+        return this.__userCntx;
+    }
+    get codiacApiUrl() {
+        var _a, _b, _c;
+        if (this.__codiacApiUrl === undefined) {
+            this.__codiacApiUrl = (_c = (_b = (_a = this.localConfig) === null || _a === void 0 ? void 0 : _a.apiUrl) !== null && _b !== void 0 ? _b : this._cliCfg.codiacApiBaseUrl) !== null && _c !== void 0 ? _c : codiac_api_1.CodiacClient.DEFAULT_API_URL;
+        }
+        return this.__codiacApiUrl; // <--- wtf this is still needed, but we just ensured its not undefined ??
+    }
+    /**  TODO:  Get this out of the CLI.  Any calls to the codiac api should be made from the relay. */
+    get _codiacApi() {
+        if (this.__codiacApi === undefined) {
+            this.__codiacApi = this.ioc.get(codiac_api_1.CodiacClient);
+        }
+        return this.__codiacApi;
+    }
+    // protected get api(): ThrowingCodiacClient {
+    //   if (this.__api === undefined) {
+    //     this.__api = this.ioc.get(ThrowingCodiacClient);
+    //   }
+    //   return this.__api;
+    // }
+    // private __api: ThrowingCodiacClient | undefined;
+    get relayClient() {
+        if (this.__relayClient === undefined) {
+            if (this._projectRoot !== undefined) { }
+            // this.__relayClient = new RelayClient(this._userCntx, this._relayContainer, this._styler, this.logger);
+            // this.__relayClient = new ExtendedRelayClient(this.ioc, this._userCntx, this._relayContainer, this._styler, this.logger);
+            this.__relayClient = this.ioc.get(extended_relay_client_1.ExtendedRelayClient);
+        }
+        return this.__relayClient;
+    }
+    get genRelayClient() {
+        if (this.__genRelayClient === undefined) {
+            if (this._projectRoot !== undefined) { }
+            // this.__relayClient = new RelayClient(this._userCntx, this._relayContainer, this._styler, this.logger);
+            // this.__relayClient = new ExtendedRelayClient(this.ioc, this._userCntx, this._relayContainer, this._styler, this.logger);
+            this.__genRelayClient = this.ioc.get(codiac_relay_1.RelayClient);
+        }
+        return this.__genRelayClient;
+    }
+    set _relayContainer(rc) {
+        this.__relayContainer = rc;
+    }
+    get _relayContainer() {
+        if (this.__relayContainer === undefined) {
+            // HACK: Need an IoC strategy !!
+            this.__relayContainer = new relay_container_1.RelayContainer(this._styler, this.logger, undefined, undefined, this._projectRoot);
+            // this.__relayContainer.init();  // Do we NOT need this now?
+        }
+        return this.__relayContainer;
+    }
+    get _userContextManager() {
+        if (this.__userContextManager === undefined) {
+            this.__userContextManager = new user_context_loader_1.UserContextManager(this._codiacApi, this.logger);
+        }
+        return this.__userContextManager;
+    }
+    // TODO:  Make these all nullable
+    // --- PROJECT SCOPE -----------------------------------------------------------
+    // TODO: Try to get rid of this one.
+    /** NOTE:  This property MUST ONLY be accessed from within a project folder.
+   * It requires project scoped objects
+   * such as: `projectRoot`, `projectConfig`, `projectUserConfig`, and `ProjectContextRepo`.
+   *
+   * It lazy-loads them, and its methods will fail without them.
+  */
+    get _ops() {
+        if (this.__ops === undefined) {
+            this.__ops = new ops_1.LocalOps(this.ioc); // this ctor is trivial, no effect on perf. Lazy loading here is just for back-compat.
+        }
+        return this.__ops;
+    }
+    get enterpriseContextor() {
+        if (this.__enterpriseContextor === undefined) {
+            // TODO: make this injectable
+            // TODO: This ctor arg list is crazy.  Might want to break this class up somehow.
+            this.__enterpriseContextor = new enterprise_contextualizer_1.EnterpriseContextualizer(this._userCntx.currentTenantCode, this._ops, this.genRelayClient, this._codiacApi, this._projCfg, this._projUserCfg, this.projCfgRepo, this._userCntx, this._userContextManager, this._ui, this._styler, (code) => this.exit(code), this.logger);
+        }
+        return this.__enterpriseContextor;
+    }
+    get exec() {
+        if (this.__exec === undefined) {
+            this.__exec = new argument_manager_1.ArgumentManager(this.id, this._projCfg, this.projCfgRepo, this.logger, this._ui);
+        }
+        return this.__exec;
+    }
+    /** This getter Lazyloads from ioc. */
+    get projCfgRepo() {
+        if (this.__projCfgRepo_isSet === undefined) {
+            this.__projCfgRepo = this.ioc.get(ops_1.ProjectContextRepo);
+            this.__projCfgRepo_isSet = true;
+        }
+        return this.__projCfgRepo;
+    }
+    /** This getter Lazyloads from ioc. */
+    get _projCfg() {
+        if (this.__projCfg_isSet === undefined) {
+            this.__projCfg = this.ioc.get(codiac_relay_contracts_1.ProjectConfig);
+            this.__projCfg_isSet = true;
+        }
+        return this.__projCfg;
+    }
+    /** This getter Lazyloads from ioc. */
+    get _projUserCfg() {
+        if (this.__projUserCfg_isSet === undefined) {
+            this.__projUserCfg = this.ioc.get(codiac_relay_contracts_1.ProjectUserConfig);
+            this.__projUserCfg_isSet = true;
+        }
+        return this.__projUserCfg;
+    }
+    /** Lazyloads the project root folder path by walking up the current path to find a project config file. */
+    get _projectRoot() {
+        if (this.__projectRoot_isSet === undefined) {
+            this.__projectRoot = codiac_ops_common_1.CliPathWalker.getProjectRoot(undefined, (this.requiresProjectScope === true));
+            this.__projectRoot_isSet = true;
+        }
+        return this.__projectRoot;
+    }
+    /** Currently just coincides with projectRoot. */
+    get _dockerRoot() {
+        return this._projectRoot;
+    }
+    // private _dockerRoot: string|undefined;
+    // --- END PROJECT SCOPE -----------------------------------------------------------
+    /* == END OF LAZY LOADS ============================================================================================ */
+    /**
+     *
+     * @deprecated Use `establishTenantContext()` instead.
+     */
+    loadCodiacContext() {
+        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 cliCfg = this._cfgRepo.readCliConfig();
+                    let codiacApiUrl = (this._cliCfg) ? this._cliCfg.codiacApiBaseUrl : undefined;
+                    let codiacApi = codiac_api_1.CodiacClient.create(this.logger, codiacApiUrl);
+                    let authApiUrl = (this._cliCfg) ? this._cliCfg.authApiBaseUrl : undefined;
+                    let authApi = codiac_api_1.CodiacClient.create(this.logger, authApiUrl);
+                    let contextor = new uilogic_1.TenantContextualizer(this._projCfg, authApi, codiacApi, this.projCfgRepo, this._ui, this._styler, this.logger);
+                    let cntx = yield contextor.establishTenantContext();
+                    this.logger.debug("using codiac context:", cntx);
+                    resolve(cntx);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    getCabinetInfrx(enterprise, environment, cabinet, rootMap) {
+        try {
+            let targetEnt = rootMap.enterprises.find(ent => ent.name == enterprise);
+            let targetCab = targetEnt
+                .environments.find(env => env.name == environment)
+                .cabinets.find(c => c.name == cabinet);
+            return targetCab;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    /** Retrieves "all-the-things" from the api for the given enterprise. Throws not found or on error. */
+    getRootMap(enterpriseCode) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                let rootMapResult = yield this._codiacApi.Call.getRootMap({ enterprise: enterpriseCode });
+                if (rootMapResult.error)
+                    throw rootMapResult.error;
+                if (rootMapResult.output === undefined)
+                    throw new Error(`No rootmap found for enterprise [${enterpriseCode}]`);
+                return rootMapResult.output;
+            }
+            catch (err) {
+                throw err;
+            }
+        });
+    }
+    createAuditable() {
+        let stamp = new Date(Date.now());
+        return {
+            created: stamp,
+            createdBy: this._userCntx.userName,
+            modified: stamp,
+            modifiedBy: this._userCntx.userName
+        };
+    }
+    /** Logs the user in as needed, and persists the new context object to the local machine. */
+    establishTenantContext(currentContext, tenantContextualizer) {
+        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 contextor = tenantContextualizer !== null && tenantContextualizer !== void 0 ? tenantContextualizer : new uilogic_1.TenantContextualizer(this._projCfg, this._codiacApi, this._codiacApi, this.projCfgRepo, this._ui, this._styler, this.logger);
+                    let cntx = yield contextor.establishTenantContext(currentContext);
+                    if (cntx.currentToken) {
+                        this._codiacApi.setUserToken(cntx.currentToken); // why isnt this being done by the contextualizer?
+                        // this.api.repo.setUserToken(cntx.currentToken);  // why isnt this being done by the contextualizer?
+                    }
+                    // Register it with the ioc container
+                    if (this.ioc.isBound(codiac_relay_contracts_1.UserContext)) {
+                        this.ioc.rebind(codiac_relay_contracts_1.UserContext).toConstantValue(cntx);
+                    }
+                    else {
+                        this.ioc.bind(codiac_relay_contracts_1.UserContext).toConstantValue(cntx);
+                    }
+                    // Do the same for the UserNameTenantCode obj
+                    let tenantUser = {
+                        username: cntx.userName,
+                        tenantCode: cntx.currentTenantCode // ! operator is ok because we just estab'd tenant context
+                    };
+                    if (this.ioc.isBound(codiac_ops_common_1.UserNameTenantCode)) {
+                        this.ioc.rebind(codiac_ops_common_1.UserNameTenantCode).toConstantValue(tenantUser);
+                    }
+                    else {
+                        this.ioc.bind(codiac_ops_common_1.UserNameTenantCode).toConstantValue(tenantUser);
+                    }
+                    if (cntx.currentToken) {
+                        let apiCreds = new api_user_creds_1.ApiUserCreds(cntx.currentToken);
+                        if (this.ioc.isBound(api_user_creds_1.ApiUserCreds)) {
+                            this.ioc.unbind(api_user_creds_1.ApiUserCreds);
+                        }
+                        this.ioc.bind(api_user_creds_1.ApiUserCreds).toConstantValue(apiCreds);
+                    }
+                    // -----------------------------------------------
+                    // Trigger reinstantiations
+                    // COMMENTED OUT BC: this doesnt work.  No matter how hard I try, 
+                    // I cant get the ioc to inject the newly minted ApiUserCreds 
+                    // into the CodiacClient ctor.
+                    // 
+                    // this.__codiacApi = undefined;
+                    // this.__api = undefined;
+                    // -----------------------------------------------
+                    resolve(cntx);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** Acquires and adopts the identity of a single enterprise for the current project
+     * (DOES NOT establish an AssetBinding for the current tenant).
+     * TODO: Move this to commandBase
+     */
+    establishEnterpriseContext(enterpriseCode) {
+        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 {
+                    // CAUTION:
+                    // we are relying on this assertion:  `this._userCntx.currentTenantCode!`
+                    // The tenantContexualizer went through great lengths 
+                    // to ensure the _userCntx has a current tenant code,
+                    // so we can safely use that assertion operator here.
+                    // // This ctor arg list is crazy.  Might want to break this class up somehow.
+                    // let contextor = new EnterpriseContextualizer(this._userCntx.currentTenantCode!, this._ops, this._codiacApi,
+                    //   this._projCfg, this._projUserCfg, this.projCfgRepo,
+                    //   this._userCntx, this._userContextManager, this._regClientFactory, this._ui, this._styler, (code) => this.exit(code), this.logger);
+                    let enterprise = yield this.enterpriseContextor.establishEnterprise(enterpriseCode);
+                    resolve({ enterprise: enterprise });
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** Acquires and adopts the identity of a single enterprise (and asset) for the current project
+     * (aka: establishes an AssetBinding for the current tenant).
+     * TODO: return undefined to mean for "all in enterprise"
+     * TODO: Move this to commandBase
+     *
+     * @param suppressConfirmations (Optional: defaults to false) Prevents confirmations of user-values that are remembered from prior runs.
+     */
+    establishAssetContext(enterprise, suppressConfirmations) {
+        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 contextor = new enterprise_contextualizer_1.EnterpriseContextualizer(this._userCntx.currentTenantCode, this._ops, this.genRelayClient, this._codiacApi, this._projCfg, this._projUserCfg, this.projCfgRepo, this._userCntx, this._userContextManager, this._ui, this._styler, this.exit, this.logger);
+                    // let enterprise = await contextor.establishEnterprise(enterpriseCode);
+                    let assetName = yield contextor.establishEnterpriseAsset(enterprise, suppressConfirmations);
+                    resolve([assetName]);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** Defaults to the cabinet declared in the project user config.
+     * NOTE:  Run EstablishEnterpriseContext() before calling this method!!  It throws if no enterprise has been establiashed.
+    */
+    establishCabinetContext(requestedCabinet, requestedEnviro) {
+        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 contextor = new enterprise_contextualizer_1.EnterpriseContextualizer(this._userCntx.currentTenantCode, this._ops, this.genRelayClient, this._codiacApi, this._projCfg, this._projUserCfg, this.projCfgRepo, this._userCntx, this._userContextManager, this._ui, this._styler, this.exit, this.logger);
+                    let cabCntx = yield contextor.establishCabinetContext(requestedCabinet, undefined, requestedEnviro);
+                    resolve(cabCntx);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** This is only here so we can get the cluster name.
+     * Defaults to the cabinet declared in the project user config.
+     * NOTE:  Run EstablishEnterpriseContext() before calling this method!!  It throws if no enterprise has been establiashed.
+    */
+    establishCabinet(requestedCabinet, suppressConfirmations) {
+        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 contextor = new enterprise_contextualizer_1.EnterpriseContextualizer(this._userCntx.currentTenantCode, this._ops, this.genRelayClient, this._codiacApi, this._projCfg, this._projUserCfg, this.projCfgRepo, this._userCntx, this._userContextManager, this._ui, this._styler, this.exit, this.logger);
+                    let cabCntx = yield contextor.establishCabinet(requestedCabinet, suppressConfirmations);
+                    resolve(cabCntx);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** UI dialogue to acquire a valid environment under the current tenant.  */
+    establishEnvironment(requestedEnv) {
+        var _a, _b;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                let contextor = new environment_contextualizer_1.EnvironmentContextualizer(this._codiacApi, this._ui, this.logger);
+                let env = yield contextor.establishEnvironment(requestedEnv);
+                return env;
+            }
+            catch (err) {
+                this._ui.userMessage(`Error establishing environment: ${(_a = err.name) !== null && _a !== void 0 ? _a : ""} ${(_b = err.message) !== null && _b !== void 0 ? _b : ""}`);
+                throw err;
+            }
+        });
+    }
+    establishCloudProviderCreds(rootMap, clusterName, suppressConfirmations, providedUserName, providedSecret) {
+        var _a, _b;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                if (clusterName === undefined)
+                    throw new Error(`Cannot prompt for cloud provider credentials: cluster name provided was undefined.`);
+                let targetClusterDef = rootMap.clusters.find(c => c.name === clusterName);
+                if (targetClusterDef) {
+                    yield this.cspContextualizer.promptForCloudProviderCreds(this.ioc, targetClusterDef.provider, suppressConfirmations, providedUserName, providedSecret);
+                }
+                else {
+                    this.logger.warn(`No cluster defnition named ${clusterName} was found, so cloud provider creds may not be in scope.`);
+                }
+            }
+            catch (err) {
+                this._ui.userMessage(`Error establishing cloud provider credentials: ${(_a = err.name) !== null && _a !== void 0 ? _a : ""} ${(_b = err.message) !== null && _b !== void 0 ? _b : ""}`);
+                throw err;
+            }
+        });
+    }
+}
+exports.CommandBaseEnterprise = CommandBaseEnterprise;
+//# sourceMappingURL=command-base-enterprise.js.map