@salesforce/core 8.15.1-dev.0 → 8.17.0

package/lib/config/configAggregator.d.ts

@@ -54,8 +54,9 @@ export type ConfigInfo = {
  * ```
  */
 export declare class ConfigAggregator extends AsyncOptionalCreatable<ConfigAggregator.Options> {
-    protected static instance: AsyncOptionalCreatable;
     protected static encrypted: boolean;
+    protected static instance: AsyncOptionalCreatable | undefined;
+    private static readonly mutex;
     private allowedProperties;
     private readonly localConfig?;
     private readonly globalConfig;
@@ -68,6 +69,12 @@ export declare class ConfigAggregator extends AsyncOptionalCreatable<ConfigAggre
     constructor(options?: ConfigAggregator.Options);
     private get config();
     static create<P extends ConfigAggregator.Options, T extends AsyncOptionalCreatable<P>>(this: new (options?: P) => T, options?: P): Promise<T>;
+    /**
+     * Clear the cache to force reading from disk.
+     *
+     * *NOTE: Only call this method if you must and you know what you are doing.*
+     */
+    static clearInstance(): Promise<void>;
     /**
      * Get the info for a given key. If the ConfigAggregator was not asynchronously created OR
      * the {@link ConfigAggregator.reload} was not called, the config value may be encrypted.

package/lib/config/configAggregator.js

@@ -11,6 +11,7 @@ const kit_1 = require("@salesforce/kit");
 const ts_types_1 = require("@salesforce/ts-types");
 const messages_1 = require("../messages");
 const lifecycleEvents_1 = require("../lifecycleEvents");
+const mutex_1 = require("../util/mutex");
 const envVars_1 = require("./envVars");
 const config_1 = require("./config");
 ;
@@ -31,8 +32,9 @@ const messages = new messages_1.Messages('@salesforce/core', 'config', new Map([
  * ```
  */
 class ConfigAggregator extends kit_1.AsyncOptionalCreatable {
-    static instance;
     static encrypted = true;
+    static instance;
+    static mutex = new mutex_1.Mutex();
     // Initialized in loadProperties
     allowedProperties;
     localConfig;
@@ -64,18 +66,32 @@ class ConfigAggregator extends kit_1.AsyncOptionalCreatable {
     // Use typing from AsyncOptionalCreatable to support extending ConfigAggregator.
     // We really don't want ConfigAggregator extended but typescript doesn't support a final.
     static async create(options) {
-        let config = ConfigAggregator.instance;
-        if (!config) {
-            config = ConfigAggregator.instance = new this(options);
-            await config.init();
-        }
-        if (ConfigAggregator.encrypted) {
-            await config.loadProperties();
-        }
-        if (options?.customConfigMeta) {
-            config_1.Config.addAllowedProperties(options.customConfigMeta);
-        }
-        return ConfigAggregator.instance;
+        return ConfigAggregator.mutex.lock(async () => {
+            let config = ConfigAggregator.instance;
+            if (!config) {
+                config = ConfigAggregator.instance = new this(options);
+                await config.init();
+            }
+            if (ConfigAggregator.encrypted) {
+                await config.loadProperties();
+            }
+            if (options?.customConfigMeta) {
+                config_1.Config.addAllowedProperties(options.customConfigMeta);
+            }
+            // console.log(ConfigAggregator.instance);
+            return ConfigAggregator.instance;
+        });
+    }
+    /**
+     * Clear the cache to force reading from disk.
+     *
+     * *NOTE: Only call this method if you must and you know what you are doing.*
+     */
+    static async clearInstance() {
+        return ConfigAggregator.mutex.lock(() => {
+            ConfigAggregator.instance = undefined;
+            ConfigAggregator.encrypted = true; // Reset encryption flag as well
+        });
     }
     /**
      * Get the info for a given key. If the ConfigAggregator was not asynchronously created OR

package/lib/index.d.ts

@@ -38,3 +38,4 @@ export { ScratchOrgLifecycleEvent, scratchOrgLifecycleEventName, scratchOrgLifec
 export { ScratchOrgCache } from './org/scratchOrgCache';
 export { default as ScratchOrgSettingsGenerator } from './org/scratchOrgSettingsGenerator';
 export * from './util/sfdc';
+export * from './util/mutex';

package/lib/index.js

@@ -118,4 +118,5 @@ var scratchOrgSettingsGenerator_1 = require("./org/scratchOrgSettingsGenerator")
 Object.defineProperty(exports, "ScratchOrgSettingsGenerator", { enumerable: true, get: function () { return __importDefault(scratchOrgSettingsGenerator_1).default; } });
 // Utility sub-modules
 __exportStar(require("./util/sfdc"), exports);
+__exportStar(require("./util/mutex"), exports);
 //# sourceMappingURL=index.js.map

package/lib/org/authInfo.d.ts

@@ -259,8 +259,6 @@ export declare class AuthInfo extends AsyncOptionalCreatable<AuthInfo.Options> {
     getFields(decrypt?: boolean): Readonly<AuthFields>;
     /**
      * Get the org front door (used for web based oauth flows)
-     *
-     * @deprecated Will be removed in the next major version. Use the `Org.getFrontDoorUrl()` method instead.
      */
     getOrgFrontDoorUrl(): string;
     /**

package/lib/org/authInfo.js

@@ -545,8 +545,6 @@ class AuthInfo extends kit_1.AsyncOptionalCreatable {
     }
     /**
      * Get the org front door (used for web based oauth flows)
-     *
-     * @deprecated Will be removed in the next major version. Use the `Org.getFrontDoorUrl()` method instead.
      */
     getOrgFrontDoorUrl() {
         const authFields = this.getFields(true);

package/lib/org/org.d.ts

@@ -152,39 +152,6 @@ export declare class Org extends AsyncOptionalCreatable<Org.Options> {
      * @ignore
      */
     constructor(options?: Org.Options);
-    /**
-     * Generate a URL to a metadata UI builder/setup section in an org.
-     *
-     * Bot: open in Agentforce Builder
-     * ApexPage: opens page
-     * Flow: open in Flow Builder
-     * FlexiPage: open in Lightning App Builder
-     * CustomObject: open in Object Manager
-     * ApexClass: open in Setup -> Apex Classes UI
-     *
-     * if you pass any other metadata type you'll get a path to Lightning App Builder
-     *
-     * @example
-     *   // use SDR resolver:
-     *   import { MetadataResolver } from '@salesforce/source-deploy-retrieve';
-     *
-     *   const metadataResolver = new MetadataResolver();
-     *   const components = metadataResolver.getComponentsFromPath(filePath);
-     *   const typeName = components[0]?.type?.name;
-     *
-     *   const metadataBuilderUrl = await org.getMetadataUIURL(typeName, filePath);
-     *
-     * @typeName Bot | ApexPage | Flow | FlexiPage | CustomObject | ApexClass
-     * @file Absolute file path to the metadata file
-     */
-    getMetadataUIURL(typeName: string, file: string): Promise<string>;
-    /**
-     * Get a Frontdoor URL
-     *
-     * This uses the UI Bridge API to generate a single-use Frontdoor URL:
-     * https://help.salesforce.com/s/articleView?id=xcloud.frontdoor_singleaccess.htm&type=5
-     */
-    getFrontDoorUrl(redirectUri?: string): Promise<string>;
     /**
      * create a sandbox from a production org
      * 'this' needs to be a production org with sandbox licenses available

package/lib/org/org.js

@@ -29,13 +29,10 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Org = exports.SandboxEvents = exports.OrgTypes = void 0;
 exports.sandboxIsResumable = sandboxIsResumable;
-const node_path_1 = __importDefault(require("node:path"));
+const node_path_1 = require("node:path");
 const fs = __importStar(require("node:fs"));
 const kit_1 = require("@salesforce/kit");
 const ts_types_1 = require("@salesforce/ts-types");
@@ -56,7 +53,7 @@ const authInfo_1 = require("./authInfo");
 const scratchOrgCreate_1 = require("./scratchOrgCreate");
 const orgConfigProperties_1 = require("./orgConfigProperties");
 ;
-const messages = new messages_1.Messages('@salesforce/core', 'org', new Map([["notADevHub", "The provided dev hub username %s is not a valid dev hub."], ["noUsernameFound", "No username found."], ["noDevHubFound", "Unable to associate this scratch org with a DevHub."], ["deleteOrgHubError", "The Dev Hub org cannot be deleted."], ["insufficientAccessToDelete", "You do not have the appropriate permissions to delete a scratch org. Please contact your Salesforce admin."], ["scratchOrgNotFound", "Attempting to delete an expired or deleted org"], ["sandboxDeleteFailed", "The sandbox org deletion failed with a result of %s."], ["sandboxNotFound", "We can't find a SandboxProcess for the sandbox %s."], ["sandboxInfoCreateFailed", "The sandbox org creation failed with a result of %s."], ["sandboxInfoRefreshFailed", "The sandbox org refresh failed with a result of %s."], ["missingAuthUsername", "The sandbox %s does not have an authorized username."], ["orgPollingTimeout", "Sandbox status is %s; timed out waiting for completion."], ["NotFoundOnDevHub", "The scratch org does not belong to the dev hub username %s."], ["AuthInfoOrgIdUndefined", "AuthInfo orgId is undefined."], ["sandboxCreateNotComplete", "The sandbox creation has not completed."], ["SandboxProcessNotFoundBySandboxName", "We can't find a SandboxProcess with the SandboxName %s."], ["MultiSandboxProcessNotFoundBySandboxName", "We found more than one SandboxProcess with the SandboxName %s."], ["sandboxNotResumable", "The sandbox %s cannot resume with status of %s."], ["FrontdoorURLError", "Failed to generate a frontdoor URL."], ["FlowIdNotFound", "ID not found for Flow %s."], ["CustomObjectIdNotFound", "ID not found for custom object %s."], ["ApexClassIdNotFound", "ID not found for Apex class %s."]]));
+const messages = new messages_1.Messages('@salesforce/core', 'org', new Map([["notADevHub", "The provided dev hub username %s is not a valid dev hub."], ["noUsernameFound", "No username found."], ["noDevHubFound", "Unable to associate this scratch org with a DevHub."], ["deleteOrgHubError", "The Dev Hub org cannot be deleted."], ["insufficientAccessToDelete", "You do not have the appropriate permissions to delete a scratch org. Please contact your Salesforce admin."], ["scratchOrgNotFound", "Attempting to delete an expired or deleted org"], ["sandboxDeleteFailed", "The sandbox org deletion failed with a result of %s."], ["sandboxNotFound", "We can't find a SandboxProcess for the sandbox %s."], ["sandboxInfoCreateFailed", "The sandbox org creation failed with a result of %s."], ["sandboxInfoRefreshFailed", "The sandbox org refresh failed with a result of %s."], ["missingAuthUsername", "The sandbox %s does not have an authorized username."], ["orgPollingTimeout", "Sandbox status is %s; timed out waiting for completion."], ["NotFoundOnDevHub", "The scratch org does not belong to the dev hub username %s."], ["AuthInfoOrgIdUndefined", "AuthInfo orgId is undefined."], ["sandboxCreateNotComplete", "The sandbox creation has not completed."], ["SandboxProcessNotFoundBySandboxName", "We can't find a SandboxProcess with the SandboxName %s."], ["MultiSandboxProcessNotFoundBySandboxName", "We found more than one SandboxProcess with the SandboxName %s."], ["sandboxNotResumable", "The sandbox %s cannot resume with status of %s."]]));
 var OrgTypes;
 (function (OrgTypes) {
     OrgTypes["Scratch"] = "scratch";
@@ -149,111 +146,6 @@ class Org extends kit_1.AsyncOptionalCreatable {
         super(options);
         this.options = options ?? {};
     }
-    /**
-     * Generate a URL to a metadata UI builder/setup section in an org.
-     *
-     * Bot: open in Agentforce Builder
-     * ApexPage: opens page
-     * Flow: open in Flow Builder
-     * FlexiPage: open in Lightning App Builder
-     * CustomObject: open in Object Manager
-     * ApexClass: open in Setup -> Apex Classes UI
-     *
-     * if you pass any other metadata type you'll get a path to Lightning App Builder
-     *
-     * @example
-     *   // use SDR resolver:
-     *   import { MetadataResolver } from '@salesforce/source-deploy-retrieve';
-     *
-     *   const metadataResolver = new MetadataResolver();
-     *   const components = metadataResolver.getComponentsFromPath(filePath);
-     *   const typeName = components[0]?.type?.name;
-     *
-     *   const metadataBuilderUrl = await org.getMetadataUIURL(typeName, filePath);
-     *
-     * @typeName Bot | ApexPage | Flow | FlexiPage | CustomObject | ApexClass
-     * @file Absolute file path to the metadata file
-     */
-    async getMetadataUIURL(typeName, file) {
-        const botFileNameToId = async (conn, filePath) => (await conn.singleRecordQuery(`SELECT id FROM BotDefinition WHERE DeveloperName='${node_path_1.default.basename(filePath, '.bot-meta.xml')}'`)).Id;
-        /** query flexipage via toolingAPI to get its ID (starts with 0M0) */
-        const flexiPageFilenameToId = async (conn, filePath) => (await conn.singleRecordQuery(`SELECT id FROM flexipage WHERE DeveloperName='${node_path_1.default.basename(filePath, '.flexipage-meta.xml')}'`, { tooling: true })).Id;
-        /** query the rest API to turn a flow's filepath into a FlowId  (starts with 301) */
-        const flowFileNameToId = async (conn, filePath) => {
-            try {
-                const flow = await conn.singleRecordQuery(`SELECT DurableId FROM FlowVersionView WHERE FlowDefinitionView.ApiName = '${node_path_1.default.basename(filePath, '.flow-meta.xml')}' ORDER BY VersionNumber DESC LIMIT 1`);
-                return flow.DurableId;
-            }
-            catch (error) {
-                throw messages.createError('FlowIdNotFound', [filePath]);
-            }
-        };
-        const customObjectFileNameToId = async (conn, filePath) => {
-            try {
-                const customObject = await conn.singleRecordQuery(`SELECT Id FROM CustomObject WHERE DeveloperName = '${node_path_1.default.basename(filePath.replace(/__c/g, ''), '.object-meta.xml')}'`, {
-                    tooling: true,
-                });
-                return customObject.Id;
-            }
-            catch (error) {
-                throw messages.createError('CustomObjectIdNotFound', [filePath]);
-            }
-        };
-        const apexClassFileNameToId = async (conn, filePath) => {
-            try {
-                const apexClass = await conn.singleRecordQuery(`SELECT Id FROM ApexClass WHERE Name = '${node_path_1.default.basename(filePath, '.cls')}'`, {
-                    tooling: true,
-                });
-                return apexClass.Id;
-            }
-            catch (error) {
-                throw messages.createError('ApexClassIdNotFound', [filePath]);
-            }
-        };
-        let redirectUri = '';
-        switch (typeName) {
-            case 'ApexClass':
-                redirectUri = `lightning/setup/ApexClasses/page?address=%2F${await apexClassFileNameToId(this.connection, file)}`;
-                break;
-            case 'CustomObject':
-                redirectUri = `lightning/setup/ObjectManager/${await customObjectFileNameToId(this.connection, file)}/Details/view`;
-                break;
-            case 'Bot':
-                redirectUri = `/AiCopilot/copilotStudio.app#/copilot/builder?copilotId=${await botFileNameToId(this.connection, file)}`;
-                break;
-            case 'ApexPage':
-                redirectUri = `/apex/${node_path_1.default.basename(file).replace('.page-meta.xml', '').replace('.page', '')}`;
-                break;
-            case 'Flow':
-                redirectUri = `/builder_platform_interaction/flowBuilder.app?flowId=${await flowFileNameToId(this.connection, file)}`;
-                break;
-            case 'FlexiPage':
-                redirectUri = `/visualEditor/appBuilder.app?pageId=${await flexiPageFilenameToId(this.connection, file)}`;
-                break;
-            default:
-                redirectUri = '/lightning/setup/FlexiPageList/home';
-                break;
-        }
-        return this.getFrontDoorUrl(redirectUri);
-    }
-    /**
-     * Get a Frontdoor URL
-     *
-     * This uses the UI Bridge API to generate a single-use Frontdoor URL:
-     * https://help.salesforce.com/s/articleView?id=xcloud.frontdoor_singleaccess.htm&type=5
-     */
-    async getFrontDoorUrl(redirectUri) {
-        // the `singleaccess` endpoint returns 403 when using an expired token and jsforce only triggers a token refresh on 401 so we check if it's valid first
-        await this.refreshAuth();
-        const singleAccessUrl = new URL('/services/oauth2/singleaccess', this.connection.instanceUrl);
-        if (redirectUri) {
-            singleAccessUrl.searchParams.append('redirect_uri', redirectUri);
-        }
-        const response = await this.connection.requestGet(singleAccessUrl.toString());
-        if (response.frontdoor_uri)
-            return response.frontdoor_uri;
-        throw new sfError_1.SfError(messages.getMessage('FrontdoorURLError')).setData(response);
-    }
     /**
      * create a sandbox from a production org
      * 'this' needs to be a production org with sandbox licenses available
@@ -1033,7 +925,7 @@ class Org extends kit_1.AsyncOptionalCreatable {
     }
     async getLocalDataDir(orgDataPath) {
         const rootFolder = await config_1.Config.resolveRootFolder(false);
-        return node_path_1.default.join(rootFolder, global_1.Global.SFDX_STATE_FOLDER, orgDataPath ? orgDataPath : 'orgs');
+        return (0, node_path_1.join)(rootFolder, global_1.Global.SFDX_STATE_FOLDER, orgDataPath ? orgDataPath : 'orgs');
     }
     /**
      * Gets the sandboxProcessObject and then polls for it to complete.
@@ -1459,7 +1351,7 @@ class Org extends kit_1.AsyncOptionalCreatable {
     async removeSourceTrackingFiles() {
         try {
             const rootFolder = await config_1.Config.resolveRootFolder(false);
-            await fs.promises.rm(node_path_1.default.join(rootFolder, global_1.Global.SF_STATE_FOLDER, 'orgs', this.getOrgId()), {
+            await fs.promises.rm((0, node_path_1.join)(rootFolder, global_1.Global.SF_STATE_FOLDER, 'orgs', this.getOrgId()), {
                 recursive: true,
                 force: true,
             });

package/lib/stateAggregator/stateAggregator.d.ts

@@ -4,6 +4,7 @@ import { OrgAccessor } from './accessors/orgAccessor';
 import { SandboxAccessor } from './accessors/sandboxAccessor';
 export declare class StateAggregator extends AsyncOptionalCreatable {
     private static instanceMap;
+    private static readonly mutex;
     aliases: AliasAccessor;
     orgs: OrgAccessor;
     sandboxes: SandboxAccessor;
@@ -17,7 +18,14 @@ export declare class StateAggregator extends AsyncOptionalCreatable {
      * Clear the cache to force reading from disk.
      *
      * *NOTE: Only call this method if you must and you know what you are doing.*
+     * *NOTE: This call is NOT thread-safe, so it should only be called when no other threads are using the StateAggregator.*
      */
     static clearInstance(path?: string): void;
+    /**
+     * Clear the cache to force reading from disk in a thread-safe manner.
+     *
+     * *NOTE: Only call this method if you must and you know what you are doing.*
+     */
+    static clearInstanceAsync(path?: string): Promise<void>;
     protected init(): Promise<void>;
 }

package/lib/stateAggregator/stateAggregator.js

@@ -9,11 +9,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StateAggregator = void 0;
 const kit_1 = require("@salesforce/kit");
 const global_1 = require("../global");
+const mutex_1 = require("../util/mutex");
 const aliasAccessor_1 = require("./accessors/aliasAccessor");
 const orgAccessor_1 = require("./accessors/orgAccessor");
 const sandboxAccessor_1 = require("./accessors/sandboxAccessor");
 class StateAggregator extends kit_1.AsyncOptionalCreatable {
     static instanceMap = new Map();
+    static mutex = new mutex_1.Mutex();
     aliases;
     orgs;
     sandboxes;
@@ -23,20 +25,33 @@ class StateAggregator extends kit_1.AsyncOptionalCreatable {
      * HomeDir might be stubbed in tests
      */
     static async getInstance() {
-        if (!StateAggregator.instanceMap.has(global_1.Global.DIR)) {
-            StateAggregator.instanceMap.set(global_1.Global.DIR, await StateAggregator.create());
-        }
-        // TS assertion is valid because there either was one OR it was just now instantiated
-        return StateAggregator.instanceMap.get(global_1.Global.DIR);
+        return StateAggregator.mutex.lock(async () => {
+            if (!StateAggregator.instanceMap.has(global_1.Global.DIR)) {
+                StateAggregator.instanceMap.set(global_1.Global.DIR, await StateAggregator.create());
+            }
+            // TS assertion is valid because there either was one OR it was just now instantiated
+            return StateAggregator.instanceMap.get(global_1.Global.DIR);
+        });
     }
     /**
      * Clear the cache to force reading from disk.
      *
      * *NOTE: Only call this method if you must and you know what you are doing.*
+     * *NOTE: This call is NOT thread-safe, so it should only be called when no other threads are using the StateAggregator.*
      */
     static clearInstance(path = global_1.Global.DIR) {
         StateAggregator.instanceMap.delete(path);
     }
+    /**
+     * Clear the cache to force reading from disk in a thread-safe manner.
+     *
+     * *NOTE: Only call this method if you must and you know what you are doing.*
+     */
+    static async clearInstanceAsync(path = global_1.Global.DIR) {
+        return StateAggregator.mutex.lock(() => {
+            StateAggregator.clearInstance(path);
+        });
+    }
     async init() {
         this.orgs = await orgAccessor_1.OrgAccessor.create();
         this.sandboxes = await sandboxAccessor_1.SandboxAccessor.create();

package/lib/util/mutex.d.ts

@@ -0,0 +1,49 @@
+/**
+ * A mutual exclusion (mutex) class that ensures only one asynchronous operation
+ * can execute at a time, providing thread-safe execution of critical sections.
+ *
+ * @example
+ * ```typescript
+ * const mutex = new Mutex();
+ *
+ * // Only one of these will execute at a time
+ * mutex.lock(async () => {
+ *   // Critical section code here
+ *   return someAsyncOperation();
+ * });
+ * ```
+ */
+export declare class Mutex {
+    /**
+     * Internal promise chain that maintains the mutex state.
+     * Each new lock acquisition is chained to this promise.
+     *
+     * @private
+     */
+    private mutex;
+    /**
+     * Acquires the mutex lock and executes the provided function.
+     * The function will not execute until all previously queued operations complete.
+     *
+     * @template T - The return type of the function
+     * @param fn - The function to execute while holding the mutex lock. Can be synchronous or asynchronous.
+     * @returns A promise that resolves with the result of the function execution
+     *
+     * @example
+     * ```typescript
+     * const result = await mutex.lock(async () => {
+     *   // This code is guaranteed to run exclusively
+     *   return await someAsyncOperation();
+     * });
+     * ```
+     */
+    lock<T>(fn: () => Promise<T> | T): Promise<T>;
+    /**
+     * Acquires the mutex by waiting for the current promise chain to resolve
+     * and returns a release function to unlock the mutex.
+     *
+     * @private
+     * @returns A promise that resolves to a function that releases the mutex lock
+     */
+    private acquire;
+}

package/lib/util/mutex.js

@@ -0,0 +1,77 @@
+"use strict";
+/*
+ * Copyright (c) 2025, 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.Mutex = void 0;
+/**
+ * A mutual exclusion (mutex) class that ensures only one asynchronous operation
+ * can execute at a time, providing thread-safe execution of critical sections.
+ *
+ * @example
+ * ```typescript
+ * const mutex = new Mutex();
+ *
+ * // Only one of these will execute at a time
+ * mutex.lock(async () => {
+ *   // Critical section code here
+ *   return someAsyncOperation();
+ * });
+ * ```
+ */
+class Mutex {
+    /**
+     * Internal promise chain that maintains the mutex state.
+     * Each new lock acquisition is chained to this promise.
+     *
+     * @private
+     */
+    mutex = Promise.resolve();
+    /**
+     * Acquires the mutex lock and executes the provided function.
+     * The function will not execute until all previously queued operations complete.
+     *
+     * @template T - The return type of the function
+     * @param fn - The function to execute while holding the mutex lock. Can be synchronous or asynchronous.
+     * @returns A promise that resolves with the result of the function execution
+     *
+     * @example
+     * ```typescript
+     * const result = await mutex.lock(async () => {
+     *   // This code is guaranteed to run exclusively
+     *   return await someAsyncOperation();
+     * });
+     * ```
+     */
+    async lock(fn) {
+        const unlock = await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            unlock();
+        }
+    }
+    /**
+     * Acquires the mutex by waiting for the current promise chain to resolve
+     * and returns a release function to unlock the mutex.
+     *
+     * @private
+     * @returns A promise that resolves to a function that releases the mutex lock
+     */
+    async acquire() {
+        let release;
+        const promise = new Promise((resolve) => {
+            release = resolve;
+        });
+        const currentMutex = this.mutex;
+        this.mutex = this.mutex.then(() => promise);
+        await currentMutex;
+        return release;
+    }
+}
+exports.Mutex = Mutex;
+//# sourceMappingURL=mutex.js.map

package/messages/org.md

@@ -69,19 +69,3 @@ We found more than one SandboxProcess with the SandboxName %s.
 # sandboxNotResumable
 
 The sandbox %s cannot resume with status of %s.
-
-# FrontdoorURLError
-
-Failed to generate a frontdoor URL.
-
-# FlowIdNotFound
-
-ID not found for Flow %s.
-
-# CustomObjectIdNotFound
-
-ID not found for custom object %s.
-
-# ApexClassIdNotFound
-
-ID not found for Apex class %s.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/core",
-  "version": "8.15.1-dev.0",
+  "version": "8.17.0",
   "description": "Core libraries to interact with SFDX projects, orgs, and APIs.",
   "main": "lib/index",
   "types": "lib/index.d.ts",
@@ -53,7 +53,7 @@
     "messageTransformer/messageTransformer.ts"
   ],
   "dependencies": {
-    "@jsforce/jsforce-node": "^3.9.1",
+    "@jsforce/jsforce-node": "^3.8.2",
     "@salesforce/kit": "^3.2.2",
     "@salesforce/schemas": "^1.9.0",
     "@salesforce/ts-types": "^2.0.10",