@codiac.io/codiac-cli 1.2.157 → 1.2.165

package/lib/uilogic/prompt-select-fuzzy.js

@@ -1,139 +1,139 @@
-"use strict";
-// import { IBetterLogger, INTERFACES } from "@codiac.io/codiac-common";
-// import { inject, injectable } from "inversify";
-// const autocomplete = require("inquirer-autocomplete-prompt");
-// import inquirer = require('inquirer');
-// import fuzzy = require("fuzzy");
-// import { INTERFACES_OPS, IOutputStyler, IUserInputProvider } from "@codiac.io/codiac-ops-common";
-// import { PromptChoice } from "../cli-entities/prompt-choice";
-// // private async searchPorts(answers: PromptChoice[], input: string): Promise<PromptChoice[]> {
-// //   return new Promise<PromptChoice[]>(async (resolve, reject) => {
-// //     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 filtered: PromptChoice[];
-// //         // if (parseInt(input) != NaN) {
-// //         if (isNaN(+input)) {
-// //           // let options: fuzzy.FilterOptions<PromptChoice> = { extract: (ver: PromptChoice) => { return ver.value } };
-// //           let options: fuzzy.FilterOptions<PromptChoice> = { extract: (ver: PromptChoice) => { return ver.name } };
-// //           let results = fuzzy.filter(input, ports, options);
-// //           filtered = results.map((fr: fuzzy.FilterResult<PromptChoice>) => fr.original);
-// //         } else {
-// //           filtered = ports.filter(p => `${p.value}`.startsWith(input))
-// //         }
-// //         resolve(filtered)
-// //       }, 20); //_.random(30, 500));  // why a random number?
-// //     } catch (err) {
-// //       reject(err);
-// //     }
-// //   });
-// // }
-// export type ValidationResult = boolean | { isValid: boolean, reason?: string }
-// type FuzzyResult = {
-//   /** The rendered string (eg: '<b>lah'). */
-//   string: string,
-//   /** The index of the element in `arr` (eg: 2). */
-//   index: number,
-//   /** The original element in `arr`. */
-//   original: 'blah'
-// }
-// /** Has to be module-scoped bc the autocomplete redefines "this",
-//  *  so we can't use it inside getFuzzyFilteredChoices().
-//  *
-//  * THIS WILL PREVENT MULTIPLE instances of a fuzzy-search: Refactor to use `PromptSelectFuzzy.fetchedChoices[controlId]` instead.
-//  */
-// let fetchedChoices: PromptChoice[] = [];
-// /** Prompt for a value using a fuzzy-search to show available selections.
-//  */
-// @injectable()
-// export class PromptSelectFuzzy {
-//   constructor(
-//     @inject(INTERFACES.IBetterLogger) private logger: IBetterLogger,
-//     @inject(INTERFACES_OPS.IUserInputProvider) private _ui: IUserInputProvider,
-//     @inject(INTERFACES_OPS.IOutputStyler) private _styler: IOutputStyler
-//   ) {
-//   }
-//   private static fetchedChoices: { [controlId: string]: PromptChoice[] } = {};
-//   public go(controlId: string, prompt: string, suggestOnly: boolean, defaultValue: string | undefined, searchOnRemote: boolean, fetchMethod: (searchString?: string) => Promise<PromptChoice[]>, validationMethod?: ((candidate: string) => ValidationResult)): Promise<string> {
-//     return new Promise<string>(async (resolve, reject) => {
-//       let entry: string | undefined;  // = defaultValue;
-//       try {
-//         // TODO: Consider running this inside getFuzzyFilteredChoices()...
-//         // eg:
-//         // let fuzzySearch = (answers: PromptChoice[], input: string): Promise<PromptChoice[]> {
-//         //  return this.getFuzzyFilteredChoices(answers, input, fetchMethod);
-//         // }
-//         // PromptSelectFuzzy.fetchedChoices[controlId] = await fetchMethod();
-//         if (searchOnRemote !== true) fetchedChoices = await fetchMethod("");
-//         let selectedValue: string | undefined;
-//         let isValid: boolean = false;
-//         let invalidReason: string | undefined;
-//         while (entry === undefined || !isValid) {
-//           inquirer.registerPrompt('autocomplete', autocomplete);
-//           if (invalidReason) this._ui.userMessage(invalidReason);
-//           let selectResult = await inquirer.prompt<{ [key: string]: string }>([{
-//             type: 'autocomplete',
-//             suggestOnly: suggestOnly,
-//             name: controlId,
-//             message: `${prompt} `,
-//             source: (searchOnRemote) ? (answers: PromptChoice[], input: string) => fetchMethod(input) : this.getFuzzyFilteredChoices,
-//             default: defaultValue
-//           }]);
-//           entry = selectResult[controlId];
-//           selectedValue = selectResult[controlId];  // this is not entry because selectedValue should be of generic type "T"
-//           this.logger.trace(`${controlId} selected`, selectedValue);
-//           // Validate the selection
-//           let validResult = (validationMethod) ? validationMethod(selectedValue) : true;
-//           if (typeof validResult === 'boolean') {
-//             isValid = validResult;
-//             invalidReason = undefined;
-//           } else {
-//             isValid = validResult.isValid;
-//             invalidReason = validResult.reason;
-//           }
-//           if (!isValid) {
-//             this.logger.trace(`${controlId} value [${selectedValue}] is invalid. ${invalidReason ?? ""}`);
-//           }
-//         }
-//         resolve(selectedValue ?? "");
-//       } catch (err) {
-//         this.logger.error(`Error performing a fuzzy-select for [${controlId}]: ${err.name ?? ""} ${err.message ?? ""}`, err.stack);
-//         reject(err);
-//       }
-//     });
-//   }
-//   /** Performs the actual fuzzy-filtering of the already-fetched module-scoped list of available values.  */
-//   private getFuzzyFilteredChoices(answers: PromptChoice[], input: string): Promise<PromptChoice[]> {
-//     return new Promise<PromptChoice[]>(async (resolve, reject) => {
-//       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 || "";
-//         // Original instructions called for this (maybe to debounce it?)
-//         // setTimeout(() => {
-//         let filtered: PromptChoice[];
-//         // if (parseInt(input) != NaN) {
-//         if (isNaN(+input)) {
-//           // let options: fuzzy.FilterOptions<PromptChoice> = { extract: (ver: PromptChoice) => { return ver.value } };
-//           let options: fuzzy.FilterOptions<PromptChoice> = { extract: (ver: PromptChoice) => { return ver.name } };
-//           let results = fuzzy.filter(input, fetchedChoices, options);
-//           filtered = results.map((fr: fuzzy.FilterResult<PromptChoice>) => fr.original);
-//         } else {
-//           // Numeric search
-//           filtered = fetchedChoices.filter(p => `${p.value}`.startsWith(input))
-//         }
-//         resolve(filtered)
-//         // }, 20);  // is this for debouncing?
-//       } catch (err) {
-//         reject(err);
-//       }
-//     });
-//   }
-// }
+"use strict";
+// import { IBetterLogger, INTERFACES } from "@codiac.io/codiac-common";
+// import { inject, injectable } from "inversify";
+// const autocomplete = require("inquirer-autocomplete-prompt");
+// import inquirer = require('inquirer');
+// import fuzzy = require("fuzzy");
+// import { INTERFACES_OPS, IOutputStyler, IUserInputProvider } from "@codiac.io/codiac-ops-common";
+// import { PromptChoice } from "../cli-entities/prompt-choice";
+// // private async searchPorts(answers: PromptChoice[], input: string): Promise<PromptChoice[]> {
+// //   return new Promise<PromptChoice[]>(async (resolve, reject) => {
+// //     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 filtered: PromptChoice[];
+// //         // if (parseInt(input) != NaN) {
+// //         if (isNaN(+input)) {
+// //           // let options: fuzzy.FilterOptions<PromptChoice> = { extract: (ver: PromptChoice) => { return ver.value } };
+// //           let options: fuzzy.FilterOptions<PromptChoice> = { extract: (ver: PromptChoice) => { return ver.name } };
+// //           let results = fuzzy.filter(input, ports, options);
+// //           filtered = results.map((fr: fuzzy.FilterResult<PromptChoice>) => fr.original);
+// //         } else {
+// //           filtered = ports.filter(p => `${p.value}`.startsWith(input))
+// //         }
+// //         resolve(filtered)
+// //       }, 20); //_.random(30, 500));  // why a random number?
+// //     } catch (err) {
+// //       reject(err);
+// //     }
+// //   });
+// // }
+// export type ValidationResult = boolean | { isValid: boolean, reason?: string }
+// type FuzzyResult = {
+//   /** The rendered string (eg: '<b>lah'). */
+//   string: string,
+//   /** The index of the element in `arr` (eg: 2). */
+//   index: number,
+//   /** The original element in `arr`. */
+//   original: 'blah'
+// }
+// /** Has to be module-scoped bc the autocomplete redefines "this",
+//  *  so we can't use it inside getFuzzyFilteredChoices().
+//  *
+//  * THIS WILL PREVENT MULTIPLE instances of a fuzzy-search: Refactor to use `PromptSelectFuzzy.fetchedChoices[controlId]` instead.
+//  */
+// let fetchedChoices: PromptChoice[] = [];
+// /** Prompt for a value using a fuzzy-search to show available selections.
+//  */
+// @injectable()
+// export class PromptSelectFuzzy {
+//   constructor(
+//     @inject(INTERFACES.IBetterLogger) private logger: IBetterLogger,
+//     @inject(INTERFACES_OPS.IUserInputProvider) private _ui: IUserInputProvider,
+//     @inject(INTERFACES_OPS.IOutputStyler) private _styler: IOutputStyler
+//   ) {
+//   }
+//   private static fetchedChoices: { [controlId: string]: PromptChoice[] } = {};
+//   public go(controlId: string, prompt: string, suggestOnly: boolean, defaultValue: string | undefined, searchOnRemote: boolean, fetchMethod: (searchString?: string) => Promise<PromptChoice[]>, validationMethod?: ((candidate: string) => ValidationResult)): Promise<string> {
+//     return new Promise<string>(async (resolve, reject) => {
+//       let entry: string | undefined;  // = defaultValue;
+//       try {
+//         // TODO: Consider running this inside getFuzzyFilteredChoices()...
+//         // eg:
+//         // let fuzzySearch = (answers: PromptChoice[], input: string): Promise<PromptChoice[]> {
+//         //  return this.getFuzzyFilteredChoices(answers, input, fetchMethod);
+//         // }
+//         // PromptSelectFuzzy.fetchedChoices[controlId] = await fetchMethod();
+//         if (searchOnRemote !== true) fetchedChoices = await fetchMethod("");
+//         let selectedValue: string | undefined;
+//         let isValid: boolean = false;
+//         let invalidReason: string | undefined;
+//         while (entry === undefined || !isValid) {
+//           inquirer.registerPrompt('autocomplete', autocomplete);
+//           if (invalidReason) this._ui.userMessage(invalidReason);
+//           let selectResult = await inquirer.prompt<{ [key: string]: string }>([{
+//             type: 'autocomplete',
+//             suggestOnly: suggestOnly,
+//             name: controlId,
+//             message: `${prompt} `,
+//             source: (searchOnRemote) ? (answers: PromptChoice[], input: string) => fetchMethod(input) : this.getFuzzyFilteredChoices,
+//             default: defaultValue
+//           }]);
+//           entry = selectResult[controlId];
+//           selectedValue = selectResult[controlId];  // this is not entry because selectedValue should be of generic type "T"
+//           this.logger.trace(`${controlId} selected`, selectedValue);
+//           // Validate the selection
+//           let validResult = (validationMethod) ? validationMethod(selectedValue) : true;
+//           if (typeof validResult === 'boolean') {
+//             isValid = validResult;
+//             invalidReason = undefined;
+//           } else {
+//             isValid = validResult.isValid;
+//             invalidReason = validResult.reason;
+//           }
+//           if (!isValid) {
+//             this.logger.trace(`${controlId} value [${selectedValue}] is invalid. ${invalidReason ?? ""}`);
+//           }
+//         }
+//         resolve(selectedValue ?? "");
+//       } catch (err) {
+//         this.logger.error(`Error performing a fuzzy-select for [${controlId}]: ${err.name ?? ""} ${err.message ?? ""}`, err.stack);
+//         reject(err);
+//       }
+//     });
+//   }
+//   /** Performs the actual fuzzy-filtering of the already-fetched module-scoped list of available values.  */
+//   private getFuzzyFilteredChoices(answers: PromptChoice[], input: string): Promise<PromptChoice[]> {
+//     return new Promise<PromptChoice[]>(async (resolve, reject) => {
+//       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 || "";
+//         // Original instructions called for this (maybe to debounce it?)
+//         // setTimeout(() => {
+//         let filtered: PromptChoice[];
+//         // if (parseInt(input) != NaN) {
+//         if (isNaN(+input)) {
+//           // let options: fuzzy.FilterOptions<PromptChoice> = { extract: (ver: PromptChoice) => { return ver.value } };
+//           let options: fuzzy.FilterOptions<PromptChoice> = { extract: (ver: PromptChoice) => { return ver.name } };
+//           let results = fuzzy.filter(input, fetchedChoices, options);
+//           filtered = results.map((fr: fuzzy.FilterResult<PromptChoice>) => fr.original);
+//         } else {
+//           // Numeric search
+//           filtered = fetchedChoices.filter(p => `${p.value}`.startsWith(input))
+//         }
+//         resolve(filtered)
+//         // }, 20);  // is this for debouncing?
+//       } catch (err) {
+//         reject(err);
+//       }
+//     });
+//   }
+// }
 //# sourceMappingURL=prompt-select-fuzzy.js.map

package/lib/uilogic/render-methods.d.ts

@@ -1,12 +1,12 @@
-export declare enum OutputFormatsEnum {
-    "text" = "text",
-    "tree" = "tree",
-    "json" = "json",
-    "yaml" = "yaml"
-}
-export type StringParent = {
-    text: string;
-    children?: StringParent[];
-};
-export declare function renderStringTree(tree: StringParent[], renderMethod?: (renderedItem: string, item: StringParent) => void, depth?: number, levelPrefix?: string): string;
-export declare function renderStringList(values: string[], renderMethod?: (text: string) => void): string;
+export declare enum OutputFormatsEnum {
+    "text" = "text",
+    "tree" = "tree",
+    "json" = "json",
+    "yaml" = "yaml"
+}
+export type StringParent = {
+    text: string;
+    children?: StringParent[];
+};
+export declare function renderStringTree(tree: StringParent[], renderMethod?: (renderedItem: string, item: StringParent) => void, depth?: number, levelPrefix?: string): string;
+export declare function renderStringList(values: string[], renderMethod?: (text: string) => void): string;

package/lib/uilogic/render-methods.js

@@ -1,65 +1,65 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderStringList = exports.renderStringTree = exports.OutputFormatsEnum = void 0;
-var OutputFormatsEnum;
-(function (OutputFormatsEnum) {
-    OutputFormatsEnum["text"] = "text";
-    OutputFormatsEnum["tree"] = "tree";
-    OutputFormatsEnum["json"] = "json";
-    OutputFormatsEnum["yaml"] = "yaml";
-})(OutputFormatsEnum = exports.OutputFormatsEnum || (exports.OutputFormatsEnum = {}));
-function renderStringTree(tree, renderMethod, depth, levelPrefix) {
-    let output = "";
-    let currentDepth = (depth !== null && depth !== void 0 ? depth : -1) + 1;
-    // let defaultRenderMethod = (text: string) => { output = output.concat(text, "\n"); };
-    // let render = renderMethod ?? defaultRenderMethod;
-    if (tree.length === 0) {
-        output = "[none]";
-    }
-    for (let idx = 0; idx < tree.length; idx++) {
-        let branch = tree[idx];
-        let lines = "";
-        if (currentDepth > 0) {
-            lines = (idx === tree.length - 1) ? "└─" : "├─";
-            if (currentDepth > 1) {
-                // lines = "│  ".repeat(currentDepth - 1).concat(lines);  // TODO: cant show the vertical if its the last branch of that ancestor
-                lines = (levelPrefix !== null && levelPrefix !== void 0 ? levelPrefix : "").concat(lines); // TODO: cant show the vertical if its the last branch of that ancestor
-            }
-            lines = lines.concat(" ");
-        }
-        let thisLine = lines.concat(branch.text);
-        output = output.concat(thisLine, "\n");
-        if (renderMethod)
-            renderMethod(thisLine, branch);
-        if (branch.children !== undefined && branch.children.length > 0) {
-            let newPrefix = "";
-            if (currentDepth > 0) {
-                let mySiblingConnector = (idx === tree.length - 1) ? " " : "│";
-                newPrefix = (levelPrefix !== null && levelPrefix !== void 0 ? levelPrefix : "").concat(mySiblingConnector, "  ");
-            }
-            output = output.concat(renderStringTree(branch.children, renderMethod, currentDepth, newPrefix));
-        }
-    }
-    return output;
-}
-exports.renderStringTree = renderStringTree;
-function renderStringList(values, renderMethod) {
-    try {
-        let output = "";
-        if (values.length === 0) {
-            output = "[none]";
-        }
-        for (let text of values) {
-            let thisLine = text.concat("\n");
-            output = output.concat(thisLine);
-            if (renderMethod)
-                renderMethod(thisLine);
-        }
-        return output;
-    }
-    catch (err) {
-        throw err;
-    }
-}
-exports.renderStringList = renderStringList;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderStringList = exports.renderStringTree = exports.OutputFormatsEnum = void 0;
+var OutputFormatsEnum;
+(function (OutputFormatsEnum) {
+    OutputFormatsEnum["text"] = "text";
+    OutputFormatsEnum["tree"] = "tree";
+    OutputFormatsEnum["json"] = "json";
+    OutputFormatsEnum["yaml"] = "yaml";
+})(OutputFormatsEnum = exports.OutputFormatsEnum || (exports.OutputFormatsEnum = {}));
+function renderStringTree(tree, renderMethod, depth, levelPrefix) {
+    let output = "";
+    let currentDepth = (depth !== null && depth !== void 0 ? depth : -1) + 1;
+    // let defaultRenderMethod = (text: string) => { output = output.concat(text, "\n"); };
+    // let render = renderMethod ?? defaultRenderMethod;
+    if (tree.length === 0) {
+        output = "[none]";
+    }
+    for (let idx = 0; idx < tree.length; idx++) {
+        let branch = tree[idx];
+        let lines = "";
+        if (currentDepth > 0) {
+            lines = (idx === tree.length - 1) ? "└─" : "├─";
+            if (currentDepth > 1) {
+                // lines = "│  ".repeat(currentDepth - 1).concat(lines);  // TODO: cant show the vertical if its the last branch of that ancestor
+                lines = (levelPrefix !== null && levelPrefix !== void 0 ? levelPrefix : "").concat(lines); // TODO: cant show the vertical if its the last branch of that ancestor
+            }
+            lines = lines.concat(" ");
+        }
+        let thisLine = lines.concat(branch.text);
+        output = output.concat(thisLine, "\n");
+        if (renderMethod)
+            renderMethod(thisLine, branch);
+        if (branch.children !== undefined && branch.children.length > 0) {
+            let newPrefix = "";
+            if (currentDepth > 0) {
+                let mySiblingConnector = (idx === tree.length - 1) ? " " : "│";
+                newPrefix = (levelPrefix !== null && levelPrefix !== void 0 ? levelPrefix : "").concat(mySiblingConnector, "  ");
+            }
+            output = output.concat(renderStringTree(branch.children, renderMethod, currentDepth, newPrefix));
+        }
+    }
+    return output;
+}
+exports.renderStringTree = renderStringTree;
+function renderStringList(values, renderMethod) {
+    try {
+        let output = "";
+        if (values.length === 0) {
+            output = "[none]";
+        }
+        for (let text of values) {
+            let thisLine = text.concat("\n");
+            output = output.concat(thisLine);
+            if (renderMethod)
+                renderMethod(thisLine);
+        }
+        return output;
+    }
+    catch (err) {
+        throw err;
+    }
+}
+exports.renderStringList = renderStringList;
 //# sourceMappingURL=render-methods.js.map

package/lib/uilogic/tenant-contextualizer.d.ts

@@ -1,79 +1,79 @@
-import { AuthTenant } from '@codiac.io/codiac-common/security/auth-entities';
-import { CodiacClient, CodiacClient as AuthClient } from '../apis/codiac-api';
-import { ProjectConfig, UserContext } from '@codiac.io/codiac-relay-contracts';
-import { IBetterLogger } from '@codiac.io/codiac-common/IBetterLogger';
-import { IUserInputProvider, IOutputStyler } from '@codiac.io/codiac-ops-common';
-import { ProjectContextRepo } from '../ops';
-/** Interfaces with CLI user to establish a tenant context.  */
-export declare class TenantContextualizer {
-    private projCfg;
-    private authClient;
-    private _projCfgRepo;
-    private ui;
-    private styler;
-    private logger;
-    static readonly CODE_FOR_NEW_TENANT = "** create new **";
-    /**
-     * @param projCfg The In-memory representation of the project's thaulconfig file.
-     */
-    constructor(projCfg: ProjectConfig | undefined, authClient: AuthClient, apiClient: CodiacClient, _projCfgRepo: ProjectContextRepo | undefined, ui: IUserInputProvider, styler: IOutputStyler, logger: IBetterLogger);
-    private userContextLoader;
-    private userContextRepo;
-    /** An authenticated user, freshly retrieved during this process. */
-    private _user;
-    /** Ensures that a valid tenant is assigned
-     * and the user has a valid tenant contributor token.
-     *
-     * @param currentContext The Machine-user context.  It's just the starting point, not necessarily the right one.  ie: Project config enforcement may switch it on you.
-    */
-    establishTenantContext(currentContext?: UserContext): Promise<UserContext>;
-    /** Checks the given user context and then the machine user configuration for a user profile with the given tenant.
-     *
-     * Returns a principal user context (undefined currentTenantCode properties) if it doesnt have a matching tenant profile.
-     * Returns `undefined` if no context found at all.
-     *
-     * DOES NOT throw encountered exceptions, so that a login prompt can follow in case something is corrupted.
-     *
-     * DOES NOT validate or authenticate - merely loads whatever is the local cache.
-     */
-    private tryMatchGivenOrCached;
-    /** Returns a valid tenant context if the given tenant is already current on the given context and the token isnt expired. */
-    tryUseCurrentToken(currentContext: UserContext, tenantCode: string): UserContext | undefined;
-    /** Attempts to switch the userContext to a locally cached profile for the given tenant,
-     * and if not found, requests a switch from the auth service.
-     * The current userContext will only be modified if the switch is successfully made.
-     * throws is the userContext does not already contain at least one token that will identify the user (regardless of tenant).
-     * SIDE-EFFECT:  This may refresh the currentToken on the current user context and cache it to the user context file. */
-    private trySwitchTenant;
-    /** Only diff betw this an authenticate is that
-     * this method only returns a valid tenant context
-     * (whereas authenticate returns a user or tenant context). */
-    private tryAuthenticateUnderTenant;
-    trySelectFromMyTenants(currentContext: UserContext | undefined, allowAddNew?: boolean): Promise<UserContext | undefined>;
-    /** Side effect: Overwrites this._user if it s able to refresh it from the auth api */
-    establishPrincipalContext(context: UserContext | undefined): Promise<UserContext | undefined>;
-    private getUserTenants;
-    /** Prompts the user to select a tenant from the given list of tenantCodes.
-     * Returns undefined if cancelled, and TenantContextualizer.CODE_FOR_NEW_TENANT if "register new" is selected.
-     * @param tenants List of tenants from which to select.
-     * @param allowAddNew Inserts an option to add a new tenant.  (NOTE: this method DOES NOT perform the add new action itself!)
-    */
-    promptToSelectTenant(tenants: AuthTenant[], allowAddNew?: boolean): Promise<string | undefined>;
-    /** Returns a tenant context, a user context, or undefined if operation cancelled.
-     * Caches the new user context.
-     * Throws any exceptions.
-     *
-     * `unregistered` tenant code gets ignored.
-     *
-     * @param login
-     * @param silent (optional: defaults to false) When set to true, suppresses the prompts to confirm the given defaults.  Requires defaultLogin and defaultPassword to be set.  Also requires tenantCode if the current user has more than one tenant profile and it cannot be derived decisively from the current context.
-     */
-    authenticate(tenantCode?: string, login?: string, password?: string, silent?: boolean): Promise<UserContext | undefined>;
-    private isNullOrEmpty;
-    tryRegisterNewTenant(currentContext: UserContext | undefined, companyName?: string, tenantCode?: string): Promise<UserContext | undefined>;
-    cancel(): void;
-    /** logs a user message stating that the current user
-     * is not a member of the given tenant,
-     * with instructions for what to do next.  */
-    private renderNotAMember;
-}
+import { AuthTenant } from '@codiac.io/codiac-common/security/auth-entities';
+import { CodiacClient, CodiacClient as AuthClient } from '../apis/codiac-api';
+import { ProjectConfig, UserContext } from '@codiac.io/codiac-relay-contracts';
+import { IBetterLogger } from '@codiac.io/codiac-common/IBetterLogger';
+import { IUserInputProvider, IOutputStyler } from '@codiac.io/codiac-ops-common';
+import { ProjectContextRepo } from '../ops';
+/** Interfaces with CLI user to establish a tenant context.  */
+export declare class TenantContextualizer {
+    private projCfg;
+    private authClient;
+    private _projCfgRepo;
+    private ui;
+    private styler;
+    private logger;
+    static readonly CODE_FOR_NEW_TENANT = "** create new **";
+    /**
+     * @param projCfg The In-memory representation of the project's thaulconfig file.
+     */
+    constructor(projCfg: ProjectConfig | undefined, authClient: AuthClient, apiClient: CodiacClient, _projCfgRepo: ProjectContextRepo | undefined, ui: IUserInputProvider, styler: IOutputStyler, logger: IBetterLogger);
+    private userContextLoader;
+    private userContextRepo;
+    /** An authenticated user, freshly retrieved during this process. */
+    private _user;
+    /** Ensures that a valid tenant is assigned
+     * and the user has a valid tenant contributor token.
+     *
+     * @param currentContext The Machine-user context.  It's just the starting point, not necessarily the right one.  ie: Project config enforcement may switch it on you.
+    */
+    establishTenantContext(currentContext?: UserContext): Promise<UserContext>;
+    /** Checks the given user context and then the machine user configuration for a user profile with the given tenant.
+     *
+     * Returns a principal user context (undefined currentTenantCode properties) if it doesnt have a matching tenant profile.
+     * Returns `undefined` if no context found at all.
+     *
+     * DOES NOT throw encountered exceptions, so that a login prompt can follow in case something is corrupted.
+     *
+     * DOES NOT validate or authenticate - merely loads whatever is the local cache.
+     */
+    private tryMatchGivenOrCached;
+    /** Returns a valid tenant context if the given tenant is already current on the given context and the token isnt expired. */
+    tryUseCurrentToken(currentContext: UserContext, tenantCode: string): UserContext | undefined;
+    /** Attempts to switch the userContext to a locally cached profile for the given tenant,
+     * and if not found, requests a switch from the auth service.
+     * The current userContext will only be modified if the switch is successfully made.
+     * throws is the userContext does not already contain at least one token that will identify the user (regardless of tenant).
+     * SIDE-EFFECT:  This may refresh the currentToken on the current user context and cache it to the user context file. */
+    private trySwitchTenant;
+    /** Only diff betw this an authenticate is that
+     * this method only returns a valid tenant context
+     * (whereas authenticate returns a user or tenant context). */
+    private tryAuthenticateUnderTenant;
+    trySelectFromMyTenants(currentContext: UserContext | undefined, allowAddNew?: boolean): Promise<UserContext | undefined>;
+    /** Side effect: Overwrites this._user if it s able to refresh it from the auth api */
+    establishPrincipalContext(context: UserContext | undefined): Promise<UserContext | undefined>;
+    private getUserTenants;
+    /** Prompts the user to select a tenant from the given list of tenantCodes.
+     * Returns undefined if cancelled, and TenantContextualizer.CODE_FOR_NEW_TENANT if "register new" is selected.
+     * @param tenants List of tenants from which to select.
+     * @param allowAddNew Inserts an option to add a new tenant.  (NOTE: this method DOES NOT perform the add new action itself!)
+    */
+    promptToSelectTenant(tenants: AuthTenant[], allowAddNew?: boolean): Promise<string | undefined>;
+    /** Returns a tenant context, a user context, or undefined if operation cancelled.
+     * Caches the new user context.
+     * Throws any exceptions.
+     *
+     * `unregistered` tenant code gets ignored.
+     *
+     * @param login
+     * @param silent (optional: defaults to false) When set to true, suppresses the prompts to confirm the given defaults.  Requires defaultLogin and defaultPassword to be set.  Also requires tenantCode if the current user has more than one tenant profile and it cannot be derived decisively from the current context.
+     */
+    authenticate(tenantCode?: string, login?: string, password?: string, silent?: boolean): Promise<UserContext | undefined>;
+    private isNullOrEmpty;
+    tryRegisterNewTenant(currentContext: UserContext | undefined, companyName?: string, tenantCode?: string): Promise<UserContext | undefined>;
+    cancel(): void;
+    /** logs a user message stating that the current user
+     * is not a member of the given tenant,
+     * with instructions for what to do next.  */
+    private renderNotAMember;
+}