@salesforce/core 8.31.4 → 8.32.0

package/lib/fs/fs.js

@@ -34,9 +34,9 @@ const nodeFs = __importStar(require("node:fs"));
 // yes, we're going to import it even though it might not be used.
 // the alternatives were all worse without top-level await (iife, runtime errors from something trying to use it before it's initialized)
 const memfs = __importStar(require("memfs"));
-const isWeb = () => process.env.FORCE_MEMFS === 'true' || 'window' in globalThis || 'self' in globalThis;
+const isWeb_1 = require("../util/isWeb");
 const getVirtualFs = (memfsVolume) => {
-    if (isWeb()) {
+    if (process.env.FORCE_MEMFS === 'true' || (0, isWeb_1.isWeb)()) {
         const memfsInstance = memfs.createFsFromVolume(memfsVolume ?? new memfs.Volume());
         // Start with memfs instance and only override problematic methods
         const webFs = {

package/lib/global.js

@@ -34,6 +34,7 @@ const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const kit_1 = require("@salesforce/kit");
 const fs_1 = require("./fs/fs");
+const isWeb_1 = require("./util/isWeb");
 const sfError_1 = require("./sfError");
 /**
  * Represents an environment mode.  Supports `production`, `development`, `demo`, and `test`
@@ -74,7 +75,7 @@ class Global {
      * Whether the code is running in a web browser.
      */
     static get isWeb() {
-        return 'window' in globalThis || 'self' in globalThis;
+        return (0, isWeb_1.isWeb)();
     }
     /**
      * The full system path to the global sfdx state folder.

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/util/isWeb.d.ts

@@ -0,0 +1 @@
+export declare const isWeb: () => boolean;

package/lib/util/isWeb.js

@@ -0,0 +1,16 @@
+"use strict";
+/*
+ * Copyright (c) 2023, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWeb = void 0;
+const isWeb = () => {
+    if (process.versions.bun)
+        return false;
+    return 'window' in globalThis || 'self' in globalThis;
+};
+exports.isWeb = isWeb;
+//# sourceMappingURL=isWeb.js.map

package/package.json

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