@salesforce/core 8.31.5 → 8.32.1

package/lib/org/authInfo.js

@@ -443,6 +443,10 @@ class AuthInfo extends kit_1.AsyncOptionalCreatable {
      */
     update(authData) {
         if (authData && (0, ts_types_1.isPlainObject)(authData)) {
+            if (authData.instanceApiVersion && !(0, sfdc_1.validateApiVersion)(authData.instanceApiVersion)) {
+                this.logger.warn(`Ignoring invalid instanceApiVersion "${authData.instanceApiVersion}" (expected format: "XX.0")`);
+                authData.instanceApiVersion = undefined;
+            }
             this.username = authData.username ?? this.username;
             this.stateAggregator.orgs.update(this.username, authData);
             this.logger.info(`Updated auth info for username: ${this.username}`);

package/lib/org/authRemover.d.ts

@@ -23,11 +23,22 @@ import { AuthFields } from './authInfo';
  * );
  * await remover.removeAuth(auth.username);
  * ```
+ *
+ * Pass a `projectPath` to resolve local config from a specific project instead of `process.cwd()`,
+ * and `skipCache` to re-read config from disk when the process-cached aggregator can't be trusted:
+ *
+ * ```
+ * const remover = await AuthRemover.create({ projectPath: '/path/to/project', skipCache: true });
+ * await remover.removeAuth('example@mycompany.com');
+ * ```
  */
-export declare class AuthRemover extends AsyncOptionalCreatable {
+export declare class AuthRemover extends AsyncOptionalCreatable<AuthRemoverOptions> {
     private config;
     private stateAggregator;
     private logger;
+    private readonly projectPath?;
+    private readonly skipCache?;
+    constructor(options?: AuthRemoverOptions);
     /**
      * Removes the authentication and any configs or aliases associated with it
      *
@@ -85,3 +96,12 @@ export declare class AuthRemover extends AsyncOptionalCreatable {
      */
     private unsetAliases;
 }
+export type AuthRemoverOptions = {
+    /** an absolute path to the project root, used to resolve local config; defaults to `process.cwd()` */
+    projectPath?: string;
+    /**
+     * re-read config from disk instead of trusting the process-cached ConfigAggregator. Set `true`
+     * when the config may have changed out of process or before this call. Defaults to `false`.
+     */
+    skipCache?: boolean;
+};

package/lib/org/authRemover.js

@@ -37,11 +37,26 @@ const messages = new messages_1.Messages('@salesforce/core', 'auth', new Map([["
  * );
  * await remover.removeAuth(auth.username);
  * ```
+ *
+ * Pass a `projectPath` to resolve local config from a specific project instead of `process.cwd()`,
+ * and `skipCache` to re-read config from disk when the process-cached aggregator can't be trusted:
+ *
+ * ```
+ * const remover = await AuthRemover.create({ projectPath: '/path/to/project', skipCache: true });
+ * await remover.removeAuth('example@mycompany.com');
+ * ```
  */
 class AuthRemover extends kit_1.AsyncOptionalCreatable {
     config;
     stateAggregator;
     logger;
+    projectPath;
+    skipCache;
+    constructor(options) {
+        super(options);
+        this.projectPath = options?.projectPath;
+        this.skipCache = options?.skipCache;
+    }
     /**
      * Removes the authentication and any configs or aliases associated with it
      *
@@ -91,7 +106,13 @@ class AuthRemover extends kit_1.AsyncOptionalCreatable {
     }
     async init() {
         this.logger = await logger_1.Logger.child(this.constructor.name);
-        this.config = await configAggregator_1.ConfigAggregator.create();
+        this.config = await configAggregator_1.ConfigAggregator.create(this.projectPath ? { projectPath: this.projectPath } : undefined);
+        // ConfigAggregator.create returns a process-cached instance keyed by projectPath, so its
+        // in-memory config may be stale (set out of process, or before this call). When the caller
+        // can't trust the cache, skipCache re-reads from disk so unsetConfigValues sees current values.
+        if (this.skipCache) {
+            await this.config.reload();
+        }
         this.stateAggregator = await stateAggregator_1.StateAggregator.getInstance();
         await this.stateAggregator.orgs.readAll();
     }

package/lib/org/connection.js

@@ -205,8 +205,7 @@ class Connection extends jsforce_node_1.Connection {
             if (error.name === exports.DNS_ERROR_NAME) {
                 throw error; // throws on DNS connection errors
             }
-            // Don't fail if we can't use the latest, just use the default
-            this.logger.warn('Failed to set the latest API version:', error);
+            this.logger.warn(`Failed to set the latest API version (${error.name}: ${error.message}). Using default: v${this.version}`);
         }
     }
     /**
@@ -382,7 +381,10 @@ class Connection extends jsforce_node_1.Connection {
             const has24HoursPastSinceLastCheck = now.getTime() - lastChecked > kit_1.Duration.hours(24).milliseconds;
             this.logger.debug(`API version cache last checked on ${lastCheckedDateString ?? '<undefined>'} (now is ${now.toLocaleString()})`);
             if (!has24HoursPastSinceLastCheck && version) {
-                // return cached API version
+                if (!(0, sfdc_1.validateApiVersion)(version)) {
+                    this.logger.warn(`Cached instanceApiVersion "${version}" is invalid (expected format: "XX.0"). Ignoring cache and re-fetching.`);
+                    return;
+                }
                 this.logger.debug(`Using cached API version: ${version}`);
                 return version;
             }

package/package.json

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