@salesforce/core 8.3.0 → 8.4.0

package/lib/sfProject.d.ts

@@ -45,6 +45,8 @@ export declare class SfProjectJson extends ConfigFile<ConfigFile.Options, Projec
     static getFileName(): string;
     static getDefaultOptions(isGlobal?: boolean): ConfigFile.Options;
     read(): Promise<ProjectJson>;
+    /** force a reread of the project contents if you know they may have been modified */
+    refreshSync(): SfProjectJson;
     readSync(): ProjectJson;
     write(): Promise<ProjectJson>;
     writeSync(): ProjectJson;
@@ -154,6 +156,12 @@ export declare class SfProject {
      * @ignore
      */
     protected constructor(path: string);
+    /**
+     * Clear the cache to force reading from disk.
+     *
+     * *NOTE: Only call this method if you must and you know what you are doing.*
+     */
+    static clearInstances(): void;
     /**
      * Get a Project from a given path or from the working directory.
      *

package/lib/sfProject.js

@@ -84,6 +84,11 @@ class SfProjectJson extends configFile_1.ConfigFile {
         this.validateKeys();
         return contents;
     }
+    /** force a reread of the project contents if you know they may have been modified */
+    refreshSync() {
+        super.readSync(false, true);
+        return this;
+    }
     readSync() {
         const contents = super.readSync();
         this.validateKeys();
@@ -339,6 +344,14 @@ class SfProject {
     constructor(path) {
         this.path = path;
     }
+    /**
+     * Clear the cache to force reading from disk.
+     *
+     * *NOTE: Only call this method if you must and you know what you are doing.*
+     */
+    static clearInstances() {
+        SfProject.instances.clear();
+    }
     /**
      * Get a Project from a given path or from the working directory.
      *

package/lib/testSetup.js

@@ -534,8 +534,7 @@ const restoreContext = (testContext) => {
     testContext.configStubs = {};
     // Give each test run a clean StateAggregator
     stateAggregator_1.StateAggregator.clearInstance();
-    // @ts-expect-error accessing a private property
-    sfProject_1.SfProject.instances.clear();
+    sfProject_1.SfProject.clearInstances();
     // Allow each test to have their own config aggregator
     // @ts-ignore clear for testing.
     delete configAggregator_1.ConfigAggregator.instance;

package/package.json

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