@resconet/jsbridge 17.1.0-beta.2 → 17.1.0-beta.3

package/package.json

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

package/src/JSBridge.d.ts

@@ -1,6 +1,12 @@
 // JSBridge.js TypeScript definition file
 // (c) 2023 Resco
 
+/* eslint-disable @typescript-eslint/ban-types */
+/* eslint-disable @typescript-eslint/prefer-namespace-keyword */
+/* eslint-disable @typescript-eslint/naming-convention */
+/* eslint-disable no-var */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
 declare namespace MobileCRM {
 	class Size {
 		width: string;
@@ -1588,6 +1594,40 @@ declare module MobileCRM.Services {
 		responseText: string;
 		responseType: string;
 	}
+
+	class GeoFencingService {
+		/** Indicates whether the service is active. */
+		isEnabled: boolean;
+		/** Indicates whether the events should be delivered realtime using Resco forwarding service.*/
+		realtimeFlushing: boolean;
+		/** Defines logging verbosity (0=Normal, 1=Diagnostic, -1=None) */
+		logLevel: number;
+		/** Defines event mask for showing notifications (0=None, 1=WhenArrived, 2=WhenExited, 3=Always) */
+		notificationMask: number;
+		/** Business hours interval (default value is '9:00-17:00') */
+		businessHours: string;
+		/** Business days mask (the lowest bit is Sunday, the next Monday, ...) */
+		businessDaysMask: number;
+
+		updateGeoFences(records: GeoFenceRecord[]);
+	}
+
+	interface GeoFenceRecord {
+		/** Defines numeric mask for geo fence events (Enter = 1, Exit = 2, Both = 3).*/
+		eventTypeMask: number;
+		/** Unique id of geo-fence record. If it is associated with some entity record, it must have form logicalname:id (e.g. appointment:4595AA3E-9873-4DC4-B723-C94DE27B82BE).*/
+		id: string;
+		/** Human-readable name of record used for notifications.*/
+		name: string;
+		/** Latitude of geo-fence center.*/
+		latitude: number;
+		/** Longitude of geo-fence center.*/
+		longitude: number;
+		/** Geo-fence radius in meters.*/
+		radius: number;
+		/** Geo-fence expiration in seconds.*/
+		expiration: number;
+	}
 }
 declare module MobileCRM.Services.AddressBookService {
 	class AddressBookRecord {
@@ -2776,9 +2816,9 @@ declare module MobileCRM.UI {
 
 		addView(entityName: string, viewName: string, isDefault?: boolean);
 		addEntityFilter(entityName: string, filterXML: string);
+		addEntityFilter(entityName: string, filterXml);
 		show(success: (obj?: MobileCRM.Reference) => void, failed?: (err: string) => void, scope?: any);
 		showAsync(): Promise<Reference>;
-		addEntityFilter(entityName: string, filterXml);
 	}
 
 	class MultiLookupForm {

package/src/JSBridge.js

@@ -156,7 +156,7 @@
 			}
 		};
 	};
-	var _global = window || global;
+	var _global = typeof window == "undefined" ? global : window;
 	var MobileCrmException = _global.MobileCrmException;
 	if (typeof MobileCrmException === "undefined") {
 		_global.MobileCrmException = MobileCrmException = function (msg) {
@@ -1048,6 +1048,38 @@
 					this.url = "";
 					this.serviceType = "Azure"; // [v12.3] supports only azure service, used as default.
 				},
+				GeoFencingService: function () {
+					/// <summary>[v17.1] Represents geo-fencing service.</summary>
+					/// <field name="isEnabled" type="Boolean">Indicates whether the service is active.</field>
+					/// <field name="realtimeFlushing" type="Boolean">Indicates whether the events should be delivered realtime using Resco forwarding service.</field>
+					/// <field name="logLevel" type="number">Defines logging verbosity (0=Normal, 1=Diagnostic, -1=None)</field>
+					/// <field name="notificationMask" type="number">Defines event mask for showing notifications (0=None, 1=WhenArrived, 2=WhenExited, 3=Always)</field>
+					/// <field name="businessHours" type="String">Business hours interval (e.g. '9:00-17:00')</field>
+					/// <field name="businessDaysMask" type="number">Business days mask (the lowest bit is Sunday, the next Monday, ...)</field>
+					this.isEnabled = false;
+					this.realtimeFlushing = true;
+					this.logLevel = 0;
+					this.notificationMask = 1;
+					this.businessHours = null;
+					this.businessDaysMask = -1;
+				},
+				GeoFenceRecord: function (eventTypeMask, id, name, latitude, longitude, radius, expiration) {
+					/// <summary>[v17.1] Represents geo-fence definition record.</summary>
+					/// <field name="eventTypeMask" type="number">Defines numeric mask for geo fence events (Enter = 1, Exit = 2, Both = 3).</field>
+					/// <field name="id" type="String">Unique id of geo-fence record. If it is associated with some entity record, it must have form logicalname:id (e.g. appointment:4595AA3E-9873-4DC4-B723-C94DE27B82BE).</field>
+					/// <field name="name" type="String">Human-readable name of record used for notifications.</field>
+					/// <field name="latitude" type="number">Latitude of geo-fence center.</field>
+					/// <field name="longitude" type="number">Longitude of geo-fence center.</field>
+					/// <field name="radius" type="number">Geo-fence radius in meters.</field>
+					/// <field name="expiration" type="number">Geo-fence expiration in seconds.</field>
+					this.eventTypeMask = eventTypeMask;
+					this.id = id;
+					this.name = name;
+					this.latitude = latitude;
+					this.longitude = longitude;
+					this.radius = radius;
+					this.expiration = expiration;
+				},
 			},
 		};
 
@@ -1420,7 +1452,7 @@
 					callback.call(scope);
 				}
 			});
-			window.setTimeout(function () {
+			_global.setTimeout(function () {
 				var nextWorker = _alertQueue.splice(0, 1);
 				nextWorker[0]();
 			});
@@ -2277,7 +2309,7 @@
 			}
 			var cmdParams = JSON.stringify(request);
 			var self = this;
-			window.MobileCRM.bridge.command(
+			_global.MobileCRM.bridge.command(
 				"entitysave",
 				cmdParams,
 				function (res) {
@@ -2493,7 +2525,7 @@
 			/// <param name="success" type="function(result)">A callback function for successful asynchronous result. The <b>result</b> argument will carry the objects array of type specified by <b>resultformat</b> XML attribute (Array, JSON, XML or DynamicEntities).</param>
 			/// <param name="failed" type="function(error)">A callback function for command failure. The <b>error</b> argument will carry the error message.</param>
 			/// <param name="scope" type="">A scope for calling the callbacks; set &quot;null&quot; to call the callbacks in global scope.</param>
-			window.MobileCRM.bridge.command("fetchXML", fetchXmlData, success, failed, scope);
+			_global.MobileCRM.bridge.command("fetchXML", fetchXmlData, success, failed, scope);
 		};
 		MobileCRM.FetchXml.Fetch.prototype.execute = function (output, success, failed, scope) {
 			/// <summary>Performs the asynchronous CRM Fetch request.</summary>
@@ -6094,6 +6126,30 @@
 				scope
 			);
 		};
+
+		MobileCRM.Services.GeoFencingService.prototype.updateGeoFences = function (geoFences, errorCallback) {
+			/// <summary>[v17.1] Updates geo-fences being monitored.</summary>
+			/// <param name="geoFences" type="Array">An array of GeoFenceRecord objects.</field>
+			var cfg = {
+				isEnabled: !!this.isEnabled,
+				realtimeFlushing: !!this.realtimeFlushing,
+			};
+			if (this.logLevel >= -1 && this.logLevel <= 1) {
+				cfg.logLevel = this.logLevel;
+			}
+			if (this.notificationMask >= 0 && this.notificationMask <= 4) {
+				cfg.notificationMask = this.notificationMask;
+			}
+			if (this.businessHours) {
+				cfg.businessHours = this.businessHours;
+			}
+			if (this.businessDaysMask) {
+				cfg.businessDaysMask = this.businessDaysMask;
+			}
+			cfg.geoFences = geoFences;
+			MobileCRM.bridge.command("geofencing", JSON.stringify(cfg), null, errorCallback);
+		};
+
 		MobileCRM.Services.DynamicsReport.prototype.download = function (fileName, format, success, failed, scope) {
 			/// <summary>Downloads the MS Dynamics report into a file.</summary>
 			/// <param name="fileName" type="String">A file name for resulting file. Leave &quot;null&quot; to let app to safely generate the file name and extension.</param>
@@ -6192,7 +6248,7 @@
 			/// <param name="success" type="function(string)">A callback function for successful asynchronous result. The <b>result</b> argument will carry the serialized response from the server.</param>
 			/// <param name="failed" type="function(error)">A callback function for command failure. The <b>error</b> argument will carry the error message.</param>
 			/// <param name="scope" type="">A scope for calling the callbacks; set &quot;null&quot; to call the callbacks in global scope.</param>
-			window.MobileCRM.bridge.command(
+			_global.MobileCRM.bridge.command(
 				"executeWorkflowAction",
 				JSON.stringify({ actionName: actionName, actionParameters: JSON.stringify(parameters) }),
 				success,