@esri/hub-common 14.121.1 → 14.122.0

package/dist/types/downloads/build-existing-exports-portal-query.d.ts

@@ -1,42 +1,5 @@
 import { ISpatialReference } from "@esri/arcgis-rest-types";
 export declare const WGS84_WKID = "4326";
-export declare const PORTAL_EXPORT_TYPES: {
-    csv: {
-        name: string;
-        itemTypes: string[];
-        supportsProjection: boolean;
-    };
-    kml: {
-        name: string;
-        itemTypes: string[];
-        supportsProjection: boolean;
-    };
-    shapefile: {
-        name: string;
-        itemTypes: string[];
-        supportsProjection: boolean;
-    };
-    fileGeodatabase: {
-        name: string;
-        itemTypes: string[];
-        supportsProjection: boolean;
-    };
-    geojson: {
-        name: string;
-        itemTypes: string[];
-        supportsProjection: boolean;
-    };
-    excel: {
-        name: string;
-        itemTypes: string[];
-        supportsProjection: boolean;
-    };
-    featureCollection: {
-        name: string;
-        itemTypes: string[];
-        supportsProjection: boolean;
-    };
-};
 interface IExistingExportsPortalQueryOptions {
     layerId?: number | string;
     onlyTypes?: string[];

package/dist/types/downloads/canUseCreateReplica.d.ts

@@ -0,0 +1,7 @@
+import { IHubEditableContent } from "../core/types/IHubEditableContent";
+/**
+ * Determines whether Hub can perform the /createReplica operation on a given service entity.
+ * @param entity entity to check
+ * @returns whether the /createReplica operation can be used
+ */
+export declare function canUseCreateReplica(entity: IHubEditableContent): boolean;

package/dist/types/downloads/canUseHubDownloadApi.d.ts

@@ -0,0 +1,9 @@
+import { IArcGISContext } from "../ArcGISContext";
+import { IHubEditableContent } from "../core/types/IHubEditableContent";
+/**
+ * Determines if the Hub Download API can be used for the given entity.
+ * @param entity entity to check if Hub Download API can be used
+ * @param context ArcGIS context
+ * @returns whether the Hub Download API can be used
+ */
+export declare function canUseHubDownloadApi(entity: IHubEditableContent, context: IArcGISContext): boolean;

package/dist/types/downloads/fetchDownloadFileUrl.d.ts

@@ -0,0 +1,8 @@
+import { IFetchDownloadFileUrlOptions } from "./types";
+/**
+ * Fetches a download file URL for the given entity and format.
+ * @param options options to refine / filter the results of the fetchDownloadFileUrl operation
+ * @returns a promise that resolves with the download file URL
+ * @throws {ArcgisHubDownloadError} if the download file URL cannot be fetched for a well-known reason
+ */
+export declare function fetchDownloadFileUrl(options: IFetchDownloadFileUrlOptions): Promise<string>;

package/dist/types/downloads/fetchDownloadFormats.d.ts

@@ -0,0 +1,7 @@
+import { IDownloadFormat, IFetchDownloadFormatsOptions } from "./types";
+/**
+ * Fetches download formats for the given entity. Also folds in any additional resources defined on the entity.
+ * @param options options to refine / filter the results of the fetchDownloadFormats operation
+ * @returns a promise that resolves with the download formats
+ */
+export declare function fetchDownloadFormats(options: IFetchDownloadFormatsOptions): Promise<IDownloadFormat[]>;

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

@@ -1 +1,6 @@
 export * from "./build-existing-exports-portal-query";
+export * from "./types";
+export * from "./fetchDownloadFileUrl";
+export * from "./fetchDownloadFormats";
+export * from "./canUseCreateReplica";
+export * from "./canUseHubDownloadApi";

package/dist/types/downloads/types.d.ts

@@ -0,0 +1,152 @@
+/// <reference types="arcgis-js-api" />
+import { IArcGISContext } from "../ArcGISContext";
+import { IHubEditableContent } from "../core/types/IHubEditableContent";
+/**
+ * This hash map was defined to support the previous implementation of the export item flow.
+ * We are currently working on a new implementation that will replace this hash map, but we
+ * need to keep this around for now to support the existing implementation.
+ */
+export declare const PORTAL_EXPORT_TYPES: {
+    csv: {
+        name: string;
+        itemTypes: string[];
+        supportsProjection: boolean;
+    };
+    kml: {
+        name: string;
+        itemTypes: string[];
+        supportsProjection: boolean;
+    };
+    shapefile: {
+        name: string;
+        itemTypes: string[];
+        supportsProjection: boolean;
+    };
+    fileGeodatabase: {
+        name: string;
+        itemTypes: string[];
+        supportsProjection: boolean;
+    };
+    geojson: {
+        name: string;
+        itemTypes: string[];
+        supportsProjection: boolean;
+    };
+    excel: {
+        name: string;
+        itemTypes: string[];
+        supportsProjection: boolean;
+    };
+    featureCollection: {
+        name: string;
+        itemTypes: string[];
+        supportsProjection: boolean;
+    };
+};
+export declare type LegacyExportItemFormat = keyof typeof PORTAL_EXPORT_TYPES;
+/**
+ * Comprehensive enum of all the download formats that are supported by service-backed items across the ArcGIS platform.
+ */
+export declare enum ServiceDownloadFormat {
+    BIP = "bip",
+    BMP = "bmp",
+    BSQ = "bsq",
+    GIF = "gif",
+    JPG = "jpg",
+    JPG_PNG = "jpgpng",
+    LERC = "lerc",
+    PNG = "png",
+    PNG8 = "png8",
+    PNG24 = "png24",
+    PNG32 = "png32",
+    TIFF = "tiff",
+    CSV = "csv",
+    EXCEL = "excel",
+    FEATURE_COLLECTION = "featureCollection",
+    FILE_GDB = "filegdb",
+    GEOJSON = "geojson",
+    GEO_PACKAGE = "geoPackage",
+    JSON = "json",
+    KML = "kml",
+    SHAPEFILE = "shapefile",
+    SQLITE = "sqlite"
+}
+/**
+ * Represents a file format related to a content entity that can be downloaded.
+ * Formats can either be dynamic (i.e., generated on-the-fly) or static (i.e., pre-generated)
+ */
+export interface IDownloadFormat {
+    type: "static" | "dynamic";
+}
+/**
+ * Represents a static download format that is pre-generated and available for download.
+ * If the format is a service-backed format, the `format` property will be set to the corresponding
+ * service format. If the format is to an arbitrary static file, the `format` property should be undefined.
+ */
+export interface IStaticDownloadFormat extends IDownloadFormat {
+    type: "static";
+    format?: ServiceDownloadFormat;
+    label: string;
+    url: string;
+}
+/**
+ * Represents a dynamic download format that is generated on-the-fly when requested.
+ * The `format` property will be set to the corresponding service format.
+ */
+export interface IDynamicDownloadFormat extends IDownloadFormat {
+    type: "dynamic";
+    format: ServiceDownloadFormat;
+}
+/**
+ * A callback function that is invoked to report the progress of a download operation.
+ */
+export declare type downloadProgressCallback = (status: DownloadOperationStatus, percent?: number) => void;
+/**
+ * Options for refining / filtering the results of the fetchDownloadFileUrl operation.
+ */
+export interface IFetchDownloadFileUrlOptions {
+    entity: IHubEditableContent;
+    format: ServiceDownloadFormat;
+    context: IArcGISContext;
+    layers?: number[];
+    geometry?: __esri.Geometry;
+    where?: string;
+    progressCallback?: downloadProgressCallback;
+    pollInterval?: number;
+}
+/**
+ * Human-readable status of a download operation. Operation specific statuses
+ * should be converted to one of these statuses before being reported to the user.
+ */
+export declare enum DownloadOperationStatus {
+    PENDING = "pending",
+    PROCESSING = "processing",
+    CONVERTING = "converting",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+/**
+ * Options for fetching download formats for an entity.
+ */
+export interface IFetchDownloadFormatsOptions {
+    entity: IHubEditableContent;
+    context: IArcGISContext;
+    layers?: number[];
+}
+/**
+ * Options for instantiating an ArcgisHubDownloadError object.
+ */
+interface IArcgisHubDownloadErrorOptions {
+    rawMessage: string;
+    messageId?: string;
+    operation?: string;
+}
+/**
+ * Error class for reporting well-known download errors that occur during the download process.
+ */
+export declare class ArcgisHubDownloadError extends Error {
+    messageId?: string;
+    operation?: string;
+    constructor(options: IArcgisHubDownloadErrorOptions);
+}
+export {};

package/dist/types/events/api/orval/api/orval-events.d.ts

@@ -105,8 +105,10 @@ export interface IUpdateEvent {
     description?: string;
     /** Groups with edit access to the event */
     editGroups?: string[];
-    /** ISO8601 end date-time for the event */
-    endDateTime?: string;
+    /** end date string formatted YYYY-MM-DD */
+    endDate?: string;
+    /** end time string 24 hour formatted HH:MM:SS */
+    endTime?: string;
     /** GeoJSON formatted geometry related to the event */
     geometry?: IUpdateEventGeometry;
     /** Flag to notify attendees */
@@ -115,8 +117,10 @@ export interface IUpdateEvent {
     onlineMeetings?: ICreateOnlineMeeting[];
     /** Groups with read access to the event */
     readGroups?: string[];
-    /** ISO8601 start date-time for the event */
-    startDateTime?: string;
+    /** start date string formatted YYYY-MM-DD */
+    startDate?: string;
+    /** start time string 24 hour formatted HH:MM:SS */
+    startTime?: string;
     /** Status of the event */
     status?: EventStatus;
     /** Summary of the event */
@@ -144,6 +148,10 @@ export declare enum EventSort {
     updatedAt = "updatedAt"
 }
 export declare type GetEventsParams = {
+    /**
+     * Comma separated string list of EventAccess
+     */
+    access?: string;
     /**
      * Comma separated string list of relation fields to include in response
      */
@@ -225,7 +233,9 @@ export interface IEvent {
     creator?: IUser;
     description: string | null;
     editGroups: string[];
+    endDate: string;
     endDateTime: string;
+    endTime: string;
     geometry: IEventGeometry;
     id: string;
     notifyAttendees: boolean;
@@ -235,7 +245,9 @@ export interface IEvent {
     readGroups: string[];
     recurrence: string | null;
     registrations?: IRegistration[];
+    startDate: string;
     startDateTime: string;
+    startTime: string;
     status: EventStatus;
     summary: string | null;
     tags: string[];
@@ -378,8 +390,10 @@ export interface ICreateEvent {
     editGroups?: string[];
     /** Email for the subscriber. Will always be extracted from the token unless service token is used. */
     email?: string;
-    /** ISO8601 end date-time for the event */
-    endDateTime: string;
+    /** end date string formatted YYYY-MM-DD */
+    endDate: string;
+    /** end time string 24 hour formatted HH:MM:SS */
+    endTime: string;
     /** First name for the subscriber. Will always be extracted from the token unless service token is used. */
     firstName?: string;
     /** GeoJSON formatted geometry related to the event */
@@ -392,8 +406,10 @@ export interface ICreateEvent {
     onlineMeetings?: ICreateOnlineMeeting[];
     /** Groups with read access to the event */
     readGroups?: string[];
-    /** ISO8601 start date-time for the event */
-    startDateTime: string;
+    /** start date string formatted YYYY-MM-DD */
+    startDate: string;
+    /** start time string 24 hour formatted HH:MM:SS */
+    startTime: string;
     /** Summary of the event */
     summary?: string;
     /** Tags for the event */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esri/hub-common",
-  "version": "14.121.1",
+  "version": "14.122.0",
   "description": "Common TypeScript types and utility functions for @esri/hub.js.",
   "main": "dist/node/index.js",
   "module": "dist/esm/index.js",