@aws-amplify/geo 1.2.1 → 1.2.2-geo.3

package/lib-esm/util.js

@@ -0,0 +1,156 @@
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+/*
+ * Copyright 2017-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
+ * the License. A copy of the License is located at
+ *
+ *     http://aws.amazon.com/apache2.0/
+ *
+ * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+ * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
+ * and limitations under the License.
+ */
+import { ConsoleLogger as Logger } from '@aws-amplify/core';
+var logger = new Logger('Geo');
+export function validateCoordinates(lng, lat) {
+    if (!Number.isFinite(lng) || !Number.isFinite(lat)) {
+        throw new Error("Invalid coordinates: [" + lng + "," + lat + "]");
+    }
+    if (lat < -90 || lat > 90) {
+        var errorString = 'Latitude must be between -90 and 90 degrees inclusive.';
+        logger.debug(errorString);
+        throw new Error(errorString);
+    }
+    else if (lng < -180 || lng > 180) {
+        var errorString = 'Longitude must be between -180 and 180 degrees inclusive.';
+        logger.debug(errorString);
+        throw new Error(errorString);
+    }
+}
+export function validateGeofenceId(geofenceId) {
+    var geofenceIdRegex = /^[-._\p{L}\p{N}]+$/iu;
+    // Check if geofenceId is valid
+    if (!geofenceIdRegex.test(geofenceId)) {
+        var errorString = "Invalid geofenceId: " + geofenceId + " Ids can only contain alphanumeric characters, hyphens, underscores and periods.";
+        logger.debug(errorString);
+        throw new Error(errorString);
+    }
+}
+export function validateLinearRing(linearRing) {
+    // Validate LinearRing size, must be at least 4 points
+    if (linearRing.length < 4) {
+        var errorString = 'LinearRing must contain 4 or more coordinates.';
+        logger.debug(errorString);
+        throw new Error(errorString);
+    }
+    // Validate all coordinates are valid, error with which ones are bad
+    var badCoordinates = [];
+    linearRing.forEach(function (coordinates) {
+        try {
+            validateCoordinates(coordinates[0], coordinates[1]);
+        }
+        catch (error) {
+            badCoordinates.push({ coordinates: coordinates, error: error.message });
+        }
+    });
+    if (badCoordinates.length > 0) {
+        var errorString = "One or more of the coordinates are not valid: " + JSON.stringify(badCoordinates);
+        logger.debug(errorString);
+        throw new Error(errorString);
+    }
+    // Validate first and last coordinates are the same
+    var _a = __read(linearRing[0], 2), lngA = _a[0], latA = _a[1];
+    var _b = __read(linearRing[linearRing.length - 1], 2), lngB = _b[0], latB = _b[1];
+    if (lngA !== lngB || latA !== latB) {
+        var errorString = "LinearRing's first and last coordinates are not the same";
+        logger.debug(errorString);
+        throw new Error(errorString);
+    }
+}
+export function validatePolygon(polygon) {
+    if (!Array.isArray(polygon)) {
+        var errorString = "Polygon " + JSON.stringify(polygon) + " is of incorrect structure. It should be an array of 'LinearRing'";
+        logger.debug(errorString);
+        throw new Error(errorString);
+    }
+    if (!(polygon.length === 1)) {
+        var errorString = "Polygon " + JSON.stringify(polygon) + " geometry.polygon must have a single LinearRing array";
+        logger.debug(errorString);
+        throw new Error(errorString);
+    }
+    var verticesCount = polygon.reduce(function (prev, linearRing) { return prev + linearRing.length; }, 0);
+    if (verticesCount > 1000) {
+        var errorString = "Polygon has more than the maximum 1000 vertices.";
+        logger.debug(errorString);
+        throw new Error(errorString);
+    }
+}
+export function validateGeofences(geofences) {
+    var geofenceIds = {};
+    geofences.forEach(function (geofence) {
+        // verify all required properties are present
+        if (!geofence.geofenceId) {
+            var errorString = "Geofence " + JSON.stringify(geofence) + " is missing geofenceId";
+            logger.debug(errorString);
+            throw new Error(errorString);
+        }
+        if (!geofence.geometry) {
+            var errorString = "Geofence " + JSON.stringify(geofence) + " is missing geometry";
+            logger.debug(errorString);
+            throw new Error(errorString);
+        }
+        if (!geofence.geometry.polygon) {
+            var errorString = "Geofence " + JSON.stringify(geofence) + " is missing geometry.polygon";
+            logger.debug(errorString);
+            throw new Error(errorString);
+        }
+        var geofenceId = geofence.geofenceId, polygon = geofence.geometry.polygon;
+        // Validate geofenceId is valid
+        try {
+            validateGeofenceId(geofenceId);
+        }
+        catch (error) {
+            throw error;
+        }
+        // Validate geofenceId is unique
+        if (geofenceIds[geofenceId]) {
+            var errorString = "Duplicate geofenceId: " + geofenceId;
+            logger.debug(errorString);
+            throw new Error(errorString);
+        }
+        else {
+            geofenceIds[geofenceId] = true;
+        }
+        // Validate polygon length and structure
+        try {
+            validatePolygon(polygon);
+        }
+        catch (error) {
+            if (error.message === "Polygon has more than the maximum 1000 vertices.") {
+                var errorString = "Geofence " + geofenceId + " has more than the maximum of 1000 vertices";
+                logger.debug(errorString);
+                throw new Error(errorString);
+            }
+        }
+        // Validate LinearRing length, structure, and coordinates
+        var _a = __read(polygon, 1), linearRing = _a[0];
+        validateLinearRing(linearRing);
+    });
+}
+//# sourceMappingURL=util.js.map

package/lib-esm/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@aws-amplify/geo",
-	"version": "1.2.1",
+	"version": "1.2.2-geo.3+8413d3deb",
 	"description": "Geo category for aws-amplify",
 	"main": "./lib/index.js",
 	"module": "./lib-esm/index.js",
@@ -41,7 +41,7 @@
 	},
 	"homepage": "https://aws-amplify.github.io/",
 	"dependencies": {
-		"@aws-amplify/core": "4.4.0",
+		"@aws-amplify/core": "4.4.1-geo.3+8413d3deb",
 		"@aws-sdk/client-location": "3.48.0",
 		"camelcase-keys": "6.2.2"
 	},
@@ -71,7 +71,8 @@
 			"__tests__/model.ts",
 			"__tests__/schema.ts",
 			"__tests__/helpers.ts",
-			"__tests__/data.ts"
+			"__tests__/testData.ts",
+			"__tests__/testUtils.ts"
 		],
 		"moduleFileExtensions": [
 			"ts",
@@ -97,5 +98,5 @@
 			"lib-esm"
 		]
 	},
-	"gitHead": "163d74a08dfb6bb2c183f9af2bc32b56203ef67a"
+	"gitHead": "8413d3deb36406ea9a716e55db8f864bf8b6056c"
 }

package/src/Geo.ts

@@ -18,6 +18,13 @@ import {
 import { AmazonLocationServiceProvider } from './Providers/AmazonLocationServiceProvider';
 
 import {
+	validateCoordinates,
+	validateGeofences,
+	validateGeofenceId,
+} from './util';
+
+import {
+	Place,
 	GeoConfig,
 	Coordinates,
 	SearchByTextOptions,
@@ -25,6 +32,13 @@ import {
 	SearchByCoordinatesOptions,
 	GeoProvider,
 	MapStyle,
+	GeofenceInput,
+	GeofenceOptions,
+	SaveGeofencesResults,
+	Geofence,
+	ListGeofenceOptions,
+	ListGeofenceResults,
+	DeleteGeofencesResults,
 } from './types';
 
 const logger = new Logger('Geo');
@@ -143,7 +157,10 @@ export class GeoClass {
 	 * @param  {SearchByTextOptions} options? - Optional parameters to the search
 	 * @returns {Promise<Place[]>} - Promise resolves to a list of Places that match search parameters
 	 */
-	public async searchByText(text: string, options?: SearchByTextOptions) {
+	public async searchByText(
+		text: string,
+		options?: SearchByTextOptions
+	): Promise<Place[]> {
 		const { providerName = DEFAULT_PROVIDER } = options || {};
 		const prov = this.getPluggable(providerName);
 
@@ -185,17 +202,142 @@ export class GeoClass {
 	public async searchByCoordinates(
 		coordinates: Coordinates,
 		options?: SearchByCoordinatesOptions
-	) {
+	): Promise<Place> {
 		const { providerName = DEFAULT_PROVIDER } = options || {};
 		const prov = this.getPluggable(providerName);
 
+		const [lng, lat] = coordinates;
 		try {
+			validateCoordinates(lng, lat);
 			return await prov.searchByCoordinates(coordinates, options);
 		} catch (error) {
 			logger.debug(error);
 			throw error;
 		}
 	}
+
+	/**
+	 * Create geofences
+	 * @param geofences - Single or array of geofence objects to create
+	 * @param options? - Optional parameters for creating geofences
+	 * @returns {Promise<SaveGeofencesResults>} - Promise that resolves to an object with:
+	 *   successes: list of geofences successfully created
+	 *   errors: list of geofences that failed to create
+	 */
+	public async saveGeofences(
+		geofences: GeofenceInput | GeofenceInput[],
+		options?: GeofenceOptions
+	): Promise<SaveGeofencesResults> {
+		const { providerName = DEFAULT_PROVIDER } = options || {};
+		const prov = this.getPluggable(providerName);
+
+		// If single geofence input, make it an array for batch call
+		let geofenceInputArray;
+		if (!Array.isArray(geofences)) {
+			geofenceInputArray = [geofences];
+		} else {
+			geofenceInputArray = geofences;
+		}
+
+		try {
+			// Validate all geofences are unique and valid before calling Provider
+			validateGeofences(geofenceInputArray);
+			return await prov.saveGeofences(geofenceInputArray, options);
+		} catch (error) {
+			logger.debug(error);
+			throw error;
+		}
+	}
+
+	/**
+	 * Get a single geofence by geofenceId
+	 * @param geofenceId: string
+	 * @param options?: GeofenceOptions
+	 * @returns Promise<Geofence> - Promise that resolves to a geofence object
+	 */
+	public async getGeofence(
+		geofenceId: string,
+		options?: GeofenceOptions
+	): Promise<Geofence> {
+		const { providerName = DEFAULT_PROVIDER } = options || {};
+		const prov = this.getPluggable(providerName);
+
+		try {
+			// Validate geofenceId is valid before calling Provider
+			validateGeofenceId(geofenceId);
+			return await prov.getGeofence(geofenceId, options);
+		} catch (error) {
+			logger.debug(error);
+			throw error;
+		}
+	}
+
+	/**
+	 * List geofences
+	 * @param  options?: ListGeofenceOptions
+	 * @returns {Promise<ListGeofencesResults>} - Promise that resolves to an object with:
+	 *   entries: list of geofences - 100 geofences are listed per page
+	 *   nextToken: token for next page of geofences
+	 */
+	public async listGeofences(
+		options?: ListGeofenceOptions
+	): Promise<ListGeofenceResults> {
+		const { providerName = DEFAULT_PROVIDER } = options || {};
+		const prov = this.getPluggable(providerName);
+
+		try {
+			return await prov.listGeofences(options);
+		} catch (error) {
+			logger.debug(error);
+			throw error;
+		}
+	}
+
+	/**
+	 * Delete geofences
+	 * @param geofenceIds: string|string[]
+	 * @param options?: GeofenceOptions
+	 * @returns {Promise<DeleteGeofencesResults>} - Promise that resolves to an object with:
+	 *  successes: list of geofences successfully deleted
+	 *  errors: list of geofences that failed to delete
+	 */
+	public async deleteGeofences(
+		geofenceIds: string | string[],
+		options?: GeofenceOptions
+	): Promise<DeleteGeofencesResults> {
+		const { providerName = DEFAULT_PROVIDER } = options || {};
+		const prov = this.getPluggable(providerName);
+
+		// If single geofence input, make it an array for batch call
+		let geofenceIdsInputArray;
+		if (!Array.isArray(geofenceIds)) {
+			geofenceIdsInputArray = [geofenceIds];
+		} else {
+			geofenceIdsInputArray = geofenceIds;
+		}
+
+		// Validate all geofenceIds are valid
+		const badGeofenceIds = geofenceIdsInputArray.filter(geofenceId => {
+			try {
+				validateGeofenceId(geofenceId);
+			} catch (error) {
+				return false;
+			}
+		});
+		if (badGeofenceIds.length > 0) {
+			const errorString = `Invalid geofence ids: ${badGeofenceIds}`;
+			logger.debug(errorString);
+			throw new Error(errorString);
+		}
+
+		//  Delete geofences
+		try {
+			return await prov.deleteGeofences(geofenceIdsInputArray, options);
+		} catch (error) {
+			logger.debug(error);
+			throw error;
+		}
+	}
 }
 
 export const Geo = new GeoClass();