@esri/hub-common 9.10.1 → 9.10.2

package/dist/node/urls/get-portal-url.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPortalUrl = void 0;
+const arcgis_rest_portal_1 = require("@esri/arcgis-rest-portal");
+/**
+ * ```js
+ * import { getPortalUrl } from "@esri/hub-common";
+ * // from a portal API URL
+ * let portalUrl = getPortalUrl("https://org.maps.arcgis.com/sharing/rest"); // https://org.maps.arcgis.com
+ * // from an enterprise portal self response (IPortal)
+ * let portalSelf = { isPortal: true, portalHostname: "server.example.org" };
+ * portalUrl = getPortalUrl(portalSelf); // https://server.example.org
+ * // from an online portal self response (IPortal)
+ * portalSelf = { isPortal: false, urlKey: "org", customBaseUrl: "maps.arcgis.com" };
+ * portalUrl = getPortalUrl(portalSelf); // https://org.maps.arcgis.com
+ * // from hub request options (IHubRequestOptions) with a portal self (IPortal)
+ * let requestOptions = { isPortal: false, portalSelf };
+ * portalUrl = getPortalUrl(requestOptions); // https://org.maps.arcgis.com
+ * // from request options (IRequestOptions) with a portal (string)
+ * requestOptions = { portal: "https://org.maps.arcgis.com/sharing/rest" };
+ * portalUrl = getPortalUrl(requestOptions); // https://org.maps.arcgis.com
+ * ```
+ * Derive a portal's base URL from the portal's API URL, a portal object, or request options
+ * @param urlOrObject a portal API URL, a portal object, or request options containing either of those
+ * @returns The portal base URL, defaults to `https://www.arcgis.com`
+ */
+function getPortalUrl(urlOrObject) {
+    if (typeof urlOrObject === "string") {
+        // assume this is the URL of the portal API
+        // and strip the `/sharing/rest`
+        return urlOrObject.replace(/\/sharing\/rest\/?$/, "");
+    }
+    if (typeof urlOrObject === "object") {
+        // build URL from portal self object, which could be
+        // either a property of the object (request options) or the object itself
+        const portalSelf = urlOrObject.portalSelf;
+        const portal = portalSelf || urlOrObject;
+        const { portalHostname, urlKey, customBaseUrl } = portal;
+        if (portalHostname || (urlKey && customBaseUrl)) {
+            // user passed in a portal object, we'll use that to build the URL
+            if (portal.isPortal) {
+                return `https://${portal.portalHostname}`;
+            }
+            else {
+                return `https://${portal.urlKey}.${portal.customBaseUrl}`;
+            }
+        }
+    }
+    // urlOrObj is either undefined, or a request options w/o portal self
+    // get portal API URL and parse portal URL from that
+    return getPortalUrl(arcgis_rest_portal_1.getPortalUrl(urlOrObject));
+}
+exports.getPortalUrl = getPortalUrl;
+//# sourceMappingURL=get-portal-url.js.map

package/dist/node/urls/get-portal-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-portal-url.js","sourceRoot":"","sources":["../../../src/urls/get-portal-url.ts"],"names":[],"mappings":";;;AACA,iEAGkC;AAGlC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,YAAY,CAC1B,WAAqE;IAErE,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;QACnC,2CAA2C;QAC3C,gCAAgC;QAChC,OAAO,WAAW,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;KACvD;IAED,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;QACnC,oDAAoD;QACpD,yEAAyE;QACzE,MAAM,UAAU,GAAI,WAAkC,CAAC,UAAU,CAAC;QAClE,MAAM,MAAM,GAAG,UAAU,IAAK,WAAuB,CAAC;QACtD,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;QACzD,IAAI,cAAc,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,EAAE;YAC/C,kEAAkE;YAClE,IAAI,MAAM,CAAC,QAAQ,EAAE;gBACnB,OAAO,WAAW,MAAM,CAAC,cAAc,EAAE,CAAC;aAC3C;iBAAM;gBACL,OAAO,WAAW,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;aAC3D;SACF;KACF;IAED,qEAAqE;IACrE,oDAAoD;IACpD,OAAO,YAAY,CAAC,iCAAe,CAAC,WAA8B,CAAC,CAAC,CAAC;AACvE,CAAC;AA5BD,oCA4BC"}

package/dist/node/urls/hub-cdn-urlmap.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HUB_CDN_URLMAP = void 0;
+/**
+ * Mapping between the AGO Env's and the Hub's asset CDNs
+ */
+exports.HUB_CDN_URLMAP = {
+    devext: "https://d1011m9qpnz5mw.cloudfront.net",
+    qaext: "https://dyq9ux9ryu4qj.cloudfront.net",
+    www: "https://d1iq7pbacwn5rb.cloudfront.net"
+};
+//# sourceMappingURL=hub-cdn-urlmap.js.map

package/dist/node/urls/hub-cdn-urlmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-cdn-urlmap.js","sourceRoot":"","sources":["../../../src/urls/hub-cdn-urlmap.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,MAAM,EAAE,uCAAuC;IAC/C,KAAK,EAAE,sCAAsC;IAC7C,GAAG,EAAE,uCAAuC;CAC7C,CAAC"}

package/dist/node/urls/index.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getServiceTypeFromUrl = exports.isMapOrFeatureServerUrl = void 0;
+const tslib_1 = require("tslib");
+const util_1 = require("../util");
+tslib_1.__exportStar(require("./build-url"), exports);
+tslib_1.__exportStar(require("./get-hub-locale-asset-url"), exports);
+tslib_1.__exportStar(require("./get-portal-api-url"), exports);
+tslib_1.__exportStar(require("./get-portal-url"), exports);
+tslib_1.__exportStar(require("./hub-cdn-urlmap"), exports);
+tslib_1.__exportStar(require("./upgrade-protocol"), exports);
+tslib_1.__exportStar(require("./strip-protocol"), exports);
+tslib_1.__exportStar(require("./_get-http-and-https-uris"), exports);
+tslib_1.__exportStar(require("./_get-location"), exports);
+tslib_1.__exportStar(require("./get-hub-api-url-from-portal"), exports);
+tslib_1.__exportStar(require("./get-hub-url-from-portal"), exports);
+tslib_1.__exportStar(require("./get-item-home-url"), exports);
+tslib_1.__exportStar(require("./get-item-api-url"), exports);
+tslib_1.__exportStar(require("./get-item-data-url"), exports);
+const MAP_OR_FEATURE_SERVER_URL_REGEX = /\/(map|feature)server/i;
+/**
+ *
+ * @param url
+ * @returns true if the url is of a map or feature service
+ */
+exports.isMapOrFeatureServerUrl = (url) => {
+    return MAP_OR_FEATURE_SERVER_URL_REGEX.test(url);
+};
+/**
+ * parses map or feature service type from URL
+ * @param url map or feature service URL
+ * @returns item type, either "Map Service" or "Feature Service"
+ * or undefined for other types of URLs
+ */
+exports.getServiceTypeFromUrl = (url) => {
+    const match = url.match(MAP_OR_FEATURE_SERVER_URL_REGEX);
+    const mapOrFeature = match && match[1];
+    return mapOrFeature && `${util_1.capitalize(mapOrFeature)} Service`;
+};
+//# sourceMappingURL=index.js.map

package/dist/node/urls/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/urls/index.ts"],"names":[],"mappings":";;;;AAAA,kCAAqC;AACrC,sDAA4B;AAC5B,qEAA2C;AAC3C,+DAAqC;AACrC,2DAAiC;AACjC,2DAAiC;AACjC,6DAAmC;AACnC,2DAAiC;AACjC,qEAA2C;AAC3C,0DAAgC;AAChC,wEAA8C;AAC9C,oEAA0C;AAC1C,8DAAoC;AACpC,6DAAmC;AACnC,8DAAoC;AAEpC,MAAM,+BAA+B,GAAG,wBAAwB,CAAC;AAEjE;;;;GAIG;AACU,QAAA,uBAAuB,GAAG,CAAC,GAAW,EAAE,EAAE;IACrD,OAAO,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF;;;;;GAKG;AACU,QAAA,qBAAqB,GAAG,CAAC,GAAW,EAAE,EAAE;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,YAAY,IAAI,GAAG,iBAAU,CAAC,YAAY,CAAC,UAAU,CAAC;AAC/D,CAAC,CAAC"}

package/dist/node/urls/strip-protocol.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripProtocol = void 0;
+/**
+ * Remove protocol if present
+ * @param {string} hostname Hostname
+ */
+function stripProtocol(hostname) {
+    hostname = hostname.toLowerCase();
+    if (hostname.includes("//")) {
+        hostname = hostname.split("//")[1];
+    }
+    return hostname;
+}
+exports.stripProtocol = stripProtocol;
+//# sourceMappingURL=strip-protocol.js.map

package/dist/node/urls/strip-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-protocol.js","sourceRoot":"","sources":["../../../src/urls/strip-protocol.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,SAAgB,aAAa,CAAC,QAAgB;IAC5C,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QAC3B,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;KACpC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAND,sCAMC"}

package/dist/node/urls/upgrade-protocol.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upgradeProtocol = void 0;
+/**
+ * Add protocol or upgrade http to https
+ * @param {string} url
+ */
+function upgradeProtocol(url) {
+    if (url.indexOf("http") === -1) {
+        return `https://${url}`;
+    }
+    else if (url.indexOf("http://") !== -1) {
+        return url.replace(/^http:/i, "https:");
+    }
+    return url;
+}
+exports.upgradeProtocol = upgradeProtocol;
+//# sourceMappingURL=upgrade-protocol.js.map

package/dist/node/urls/upgrade-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-protocol.js","sourceRoot":"","sources":["../../../src/urls/upgrade-protocol.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE;QAC9B,OAAO,WAAW,GAAG,EAAE,CAAC;KACzB;SAAM,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE;QACxC,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;KACzC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAPD,0CAOC"}

package/dist/node/util.js

@@ -0,0 +1,415 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenArray = exports.capitalize = exports.isNil = exports.chunkArray = exports.addDays = exports.extend = exports.filterBy = exports.last = exports.uniqueBy = exports.unique = exports.camelize = exports.maybePush = exports.maybeAdd = exports.createId = exports.compose = exports.without = exports.findBy = exports.objectToArray = exports.arrayToObject = exports.cloneObject = void 0;
+/* Copyright (c) 2018-2019 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+const get_prop_1 = require("./objects/get-prop");
+/**
+ * ```js
+ * import { cloneObject } from "@esri/hub-common";
+ * const original = { foo: "bar" }
+ * const copy = cloneObject(original)
+ * copy.foo // "bar"
+ * copy === original // false
+ * ```
+ * Make a deep clone, including arrays. Does not handle functions!
+ */
+function cloneObject(obj) {
+    let clone = {};
+    // first check array
+    if (Array.isArray(obj)) {
+        clone = obj.map(cloneObject);
+    }
+    else if (typeof obj === "object") {
+        for (const i in obj) {
+            /* istanbul ignore next no need to deal w/ other side of hasOwnProperty() */
+            if (obj.hasOwnProperty(i)) {
+                const value = obj[i];
+                if (value != null && typeof value === "object") {
+                    if (value instanceof Date) {
+                        clone[i] = new Date(value.getTime());
+                    }
+                    else {
+                        clone[i] = cloneObject(value);
+                    }
+                }
+                else {
+                    clone[i] = value;
+                }
+            }
+        }
+    }
+    else {
+        clone = obj;
+    }
+    return clone;
+}
+exports.cloneObject = cloneObject;
+/**
+ * Given an array of objects, convert into an object, with each
+ * entry assigned the key via the keyprop
+ */
+function arrayToObject(arr, key) {
+    return arr.reduce((hash, entry) => {
+        hash[get_prop_1.getProp(entry, key)] = entry;
+        return hash;
+    }, {});
+}
+exports.arrayToObject = arrayToObject;
+/**
+ * Given an object, convert into an array, with each
+ * something or other
+ */
+function objectToArray(obj, keyProp = "id") {
+    const arr = Object.keys(obj).reduce((acc, prop) => {
+        obj[prop][keyProp] = prop;
+        acc.push(cloneObject(obj[prop]));
+        return acc;
+    }, []);
+    return arr;
+}
+exports.objectToArray = objectToArray;
+/**
+ * Return an entry from an array by a property name
+ */
+function findBy(arr, prop, value) {
+    if (!arr) {
+        return null;
+    }
+    const res = arr.reduce((acc, entry) => {
+        if (get_prop_1.getProp(entry, prop) === value) {
+            acc = entry;
+        }
+        return acc;
+    }, null);
+    return res;
+}
+exports.findBy = findBy;
+/**
+ * Return a new array without the specified value.
+ *
+ * @export
+ * @param {any[]} arr
+ * @param {*} val value or object to remove
+ * @returns {any[]} Array without the value
+ */
+function without(arr, value) {
+    const res = arr.filter((entry) => entry !== value);
+    return res;
+}
+exports.without = without;
+/**
+ * Compose
+ * adapted from: https://github.com/stoeffel/compose-function/blob/master/module/index.js
+ */
+function compose(...fns) {
+    return fns.reduce((f, g) => (...args) => f(g(...args)));
+}
+exports.compose = compose;
+/**
+ * Return a random number, prefixed with a string. Used for unique identifiers that do not require
+ * the rigor of a full UUID - i.e. node id's, process ids etc.
+ * @param prefix String to prefix the random number with so the result is a valid javascript property
+ */
+function createId(prefix = "i") {
+    // prepend some char so it's always a valid dotable property name
+    // get a random number, convert to base 36 representation, then grab chars 2-8
+    return `${prefix}${Math.random().toString(36).substr(2, 8)}`;
+}
+exports.createId = createId;
+/**
+ * Append or replace a value on an object, using a specified key, if the value is not null.
+ * This is a very useful companion to the [getProp()](../getProp/) utility.
+ *
+ * Note: object that is passed in is cloned before the property is appended.
+ *
+ * Allows for code like:
+ *
+ * ```js
+ * let model = {
+ *  item: {
+ *    title: 'some example object',
+ *    description: 'this is some longer text',
+ *    type: 'Web Map',
+ *    properties: {
+ *      sourceId: '3ef'
+ *    }
+ *  },
+ *  data: {
+ *    theme: 'orange',
+ *    parcelLayer: {
+ *      primaryField: 'PIN'
+ *    }
+ *  }
+ * };
+ *
+ * // Let's extract some details into an object.
+ * const summary = [
+ *  'item.title',
+ *  'item.description',
+ *  'item.missingProp',
+ *  'data.parcelLayer.primaryField'].reduce((acc, prop) => {
+ *   // create the property name... you could do this however...
+ *   let propName = prop.split('.').reverse()[0];
+ *   return maybeAdd(propName, getProp(model, key), acc);
+ * }, {});
+ *
+ * // summary =>
+ * // {
+ * //   title: 'some example object',
+ * //   description: 'this is some longer text',
+ * //   primaryField: 'PIN'
+ * // }
+ * ```
+ * @param key - key to use when appending to the object
+ * @param val - the possibly null value
+ * @param target - the object to update
+ */
+function maybeAdd(key, val, target) {
+    // see if we got something...
+    if (val !== null && val !== undefined) {
+        target = cloneObject(target);
+        // attach using the key
+        target[key] = val;
+    }
+    return target;
+}
+exports.maybeAdd = maybeAdd;
+/**
+ * Append a value to an array, if the value is not null.
+ * This is a very useful companion to the [getProp()](../getProp/) utility.
+ *
+ * Note: the array that is passed in is cloned before being appended to.
+ *
+ * Allows for code like:
+ * ```js
+ *  // example object
+ * let model = {
+ *  item: {
+ *    id: 'c00',
+ *    title: 'some example object',
+ *    description: 'this is some longer text',
+ *    type: 'Web Map',
+ *    properties: {
+ *      sourceId: '3ef'
+ *    }
+ *  },
+ *  data: {
+ *    theme: 'orange',
+ *    parcelLayer: {
+ *      itemId: '7ca',
+ *      primaryField: 'PIN'
+ *    }
+ *  }
+ * };
+ * // lets pluck some id's into an array...
+ * maybePush(getProp(model, 'item.properties.sourceId'), []);
+ * // > ['3ef']
+ *
+ * // now try to get a value from a property that is missing...
+ * maybePush(getProp(obj, 'item.properties.childId'), []);
+ * // > []
+ *
+ * // easily pluck values via property paths
+ * const summary = [
+ *  'item.id',
+ *  'item.properties.sourceId',
+ *  'item.properties.childId',
+ *  'data.parcelLayer.itemId'].reduce((acc, prop) => {
+ *   return maybePush(getProp(model, key), acc);
+ * }, []);
+ *
+ * // summary => ['c00', '3ef', '7ca']
+ *
+ * ```
+ *
+ * @param val - the possibly null value
+ * @param target - the array to add the value to
+ */
+function maybePush(val, target) {
+    if (val !== null && val !== undefined) {
+        // create a clone because mutation makes us sad...
+        target = cloneObject(target);
+        target.push(val);
+    }
+    return target;
+}
+exports.maybePush = maybePush;
+/**
+ * Convert a string to camelCase
+ *
+ * @export
+ * @param {string} value
+ * @returns {string} camelCased string
+ */
+function camelize(value) {
+    // lower case the whole thing to start...
+    value = value.toLowerCase();
+    // strip out any/all special chars...
+    value = value.replace(/[`~!@#$%^&*()_|+\-=?;:'",.<>\{\}\[\]\\\/]/gi, " ");
+    // Hoisted from EmberJS (MIT License)
+    // https://github.com/emberjs/ember.js/blob/v2.0.1/packages/ember-runtime/lib/system/string.js#L23-L27
+    const STRING_CAMELIZE_REGEXP_1 = /(\-|\_|\.|\s)+(.)?/g;
+    const STRING_CAMELIZE_REGEXP_2 = /(^|\/)([A-Z])/g;
+    return value
+        .replace(STRING_CAMELIZE_REGEXP_1, function (match, separator, chr) {
+        return chr ? chr.toUpperCase() : "";
+    })
+        .replace(STRING_CAMELIZE_REGEXP_2, function (match, separator, chr) {
+        return match.toLowerCase();
+    });
+}
+exports.camelize = camelize;
+/**
+ * Determines if a value is unique in an array
+ * Allows for code like:
+ *
+ * ```js
+ * const ary = [ 1, 2, 3, 3, 4, 5, 1 ];
+ *
+ * const result = ary.filter(unique);
+ *
+ * result => [ 1, 2, 3, 4, 5 ]
+ * ```
+ * @param value - the value to search for
+ * @param index - the index of the searched value
+ * @param ary - the array to search
+ * @returns {boolean} - indicating if the value is unique in the array
+ */
+function unique(value, index, ary) {
+    return ary.indexOf(value) === index;
+}
+exports.unique = unique;
+/**
+ * Return array of unique objects, based on a deep property value
+ *  Note: Property you compare on should be a primative type
+ * @export
+ * @template T
+ * @param {T[]} arr
+ * @param {string} prop
+ * @return {*}  {T[]}
+ */
+function uniqueBy(arr, prop) {
+    return arr.reduce((acc, entry) => {
+        const nameMatches = (e) => get_prop_1.getProp(e, prop) === get_prop_1.getProp(entry, prop);
+        return maybePush(acc.find(nameMatches) ? null : entry, acc);
+    }, []);
+}
+exports.uniqueBy = uniqueBy;
+/**
+ * Return last element of an array
+ *
+ * @export
+ * @template T
+ * @param {T[]} arr
+ * @return {*}  {T}
+ */
+function last(arr) {
+    return arr[arr.length - 1];
+}
+exports.last = last;
+/**
+ * Filter an array by a deep property value
+ *
+ * @export
+ * @template T
+ * @param {T[]} arr
+ * @param {string} prop
+ * @param {unknown} val
+ * @return {*}  {T[]}
+ */
+function filterBy(arr, prop, val) {
+    return arr.filter((entry) => get_prop_1.getProp(entry, prop) === val);
+}
+exports.filterBy = filterBy;
+/**
+ * Extends the target object with props from the source object, overwriting identically named
+ * props in target with those from source, ignoring null and undefined values; similar to $.extend.
+ * Performs a deep extend by default, unless deep = false is passed as the third arg.
+ *
+ * @param target - the object that will take props from source
+ * @param source - the object from which to take props
+ * @param deep - whether or not to perform a deep (recursive) extend of source
+ */
+function extend(target, source, deep = true) {
+    const extended = cloneObject(target);
+    return Object.keys(source).reduce((obj, prop) => {
+        if (source[prop] !== null && source[prop] !== undefined) {
+            const value = cloneObject(source[prop]);
+            if (Array.isArray(value)) {
+                // check for arrays, since array is type object
+                obj[prop] = value;
+            }
+            else if (deep && typeof value === "object") {
+                obj[prop] = extend(obj[prop] || {}, value, deep);
+            }
+            else {
+                obj[prop] = value;
+            }
+        }
+        return obj;
+    }, extended);
+}
+exports.extend = extend;
+/**
+ * Add number of days to a given date
+ *
+ * @export
+ * @param {string} date
+ * @param {number} numOfDays
+ * @returns {string} date string with numOfDays added to the given date
+ */
+function addDays(date, numOfDays) {
+    try {
+        const given = new Date(date);
+        const dateString = new Date(given.setDate(given.getDate() + numOfDays)).toISOString();
+        return dateString.split("T")[0];
+    }
+    catch (e) {
+        throw new Error("Invalid Date");
+    }
+}
+exports.addDays = addDays;
+/**
+ * Returns an array with arrays of the given size.
+ *
+ * @param arr Array to split
+ * @param size Size of every group
+ */
+function chunkArray(arr, size) {
+    const results = [];
+    let index = 0;
+    while (index < arr.length) {
+        results.push(arr.slice(index, index + size));
+        index += size;
+    }
+    return results;
+}
+exports.chunkArray = chunkArray;
+/**
+ * Determine if a value is null or undefined
+ * @param value anything
+ * @returns
+ */
+exports.isNil = (value) => value == null;
+/**
+ * Upper case first letter (only) of a string
+ * @param word
+ * @returns Word
+ */
+exports.capitalize = (word) => {
+    // upper case first letter and return as element in array for backwards compatibility
+    const chars = Array.from(word);
+    chars[0] = chars[0].toUpperCase();
+    return chars.join("");
+};
+/**
+ * An IE-compatible stand-in for Javascript's [array.flat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat)
+ * @param arr the array
+ * @returns an array
+ */
+function flattenArray(arr) {
+    return arr.reduce((acc, val) => acc.concat(val), []);
+}
+exports.flattenArray = flattenArray;
+//# sourceMappingURL=util.js.map

package/dist/node/util.js.map

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

package/dist/node/utils/batch.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batch = void 0;
+/**
+ * Helper to split a large number of calls into
+ * smaller batches of concurrent calls.
+ * @param {Array} values Any array of values with which to invoke fn
+ * @param {Function} fn The function that will be invoked with each value
+ * @param {number} [batchSize=5] The number of concurrent calls to fn, defaults to 5
+ * @returns {Promise<IBatch[]>}
+ */
+function batch(values, fn, batchSize = 5) {
+    const toBatches = (_batches, value) => {
+        let _batch = _batches[_batches.length - 1];
+        if (!_batch || _batch.length === batchSize) {
+            _batch = [];
+            _batches.push(_batch);
+        }
+        _batch.push(value);
+        return _batches;
+    };
+    const toSerialBatchChain = (promise, batchOfValues) => {
+        const executeBatch = (prevResults) => {
+            const batchResults = batchOfValues.map(id => fn(id));
+            return Promise.all(batchResults).then(results => prevResults.concat(results));
+        };
+        return promise.then(executeBatch);
+    };
+    // split values into batches of values
+    const batches = values.reduce(toBatches, []);
+    // batches are processed serially, however
+    // all calls within a batch are concurrent
+    return batches.reduce(toSerialBatchChain, Promise.resolve([]));
+}
+exports.batch = batch;
+//# sourceMappingURL=batch.js.map

package/dist/node/utils/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../../src/utils/batch.ts"],"names":[],"mappings":";;;AAEA;;;;;;;GAOG;AACH,SAAgB,KAAK,CACnB,MAAc,EACd,EAAmB,EACnB,YAAoB,CAAC;IAErB,MAAM,SAAS,GAAG,CAAC,QAAkB,EAAE,KAAU,EAAY,EAAE;QAC7D,IAAI,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE;YAC1C,MAAM,GAAG,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACvB;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,kBAAkB,GAAG,CACzB,OAAqB,EACrB,aAAqB,EACP,EAAE;QAChB,MAAM,YAAY,GAAG,CAAC,WAAkB,EAAE,EAAE;YAC1C,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACrD,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAC9C,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAC5B,CAAC;QACJ,CAAC,CAAC;QACF,OAAO,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC,CAAC;IAEF,sCAAsC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAE7C,0CAA0C;IAC1C,0CAA0C;IAC1C,OAAO,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAlCD,sBAkCC"}

package/dist/node/utils/create-operation-pipeline.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOperationPipeline = void 0;
+const OperationError_1 = require("../OperationError");
+/**
+ * Returns a function that orchestrates a pipeline of smaller functions.
+ * See [Composing Workflows](../../../guides/composing-workflows) for more information.
+ *
+ * All the functions must adhere to the `PipelineFn<T>` signature:
+ *
+ * `(value: IPipeable<T>) => Promise<IPipeable<T>>`
+ *
+ * Given an array of OperationPipeFns, run them in sequence and return the resultant promise
+ *
+ * i.e. `createOperationPipeline([fn1, fn2, f3])` will return in a function that chains
+ * the functions like this: `fn1(input).then(fn2).then(fn3).then(result)`
+ *
+ * @param fns functions to be run in sequence
+ * @returns Promise<Pipable<T>>
+ */
+exports.createOperationPipeline = (fns) => (input) => {
+    return fns.reduce((chain, func) => {
+        return chain.then(func).catch((err) => {
+            // if it's an OperationError we can just reject with it...
+            if (err.name === "OperationError") {
+                return Promise.reject(err);
+            }
+            else {
+                // otherwise, create an OperationError and reject with that
+                const msg = `IPipeableFn did not reject with an OperationError \n Operation Stack: \n ${input.stack.toString()}`;
+                const opErr = new OperationError_1.default("pipeline execution error", msg);
+                opErr.operationStack = input.stack.serialize();
+                return Promise.reject(opErr);
+            }
+        });
+    }, Promise.resolve(input));
+};
+//# sourceMappingURL=create-operation-pipeline.js.map