@esri/solution-common 1.3.10 → 1.3.13

package/dist/node/generalHelpers.js

@@ -30,7 +30,7 @@ const polyfills_1 = require("./polyfills");
  *
  * @param url URL to append to
  * @param parameter Query parameter to append, prefixed with "?" or "&" as appropriate to what url already has
- * @return New URL combining url and parameter
+ * @returns New URL combining url and parameter
  */
 function appendQueryParam(url, parameter) {
     return url + (url.indexOf("?") === -1 ? "?" : "&") + parameter;
@@ -40,7 +40,7 @@ exports.appendQueryParam = appendQueryParam;
  * Extracts JSON from a Blob.
  *
  * @param blob Blob to use as source
- * @return A promise that will resolve with JSON or null
+ * @returns A promise that will resolve with JSON or null
  */
 function blobToJson(blob) {
     return new Promise(resolve => {
@@ -61,7 +61,7 @@ exports.blobToJson = blobToJson;
  * @param blob Blob to use as source
  * @param filename Name to use for file
  * @param mimeType MIME type to override blob's MIME type
- * @return File created out of Blob and filename
+ * @returns File created out of Blob and filename
  */
 function blobToFile(blob, filename, mimeType) {
     return blob
@@ -75,7 +75,7 @@ exports.blobToFile = blobToFile;
  * Extracts text from a Blob.
  *
  * @param blob Blob to use as source
- * @return A promise that will resolve with text read from blob
+ * @returns A promise that will resolve with text read from blob
  */
 function blobToText(blob) {
     return new Promise(resolve => {
@@ -94,7 +94,7 @@ exports.blobToText = blobToText;
  * Checks that a URL path ends with a slash.
  *
  * @param url URL to check
- * @return URL, appended with slash if missing
+ * @returns URL, appended with slash if missing
  */
 function checkUrlPathTermination(url) {
     return url ? (url.endsWith("/") ? url : url + "/") : url;
@@ -103,7 +103,7 @@ exports.checkUrlPathTermination = checkUrlPathTermination;
 /**
  * Creates a random 32-character alphanumeric string.
  *
- * @return A lowercase 32-char alphanumeric string
+ * @returns A lowercase 32-char alphanumeric string
  * @internal
  */
 function createLongId() {
@@ -114,7 +114,7 @@ exports.createLongId = createLongId;
 /**
  * Creates a random 8-character alphanumeric string that begins with an alphabetic character.
  *
- * @return An alphanumeric string in the range [a0000000..zzzzzzzz]
+ * @returns An alphanumeric string in the range [a0000000..zzzzzzzz]
  */
 function createShortId() {
     // Return a random number, but beginning with an alphabetic character so that it can be used as a valid
@@ -146,7 +146,7 @@ exports.dedupe = dedupe;
  *
  * @param itemType The AGO item type
  * @param id Item id to include in response
- * @return Empty creation response
+ * @returns Empty creation response
  */
 function generateEmptyCreationResponse(itemType, id = "") {
     return {
@@ -161,7 +161,7 @@ exports.generateEmptyCreationResponse = generateEmptyCreationResponse;
  * Converts JSON to a Blob.
  *
  * @param json JSON to use as source
- * @return A blob from the source JSON
+ * @returns A blob from the source JSON
  */
 function jsonToBlob(json) {
     const _json = JSON.stringify(json);
@@ -179,7 +179,7 @@ exports.jsonToBlob = jsonToBlob;
  * @param json JSON to use as source
  * @param filename Name to use for file
  * @param mimeType MIME type to override blob's MIME type
- * @return File created out of JSON and filename
+ * @returns File created out of JSON and filename
  */
 function jsonToFile(json, filename, mimeType = "application/json") {
     return blobToFile(jsonToBlob(json), filename, mimeType);
@@ -190,7 +190,7 @@ exports.jsonToFile = jsonToFile;
  *
  * @param filename Name to give file
  * @param blob Blob to save
- * @return Promise resolving when operation is complete
+ * @returns Promise resolving when operation is complete
  */
 // Function is only used for live testing, so excluding it from coverage for now
 /* istanbul ignore next */
@@ -215,7 +215,7 @@ exports.saveBlobAsFile = saveBlobAsFile;
  * Makes a deep clone, including arrays but not functions.
  *
  * @param obj Object to be cloned
- * @return Clone of obj
+ * @returns Clone of obj
  * @example
  * ```js
  * import { cloneObject } from "utils/object-helpers";
@@ -258,7 +258,7 @@ exports.cloneObject = cloneObject;
  *
  * @param json1 First object
  * @param json2 Second object
- * @return True if objects are the same
+ * @returns True if objects are the same
  */
 function compareJSON(json1, json2) {
     return JSON.stringify(json1) === JSON.stringify(json2);
@@ -269,7 +269,7 @@ exports.compareJSON = compareJSON;
  *
  * @param json1 First object
  * @param json2 Second object
- * @return True if objects are the same
+ * @returns True if objects are the same
  */
 function compareJSONNoEmptyStrings(json1, json2) {
     const jsonStr1 = JSON.stringify(json1).replace(/":""/g, '":null');
@@ -282,7 +282,7 @@ exports.compareJSONNoEmptyStrings = compareJSONNoEmptyStrings;
  *
  * @param json1 First object
  * @param json2 Second object
- * @return A list of mismatch report strings
+ * @returns A list of mismatch report strings
  */
 function compareJSONProperties(json1, json2) {
     let mismatches = [];
@@ -347,7 +347,7 @@ exports.compareJSONProperties = compareJSONProperties;
  *
  * @param json JSON to sanitize
  * @param sanitizer Instance of Sanitizer class
- * @return Sanitized version of `json`
+ * @returns Sanitized version of `json`
  * @see https://github.com/esri/arcgis-html-sanitizer#sanitize-json
  */
 function sanitizeJSONAndReportChanges(json, sanitizer) {
@@ -436,7 +436,7 @@ exports.deleteProps = deleteProps;
  * Creates an AGO-style JSON failure response with success property.
  *
  * @param e Optional error information
- * @return JSON structure with property success set to false and optionally including `e`
+ * @returns JSON structure with property success set to false and optionally including `e`
  */
 function fail(e) {
     if (e) {
@@ -452,7 +452,7 @@ exports.fail = fail;
  *
  * @param ids List of ids
  * @param e Optional error information
- * @return JSON structure with property success set to false and optionally including `e`
+ * @returns JSON structure with property success set to false and optionally including `e`
  */
 function failWithIds(itemIds, e) {
     if (e) {
@@ -467,7 +467,7 @@ exports.failWithIds = failWithIds;
  * Extracts the ids from a string
  *
  * @param v String to examine
- * @return List of id strings found
+ * @returns List of id strings found
  * @example
  * get id from
  *   bad3483e025c47338d43df308c117308
@@ -498,7 +498,7 @@ exports.getIDs = getIDs;
  * @param obj Object to retrieve value from
  * @param path Path into an object, e.g., "data.values.webmap", where "data" is a top-level property
  *             in obj
- * @return Value at end of path
+ * @returns Value at end of path
  */
 function getProp(obj, path) {
     return path.split(".").reduce(function (prev, curr) {
@@ -512,7 +512,7 @@ exports.getProp = getProp;
  *
  * @param obj Object to retrieve values from
  * @param props Array of paths into the object e.g., "data.values.webmap", where "data" is a top-level property
- * @return Array of the values plucked from the object; only defined values are returned
+ * @returns Array of the values plucked from the object; only defined values are returned
  */
 function getProps(obj, props) {
     return props.reduce((a, p) => {
@@ -532,7 +532,7 @@ exports.getProps = getProps;
  * @param path Path into an object, e.g., "data.values.webmap", where "data" is a top-level property
  *             in obj
  * @param defaultV Optional value to use if any part of path--including final value--is undefined
- * @return Value at end of path
+ * @returns Value at end of path
  */
 function getPropWithDefault(obj, path, defaultV) {
     const value = path.split(".").reduce(function (prev, curr) {
@@ -614,9 +614,9 @@ exports.setProp = setProp;
 /**
  * Creates a timestamp string using the current UTC date and time.
  *
- * @return Timestamp formatted as YYYYMMDD_hhmm_ssmmm, with month one-based and all values padded with zeroes on the
+ * @returns Timestamp formatted as YYYYMMDD_hhmm_ssmmm, with month one-based and all values padded with zeroes on the
  * left as needed (`ssmmm` stands for seconds from 0..59 and milliseconds from 0..999)
- * @protected
+ * @private
  */
 function getUTCTimestamp() {
     const now = new Date();
@@ -636,7 +636,7 @@ exports.getUTCTimestamp = getUTCTimestamp;
  *
  * @param jsonObj Object to test
  * @param keywords List of keywords to look for in jsonObj
- * @return Boolean indicating result
+ * @returns Boolean indicating result
  */
 function hasAnyKeyword(jsonObj, keywords) {
     const typeKeywords = getProp(jsonObj, "item.typeKeywords") || jsonObj.typeKeywords || [];
@@ -653,7 +653,7 @@ exports.hasAnyKeyword = hasAnyKeyword;
  *
  * @param jsonObj Object to test
  * @param keyword Keyword to look for in jsonObj
- * @return Boolean indicating result
+ * @returns Boolean indicating result
  */
 function hasTypeKeyword(jsonObj, keyword) {
     const typeKeywords = getProp(jsonObj, "item.typeKeywords") || jsonObj.typeKeywords || [];
@@ -668,7 +668,7 @@ exports.hasTypeKeyword = hasTypeKeyword;
  * @param title The root title to test
  * @param templateDictionary Hash of the facts
  * @param path to the objects to evaluate for potantial name clashes
- * @return string The unique title to use
+ * @returns string The unique title to use
  */
 function getUniqueTitle(title, templateDictionary, path) {
     title = title ? title.trim() : "_";
@@ -691,7 +691,7 @@ exports.getUniqueTitle = getUniqueTitle;
  * @param obj Object to scan and to modify
  * @param pattern Search pattern in each string
  * @param replacement Replacement for matches to search pattern
- * @return Modified obj is returned
+ * @returns Modified obj is returned
  */
 function globalStringReplace(obj, pattern, replacement) {
     if (obj) {
@@ -717,7 +717,7 @@ exports.globalStringReplace = globalStringReplace;
  * @param datasourceInfos Array of DatasourceInfos to evaluate
  * @param itemId The items id to check for
  * @param layerId The layers id to check for
- * @return Boolean indicating result
+ * @returns Boolean indicating result
  */
 function hasDatasource(datasourceInfos, itemId, layerId) {
     return datasourceInfos.some(ds => ds.itemId === itemId && ds.layerId === layerId);
@@ -766,7 +766,7 @@ exports.cleanLayerId = cleanLayerId;
  * @param templates Array of item templates to search
  * @param id of template we are searching for
  *
- * @return Template associated with the user provided id argument
+ * @returns Template associated with the user provided id argument
  */
 function getTemplateById(templates, id) {
     let template;
@@ -785,7 +785,7 @@ exports.getTemplateById = getTemplateById;
  *
  * @param v a string value to test with the expression
  * @param ex the regular expresion to test with
- * @return an array of matches
+ * @returns an array of matches
  */
 function regExTest(v, ex) {
     return v && ex.test(v) ? v.match(ex) : [];
@@ -797,7 +797,7 @@ exports.regExTest = regExTest;
  *
  * @param min Inclusive minimum desired value
  * @param max Non-inclusive maximum desired value
- * @return Random number in the range [min, max)
+ * @returns Random number in the range [min, max)
  */
 function _getRandomNumberInRange(min, max) {
     // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/random#Getting_a_random_number_between_two_values
@@ -811,8 +811,8 @@ exports._getRandomNumberInRange = _getRandomNumberInRange;
  *
  * @param n Number to pad
  * @param totalSize Desired *minimum* width of number after padding with zeroes
- * @return Number converted to string and padded on the left as needed
- * @protected
+ * @returns Number converted to string and padded on the left as needed
+ * @private
  */
 function _padPositiveNum(n, totalSize) {
     let numStr = n.toString();
@@ -827,9 +827,9 @@ exports._padPositiveNum = _padPositiveNum;
  * Implements rejected ECMA proposal to change `typeof null` from "object" to "null".
  *
  * @param value Value whose type is sought
- * @return "null" if `value` is null; `typeof value` otherwise
+ * @returns "null" if `value` is null; `typeof value` otherwise
  * @see https://web.archive.org/web/20160331031419/http://wiki.ecmascript.org:80/doku.php?id=harmony:typeof_null
- * @protected
+ * @private
  */
 function _typeof_null(value) {
     return value === null ? "null" : typeof value;

package/dist/node/getDeletableSolutionInfo.d.ts

@@ -24,6 +24,6 @@ import { ISolutionPrecis, UserSession } from "./interfaces";
  *
  * @param solutionItemId Id of a deployed Solution
  * @param authentication Credentials for the request
- * @return Promise resolving to the list of items in the solution that would be deleted.
+ * @returns Promise resolving to the list of items in the solution that would be deleted.
  */
 export declare function getDeletableSolutionInfo(solutionItemId: string, authentication: UserSession): Promise<ISolutionPrecis>;

package/dist/node/getDeletableSolutionInfo.js

@@ -27,7 +27,7 @@ const restHelpersGet = tslib_1.__importStar(require("./restHelpersGet"));
  *
  * @param solutionItemId Id of a deployed Solution
  * @param authentication Credentials for the request
- * @return Promise resolving to the list of items in the solution that would be deleted.
+ * @returns Promise resolving to the list of items in the solution that would be deleted.
  */
 function getDeletableSolutionInfo(solutionItemId, authentication) {
     let solutionSummary;

package/dist/node/getSolutionSummary.d.ts

@@ -22,6 +22,6 @@ import { ISolutionPrecis, UserSession } from "./interfaces";
  *
  * @param solutionItemId Id of a deployed Solution
  * @param authentication Credentials for the request
- * @return Promise resolving to a summary of the deployed Solution
+ * @returns Promise resolving to a summary of the deployed Solution
  */
 export declare function getSolutionSummary(solutionItemId: string, authentication: UserSession): Promise<ISolutionPrecis>;

package/dist/node/getSolutionSummary.js

@@ -30,7 +30,7 @@ const templatization = tslib_1.__importStar(require("./templatization"));
  *
  * @param solutionItemId Id of a deployed Solution
  * @param authentication Credentials for the request
- * @return Promise resolving to a summary of the deployed Solution
+ * @returns Promise resolving to a summary of the deployed Solution
  */
 function getSolutionSummary(solutionItemId, authentication) {
     const solutionSummary = {