@esri/hub-common 12.3.2 → 12.4.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 (118) hide show
  1. package/dist/esm/content/get-family.js +4 -0
  2. package/dist/esm/content/get-family.js.map +1 -1
  3. package/dist/esm/core/schemas/hubproject.js +99 -72
  4. package/dist/esm/core/schemas/hubproject.js.map +1 -1
  5. package/dist/esm/projects/_internal/getPropertyMap.js +5 -3
  6. package/dist/esm/projects/_internal/getPropertyMap.js.map +1 -1
  7. package/dist/esm/projects/defaults.js +13 -8
  8. package/dist/esm/projects/defaults.js.map +1 -1
  9. package/dist/esm/projects/edit.js +2 -2
  10. package/dist/esm/projects/edit.js.map +1 -1
  11. package/dist/esm/resources/index.js +2 -0
  12. package/dist/esm/resources/index.js.map +1 -1
  13. package/dist/esm/resources/removeResource.js +34 -0
  14. package/dist/esm/resources/removeResource.js.map +1 -0
  15. package/dist/esm/resources/upsertResource.js +65 -0
  16. package/dist/esm/resources/upsertResource.js.map +1 -0
  17. package/dist/esm/search/_internal/hubSearchItems.js +8 -48
  18. package/dist/esm/search/_internal/hubSearchItems.js.map +1 -1
  19. package/dist/esm/search/_internal/hubSearchItemsHelpers/formatOgcAggregationsResponse.js +20 -0
  20. package/dist/esm/search/_internal/hubSearchItemsHelpers/formatOgcAggregationsResponse.js.map +1 -0
  21. package/dist/esm/search/_internal/hubSearchItemsHelpers/formatOgcItemsResponse.js +14 -0
  22. package/dist/esm/search/_internal/hubSearchItemsHelpers/formatOgcItemsResponse.js.map +1 -0
  23. package/dist/esm/search/_internal/hubSearchItemsHelpers/getFilterQueryParam.js +98 -0
  24. package/dist/esm/search/_internal/hubSearchItemsHelpers/getFilterQueryParam.js.map +1 -0
  25. package/dist/esm/search/_internal/hubSearchItemsHelpers/getNextOgcCallback.js +15 -0
  26. package/dist/esm/search/_internal/hubSearchItemsHelpers/getNextOgcCallback.js.map +1 -0
  27. package/dist/esm/search/_internal/hubSearchItemsHelpers/getOgcAggregationQueryParams.js +9 -0
  28. package/dist/esm/search/_internal/hubSearchItemsHelpers/getOgcAggregationQueryParams.js.map +1 -0
  29. package/dist/esm/search/_internal/hubSearchItemsHelpers/getOgcItemQueryParams.js +13 -0
  30. package/dist/esm/search/_internal/hubSearchItemsHelpers/getOgcItemQueryParams.js.map +1 -0
  31. package/dist/esm/search/_internal/hubSearchItemsHelpers/getQQueryParam.js +35 -0
  32. package/dist/esm/search/_internal/hubSearchItemsHelpers/getQQueryParam.js.map +1 -0
  33. package/dist/esm/search/_internal/hubSearchItemsHelpers/getQueryString.js +8 -0
  34. package/dist/esm/search/_internal/hubSearchItemsHelpers/getQueryString.js.map +1 -0
  35. package/dist/esm/search/_internal/hubSearchItemsHelpers/interfaces.js +1 -0
  36. package/dist/esm/search/_internal/hubSearchItemsHelpers/interfaces.js.map +1 -0
  37. package/dist/esm/search/_internal/hubSearchItemsHelpers/ogcApiRequest.js +14 -0
  38. package/dist/esm/search/_internal/hubSearchItemsHelpers/ogcApiRequest.js.map +1 -0
  39. package/dist/esm/search/_internal/hubSearchItemsHelpers/ogcItemToSearchResult.js +9 -0
  40. package/dist/esm/search/_internal/hubSearchItemsHelpers/ogcItemToSearchResult.js.map +1 -0
  41. package/dist/esm/search/_internal/hubSearchItemsHelpers/searchOgcAggregations.js +11 -0
  42. package/dist/esm/search/_internal/hubSearchItemsHelpers/searchOgcAggregations.js.map +1 -0
  43. package/dist/esm/search/_internal/hubSearchItemsHelpers/searchOgcItems.js +11 -0
  44. package/dist/esm/search/_internal/hubSearchItemsHelpers/searchOgcItems.js.map +1 -0
  45. package/dist/esm/search/_internal/portalSearchItems.js +1 -1
  46. package/dist/esm/search/_internal/portalSearchItems.js.map +1 -1
  47. package/dist/esm/urls/build-url.js +1 -1
  48. package/dist/esm/urls/build-url.js.map +1 -1
  49. package/dist/node/content/get-family.js +4 -0
  50. package/dist/node/content/get-family.js.map +1 -1
  51. package/dist/node/core/schemas/hubproject.js +99 -72
  52. package/dist/node/core/schemas/hubproject.js.map +1 -1
  53. package/dist/node/projects/_internal/getPropertyMap.js +5 -3
  54. package/dist/node/projects/_internal/getPropertyMap.js.map +1 -1
  55. package/dist/node/projects/defaults.js +13 -8
  56. package/dist/node/projects/defaults.js.map +1 -1
  57. package/dist/node/projects/edit.js +2 -2
  58. package/dist/node/projects/edit.js.map +1 -1
  59. package/dist/node/resources/index.js +2 -0
  60. package/dist/node/resources/index.js.map +1 -1
  61. package/dist/node/resources/removeResource.js +38 -0
  62. package/dist/node/resources/removeResource.js.map +1 -0
  63. package/dist/node/resources/upsertResource.js +69 -0
  64. package/dist/node/resources/upsertResource.js.map +1 -0
  65. package/dist/node/search/_internal/hubSearchItems.js +9 -51
  66. package/dist/node/search/_internal/hubSearchItems.js.map +1 -1
  67. package/dist/node/search/_internal/hubSearchItemsHelpers/formatOgcAggregationsResponse.js +24 -0
  68. package/dist/node/search/_internal/hubSearchItemsHelpers/formatOgcAggregationsResponse.js.map +1 -0
  69. package/dist/node/search/_internal/hubSearchItemsHelpers/formatOgcItemsResponse.js +18 -0
  70. package/dist/node/search/_internal/hubSearchItemsHelpers/formatOgcItemsResponse.js.map +1 -0
  71. package/dist/node/search/_internal/hubSearchItemsHelpers/getFilterQueryParam.js +104 -0
  72. package/dist/node/search/_internal/hubSearchItemsHelpers/getFilterQueryParam.js.map +1 -0
  73. package/dist/node/search/_internal/hubSearchItemsHelpers/getNextOgcCallback.js +19 -0
  74. package/dist/node/search/_internal/hubSearchItemsHelpers/getNextOgcCallback.js.map +1 -0
  75. package/dist/node/search/_internal/hubSearchItemsHelpers/getOgcAggregationQueryParams.js +13 -0
  76. package/dist/node/search/_internal/hubSearchItemsHelpers/getOgcAggregationQueryParams.js.map +1 -0
  77. package/dist/node/search/_internal/hubSearchItemsHelpers/getOgcItemQueryParams.js +17 -0
  78. package/dist/node/search/_internal/hubSearchItemsHelpers/getOgcItemQueryParams.js.map +1 -0
  79. package/dist/node/search/_internal/hubSearchItemsHelpers/getQQueryParam.js +40 -0
  80. package/dist/node/search/_internal/hubSearchItemsHelpers/getQQueryParam.js.map +1 -0
  81. package/dist/node/search/_internal/hubSearchItemsHelpers/getQueryString.js +12 -0
  82. package/dist/node/search/_internal/hubSearchItemsHelpers/getQueryString.js.map +1 -0
  83. package/dist/node/search/_internal/hubSearchItemsHelpers/interfaces.js +3 -0
  84. package/dist/node/search/_internal/hubSearchItemsHelpers/interfaces.js.map +1 -0
  85. package/dist/node/search/_internal/hubSearchItemsHelpers/ogcApiRequest.js +18 -0
  86. package/dist/node/search/_internal/hubSearchItemsHelpers/ogcApiRequest.js.map +1 -0
  87. package/dist/node/search/_internal/hubSearchItemsHelpers/ogcItemToSearchResult.js +13 -0
  88. package/dist/node/search/_internal/hubSearchItemsHelpers/ogcItemToSearchResult.js.map +1 -0
  89. package/dist/node/search/_internal/hubSearchItemsHelpers/searchOgcAggregations.js +15 -0
  90. package/dist/node/search/_internal/hubSearchItemsHelpers/searchOgcAggregations.js.map +1 -0
  91. package/dist/node/search/_internal/hubSearchItemsHelpers/searchOgcItems.js +15 -0
  92. package/dist/node/search/_internal/hubSearchItemsHelpers/searchOgcItems.js.map +1 -0
  93. package/dist/node/search/_internal/portalSearchItems.js +2 -1
  94. package/dist/node/search/_internal/portalSearchItems.js.map +1 -1
  95. package/dist/node/urls/build-url.js +1 -1
  96. package/dist/node/urls/build-url.js.map +1 -1
  97. package/dist/types/core/traits/IWithViewSettings.d.ts +18 -5
  98. package/dist/types/resources/index.d.ts +2 -0
  99. package/dist/types/resources/removeResource.d.ts +16 -0
  100. package/dist/types/resources/upsertResource.d.ts +15 -0
  101. package/dist/types/search/_internal/hubSearchItems.d.ts +0 -9
  102. package/dist/types/search/_internal/hubSearchItemsHelpers/formatOgcAggregationsResponse.d.ts +4 -0
  103. package/dist/types/search/_internal/hubSearchItemsHelpers/formatOgcItemsResponse.d.ts +6 -0
  104. package/dist/types/search/_internal/hubSearchItemsHelpers/getFilterQueryParam.d.ts +4 -0
  105. package/dist/types/search/_internal/hubSearchItemsHelpers/getNextOgcCallback.d.ts +6 -0
  106. package/dist/types/search/_internal/hubSearchItemsHelpers/getOgcAggregationQueryParams.d.ts +6 -0
  107. package/dist/types/search/_internal/hubSearchItemsHelpers/getOgcItemQueryParams.d.ts +9 -0
  108. package/dist/types/search/_internal/hubSearchItemsHelpers/getQQueryParam.d.ts +3 -0
  109. package/dist/types/search/_internal/hubSearchItemsHelpers/getQueryString.d.ts +1 -0
  110. package/dist/types/search/_internal/hubSearchItemsHelpers/interfaces.d.ts +37 -0
  111. package/dist/types/search/_internal/hubSearchItemsHelpers/ogcApiRequest.d.ts +2 -0
  112. package/dist/types/search/_internal/hubSearchItemsHelpers/ogcItemToSearchResult.d.ts +4 -0
  113. package/dist/types/search/_internal/hubSearchItemsHelpers/searchOgcAggregations.d.ts +5 -0
  114. package/dist/types/search/_internal/hubSearchItemsHelpers/searchOgcItems.d.ts +5 -0
  115. package/dist/types/search/_internal/portalSearchItems.d.ts +11 -0
  116. package/dist/types/search/types/IHubSearchOptions.d.ts +4 -0
  117. package/dist/types/urls/build-url.d.ts +2 -3
  118. package/package.json +1 -1
@@ -1,4 +1,3 @@
1
- import { IHubContent } from "../../core";
2
1
  import { IHubSearchOptions, IHubSearchResponse, IHubSearchResult, IQuery } from "../types";
3
2
  /**
4
3
  * @private
@@ -8,11 +7,3 @@ import { IHubSearchOptions, IHubSearchResponse, IHubSearchResult, IQuery } from
8
7
  * @returns
9
8
  */
10
9
  export declare function hubSearchItems(query: IQuery, options: IHubSearchOptions): Promise<IHubSearchResponse<IHubSearchResult>>;
11
- /**
12
- * Re-structure a jsonApi data entry into a flat object cast into
13
- * IHubContent
14
- * @param data
15
- * @returns
16
- */
17
- export declare function jsonApiToHubContent(data: Record<string, any>): IHubContent;
18
- export declare function hubContentToSearchResult(content: IHubContent): Promise<IHubSearchResult>;
@@ -0,0 +1,4 @@
1
+ import { IHubSearchResponse } from "../../types/IHubSearchResponse";
2
+ import { IHubSearchResult } from "../../types/IHubSearchResult";
3
+ import { IOgcAggregationsResponse } from "./interfaces";
4
+ export declare function formatOgcAggregationsResponse(response: IOgcAggregationsResponse): IHubSearchResponse<IHubSearchResult>;
@@ -0,0 +1,6 @@
1
+ import { IQuery } from "../../types/IHubCatalog";
2
+ import { IHubSearchOptions } from "../../types/IHubSearchOptions";
3
+ import { IHubSearchResponse } from "../../types/IHubSearchResponse";
4
+ import { IHubSearchResult } from "../../types/IHubSearchResult";
5
+ import { IOgcItemsResponse } from "./interfaces";
6
+ export declare function formatOgcItemsResponse(response: IOgcItemsResponse, originalQuery: IQuery, originalOptions: IHubSearchOptions): Promise<IHubSearchResponse<IHubSearchResult>>;
@@ -0,0 +1,4 @@
1
+ import { IFilter, IPredicate, IQuery } from "../../types/IHubCatalog";
2
+ export declare function getFilterQueryParam(query: IQuery): string;
3
+ export declare function formatFilterBlock(filter: IFilter): string;
4
+ export declare function formatPredicate(predicate: IPredicate): string;
@@ -0,0 +1,6 @@
1
+ import { IQuery } from "../../types/IHubCatalog";
2
+ import { IHubSearchOptions } from "../../types/IHubSearchOptions";
3
+ import { IHubSearchResponse } from "../../types/IHubSearchResponse";
4
+ import { IHubSearchResult } from "../../types/IHubSearchResult";
5
+ import { IOgcItemsResponse } from "./interfaces";
6
+ export declare function getNextOgcCallback(response: IOgcItemsResponse, originalQuery: IQuery, originalOptions: IHubSearchOptions): (params?: any) => Promise<IHubSearchResponse<IHubSearchResult>>;
@@ -0,0 +1,6 @@
1
+ import { IQuery } from "../../types/IHubCatalog";
2
+ import { IHubSearchOptions } from "../../types/IHubSearchOptions";
3
+ export declare function getOgcAggregationQueryParams(_query: IQuery, options: IHubSearchOptions): {
4
+ aggregations: string;
5
+ token: any;
6
+ };
@@ -0,0 +1,9 @@
1
+ import { IQuery } from "../../types/IHubCatalog";
2
+ import { IHubSearchOptions } from "../../types/IHubSearchOptions";
3
+ export declare function getOgcItemQueryParams(query: IQuery, options: IHubSearchOptions): {
4
+ filter: string;
5
+ token: any;
6
+ limit: number;
7
+ startindex: number;
8
+ q: any;
9
+ };
@@ -0,0 +1,3 @@
1
+ import { IFilter, IQuery } from "../../types/IHubCatalog";
2
+ export declare function getQQueryParam(query: IQuery): any;
3
+ export declare function getQPredicate(filters: IFilter[]): import("../../types/IHubCatalog").IPredicate;
@@ -0,0 +1 @@
1
+ export declare function getQueryString(queryParams: Record<string, any>): string;
@@ -0,0 +1,37 @@
1
+ export interface IOgcItem {
2
+ id: string;
3
+ type: "Feature";
4
+ geometry: any;
5
+ time: any;
6
+ links: any[];
7
+ properties: Record<string, any>;
8
+ }
9
+ interface IOgcLink {
10
+ rel: "self" | "next" | "prev" | "collection";
11
+ type: string;
12
+ title: string;
13
+ href: string;
14
+ }
15
+ export interface IOgcItemsResponse {
16
+ type: "FeatureCollection";
17
+ features: IOgcItem[];
18
+ timestamp: string;
19
+ numberMatched: number;
20
+ numberReturned: number;
21
+ links: IOgcLink[];
22
+ }
23
+ interface IOgcItemFieldAggregation {
24
+ field: string;
25
+ aggregations: Array<{
26
+ label: string;
27
+ value: any;
28
+ }>;
29
+ }
30
+ export interface IOgcAggregationsResponse {
31
+ aggregations: {
32
+ aggregations: IOgcItemFieldAggregation[];
33
+ };
34
+ timestamp: string;
35
+ links: IOgcLink[];
36
+ }
37
+ export {};
@@ -0,0 +1,2 @@
1
+ import { IHubSearchOptions } from "../../types/IHubSearchOptions";
2
+ export declare function ogcApiRequest(url: string, queryParams: Record<string, any>, options: IHubSearchOptions): Promise<any>;
@@ -0,0 +1,4 @@
1
+ import { IHubRequestOptions } from "../../../types";
2
+ import { IHubSearchResult } from "../../types/IHubSearchResult";
3
+ import { IOgcItem } from "./interfaces";
4
+ export declare function ogcItemToSearchResult(ogcItem: IOgcItem, includes?: string[], requestOptions?: IHubRequestOptions): Promise<IHubSearchResult>;
@@ -0,0 +1,5 @@
1
+ import { IQuery } from "../../types/IHubCatalog";
2
+ import { IHubSearchOptions } from "../../types/IHubSearchOptions";
3
+ import { IHubSearchResponse } from "../../types/IHubSearchResponse";
4
+ import { IHubSearchResult } from "../../types/IHubSearchResult";
5
+ export declare function searchOgcAggregations(query: IQuery, options: IHubSearchOptions): Promise<IHubSearchResponse<IHubSearchResult>>;
@@ -0,0 +1,5 @@
1
+ import { IQuery } from "../../types/IHubCatalog";
2
+ import { IHubSearchOptions } from "../../types/IHubSearchOptions";
3
+ import { IHubSearchResponse } from "../../types/IHubSearchResponse";
4
+ import { IHubSearchResult } from "../../types/IHubSearchResult";
5
+ export declare function searchOgcItems(query: IQuery, options: IHubSearchOptions): Promise<IHubSearchResponse<IHubSearchResult>>;
@@ -1,3 +1,5 @@
1
+ import { IItem } from "@esri/arcgis-rest-portal";
2
+ import { IHubRequestOptions } from "../../types";
1
3
  import { IHubSearchOptions, IHubSearchResponse, IHubSearchResult, IMatchOptions, IPredicate, IQuery } from "../types";
2
4
  /**
3
5
  * @private
@@ -7,6 +9,15 @@ import { IHubSearchOptions, IHubSearchResponse, IHubSearchResult, IMatchOptions,
7
9
  * @returns
8
10
  */
9
11
  export declare function portalSearchItems(query: IQuery, options: IHubSearchOptions): Promise<IHubSearchResponse<IHubSearchResult>>;
12
+ /**
13
+ * Convert an `IItem` to a `IHubSearchResult`
14
+ * Fetches the enrichments, and attaches them as directed in the `include` list
15
+ * @param item
16
+ * @param includes
17
+ * @param requestOptions
18
+ * @returns
19
+ */
20
+ export declare function itemToSearchResult(item: IItem, includes?: string[], requestOptions?: IHubRequestOptions): Promise<IHubSearchResult>;
10
21
  interface IWellKnownItemPredicates {
11
22
  $application: IPredicate[];
12
23
  $feedback: IPredicate[];
@@ -63,4 +63,8 @@ export interface IHubSearchOptions {
63
63
  * The result number of the first entry in the result set response. The start parameter, along with the num parameter, can be used to paginate the search results.
64
64
  */
65
65
  start?: number;
66
+ /**
67
+ * Enables experimental functionality.
68
+ */
69
+ useBeta?: boolean;
66
70
  }
@@ -1,5 +1,5 @@
1
- interface IQueryParams {
2
- [key: string]: string;
1
+ export interface IQueryParams {
2
+ [key: string]: string | number;
3
3
  }
4
4
  /**
5
5
  * @private
@@ -9,4 +9,3 @@ export declare function buildUrl(params: {
9
9
  path: string;
10
10
  query?: IQueryParams;
11
11
  }): string;
12
- export {};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@esri/hub-common",
3
- "version": "12.3.2",
3
+ "version": "12.4.0",
4
4
  "description": "Common TypeScript types and utility functions for @esri/hub.js.",
5
5
  "main": "dist/node/index.js",
6
6
  "module": "dist/esm/index.js",