@esri/hub-common 9.35.0 → 9.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (239) hide show
  1. package/dist/es2017/content/HubContent.js +68 -0
  2. package/dist/es2017/content/HubContent.js.map +1 -0
  3. package/dist/es2017/content/_internal.js +13 -17
  4. package/dist/es2017/content/_internal.js.map +1 -1
  5. package/dist/es2017/content/compose.js +6 -6
  6. package/dist/es2017/content/compose.js.map +1 -1
  7. package/dist/es2017/content/index.js +1 -0
  8. package/dist/es2017/content/index.js.map +1 -1
  9. package/dist/es2017/extent.js +41 -13
  10. package/dist/es2017/extent.js.map +1 -1
  11. package/dist/es2017/groups/HubGroups.js +63 -0
  12. package/dist/es2017/groups/HubGroups.js.map +1 -0
  13. package/dist/es2017/groups/_internal/enrichments.js +99 -0
  14. package/dist/es2017/groups/_internal/enrichments.js.map +1 -0
  15. package/dist/es2017/groups/index.js +2 -0
  16. package/dist/es2017/groups/index.js.map +1 -1
  17. package/dist/es2017/groups/types/IGroupMembershipSummary.js +1 -0
  18. package/dist/es2017/groups/types/IGroupMembershipSummary.js.map +1 -0
  19. package/dist/es2017/groups/types/index.js +2 -0
  20. package/dist/es2017/groups/types/index.js.map +1 -0
  21. package/dist/es2017/index.js +1 -0
  22. package/dist/es2017/index.js.map +1 -1
  23. package/dist/es2017/items/_enrichments.js +9 -1
  24. package/dist/es2017/items/_enrichments.js.map +1 -1
  25. package/dist/es2017/items/create-item-from-url-or-file.js +16 -4
  26. package/dist/es2017/items/create-item-from-url-or-file.js.map +1 -1
  27. package/dist/es2017/pages/HubPages.js +61 -0
  28. package/dist/es2017/pages/HubPages.js.map +1 -0
  29. package/dist/es2017/pages/index.js +2 -0
  30. package/dist/es2017/pages/index.js.map +1 -0
  31. package/dist/es2017/projects/HubProjects.js +56 -1
  32. package/dist/es2017/projects/HubProjects.js.map +1 -1
  33. package/dist/es2017/search/_internal/hubSearchItems.js +191 -0
  34. package/dist/es2017/search/_internal/hubSearchItems.js.map +1 -0
  35. package/dist/es2017/search/_internal/index.js +3 -0
  36. package/dist/es2017/search/_internal/index.js.map +1 -1
  37. package/dist/es2017/search/_internal/parseInclude.js +27 -0
  38. package/dist/es2017/search/_internal/parseInclude.js.map +1 -0
  39. package/dist/es2017/search/_internal/portalSearchGroups.js +100 -0
  40. package/dist/es2017/search/_internal/portalSearchGroups.js.map +1 -0
  41. package/dist/es2017/search/_internal/portalSearchItems.js +109 -0
  42. package/dist/es2017/search/_internal/portalSearchItems.js.map +1 -0
  43. package/dist/es2017/search/_searchContent.js +3 -0
  44. package/dist/es2017/search/_searchContent.js.map +1 -1
  45. package/dist/es2017/search/_searchGroups.js +3 -1
  46. package/dist/es2017/search/_searchGroups.js.map +1 -1
  47. package/dist/es2017/search/_searchUsers.js +3 -1
  48. package/dist/es2017/search/_searchUsers.js.map +1 -1
  49. package/dist/es2017/search/content-utils.js +36 -4
  50. package/dist/es2017/search/content-utils.js.map +1 -1
  51. package/dist/es2017/search/filter-utils.js +18 -3
  52. package/dist/es2017/search/filter-utils.js.map +1 -1
  53. package/dist/es2017/search/group-utils.js +8 -1
  54. package/dist/es2017/search/group-utils.js.map +1 -1
  55. package/dist/es2017/search/hubSearch.js +48 -0
  56. package/dist/es2017/search/hubSearch.js.map +1 -0
  57. package/dist/es2017/search/index.js +1 -0
  58. package/dist/es2017/search/index.js.map +1 -1
  59. package/dist/es2017/search/user-utils.js +8 -1
  60. package/dist/es2017/search/user-utils.js.map +1 -1
  61. package/dist/es2017/search/utils.js +5 -0
  62. package/dist/es2017/search/utils.js.map +1 -1
  63. package/dist/es2017/sites/HubSites.js +55 -1
  64. package/dist/es2017/sites/HubSites.js.map +1 -1
  65. package/dist/es2017/types.js.map +1 -1
  66. package/dist/es2017/urls/getGroupHomeUrl.js +12 -0
  67. package/dist/es2017/urls/getGroupHomeUrl.js.map +1 -0
  68. package/dist/es2017/urls/index.js +1 -0
  69. package/dist/es2017/urls/index.js.map +1 -1
  70. package/dist/esm/content/HubContent.js +75 -0
  71. package/dist/esm/content/HubContent.js.map +1 -0
  72. package/dist/esm/content/_internal.js +13 -17
  73. package/dist/esm/content/_internal.js.map +1 -1
  74. package/dist/esm/content/compose.js +6 -6
  75. package/dist/esm/content/compose.js.map +1 -1
  76. package/dist/esm/content/index.js +1 -0
  77. package/dist/esm/content/index.js.map +1 -1
  78. package/dist/esm/extent.js +41 -13
  79. package/dist/esm/extent.js.map +1 -1
  80. package/dist/esm/groups/HubGroups.js +70 -0
  81. package/dist/esm/groups/HubGroups.js.map +1 -0
  82. package/dist/esm/groups/_internal/enrichments.js +100 -0
  83. package/dist/esm/groups/_internal/enrichments.js.map +1 -0
  84. package/dist/esm/groups/index.js +2 -0
  85. package/dist/esm/groups/index.js.map +1 -1
  86. package/dist/esm/groups/types/IGroupMembershipSummary.js +1 -0
  87. package/dist/esm/groups/types/IGroupMembershipSummary.js.map +1 -0
  88. package/dist/esm/groups/types/index.js +2 -0
  89. package/dist/esm/groups/types/index.js.map +1 -0
  90. package/dist/esm/index.js +1 -0
  91. package/dist/esm/index.js.map +1 -1
  92. package/dist/esm/items/_enrichments.js +9 -1
  93. package/dist/esm/items/_enrichments.js.map +1 -1
  94. package/dist/esm/items/create-item-from-url-or-file.js +15 -5
  95. package/dist/esm/items/create-item-from-url-or-file.js.map +1 -1
  96. package/dist/esm/pages/HubPages.js +68 -0
  97. package/dist/esm/pages/HubPages.js.map +1 -0
  98. package/dist/esm/pages/index.js +2 -0
  99. package/dist/esm/pages/index.js.map +1 -0
  100. package/dist/esm/projects/HubProjects.js +63 -2
  101. package/dist/esm/projects/HubProjects.js.map +1 -1
  102. package/dist/esm/search/_internal/hubSearchItems.js +204 -0
  103. package/dist/esm/search/_internal/hubSearchItems.js.map +1 -0
  104. package/dist/esm/search/_internal/index.js +3 -0
  105. package/dist/esm/search/_internal/index.js.map +1 -1
  106. package/dist/esm/search/_internal/parseInclude.js +27 -0
  107. package/dist/esm/search/_internal/parseInclude.js.map +1 -0
  108. package/dist/esm/search/_internal/portalSearchGroups.js +114 -0
  109. package/dist/esm/search/_internal/portalSearchGroups.js.map +1 -0
  110. package/dist/esm/search/_internal/portalSearchItems.js +123 -0
  111. package/dist/esm/search/_internal/portalSearchItems.js.map +1 -0
  112. package/dist/esm/search/_searchContent.js +3 -0
  113. package/dist/esm/search/_searchContent.js.map +1 -1
  114. package/dist/esm/search/_searchGroups.js +3 -1
  115. package/dist/esm/search/_searchGroups.js.map +1 -1
  116. package/dist/esm/search/_searchUsers.js +3 -1
  117. package/dist/esm/search/_searchUsers.js.map +1 -1
  118. package/dist/esm/search/content-utils.js +38 -4
  119. package/dist/esm/search/content-utils.js.map +1 -1
  120. package/dist/esm/search/filter-utils.js +16 -3
  121. package/dist/esm/search/filter-utils.js.map +1 -1
  122. package/dist/esm/search/group-utils.js +8 -1
  123. package/dist/esm/search/group-utils.js.map +1 -1
  124. package/dist/esm/search/hubSearch.js +52 -0
  125. package/dist/esm/search/hubSearch.js.map +1 -0
  126. package/dist/esm/search/index.js +1 -0
  127. package/dist/esm/search/index.js.map +1 -1
  128. package/dist/esm/search/user-utils.js +8 -1
  129. package/dist/esm/search/user-utils.js.map +1 -1
  130. package/dist/esm/search/utils.js +5 -0
  131. package/dist/esm/search/utils.js.map +1 -1
  132. package/dist/esm/sites/HubSites.js +62 -2
  133. package/dist/esm/sites/HubSites.js.map +1 -1
  134. package/dist/esm/types.js.map +1 -1
  135. package/dist/esm/urls/getGroupHomeUrl.js +12 -0
  136. package/dist/esm/urls/getGroupHomeUrl.js.map +1 -0
  137. package/dist/esm/urls/index.js +1 -0
  138. package/dist/esm/urls/index.js.map +1 -1
  139. package/dist/node/content/HubContent.js +72 -0
  140. package/dist/node/content/HubContent.js.map +1 -0
  141. package/dist/node/content/_internal.js +12 -16
  142. package/dist/node/content/_internal.js.map +1 -1
  143. package/dist/node/content/compose.js +6 -6
  144. package/dist/node/content/compose.js.map +1 -1
  145. package/dist/node/content/index.js +1 -0
  146. package/dist/node/content/index.js.map +1 -1
  147. package/dist/node/extent.js +42 -14
  148. package/dist/node/extent.js.map +1 -1
  149. package/dist/node/groups/HubGroups.js +67 -0
  150. package/dist/node/groups/HubGroups.js.map +1 -0
  151. package/dist/node/groups/_internal/enrichments.js +103 -0
  152. package/dist/node/groups/_internal/enrichments.js.map +1 -0
  153. package/dist/node/groups/index.js +2 -0
  154. package/dist/node/groups/index.js.map +1 -1
  155. package/dist/node/groups/types/IGroupMembershipSummary.js +3 -0
  156. package/dist/node/groups/types/IGroupMembershipSummary.js.map +1 -0
  157. package/dist/node/groups/types/index.js +5 -0
  158. package/dist/node/groups/types/index.js.map +1 -0
  159. package/dist/node/index.js +1 -0
  160. package/dist/node/index.js.map +1 -1
  161. package/dist/node/items/_enrichments.js +9 -1
  162. package/dist/node/items/_enrichments.js.map +1 -1
  163. package/dist/node/items/create-item-from-url-or-file.js +16 -4
  164. package/dist/node/items/create-item-from-url-or-file.js.map +1 -1
  165. package/dist/node/pages/HubPages.js +65 -0
  166. package/dist/node/pages/HubPages.js.map +1 -0
  167. package/dist/node/pages/index.js +5 -0
  168. package/dist/node/pages/index.js.map +1 -0
  169. package/dist/node/projects/HubProjects.js +57 -1
  170. package/dist/node/projects/HubProjects.js.map +1 -1
  171. package/dist/node/search/_internal/hubSearchItems.js +198 -0
  172. package/dist/node/search/_internal/hubSearchItems.js.map +1 -0
  173. package/dist/node/search/_internal/index.js +3 -0
  174. package/dist/node/search/_internal/index.js.map +1 -1
  175. package/dist/node/search/_internal/parseInclude.js +31 -0
  176. package/dist/node/search/_internal/parseInclude.js.map +1 -0
  177. package/dist/node/search/_internal/portalSearchGroups.js +104 -0
  178. package/dist/node/search/_internal/portalSearchGroups.js.map +1 -0
  179. package/dist/node/search/_internal/portalSearchItems.js +113 -0
  180. package/dist/node/search/_internal/portalSearchItems.js.map +1 -0
  181. package/dist/node/search/_searchContent.js +3 -0
  182. package/dist/node/search/_searchContent.js.map +1 -1
  183. package/dist/node/search/_searchGroups.js +2 -0
  184. package/dist/node/search/_searchGroups.js.map +1 -1
  185. package/dist/node/search/_searchUsers.js +2 -0
  186. package/dist/node/search/_searchUsers.js.map +1 -1
  187. package/dist/node/search/content-utils.js +38 -5
  188. package/dist/node/search/content-utils.js.map +1 -1
  189. package/dist/node/search/filter-utils.js +18 -3
  190. package/dist/node/search/filter-utils.js.map +1 -1
  191. package/dist/node/search/group-utils.js +7 -0
  192. package/dist/node/search/group-utils.js.map +1 -1
  193. package/dist/node/search/hubSearch.js +52 -0
  194. package/dist/node/search/hubSearch.js.map +1 -0
  195. package/dist/node/search/index.js +1 -0
  196. package/dist/node/search/index.js.map +1 -1
  197. package/dist/node/search/user-utils.js +7 -0
  198. package/dist/node/search/user-utils.js.map +1 -1
  199. package/dist/node/search/utils.js +5 -0
  200. package/dist/node/search/utils.js.map +1 -1
  201. package/dist/node/sites/HubSites.js +56 -1
  202. package/dist/node/sites/HubSites.js.map +1 -1
  203. package/dist/node/types.js.map +1 -1
  204. package/dist/node/urls/getGroupHomeUrl.js +16 -0
  205. package/dist/node/urls/getGroupHomeUrl.js.map +1 -0
  206. package/dist/node/urls/index.js +1 -0
  207. package/dist/node/urls/index.js.map +1 -1
  208. package/dist/types/content/HubContent.d.ts +11 -0
  209. package/dist/types/content/index.d.ts +1 -0
  210. package/dist/types/extent.d.ts +22 -4
  211. package/dist/types/groups/HubGroups.d.ts +11 -0
  212. package/dist/types/groups/_internal/enrichments.d.ts +30 -0
  213. package/dist/types/groups/index.d.ts +2 -0
  214. package/dist/types/groups/types/IGroupMembershipSummary.d.ts +15 -0
  215. package/dist/types/groups/types/index.d.ts +1 -0
  216. package/dist/types/index.d.ts +1 -0
  217. package/dist/types/items/create-item-from-url-or-file.d.ts +13 -3
  218. package/dist/types/pages/HubPages.d.ts +11 -0
  219. package/dist/types/pages/index.d.ts +1 -0
  220. package/dist/types/projects/HubProjects.d.ts +10 -1
  221. package/dist/types/search/_internal/hubSearchItems.d.ts +18 -0
  222. package/dist/types/search/_internal/index.d.ts +3 -0
  223. package/dist/types/search/_internal/parseInclude.d.ts +32 -0
  224. package/dist/types/search/_internal/portalSearchGroups.d.ts +9 -0
  225. package/dist/types/search/_internal/portalSearchItems.d.ts +9 -0
  226. package/dist/types/search/content-utils.d.ts +9 -1
  227. package/dist/types/search/hubSearch.d.ts +11 -0
  228. package/dist/types/search/index.d.ts +1 -0
  229. package/dist/types/search/types/ICollection.d.ts +8 -0
  230. package/dist/types/search/types/IHubSearchOptions.d.ts +46 -5
  231. package/dist/types/search/types/IHubSearchResult.d.ts +46 -2
  232. package/dist/types/search/types/types.d.ts +13 -15
  233. package/dist/types/sites/HubSites.d.ts +9 -1
  234. package/dist/types/types.d.ts +12 -2
  235. package/dist/types/urls/getGroupHomeUrl.d.ts +10 -0
  236. package/dist/types/urls/index.d.ts +1 -0
  237. package/dist/umd/common.umd.js +8083 -7020
  238. package/dist/umd/common.umd.js.map +1 -1
  239. package/package.json +1 -1
@@ -6,8 +6,7 @@ import { IFacet } from "./IFacet";
6
6
  *
7
7
  * `Filter<T extends FilterType>` [FilterType](../FilterType) is constrained to
8
8
  *
9
- * - `Filter<"any">` [IAnyFilterDefinition](../IAnyFilterDefinition)
10
- * - `Filter<"content">` [IContentFilterDefinition](../IContentFilterDefinition)
9
+ * - `Filter<"item">` [IContentFilterDefinition](../IContentFilterDefinition)
11
10
  * - `Filter<"user">` [IUserFilterDefinition](../IUserFilterDefinition)
12
11
  * - `Filter<"group">` [IGroupFilterDefinition](../IGroupFilterDefinition)
13
12
  *
@@ -15,8 +14,8 @@ import { IFacet } from "./IFacet";
15
14
  * and it must be `keyof` [FilterTypeMap](../FilterTypeMap)
16
15
  *
17
16
  * ```ts
18
- * const f:Filter<"content"> = {
19
- * filterType: "content" // must match the FilterType
17
+ * const f:Filter<"item"> = {
18
+ * filterType: "item" // must match the FilterType
20
19
  * term: "water"
21
20
  * }
22
21
  * ```
@@ -24,15 +23,12 @@ import { IFacet } from "./IFacet";
24
23
  export declare type Filter<T extends FilterType> = IFilterTypeMap[T] & {
25
24
  filterType: T;
26
25
  };
27
- export interface IFilterGroup<T extends FilterType> {
28
- operation?: "AND" | "OR";
29
- filters: Array<Filter<T>>;
30
- }
31
26
  /**
32
27
  * Groups of filters with an operation specifying how the
33
28
  * filters should be connected when serialized
34
29
  */
35
30
  export interface IFilterGroup<T extends FilterType> {
31
+ filterType: T;
36
32
  operation?: "AND" | "OR";
37
33
  filters: Array<Filter<T>>;
38
34
  }
@@ -42,23 +38,21 @@ export interface IFilterGroup<T extends FilterType> {
42
38
  */
43
39
  export interface IFilterTypeMap {
44
40
  item: IItemFilter;
41
+ user: IUserFilterDefinition;
42
+ group: IGroupFilterDefinition;
43
+ event: IEventFilterDefinition;
45
44
  /**
46
45
  * DEPRECATED use item
46
+ * // TODO: Remove with _searchContent
47
47
  */
48
48
  content: IContentFilterDefinition;
49
- user: IUserFilterDefinition;
50
- group: IGroupFilterDefinition;
51
- event: IEventFilterDefinition;
52
49
  }
53
50
  export declare type FilterType = keyof IFilterTypeMap;
54
- /**
55
- * Common set of fields that are reasonable to apply at the
56
- * top level of a Catalog
57
- */
58
51
  export interface IItemFilter {
59
52
  access?: AccessLevel | AccessLevel[] | IMatchOptions;
60
53
  owner?: string | string[] | IMatchOptions;
61
54
  tags?: string | string[] | IMatchOptions;
55
+ categories?: string | string[] | IMatchOptions;
62
56
  created?: IDateRange<number> | IRelativeDate;
63
57
  description?: string | string[] | IMatchOptions;
64
58
  snippet?: string | string[] | IMatchOptions;
@@ -74,11 +68,13 @@ export interface IItemFilter {
74
68
  }
75
69
  /**
76
70
  * Fields related to Content based searches
71
+ * // TODO: Remove with _searchContent
77
72
  */
78
73
  export interface IContentFilterDefinition {
79
74
  access?: string | string[] | IMatchOptions;
80
75
  owner?: string | string[] | IMatchOptions;
81
76
  tags?: string | string[] | IMatchOptions;
77
+ categories?: string | string[] | IMatchOptions;
82
78
  created?: IDateRange<number> | IRelativeDate;
83
79
  description?: string | string[] | IMatchOptions;
84
80
  snippet?: string | string[] | IMatchOptions;
@@ -153,6 +149,7 @@ export interface IGroupFilterDefinition {
153
149
  term?: string;
154
150
  title?: string | string[] | IMatchOptions;
155
151
  typekeywords?: string | string[] | IMatchOptions;
152
+ isopendata?: boolean;
156
153
  }
157
154
  export interface IEventFilterDefinition {
158
155
  created?: IDateRange<number> | IRelativeDate;
@@ -216,6 +213,7 @@ export interface IMatchOptions {
216
213
  }
217
214
  /**
218
215
  * searchContent return
216
+ * // TODO: Remove with _searchContent
219
217
  */
220
218
  export interface IContentSearchResult {
221
219
  total: number;
@@ -1,5 +1,5 @@
1
1
  import { IItem } from "@esri/arcgis-rest-portal";
2
- import { Filter, IHubRequestOptions, IHubSearchOptions, IHubSite, ISearchResponse } from "..";
2
+ import { Filter, IHubRequestOptions, IHubSearchOptions, IHubSearchResult, IHubSite, ISearchResponse } from "..";
3
3
  import { IRequestOptions } from "@esri/arcgis-rest-request";
4
4
  export declare const HUB_SITE_ITEM_TYPE = "Hub Site Application";
5
5
  export declare const ENTERPRISE_SITE_ITEM_TYPE = "Site Application";
@@ -54,3 +54,11 @@ export declare function convertItemToSite(item: IItem, requestOptions: IRequestO
54
54
  * @returns
55
55
  */
56
56
  export declare function searchSites(filter: Filter<"content">, options: IHubSearchOptions): Promise<ISearchResponse<IHubSite>>;
57
+ /**
58
+ * Fetch Site specific enrichments
59
+ * @param item
60
+ * @param include
61
+ * @param requestOptions
62
+ * @returns
63
+ */
64
+ export declare function enrichSiteSearchResult(item: IItem, include: string[], requestOptions: IHubRequestOptions): Promise<IHubSearchResult>;
@@ -1,4 +1,4 @@
1
- import { IItem, IUser, IGroup, IGeometry } from "@esri/arcgis-rest-types";
1
+ import { IItem, IUser, IGroup, IPolygon, ISpatialReference, IGeometry } from "@esri/arcgis-rest-types";
2
2
  import { IPortal, ISearchResult } from "@esri/arcgis-rest-portal";
3
3
  import { UserSession } from "@esri/arcgis-rest-auth";
4
4
  import { IRequestOptions } from "@esri/arcgis-rest-request";
@@ -144,6 +144,15 @@ export declare type Visibility = "private" | "org" | "public";
144
144
  */
145
145
  export declare type AccessControl = "view" | "edit" | "admin";
146
146
  export declare type GeographyProvenance = "item" | "none" | "automatic";
147
+ /**
148
+ * properties to be used with the ArcGIS API geometry class constructors
149
+ */
150
+ export interface IGeometryProperties extends IGeometry {
151
+ type: string;
152
+ }
153
+ export interface IPolygonProperties extends IPolygon, IGeometryProperties {
154
+ type: "polygon";
155
+ }
147
156
  /**
148
157
  * Location of a Hub resource
149
158
  *
@@ -152,8 +161,9 @@ export declare type GeographyProvenance = "item" | "none" | "automatic";
152
161
  */
153
162
  export interface IHubGeography {
154
163
  center?: [number, number];
155
- geometry?: IGeometry;
164
+ geometry?: IPolygonProperties;
156
165
  provenance?: GeographyProvenance;
166
+ spatialReference?: ISpatialReference;
157
167
  }
158
168
  export declare type SearchableType = IItem | IGroup | IUser;
159
169
  export declare type SearchFunction = (...args: any[]) => Promise<ISearchResult<SearchableType>>;
@@ -0,0 +1,10 @@
1
+ import { IRequestOptions } from "@esri/arcgis-rest-request";
2
+ import { IPortal } from "@esri/arcgis-rest-portal";
3
+ import { IHubRequestOptions } from "../types";
4
+ /**
5
+ * Return the URL of the group's page in the Portal Home application
6
+ * @param groupId The group's ID
7
+ * @param portalUrlOrObject a portal base or API URL, a portal object, or request options containing either of those
8
+ * @returns URL to the groups's url, defaults to `https://www.arcgis.com/home/group.html?id={group.id}`
9
+ */
10
+ export declare function getGroupHomeUrl(groupId: string, portalUrlOrObject?: string | IPortal | IHubRequestOptions | IRequestOptions): string;
@@ -15,6 +15,7 @@ export * from "./get-item-data-url";
15
15
  export * from "./convert-urls-to-anchor-tags";
16
16
  export * from "./getHubApiFromPortalUrl";
17
17
  export * from "./getPortalBaseFromOrgUrl";
18
+ export * from "./getGroupHomeUrl";
18
19
  /**
19
20
  *
20
21
  * @param url