@esri/hub-common 9.24.2 → 9.25.0

package/dist/types/sites/HubSiteManager.d.ts

@@ -0,0 +1,104 @@
+import { IUserRequestOptions } from "@esri/arcgis-rest-auth";
+import { IArcGISContext } from "../ArcGISContext";
+import { IHubEntityManager, IHubItemEntityManager, IHubSite } from "../core/types";
+import { ArcGISContextManager } from "../ArcGISContextManager";
+import { Filter, IHubSearchOptions } from "../search";
+import { IHubRequestOptions, ISearchResponse } from "../types";
+import { IItem } from "@esri/arcgis-rest-types";
+import { IRequestOptions } from "@esri/arcgis-rest-request";
+export declare class HubSiteManager implements IHubEntityManager<IHubSite>, IHubItemEntityManager<IHubSite> {
+    /**
+     * Hold a context manager, which should be a single instance for
+     * an application. When authentication changes, the .context
+     * property on the context manager will be replaced. As long as
+     * all the fns in this class leverage properties on .context
+     * everything be kept in sync.
+     */
+    private _contextManager;
+    /**
+     * Hold context directly. Allows the class to be used in places
+     * where an `ArcGISContextManager` is not directly available, but
+     * an `IArcGISContext` is
+     */
+    private _context;
+    /**
+     * Private so we can employ a factory function should we need
+     * async work during creation
+     * @param contextOrManager
+     */
+    private constructor();
+    /**
+     * Factory function to construct a new HubProjectManager instance.
+     *
+     * Note: Used so that we could do async actions in the ctor.
+     * @param contextOrManager
+     * @returns
+     */
+    static init(contextOrManager: ArcGISContextManager | IArcGISContext): HubSiteManager;
+    /**
+     * Getter to abstract how we store the context
+     */
+    private get context();
+    /**
+     * Create and store a new Site
+     *
+     * This also registers the item for oAuth and
+     * registers domain names with the hub Domain system
+     *
+     * Sites are stored as Items in the Sharing API
+     * @param site
+     * @param requestOptions
+     * @returns
+     */
+    create(site: Partial<IHubSite>, requestOptions?: IHubRequestOptions): Promise<IHubSite>;
+    /**
+     * Update a Site
+     * @param site
+     * @param requestOptions
+     * @returns
+     */
+    update(site: IHubSite, requestOptions?: IHubRequestOptions): Promise<IHubSite>;
+    /**
+     * Destroy a Site
+     * This permanently removes the backing Item,
+     * and clears the domain entries for it.
+     * @param id
+     * @param requestOptions
+     * @returns
+     */
+    destroy(id: string, requestOptions?: IHubRequestOptions): Promise<void>;
+    /**
+     * Fetch a Site via Id, slug or domain
+     *
+     * This function does not require a user to be
+     * authenticated, but it does require an `IRequestOptions`
+     * which contains the portal instance to communicate with
+     * @param identifier
+     * @param requestOptions
+     * @returns
+     */
+    fetch(identifier: string, requestOptions?: IHubRequestOptions): Promise<IHubSite>;
+    /**
+     * Search for Sites
+     *
+     * @param filter
+     * @param opts
+     */
+    search(filter: Filter<"content">, options: IHubSearchOptions): Promise<ISearchResponse<IHubSite>>;
+    /**
+     * Set the thumbnail for the Site
+     * @param id
+     * @param file
+     * @param filename
+     * @param requestOptions
+     * @returns
+     */
+    updateThumbnail(site: IHubSite, file: any, filename: string, requestOptions?: IUserRequestOptions): Promise<IHubSite>;
+    /**
+     * Convert a Hub Project Item to a IHubProject
+     * @param item
+     * @param requestOptions
+     * @returns
+     */
+    fromItem(item: IItem, requestOptions?: IRequestOptions): Promise<IHubSite>;
+}

package/dist/types/sites/HubSites.d.ts

@@ -0,0 +1,56 @@
+import { IItem } from "@esri/arcgis-rest-portal";
+import { Filter, IHubRequestOptions, IHubSearchOptions, IHubSite, ISearchResponse } from "..";
+import { IRequestOptions } from "@esri/arcgis-rest-request";
+export declare const HUB_SITE_ITEM_TYPE = "Hub Site Application";
+export declare const ENTERPRISE_SITE_ITEM_TYPE = "Site Application";
+/**
+ * Create a new Hub Site
+ *
+ * Minimum properties are `name` and `org`
+ * @param partialSite
+ * @param requestOptions
+ */
+export declare function createSite(partialSite: Partial<IHubSite>, requestOptions: IHubRequestOptions): Promise<IHubSite>;
+/**
+ * Update a Hub Site
+ *
+ * This checks for and applies domain changes
+ * @param site
+ * @param requestOptions
+ * @returns
+ */
+export declare function updateSite(site: IHubSite, requestOptions: IHubRequestOptions): Promise<IHubSite>;
+/**
+ * Remove a Hub Site
+ *
+ * This simply removes the Site item, and it's associated domain records.
+ * This does not remove any Teams/Groups or content associated with the
+ * Site
+ * @param id
+ * @param requestOptions
+ * @returns
+ */
+export declare function destroySite(id: string, requestOptions: IHubRequestOptions): Promise<void>;
+/**
+ * Returns site model given various kinds of identifier
+ *
+ * @param identifier - a site item ID, site hostname, enterprise site slug, or full site URL
+ * @param requestOptions
+ * @private // remove when we remove existing fetchSite function
+ */
+export declare function _fetchSite(identifier: string, requestOptions: IHubRequestOptions): Promise<IHubSite>;
+/**
+ * Convert a Hub Site Application item into a Hub Site, fetching any
+ * additional information that may be required
+ * @param item
+ * @param auth
+ * @returns
+ */
+export declare function convertItemToSite(item: IItem, requestOptions: IRequestOptions): Promise<IHubSite>;
+/**
+ * Search for Sites and get IHubSite results
+ * @param filter
+ * @param options
+ * @returns
+ */
+export declare function searchSites(filter: Filter<"content">, options: IHubSearchOptions): Promise<ISearchResponse<IHubSite>>;

package/dist/types/sites/{_apply-site-schema.d.ts → _internal/_apply-site-schema.d.ts}

@@ -1,4 +1,4 @@
-import { IModel } from "../types";
+import { IModel } from "../../types";
 /**
  * Apply the first schema version to the item
  * @param {Object} model Site Model

package/dist/types/sites/{_enforce-lowercase-domains.d.ts → _internal/_enforce-lowercase-domains.d.ts}

@@ -1,4 +1,4 @@
-import { IModel } from "..";
+import { IModel } from "../..";
 /**
  * Enforce lowercase domains
  * @param {Object} model Site Model

package/dist/types/sites/{_ensure-catalog.d.ts → _internal/_ensure-catalog.d.ts}

@@ -1,4 +1,4 @@
-import { IModel } from "..";
+import { IModel } from "../..";
 /**
  * Move the data.values.groups array into the
  * data.catalog object

package/dist/types/sites/{_ensure-telemetry.d.ts → _internal/_ensure-telemetry.d.ts}

@@ -1,4 +1,4 @@
-import { IModel, IDraft } from "..";
+import { IModel, IDraft } from "../..";
 /**
  * Add telemetry config object
  * @private

package/dist/types/sites/{_migrate-feed-config.d.ts → _internal/_migrate-feed-config.d.ts}

@@ -1,4 +1,4 @@
-import { IModel } from "..";
+import { IModel } from "../..";
 /**
  * Migrates the site so it can store configurations for multiple feed formats
  * (dcat-us-1.1, dcat-ap-2.0.1, etc.). If the site has an existing custom

package/dist/types/sites/{_purge-non-guids-from-catalog.d.ts → _internal/_purge-non-guids-from-catalog.d.ts}

@@ -1,4 +1,4 @@
-import { IModel } from "..";
+import { IModel } from "../..";
 /**
  * Remove any non-guid entries from the data catalog groups array
  * @param {object} model Site Model

package/dist/types/sites/_internal/handleDomainChanges.d.ts

@@ -0,0 +1,9 @@
+import { IHubRequestOptions, IModel } from "../..";
+/**
+ * Given two site models, determine the domain changes and apply them
+ * @param currentModel
+ * @param updatedModel
+ * @param requestOptions
+ * @private
+ */
+export declare function handleDomainChanges(updatedModel: IModel, currentModel: IModel, requestOptions: IHubRequestOptions): Promise<any[]>;

package/dist/types/sites/_internal/index.d.ts

@@ -0,0 +1 @@
+export * from "./handleDomainChanges";

package/dist/types/sites/domains/addSiteDomains.d.ts

@@ -0,0 +1,11 @@
+import { IHubRequestOptions, IModel } from "../..";
+/**
+ * Given a Site Model, register the domains with the Domain Service.
+ *
+ * This should only be used when creating a site. To update domains related
+ * to a site, use the `addDomain` and `removeDomain` functions directly
+ *
+ * @param {Object} model site model
+ * @param {IHubRequestOptions} hubRequestOptions
+ */
+export declare function addSiteDomains(model: IModel, hubRequestOptions: IHubRequestOptions): Promise<any[]>;

package/dist/types/sites/domains/index.d.ts

@@ -17,3 +17,5 @@ export * from "./remove-domains-by-site-id";
 export * from "./update-domain";
 export * from "./_ensure-safe-domain-length";
 export * from "./ensure-unique-domain-name";
+export * from "./addSiteDomains";
+export * from "./removeDomainByHostname";

package/dist/types/sites/domains/removeDomainByHostname.d.ts

@@ -0,0 +1,10 @@
+import { IHubRequestOptions } from "../../types";
+/**
+ * Remove an entry from the domain service, based on a hostname
+ *
+ * Callers must ensure the user is a member of the org that
+ * owns the domain entry else the call will fail.
+ * @param hostname
+ * @param hubRequestOptions
+ */
+export declare function removeDomainByHostname(hostname: string, hubRequestOptions: IHubRequestOptions): Promise<void>;

package/dist/types/sites/fetchSiteModel.d.ts

@@ -0,0 +1,12 @@
+import { IHubRequestOptions, IModel } from "..";
+/**
+ * Returns site model given various kinds of identifier
+ *
+ * @param identifier - a site item ID, site hostname, enterprise site slug, or full site URL
+ * @param hubRequestOptions
+ */
+export declare function fetchSiteModel(identifier: string, hubRequestOptions: IHubRequestOptions): Promise<IModel>;
+/**
+ * @private // keep out of docs
+ */
+export declare function fetchSite(identifier: string, hubRequestOptions: IHubRequestOptions): Promise<IModel>;

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

@@ -1,14 +1,11 @@
-import { IHubRequestOptions } from "../types";
-/**
- * Returns site model given various kinds of identifier
- *
- * @param identifier - a site item ID, site hostname, enterprise site slug, or full site URL
- * @param hubRequestOptions
- */
-export declare function fetchSite(identifier: string, hubRequestOptions: IHubRequestOptions): Promise<import("../types").IModel>;
+export * from "./_internal/_ensure-telemetry";
 export * from "./domains";
 export * from "./drafts";
-export * from "./_ensure-telemetry";
+export * from "./fetchSiteModel";
 export * from "./get-site-by-id";
+export * from "./HubSiteManager";
+export * from "./HubSites";
+export * from "./registerSiteAsApplication";
 export * from "./site-schema-version";
+export * from "./themes";
 export * from "./upgrade-site-schema";

package/dist/types/sites/registerSiteAsApplication.d.ts

@@ -0,0 +1,8 @@
+import { IHubRequestOptions, IModel } from "..";
+/**
+ * Register the Site item as an application so we can oauth against it
+ * @param {string} siteId Item Id of the site
+ * @param {Array} uris Arrayf valid uris for the site
+ * @param {IHubRequestOptions} hubRequestOptions
+ */
+export declare function registerSiteAsApplication(model: IModel, hubRequestOptions: IHubRequestOptions): Promise<any>;

package/dist/types/sites/themes.d.ts

@@ -0,0 +1,11 @@
+import { IPortal } from "@esri/arcgis-rest-portal";
+import { IHubSiteTheme } from "..";
+/**
+ * Default Site Theme
+ */
+export declare const DEFAULT_THEME: IHubSiteTheme;
+/**
+ * Return the default theme, extended with values from the Org's shared theme
+ * @param {Object} portalSelf Org's Portal object
+ */
+export declare function getOrgDefaultTheme(portalSelf: IPortal): IHubSiteTheme;