@esri/hub-common 9.13.2 → 9.14.0

package/dist/node/search/_searchGroups.js

@@ -14,25 +14,20 @@ const __1 = require("..");
  * @returns
  */
 async function _searchGroups(filter, options) {
-    var _a;
     // expand filter so we can serialize to either api
     const expanded = group_utils_1.expandGroupFilter(filter);
     // API
     const api = _1.expandApi(options.api || "arcgis");
     if (api.type === "arcgis") {
         const so = group_utils_1.serializeGroupFilterForPortal(expanded);
-        let token = "";
         // if we have auth, pass it forward
         // otherwise set the portal property
         if (options.authentication) {
             so.authentication = options.authentication;
-            const us = options.authentication;
-            token = us.token;
         }
         else {
             so.portal = `${api.url}/sharing/rest`;
         }
-        // TODO: Dry this up - typscript makes this... inconvenient
         if (options.num) {
             so.num = options.num;
         }
@@ -42,10 +37,6 @@ async function _searchGroups(filter, options) {
         if (options.sortOrder) {
             so.sortOrder = options.sortOrder;
         }
-        let portalUrl = `${api.url}/sharing/rest`;
-        if ((_a = so.authentication) === null || _a === void 0 ? void 0 : _a.portal) {
-            portalUrl = so.authentication.portal;
-        }
         if (options.site) {
             so.site = __1.cloneObject(options.site);
         }
@@ -67,8 +58,7 @@ function searchPortalGroups(searchOptions) {
         group.siteTeamUrl = `${searchOptions.site.item.url}/teams/${group.id}/about`;
         return group;
     };
-    const portalUrl = ((_a = searchOptions.authentication) === null || _a === void 0 ? void 0 : _a.portal) ||
-        "https://www.arcgis.com/sharing/rest";
+    const portalUrl = ((_a = searchOptions.authentication) === null || _a === void 0 ? void 0 : _a.portal) || searchOptions.portal;
     let token;
     if (searchOptions.authentication) {
         const us = searchOptions.authentication;

package/dist/node/search/_searchGroups.js.map

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

package/dist/node/search/utils.js

@@ -366,7 +366,7 @@ exports.getNextFunction = getNextFunction;
  * 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

package/dist/node/urls/getHubApiFromPortalUrl.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHubApiFromPortalUrl = void 0;
+function getHubApiFromPortalUrl(portalUrl) {
+    let 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;
+}
+exports.getHubApiFromPortalUrl = getHubApiFromPortalUrl;
+//# sourceMappingURL=getHubApiFromPortalUrl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getHubApiFromPortalUrl.js","sourceRoot":"","sources":["../../../src/urls/getHubApiFromPortalUrl.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,SAAgB,sBAAsB,CAAC,SAAiB;IACtD,IAAI,MAAM,CAAC;IAEX,IAAI,SAAS,CAAC,KAAK,CAAC,8BAA8B,CAAC,EAAE;QACnD,MAAM,GAAG,0BAA0B,CAAC;KACrC;SAAM,IAAI,SAAS,CAAC,KAAK,CAAC,mCAAmC,CAAC,EAAE;QAC/D,MAAM,GAAG,2BAA2B,CAAC;KACtC;SAAM,IAAI,SAAS,CAAC,KAAK,CAAC,0BAA0B,CAAC,EAAE;QACtD,MAAM,GAAG,wBAAwB,CAAC;KACnC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAZD,wDAYC"}

package/dist/node/urls/getPortalBaseFromOrgUrl.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPortalBaseFromOrgUrl = void 0;
+/**
+ * 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) {
+    let 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;
+}
+exports.getPortalBaseFromOrgUrl = getPortalBaseFromOrgUrl;
+//# sourceMappingURL=getPortalBaseFromOrgUrl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getPortalBaseFromOrgUrl.js","sourceRoot":"","sources":["../../../src/urls/getPortalBaseFromOrgUrl.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CAAC,MAAc;IACpD,IAAI,MAAM,GAAG,MAAM,CAAC;IAEpB,IAAI,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,EAAE;QAChD,MAAM,GAAG,0BAA0B,CAAC;KACrC;SAAM,IAAI,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,EAAE;QAC5D,MAAM,GAAG,2BAA2B,CAAC;KACtC;SAAM;QACL,0BAA0B;QAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,EAAE;YAC5C,MAAM,GAAG,wBAAwB,CAAC;SACnC;KACF;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAfD,0DAeC"}

package/dist/node/urls/index.js

@@ -18,6 +18,8 @@ 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);
 tslib_1.__exportStar(require("./convert-urls-to-anchor-tags"), exports);
+tslib_1.__exportStar(require("./getHubApiFromPortalUrl"), exports);
+tslib_1.__exportStar(require("./getPortalBaseFromOrgUrl"), exports);
 const MAP_OR_FEATURE_SERVER_URL_REGEX = /\/(map|feature)server/i;
 /**
  *

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

@@ -1 +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;AACpC,wEAA8C;AAE9C,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"}
+{"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;AACpC,wEAA8C;AAC9C,mEAAyC;AACzC,oEAA0C;AAE1C,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/types/ArcGISContext.d.ts

@@ -1,110 +1,136 @@
+import { IUser, IUserRequestOptions, UserSession } from "@esri/arcgis-rest-auth";
 import { IPortal } from "@esri/arcgis-rest-portal";
-import { IUser, UserSession } from "@esri/arcgis-rest-auth";
-import { IArcGISContextState } from "./ArcGISContextState";
+import { IRequestOptions } from "@esri/arcgis-rest-request";
+import { IHubRequestOptions } from ".";
 /**
- * Options that can be passed into `ArcGISContext.create`
+ * Defines the properties of the ArcGISContext.
+ * Typically components or functions will get an instance
+ * of `ArcGISContext` from `ArcGISContetManager`.
+ *
+ * `ArcGISContext` implements this interface, and uses
+ * getters to simplify the derivation of various complex properties.
+ *
+ */
+export interface IArcGISContext {
+    id: number;
+    session: UserSession;
+    isAuthenticated: boolean;
+    userRequestOptions: IUserRequestOptions;
+    requestOptions: IRequestOptions;
+    hubRequestOptions: IHubRequestOptions;
+    portalUrl: string;
+    sharingApiUrl: string;
+    hubUrl: string;
+    isPortal: boolean;
+    discussionsServiceUrl: string;
+    hubSearchServiceUrl: string;
+    domainServiceUrl: string;
+    eventsConfig: any;
+    hubEnabled: boolean;
+    communityOrgId: string;
+    communityOrgHostname: string;
+    communityOrgUrl: string;
+    helperServices: any;
+    currentUser: IUser;
+    portal: IPortal;
+}
+/**
+ * @internal
  */
 export interface IArcGISContextOptions {
-    /**
-     * Existing user session, which may be created from Identity Manager
-     * `const session = UserSession.fromCredential(idMgr.getCredential());`
-     */
+    id: number;
+    portalUrl: string;
+    hubUrl: string;
     authentication?: UserSession;
-    /**
-     * ArcGIS Online or ArcGIS Enterprise portal url.
-     * Do not include  `/sharing/rest`
-     * Defaults to `https://www.arcgis.com`
-     * For ArcGIS Enterprise, you must include the webadaptor name.
-     * i.e. https://gis.mytown.gov/portal
-     *
-     * When Authentication is present, the UserSession.portal value is
-     * used instead of this property.
-     */
-    portalUrl?: string;
-    /**
-     * Portal self for the authenticated user. If not passed into `.create`
-     * with the UserSession, it will be fetched
-     */
-    portal?: IPortal;
-    /**
-     * Current user as `IUser`. If not passed into `.create` with the UserSession
-     * it will be fetched.
-     */
+    portalSelf?: IPortal;
     currentUser?: IUser;
-    /**
-     * If set to `true` additional logging will be sent to the console
-     * Defaults to false.
-     */
-    debug?: boolean;
 }
 /**
- * Application Context Object
+ * ArcGISContext
  *
- * 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
  *
- * This is a work-in-progress, and will likely expand over time.
+ * Thin class just used to enable getters
  *
- * `ArcGISContext` is used in conjuction with the `arcgis-app-identity`
- * component to orchestrate oAuth.
+ * This class should not be used by anything other than
+ * the ArcGISContextManager class
  */
-export declare class ArcGISContext {
-    /**
-     * Random identifier useful for debugging issues
-     * where race-conditions can result in multiple
-     * contexts getting created
-     */
+export declare class ArcGISContext implements IArcGISContext {
     id: number;
-    private _state;
     private _authentication;
     private _portalUrl;
     private _hubUrl;
     private _portalSelf;
     private _currentUser;
-    private _debug;
+    constructor(opts: IArcGISContextOptions);
+    /**
+     * Return the UserSession if authenticated
+     */
+    get session(): UserSession;
     /**
-     * Private constructor. Use `ArcGISContext.create(...)` to
-     * instantiate an instance
-     * @param opts
+     * Return boolean indicating if authenticatio is present
      */
-    private constructor();
+    get isAuthenticated(): boolean;
     /**
-     * Static async Factory
-     * @param opts
-     * @returns
+     * Return `IUserRequestOptions`, which is used for REST-JS
+     * functions which require authentication information.
+     *
+     * If context is not authenticated, this function will throw
      */
-    static create(opts?: IArcGISContextOptions): Promise<ArcGISContext>;
+    get userRequestOptions(): IUserRequestOptions;
     /**
-     * Set the Authentication (UserSession) for the context.
-     * This should be called when a user signs into a running
-     * application.
-     * @param auth
+     * Return `IRequestOptions`, which is used by REST-JS functions
+     * which *may* use authentication information if provided.
+     *
+     * If context is not authenticated, this function just returns
+     * the `portal` property, which informs REST-JS what Sharing API
+     * instance to use (i.e. AGO, Enterprise etc)
+     */
+    get requestOptions(): IRequestOptions;
+    /**
+     * Return a `IHubRequestOptions` object
+     */
+    get hubRequestOptions(): IHubRequestOptions;
+    /**
+     * Return the portal url.
+     *
+     * 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
      */
-    setAuthentication(auth: UserSession): Promise<void>;
+    get portalUrl(): string;
     /**
-     * Clear the Authentication (UserSession). This should be
-     * called when a user signs out of an application, but
-     * the application continues running
+     * Returns the url to the sharing api
+     * i.e. https://myorg.maps.arcgis.com/sharing/rest
      */
-    clearAuthentication(): void;
+    get sharingApiUrl(): string;
+    get hubUrl(): string;
     /**
-     * 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.
+     * Returns boolean indicating if the backing system
+     * is ArcGIS Enterprise (formerly ArcGIS Portal) or not
      */
-    get state(): IArcGISContextState;
+    get isPortal(): boolean;
+    get discussionsServiceUrl(): string;
+    get hubSearchServiceUrl(): string;
+    get domainServiceUrl(): string;
+    get eventsConfig(): any;
     /**
-     * @internal
-     * Log debugging messages to the console
-     * @param message
+     * Returns boolean indicating if the current user
+     * belongs to an organization that has licensed
+     * ArcGIS Hub
      */
-    private log;
+    get hubEnabled(): boolean;
     /**
-     * If we have a UserSession, fetch portal/self and
-     * store that along with current user
+     * Return Hub Community Org Id, if defined
      */
-    private initialize;
-    private get stateOpts();
+    get communityOrgId(): string;
+    get communityOrgHostname(): string;
+    get communityOrgUrl(): string;
+    get helperServices(): any;
+    get currentUser(): IUser;
+    get portal(): IPortal;
 }

package/dist/types/ArcGISContextManager.d.ts

@@ -0,0 +1,113 @@
+import { IPortal } from "@esri/arcgis-rest-portal";
+import { IUser, UserSession } from "@esri/arcgis-rest-auth";
+import { IArcGISContext } from "./ArcGISContext";
+import { Level } from ".";
+/**
+ * Options that can be passed into `ArcGISContextManager.create`
+ */
+export interface IArcGISContextManagerOptions {
+    /**
+     * Existing user session, which may be created from Identity Manager
+     * `const session = UserSession.fromCredential(idMgr.getCredential());`
+     */
+    authentication?: UserSession;
+    /**
+     * ArcGIS Online or ArcGIS Enterprise portal url.
+     * Do not include  `/sharing/rest`
+     * Defaults to `https://www.arcgis.com`
+     * For ArcGIS Enterprise, you must include the webadaptor name.
+     * i.e. https://gis.mytown.gov/portal
+     *
+     * When Authentication is present, the UserSession.portal value is
+     * used instead of this property.
+     */
+    portalUrl?: string;
+    /**
+     * Portal self for the authenticated user. If not passed into `.create`
+     * with the UserSession, it will be fetched
+     */
+    portal?: IPortal;
+    /**
+     * Current user as `IUser`. If not passed into `.create` with the UserSession
+     * it will be fetched.
+     */
+    currentUser?: IUser;
+    /**
+     * Logging level
+     * off > error > warn > info > debug > all
+     * defaults to 'error'
+     */
+    logLevel?: Level;
+}
+/**
+ * ArcGIS Context Manager
+ *
+ * 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.
+ *
+ * This is a work-in-progress, and will likely expand over time.
+ *
+ */
+export declare class ArcGISContextManager {
+    /**
+     * Random identifier useful for debugging issues
+     * where race-conditions can result in multiple
+     * contexts getting created
+     */
+    id: number;
+    private _context;
+    private _authentication;
+    private _portalUrl;
+    private _hubUrl;
+    private _portalSelf;
+    private _currentUser;
+    private _logLevel;
+    /**
+     * Private constructor. Use `ArcGISContextManager.create(...)` to
+     * instantiate an instance
+     * @param opts
+     */
+    private constructor();
+    /**
+     * Static async Factory
+     * @param opts
+     * @returns
+     */
+    static create(opts?: IArcGISContextManagerOptions): Promise<ArcGISContextManager>;
+    /**
+     * Set the Authentication (UserSession) for the context.
+     * This should be called when a user signs into a running
+     * application.
+     * @param auth
+     */
+    setAuthentication(auth: UserSession): Promise<void>;
+    /**
+     * Clear the Authentication (UserSession). This should be
+     * called when a user signs out of an application, but
+     * the application continues running
+     */
+    clearAuthentication(): void;
+    /**
+     * 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 context(): IArcGISContext;
+    /**
+     * If we have a UserSession, fetch portal/self and
+     * store that along with current user
+     */
+    private initialize;
+    /**
+     * Getter to streamline the creation of updated Context instances
+     */
+    private get contextOpts();
+}

package/dist/types/index.d.ts

@@ -18,6 +18,7 @@ export * from "./utils";
 export * from "./i18n";
 export * from "./request";
 export * from "./surveys";
+export * from "./ArcGISContextManager";
 export * from "./ArcGISContext";
 import OperationStack from "./OperationStack";
 import OperationError from "./OperationError";

package/dist/types/search/utils.d.ts

@@ -104,7 +104,7 @@ export declare function getNextFunction<T>(request: ISearchOptions, nextStart: n
  * 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

package/dist/types/urls/getHubApiFromPortalUrl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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
+ */
+export declare function getHubApiFromPortalUrl(portalUrl: string): string;

package/dist/types/urls/getPortalBaseFromOrgUrl.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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
+ */
+export declare function getPortalBaseFromOrgUrl(orgUrl: string): string;

package/dist/types/urls/index.d.ts

@@ -13,6 +13,8 @@ export * from "./get-item-home-url";
 export * from "./get-item-api-url";
 export * from "./get-item-data-url";
 export * from "./convert-urls-to-anchor-tags";
+export * from "./getHubApiFromPortalUrl";
+export * from "./getPortalBaseFromOrgUrl";
 /**
  *
  * @param url