@salesforce/core 3.23.4 → 3.23.5

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [3.23.5](https://github.com/forcedotcom/sfdx-core/compare/v3.23.4...v3.23.5) (2022-07-06)
+
+### Bug Fixes
+
+- add resolveAlias ([#605](https://github.com/forcedotcom/sfdx-core/issues/605)) ([ffa9ed6](https://github.com/forcedotcom/sfdx-core/commit/ffa9ed63ea583baa327071db4030ea5346d1128f))
+
 ### [3.23.4](https://github.com/forcedotcom/sfdx-core/compare/v3.23.3...v3.23.4) (2022-07-05)
 
 ### Bug Fixes

package/lib/stateAggregator/accessors/aliasAccessor.d.ts

@@ -138,6 +138,16 @@ export declare class AliasAccessor extends AsyncOptionalCreatable {
      * @param usernameOrAlias a string that might be a username or might be an alias
      */
     resolveUsername(usernameOrAlias: string): string;
+    /**
+     * If the provided string is an alias, return it.
+     * If the provided string is not an alias, return the username of the provided alias
+     *
+     * This method is helpful when you don't know if the string you have is a username
+     * or an alias.
+     *
+     * @param usernameOrAlias a string that might be a username or might be an alias
+     */
+    resolveAlias(usernameOrAlias: string): Nullable<string>;
     /**
      * Set an alias for the given aliasable entity
      *
@@ -145,14 +155,24 @@ export declare class AliasAccessor extends AsyncOptionalCreatable {
      * @param entity the aliasable entity that's being aliased
      */
     set(alias: string, entity: Aliasable): void;
+    /**
+     * Unset the given alias.
+     *
+     */
     unset(alias: string): void;
     /**
-     * This method unsets all the aliases for the given entity.
+     * Unsets all the aliases for the given entity.
      *
      * @param entity the aliasable entity for which you want to unset all aliases
      */
     unsetAll(entity: Aliasable): void;
     write(): Promise<ConfigContents>;
+    /**
+     * Returns true if the provided alias exists
+     *
+     * @param alias the alias you want to check
+     */
+    has(alias: string): boolean;
     protected init(): Promise<void>;
     /**
      * Returns the username of given aliasable entity

package/lib/stateAggregator/accessors/aliasAccessor.js

@@ -202,6 +202,21 @@ class AliasAccessor extends kit_1.AsyncOptionalCreatable {
         var _a;
         return (_a = this.getUsername(usernameOrAlias)) !== null && _a !== void 0 ? _a : usernameOrAlias;
     }
+    /**
+     * If the provided string is an alias, return it.
+     * If the provided string is not an alias, return the username of the provided alias
+     *
+     * This method is helpful when you don't know if the string you have is a username
+     * or an alias.
+     *
+     * @param usernameOrAlias a string that might be a username or might be an alias
+     */
+    resolveAlias(usernameOrAlias) {
+        var _a;
+        if (this.has(usernameOrAlias))
+            return usernameOrAlias;
+        return (_a = Object.entries(this.getAll()).find(([, username]) => username === usernameOrAlias)) === null || _a === void 0 ? void 0 : _a[0];
+    }
     /**
      * Set an alias for the given aliasable entity
      *
@@ -211,11 +226,15 @@ class AliasAccessor extends kit_1.AsyncOptionalCreatable {
     set(alias, entity) {
         this.config.set(alias, this.getNameOf(entity));
     }
+    /**
+     * Unset the given alias.
+     *
+     */
     unset(alias) {
         this.config.unset(alias);
     }
     /**
-     * This method unsets all the aliases for the given entity.
+     * Unsets all the aliases for the given entity.
      *
      * @param entity the aliasable entity for which you want to unset all aliases
      */
@@ -226,6 +245,14 @@ class AliasAccessor extends kit_1.AsyncOptionalCreatable {
     async write() {
         return this.config.write();
     }
+    /**
+     * Returns true if the provided alias exists
+     *
+     * @param alias the alias you want to check
+     */
+    has(alias) {
+        return this.config.has(alias);
+    }
     async init() {
         this.config = await aliasesConfig_1.AliasesConfig.create(aliasesConfig_1.AliasesConfig.getDefaultOptions());
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/core",
-  "version": "3.23.4",
+  "version": "3.23.5",
   "description": "Core libraries to interact with SFDX projects, orgs, and APIs.",
   "main": "lib/exported",
   "types": "lib/exported.d.ts",