@resconet/jsbridge 18.1.0 → 18.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resconet/jsbridge",
-  "version": "18.1.0",
+  "version": "18.1.9",
   "main": "./src/JSBridge.js",
   "types": "./src/JSBridge.d.ts",
   "description": "Install npm JSBridge module",

package/src/JSBridge.d.ts

@@ -2210,18 +2210,22 @@ declare module MobileCRM.UI {
 		public static openSalesEntityDetail(detail: MobileCRM.DynamicEntity, errorCallback: (err?: string) => void);
 		/**
 		 * @since 18.0
-		 * The clearance must be dutifully released using leaveUiTransaction() when manipulation is finished.
-		 * The clearance will not be obtained if background sync is running and form sync behavior is configured to 'Block save during sync'
-		 * or 'Block save during sync and prevent sync while form is open'".
-		 * If form sync behavior is configured as 'No action', the clearance is always obtained.
+		 * Provides means to control concurrent access to data by form logic and background sync.
+		 * This method obtains a clearance to perform data manipulation. The clearance will be obtained when background sync is not running, or form sync behavior is configured as 'No action'.
+		 * If background sync is running and form sync behavior is configured to 'Block save during sync' or 'Block save during sync and prevent sync while form is open'", the clearance is not obtained.
+		 * Each obtained clearance must be dutifully released using leaveUiTransaction().
+		 * It is possible to call this method multiple times, but each call reserves its own internal clearance, so there must be the same number of calls to leaveUiTransaction to properly release clearance and allow background sync.
 		 * @returns true if form can give the clearance, false if it is not possible at this time.
 		 */
 		public static tryEnterUiTransaction(): Promise<boolean>;
 		/**
 		 * @since 18.0
-		 * Notifies UI form that clearance obtained using successful call to tryEnterUiTransaction() is no longer needed, because data manipulation is complete.
+		 * Provides means to control concurrent access to data by form logic and background sync.
+		 * This method releases the last clearance obtained by successful call to tryEnterUiTransaction.
+		 * Can be called even if all clearances are already released or were not obtained at all.
+		 * See tryEnterUiTransaction for more info.
 		 */
-		public static leaveUiTransaction(): Promise;
+		public static leaveUiTransaction(): Promise<void>;
 		/**
 		 * @since 9.3
 		 * Binds or unbinds the handler for onSelectedViewChanged event on EntityForm.

package/src/JSBridge.js

@@ -5905,18 +5905,14 @@
 			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called asynchronously in case of error.</param>
 			MobileCRM.bridge.invokeMethodAsync("EntityForm", "ShowEntityDetailDialog", [detail.id], null, errorCallback, null);
 		};
-		/// <summary>[v18.0] Obtains a clearance to perform manipulation with data.
-		/// The clearance must be dutifully released using leaveUiTransaction() when manipulation is finished.
-		/// The clearance will not be obtained if background sync is running and form sync behavior is configured to 'Block save during sync'
-		/// or 'Block save during sync and prevent sync while form is open'".
-		/// If form sync behavior is configured as 'No action', the clearance is always obtained.
-		/// </summary>
-		/// <returns>Returns true if form can give the clearance, false if it is not possible at this time.</returns>
 		MobileCRM.UI.EntityForm.tryEnterUiTransaction = function () {
+			/// <summary>[v18.0] Provides means to control concurrent access to data by form logic and background sync. This method obtains a clearance to perform data manipulation. The clearance will be obtained when background sync is not running, or form sync behavior is configured as 'No action'. If background sync is running and form sync behavior is configured to 'Block save during sync' or 'Block save during sync and prevent sync while form is open'", the clearance is not obtained. Each obtained clearance must be dutifully released using leaveUiTransaction(). It is possible to call this method multiple times, but each call reserves its own internal clearance, so there must be the same number of calls to leaveUiTransaction to properly release clearance and allow background sync.</summary>
+			/// <returns type="Promise&lt;boolean&gt;">Returns true if clearance is obtained, false if it is not possible at this time.</returns>
 			return MobileCRM.bridge.invokeCommandPromise("tryEnterUiTransaction");
 		};
-		/// <summary>[v18.0] Notifies UI form that clearance obtained using successful call to tryEnterUiTransaction() is no longer needed, because data manipulation is complete.</summary>
 		MobileCRM.UI.EntityForm.leaveUiTransaction = function () {
+			/// <summary>[v18.0] Provides means to control concurrent access to data by form logic and background sync. This method releases the last clearance obtained by successful call to tryEnterUiTransaction. Can be called even if all clearances are already released or were not obtained at all. See tryEnterUiTransaction for more info.</summary>
+			/// <returns type="Promise&lt;void&gt;">Returns an awaitable promise.</returns>
 			return MobileCRM.bridge.invokeCommandPromise("leaveUiTransaction");
 		};
 		// MobileCRM.UI.EntityForm.DetailCollection