@esri/hub-common 9.13.0 → 9.14.1

package/dist/umd/common.umd.js

@@ -1,5 +1,5 @@
 /* @preserve
- * @esri/hub-common - v9.12.0 - Thu Jan 20 2022 20:07:02 GMT+0000 (Coordinated Universal Time)
+ * @esri/hub-common - v9.14.0 - Mon Feb 07 2022 19:02:27 GMT+0000 (Coordinated Universal Time)
  * Copyright (c) 2022 Environmental Systems Research Institute, Inc.
  * Apache-2.0
  */
@@ -4976,6 +4976,52 @@
         return content.replace("(", "<br/>(");
     }
 
+    /**
+     * Cross-walk from a portalUrl to the corresponding Hub API Url
+     *
+     * If the passed url is not recognized, then this will return `undefined`
+     * @param portalUrl
+     * @returns
+     */
+    function getHubApiFromPortalUrl(portalUrl) {
+        var result;
+        if (portalUrl.match(/(qaext|\.mapsqa)\.arcgis.com/)) {
+            result = "https://hubqa.arcgis.com";
+        }
+        else if (portalUrl.match(/(devext|\.mapsdevext)\.arcgis.com/)) {
+            result = "https://hubdev.arcgis.com";
+        }
+        else if (portalUrl.match(/(www|\.maps)\.arcgis.com/)) {
+            result = "https://hub.arcgis.com";
+        }
+        return result;
+    }
+
+    /**
+     * Given an org url, get the portal base url
+     *
+     * i.e. https://myorg.maps.arcgis.com will return https://www.arcgis.com
+     *
+     * @param orgUrl
+     * @returns
+     */
+    function getPortalBaseFromOrgUrl(orgUrl) {
+        var result = orgUrl;
+        if (orgUrl.match(/(qaext|\.mapsqa)\.arcgis.com/)) {
+            result = "https://qaext.arcgis.com";
+        }
+        else if (orgUrl.match(/(devext|\.mapsdevext)\.arcgis.com/)) {
+            result = "https://devext.arcgis.com";
+        }
+        else {
+            /* istanbul ignore else */
+            if (orgUrl.match(/(www|\.maps)\.arcgis.com/)) {
+                result = "https://www.arcgis.com";
+            }
+        }
+        return result;
+    }
+
     var MAP_OR_FEATURE_SERVER_URL_REGEX = /\/(map|feature)server/i;
     /**
      *
@@ -6384,12 +6430,15 @@
             appbuilderExtension: "file",
             appbuilderWidgetPackage: "widgets-source",
             application: "web",
+            applicationConfiguration: "app-gear",
             arcgisProMap: "desktop",
             cadDrawing: "file-cad",
             cityEngineWebScene: "urban-model",
             codeAttachment: "file-code",
+            codeSample: "file-code",
             colorSet: "palette",
             contentCategorySet: "label",
+            csv: "file-csv",
             cSV: "file-csv",
             cSVCollection: "file-csv",
             dashboard: "dashboard",
@@ -6411,8 +6460,8 @@
             geoprocessingService: "file",
             globeLayer: "layers",
             globeService: "file",
-            hubInitiative: "mountain-summit-nocap",
-            hubInitiativeTemplate: "initiative-template-outlines-thick",
+            hubInitiative: "initiative",
+            hubInitiativeTemplate: "initiative-template",
             hubPage: "browser",
             hubSiteApplication: "web",
             image: "file-image",
@@ -6428,6 +6477,7 @@
             kMLCollection: "data",
             layer: "layers",
             layerPackage: "layers",
+            layerTemplate: "file",
             locatorPackage: "file",
             mapArea: "file",
             mapDocument: "map-contents",
@@ -6450,6 +6500,7 @@
             orthoMappingTemplate: "file",
             pDF: "file-pdf",
             quickCaptureProject: "mobile",
+            rasterFunctionTemplate: "file",
             rasterLayer: "map",
             realTimeAnalytic: "file",
             relationalDatabaseConnection: "file",
@@ -6458,19 +6509,23 @@
             sceneService: "urban-model",
             serviceDefinition: "file",
             shapefile: "data",
-            solution: "solutions",
+            solution: "puzzle-piece",
             sqliteGeodatabase: "file",
             statisticalDataCollection: "file",
+            storymap: "tour",
             storyMap: "tour",
+            storymapTheme: "palette",
             symbolSet: "file",
             table: "table",
             urbanModel: "urban-model",
+            vectorTilePackage: "file-shape",
             vectorTileService: "map",
             visioDocument: "conditional-rules",
             webExperience: "apps",
             webMap: "map",
             webMappingApplication: "apps",
             webScene: "urban-model",
+            wfs: "map",
             wFS: "map",
             wMS: "map",
             wMTS: "map",
@@ -8793,7 +8848,7 @@
      * Construct a the full url to a group thumbnail
      *
      * - If the group has a thumbnail, construct the full url
-     * - If the group is not public, append on the token
+     * - If the group is not public, append on the token (if passed in)
      * @param portalUrl
      * @param group
      * @param token
@@ -9524,12 +9579,11 @@
             return __generator(this, function (_b) {
                 expanded = expandContentFilter(filter);
                 api = expandApi(options.api || "arcgis");
-                // map over the apis, depending on the type we issue the queries
-                // const searchPromises = apis.map((api) => {
                 // Portal Search
                 if (api.type === "arcgis") {
                     so = serializeContentFilterForPortal(expanded);
-                    // pass auth forward
+                    // if we have auth, pass it forward
+                    // otherwise set the portal property
                     if (options.authentication) {
                         so.authentication = options.authentication;
                     }
@@ -9542,7 +9596,6 @@
                         so.countSize = 200;
                     }
                     // copy over various options
-                    // TODO: Dry this up - typscript makes this... inconvenient
                     if (options.num) {
                         so.num = options.num;
                     }
@@ -9569,8 +9622,6 @@
                         },
                     });
                 }
-                // });
-                // return for results
                 return [2 /*return*/, searchPromise];
             });
         });
@@ -9584,14 +9635,29 @@
      * @returns
      */
     function searchPortal(searchOptions) {
+        var _a;
+        var portalUrl = ((_a = searchOptions.authentication) === null || _a === void 0 ? void 0 : _a.portal) || searchOptions.portal;
+        var token;
+        if (searchOptions.authentication) {
+            var us = searchOptions.authentication;
+            token = us.token;
+        }
+        var thumbnailify = function (content) {
+            content.thumbnailUrl = getItemThumbnailUrl(content, portalUrl, token);
+            return content;
+        };
         return searchItems(searchOptions).then(function (resp) {
             var hasNext = resp.nextStart > -1;
+            // convert items to IHubContent's
             var content = resp.results.map(itemToContent);
+            // if we have a site, add those urls
             if (searchOptions.site) {
                 content = content.map(function (entry) {
                     return setContentSiteUrls(entry, searchOptions.site);
                 });
             }
+            // add thumbnailUrl
+            content = content.map(thumbnailify);
             // convert aggregations into facets
             var facets = convertPortalResponseToFacets(resp);
             return {
@@ -9613,10 +9679,9 @@
      * @returns
      */
     function _searchGroups(filter, options) {
-        var _a;
         return __awaiter(this, void 0, void 0, function () {
             var expanded, api, so;
-            return __generator(this, function (_b) {
+            return __generator(this, function (_a) {
                 expanded = expandGroupFilter(filter);
                 api = expandApi(options.api || "arcgis");
                 if (api.type === "arcgis") {
@@ -9629,7 +9694,6 @@
                     else {
                         so.portal = api.url + "/sharing/rest";
                     }
-                    // TODO: Dry this up - typscript makes this... inconvenient
                     if (options.num) {
                         so.num = options.num;
                     }
@@ -9639,10 +9703,6 @@
                     if (options.sortOrder) {
                         so.sortOrder = options.sortOrder;
                     }
-                    api.url + "/sharing/rest";
-                    if ((_a = so.authentication) === null || _a === void 0 ? void 0 : _a.portal) {
-                        so.authentication.portal;
-                    }
                     if (options.site) {
                         so.site = cloneObject$1(options.site);
                     }
@@ -9665,8 +9725,7 @@
             group.siteTeamUrl = searchOptions.site.item.url + "/teams/" + group.id + "/about";
             return group;
         };
-        var portalUrl = ((_a = searchOptions.authentication) === null || _a === void 0 ? void 0 : _a.portal) ||
-            "https://www.arcgis.com/sharing/rest";
+        var portalUrl = ((_a = searchOptions.authentication) === null || _a === void 0 ? void 0 : _a.portal) || searchOptions.portal;
         var token;
         if (searchOptions.authentication) {
             var us = searchOptions.authentication;
@@ -10733,116 +10792,37 @@
         discussions: "/api/discussions/v1",
     };
     /**
-     * Application Context Object
-     *
-     * Abstraction that combines a `UserSession` with
-     * the `portal/self` and `user/self` responses to
-     * provide a central lookup of platform information.
+     * Abstraction that holds a `UserSession`, along with
+     * getters to streamline access to various platform
+     * urls, and common constructs like `IRequestOptions`,
+     * `IUserRequestOptions` etc.
      *
-     * This is a work-in-progress, and will likely expand over time.
+     * Instances are intended to be immutable, but this is not directly enforced.
      *
-     * `ArcGISContext` is used in conjuction with the `arcgis-app-identity`
-     * component to orchestrate oAuth.
+     * In most circumstances, this class should be created by
+     * the ArcGISContextManager class.
      */
     var ArcGISContext = /** @class */ (function () {
         /**
-         * Private constructor. Use `ArcGISContext.create(...)` to
-         * instantiate an instance
+         * Create a new instance of `ArcGISContext`.
+         *
          * @param opts
          */
         function ArcGISContext(opts) {
             this._portalUrl = "https://www.arcgis.com";
-            this._debug = false;
-            // Having a unique id makes debugging easier
-            this.id = new Date().getTime();
-            if (opts.debug) {
-                this._debug = opts.debug;
-            }
-            this.log("ArcGISContext:ctor: Creating " + this.id);
+            this.id = opts.id;
+            this._portalUrl = opts.portalUrl;
+            this._hubUrl = opts.hubUrl;
             if (opts.authentication) {
                 this._authentication = opts.authentication;
-                this._portalUrl = this._authentication.portal.replace("/sharing/rest", "");
-                this._hubUrl = getHubApiFromPortalUrl(this._portalUrl);
             }
-            else if (opts.portalUrl) {
-                this._portalUrl = opts.portalUrl;
-                this._hubUrl = getHubApiFromPortalUrl(this._portalUrl);
+            if (opts.portalSelf) {
+                this._portalSelf = opts.portalSelf;
             }
-            else {
-                this._hubUrl = getHubApiFromPortalUrl(this._portalUrl);
+            if (opts.currentUser) {
+                this._currentUser = opts.currentUser;
             }
         }
-        /**
-         * Static async Factory
-         * @param opts
-         * @returns
-         */
-        ArcGISContext.create = function (opts) {
-            if (opts === void 0) { opts = {}; }
-            return __awaiter(this, void 0, void 0, function () {
-                var ctx;
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
-                        case 0:
-                            ctx = new ArcGISContext(opts);
-                            return [4 /*yield*/, ctx.initialize()];
-                        case 1:
-                            _a.sent();
-                            return [2 /*return*/, ctx];
-                    }
-                });
-            });
-        };
-        /**
-         * If we have a UserSession, fetch portal/self and
-         * store that along with current user
-         */
-        ArcGISContext.prototype.initialize = function () {
-            return __awaiter(this, void 0, void 0, function () {
-                var ps;
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
-                        case 0:
-                            if (!this._authentication) return [3 /*break*/, 2];
-                            this.log("ArcGISContext-" + this.id + ": Initializing");
-                            return [4 /*yield*/, getSelf({ authentication: this._authentication })];
-                        case 1:
-                            ps = _a.sent();
-                            this._portalSelf = ps;
-                            this._currentUser = ps.user;
-                            _a.label = 2;
-                        case 2: return [2 /*return*/];
-                    }
-                });
-            });
-        };
-        // Set authentication after the instance is up and running
-        ArcGISContext.prototype.setAuthentication = function (auth) {
-            return __awaiter(this, void 0, void 0, function () {
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
-                        case 0:
-                            this._authentication = auth;
-                            this._portalUrl = auth.portal.replace("/sharing/rest", "");
-                            return [4 /*yield*/, this.initialize()];
-                        case 1:
-                            _a.sent();
-                            return [2 /*return*/];
-                    }
-                });
-            });
-        };
-        /**
-         * @internal
-         * Log debugging messages to the console
-         * @param message
-         */
-        ArcGISContext.prototype.log = function (message) {
-            if (this._debug) {
-                // tslint:disable-next-line:no-console
-                console.info(message);
-            }
-        };
         Object.defineProperty(ArcGISContext.prototype, "session", {
             /**
              * Return the UserSession if authenticated
@@ -10911,28 +10891,27 @@
              */
             get: function () {
                 // We may add more logic around what is returned in some corner cases
-                return {
-                    authentication: this.session,
-                    isPortal: this.isPortal,
-                    portalSelf: this.portal,
-                    hubApiUrl: this.hubUrl,
-                };
+                if (this.isAuthenticated) {
+                    return {
+                        authentication: this.session,
+                        isPortal: this.isPortal,
+                        portalSelf: this.portal,
+                        hubApiUrl: this.hubUrl,
+                    };
+                }
             },
             enumerable: false,
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "portalUrl", {
-            // ==============================
-            // Getters / Computed Properties
-            // ==============================
             /**
-             * Return the portal url.
+             * Return the portal url i.e. https://www.arcgis.com
              *
              * If authenticated @ ArcGIS Online, it will return
              * the https://org.env.arcgis.com
              *
              * If authenticated @ ArcGIS Enterprise, it will return
-             * https://portalHostname, which includes the web adaptor
+             * https://{portalHostname}/{webadaptor}
              */
             get: function () {
                 if (this.isAuthenticated) {
@@ -10952,7 +10931,7 @@
         });
         Object.defineProperty(ArcGISContext.prototype, "sharingApiUrl", {
             /**
-             * Returns the url to the sharing api
+             * Returns the url to the sharing api composed from portalUrl
              * i.e. https://myorg.maps.arcgis.com/sharing/rest
              */
             get: function () {
@@ -10962,6 +10941,11 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "hubUrl", {
+            /**
+             * Returns the Hub url, based on the portalUrl
+             *
+             * For ArcGIS Enterprise this will return `undefined`
+             */
             get: function () {
                 return this._hubUrl;
             },
@@ -10982,9 +10966,9 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "discussionsServiceUrl", {
-            // Hub APIs
-            // ----------
-            // Discussions
+            /**
+             * Returns the discussions API URL
+             */
             get: function () {
                 if (this._hubUrl) {
                     return "" + this._hubUrl + hubApiEndpoints.discussions;
@@ -10994,7 +10978,9 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "hubSearchServiceUrl", {
-            // Hub Search
+            /**
+             * Returns the Hub Search API URL
+             */
             get: function () {
                 if (this._hubUrl) {
                     return "" + this._hubUrl + hubApiEndpoints.search;
@@ -11004,7 +10990,9 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "domainServiceUrl", {
-            // Domain
+            /**
+             * Returns Hub Domain Service URL
+             */
             get: function () {
                 if (this._hubUrl) {
                     return "" + this._hubUrl + hubApiEndpoints.domains;
@@ -11014,8 +11002,11 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "eventsConfig", {
-            // Events
-            // returns `{serviceId: '3ef..', publicViewId: 'bc3...'}
+            /**
+             * Returns the Events configuration object from portal/self
+             *
+             * `{serviceId: '3ef..', publicViewId: 'bc3...'}`
+             */
             get: function () {
                 if (this._portalSelf) {
                     return getProp(this._portalSelf, "portalProperties.hub.settings.events");
@@ -11038,7 +11029,7 @@
         });
         Object.defineProperty(ArcGISContext.prototype, "communityOrgId", {
             /**
-             * Return Hub Community Org Id, if defined
+             * Return the Hub Community Org Id, if defined
              */
             get: function () {
                 if (this._portalSelf) {
@@ -11049,6 +11040,11 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "communityOrgHostname", {
+            /**
+             * Returns the Hub Community Org Hostname, if defined
+             *
+             * i.e. c-org.maps.arcgis.com
+             */
             get: function () {
                 if (this._portalSelf) {
                     return getProp(this._portalSelf, "portalProperties.hub.settings.communityOrg.portalHostname");
@@ -11058,6 +11054,11 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "communityOrgUrl", {
+            /**
+             * Returns the Hub Community Org url
+             *
+             * i.e. https://c-org.maps.arcgis.com
+             */
             get: function () {
                 if (this.communityOrgHostname) {
                     return "https://" + this.communityOrgHostname;
@@ -11067,8 +11068,9 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "helperServices", {
-            // Platform API service urls are all in helperServices
-            // and not consistent to expose as urls
+            /**
+             * Returns the hash of helper services from portal self
+             */
             get: function () {
                 if (this._portalSelf) {
                     return this._portalSelf.helperServices;
@@ -11078,6 +11080,9 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "currentUser", {
+            /**
+             * Returns the current user as IUser
+             */
             get: function () {
                 return this._currentUser;
             },
@@ -11085,6 +11090,9 @@
             configurable: true
         });
         Object.defineProperty(ArcGISContext.prototype, "portal", {
+            /**
+             * Returns the portal object as IPortal
+             */
             get: function () {
                 return this._portalSelf;
             },
@@ -11093,26 +11101,206 @@
         });
         return ArcGISContext;
     }());
+
     /**
-     * Cross-walk from a portalUrl to the corresponding Hub.
+     * The manager exposes context (`IArcGISContext`), which combines a `UserSession` with
+     * the `portal/self` and `user/self` responses to provide a central lookup for platform
+     * information, api urls, and other useful properties for developers such as IRequestOptions
+     * IUserRequestOptions, IHubRequestOptions etc.
+     *
+     * The context is exposed on gthe `.context` property, and as the authentication changes
+     * the `.context` is re-created. This is done to allow web frameworks to watch for
+     * changes on that single property, instead of having to leverage observers or events
+     * for change detection.
+     *
+     * Please see the [ArcGISContext Guide](/hub.js/guides/context) for additional information.
      *
-     * If the passed url is not recognized, then this will return `undefined`
-     * @param portalUrl
-     * @returns
      */
-    function getHubApiFromPortalUrl(portalUrl) {
-        var result;
-        if (portalUrl.match(/(qaext|\.mapsqa)\.arcgis.com/)) {
-            result = "https://hubqa.arcgis.com";
-        }
-        else if (portalUrl.match(/(devext|\.mapsdevext)\.arcgis.com/)) {
-            result = "https://hubdev.arcgis.com";
-        }
-        else if (portalUrl.match(/(www|\.maps)\.arcgis.com/)) {
-            result = "https://hub.arcgis.com";
+    var ArcGISContextManager = /** @class */ (function () {
+        /**
+         * Private constructor. Use `ArcGISContextManager.create(...)` to
+         * instantiate an instance
+         * @param opts
+         */
+        function ArcGISContextManager(opts) {
+            this._portalUrl = "https://www.arcgis.com";
+            this._logLevel = exports.Level.error;
+            // Having a unique id makes debugging easier
+            this.id = new Date().getTime();
+            if (opts.logLevel) {
+                this._logLevel = opts.logLevel;
+            }
+            Logger.setLogLevel(this._logLevel);
+            Logger.debug("ArcGISContextManager:ctor: Creating " + this.id);
+            if (opts.authentication) {
+                this._authentication = opts.authentication;
+                this._portalUrl = this._authentication.portal.replace("/sharing/rest", "");
+                this._hubUrl = getHubApiFromPortalUrl(this._portalUrl);
+            }
+            else if (opts.portalUrl) {
+                this._portalUrl = opts.portalUrl;
+                this._hubUrl = getHubApiFromPortalUrl(this._portalUrl);
+            }
+            else {
+                this._hubUrl = getHubApiFromPortalUrl(this._portalUrl);
+            }
+            if (opts.portal) {
+                this._portalSelf = cloneObject$1(opts.portal);
+            }
+            if (opts.currentUser) {
+                this._currentUser = cloneObject$1(opts.currentUser);
+            }
         }
-        return result;
-    }
+        /**
+         * Used to create a new instance of the ArcGISContext class.
+         *
+         * ```js
+         * const ctxMgr = await ArcGISContextManager.create();
+         * ```
+         *
+         * @param opts
+         * @returns
+         */
+        ArcGISContextManager.create = function (opts) {
+            if (opts === void 0) { opts = {}; }
+            return __awaiter(this, void 0, void 0, function () {
+                var ctx;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            ctx = new ArcGISContextManager(opts);
+                            return [4 /*yield*/, ctx.initialize()];
+                        case 1:
+                            _a.sent();
+                            return [2 /*return*/, ctx];
+                    }
+                });
+            });
+        };
+        /**
+         * Set the Authentication (UserSession) for the context.
+         * This should be called when a user signs into a running
+         * application.
+         * @param auth
+         */
+        ArcGISContextManager.prototype.setAuthentication = function (auth) {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            this._authentication = auth;
+                            this._portalUrl = auth.portal.replace("/sharing/rest", "");
+                            return [4 /*yield*/, this.initialize()];
+                        case 1:
+                            _a.sent();
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        };
+        /**
+         * Clear the Authentication (UserSession). This should be
+         * called when a user signs out of an application, but
+         * the application continues running
+         */
+        ArcGISContextManager.prototype.clearAuthentication = function () {
+            // Reset the portalUrl from the org url to the base url
+            // for ArcGIS Enterprise, we just leave the _portalUrl as-is
+            if (!this._context.isPortal) {
+                this._portalUrl = getPortalBaseFromOrgUrl(this._portalUrl);
+            }
+            // Clear the auth, portalSelf and currentUser props
+            this._authentication = null;
+            this._portalSelf = null;
+            this._currentUser = null;
+            this._context = new ArcGISContext({
+                id: this.id,
+                portalUrl: this._portalUrl,
+                hubUrl: this._hubUrl,
+            });
+        };
+        Object.defineProperty(ArcGISContextManager.prototype, "context", {
+            /**
+             * Return a reference to the current state.
+             * When `.setAuthentication()` or `.clearAuthenentication()` are
+             * called, the state will be re-created. This is done so frameworks
+             * like React or Ember can detect changes.
+             */
+            get: function () {
+                return this._context;
+            },
+            enumerable: false,
+            configurable: true
+        });
+        /**
+         * If we have a UserSession, fetch portal/self and
+         * store that along with current user
+         */
+        ArcGISContextManager.prototype.initialize = function () {
+            return __awaiter(this, void 0, void 0, function () {
+                var username, requests, _a, portal, user, ex_1, msg;
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0:
+                            if (!(this._authentication && (!this._portalSelf || !this._currentUser))) return [3 /*break*/, 4];
+                            Logger.debug("ArcGISContextManager-" + this.id + ": Initializing");
+                            username = this._authentication.username;
+                            requests = [
+                                getSelf({ authentication: this._authentication }),
+                                getUser({ username: username, authentication: this._authentication }),
+                            ];
+                            _b.label = 1;
+                        case 1:
+                            _b.trys.push([1, 3, , 4]);
+                            return [4 /*yield*/, Promise.all(requests)];
+                        case 2:
+                            _a = _b.sent(), portal = _a[0], user = _a[1];
+                            this._portalSelf = portal;
+                            this._currentUser = user;
+                            Logger.debug("ArcGISContextManager-" + this.id + ": received portalSelf and currentUser");
+                            return [3 /*break*/, 4];
+                        case 3:
+                            ex_1 = _b.sent();
+                            msg = "ArcGISContextManager could not fetch portal & user for \"" + this._authentication.username + "\" using " + this._authentication.portal + ".";
+                            Logger.error(msg);
+                            // tslint:disable-next-line:no-console
+                            console.error(msg);
+                            throw ex_1;
+                        case 4:
+                            Logger.debug("ArcGISContextManager-" + this.id + ": updating context");
+                            // update the context
+                            this._context = new ArcGISContext(this.contextOpts);
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        };
+        Object.defineProperty(ArcGISContextManager.prototype, "contextOpts", {
+            /**
+             * Getter to streamline the creation of updated Context instances
+             */
+            get: function () {
+                var contextOpts = {
+                    id: this.id,
+                    portalUrl: this._portalUrl,
+                    hubUrl: this._hubUrl,
+                };
+                if (this._authentication) {
+                    contextOpts.authentication = this._authentication;
+                }
+                if (this._portalSelf) {
+                    contextOpts.portalSelf = this._portalSelf;
+                }
+                if (this._currentUser) {
+                    contextOpts.currentUser = this._currentUser;
+                }
+                return contextOpts;
+            },
+            enumerable: false,
+            configurable: true
+        });
+        return ArcGISContextManager;
+    }());
 
     /* Copyright (c) 2018-2020 Environmental Systems Research Institute, Inc.
      * Apache-2.0 */
@@ -11374,6 +11562,7 @@
     }
 
     exports.ArcGISContext = ArcGISContext;
+    exports.ArcGISContextManager = ArcGISContextManager;
     exports.GLOBAL_EXTENT = GLOBAL_EXTENT;
     exports.HUB_CDN_URLMAP = HUB_CDN_URLMAP;
     exports.HUB_LOCALES = HUB_LOCALES;
@@ -11502,6 +11691,7 @@
     exports.getFamily = getFamily;
     exports.getGeographicOrgExtent = getGeographicOrgExtent;
     exports.getGroupThumbnailUrl = getGroupThumbnailUrl;
+    exports.getHubApiFromPortalUrl = getHubApiFromPortalUrl;
     exports.getHubApiUrl = getHubApiUrl;
     exports.getHubApiUrlFromPortal = getHubApiUrlFromPortal;
     exports.getHubLocaleAssetUrl = getHubLocaleAssetUrl;
@@ -11522,6 +11712,7 @@
     exports.getNextFunction = getNextFunction;
     exports.getOrgExtentAsBBox = getOrgExtentAsBBox;
     exports.getPortalApiUrl = getPortalApiUrl;
+    exports.getPortalBaseFromOrgUrl = getPortalBaseFromOrgUrl;
     exports.getPortalUrl = getPortalUrl;
     exports.getProp = getProp;
     exports.getProps = getProps;