@esri/arcgis-rest-portal 4.4.1 → 4.6.0

package/dist/bundled/portal.esm.js

@@ -1,7 +1,7 @@
 /* @preserve
-* @esri/arcgis-rest-portal - v4.4.0 - Apache-2.0
-* Copyright (c) 2017-2024 Esri, Inc.
-* Sat Jun 15 2024 00:37:50 GMT+0000 (Coordinated Universal Time)
+* @esri/arcgis-rest-portal - v4.5.0 - Apache-2.0
+* Copyright (c) 2017-2025 Esri, Inc.
+* Mon Apr 07 2025 17:49:09 GMT+0000 (Coordinated Universal Time)
 */
 import { cleanUrl, request, appendCustomParams, warn } from '@esri/arcgis-rest-request';
 
@@ -866,15 +866,15 @@ function searchGroupUsers(id, searchOptions) {
 
 /* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
  * Apache-2.0 */
-function getSharingUrl(requestOptions) {
-    const username = requestOptions.authentication.username;
-    const owner = requestOptions.owner || username;
+function getSharingUrl(requestOptions, username) {
+    const providedUsername = username || requestOptions.authentication.username; // as any workaround for backward compatibility for discovering username from provided auth method
+    const owner = requestOptions.owner || providedUsername;
     return `${getPortalUrl(requestOptions)}/content/users/${encodeURIComponent(owner)}/items/${requestOptions.id}/share`;
 }
-function isItemOwner(requestOptions) {
-    const username = requestOptions.authentication.username;
-    const owner = requestOptions.owner || username;
-    return owner === username;
+function isItemOwner(requestOptions, username) {
+    const providedUsername = username || requestOptions.authentication.username; // as any workaround for backward compatibility for discovering username from provided auth method
+    const owner = requestOptions.owner || providedUsername;
+    return owner === providedUsername;
 }
 /**
  * Check it the user is a full org_admin
@@ -882,8 +882,7 @@ function isItemOwner(requestOptions) {
  * @returns Promise resolving in a boolean indicating if the user is an ArcGIS Organization administrator
  */
 function isOrgAdmin(requestOptions) {
-    const session = requestOptions.authentication;
-    return session.getUser(requestOptions).then((user) => {
+    return requestOptions.authentication.getUser().then((user) => {
         return user && user.role === "org_admin" && !user.roleId;
     });
 }
@@ -1031,6 +1030,29 @@ function removeFolder(requestOptions) {
         return request(url, requestOptions);
     });
 }
+/**
+ * Delete an item's thumbnail. See the [REST Documentation](https://developers.arcgis.com/rest/users-groups-and-items/delete-item-thumbnail.htm) for more information.
+ *
+ * ```js
+ * import { removeItemThumbnail } from "@esri/arcgis-rest-portal";
+ *
+ * removeItemThumbnail({
+ *   id: "3ef",
+ *   owner: "c@sey",
+ *   authentication
+ * })
+ *   .then(response)
+ * ```
+ *
+ * @param requestOptions - Options for the request
+ * @returns A Promise that deletes a thumbnail.
+ */
+function removeItemThumbnail(requestOptions) {
+    return determineOwner(requestOptions).then((owner) => {
+        const url = `${getPortalUrl(requestOptions)}/content/users/${owner}/items/${requestOptions.id}/deleteThumbnail`;
+        return request(url, requestOptions);
+    });
+}
 
 /* Copyright (c) 2018-2021 Environmental Systems Research Institute, Inc.
  * Apache-2.0 */
@@ -2075,6 +2097,30 @@ function _combineResults(responses) {
     return combined;
 }
 
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+/**
+ * Used to determine the username to use in a request. Will use the `username` passed in the
+ * `requestOptions` if present, otherwise will use the username from the `authentication` option.
+ * This method is used internally to determine the username to use in a request and is async to
+ * support the case where the username is not immediately available.
+ *
+ * @param requestOptions the requests options
+ * @returns the authentecated users username encoded for use in a URL.
+ */
+async function determineUsername(requestOptions) {
+    var _a;
+    if (requestOptions.username) {
+        return encodeURIComponent(requestOptions.username);
+    }
+    if ((_a = requestOptions.authentication) === null || _a === void 0 ? void 0 : _a.username) {
+        return encodeURIComponent(requestOptions.authentication.username);
+    }
+    if (requestOptions.authentication) {
+        return requestOptions.authentication.getUsername().then(encodeURIComponent);
+    }
+}
+
 /* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
  * Apache-2.0 */
 /**
@@ -2091,7 +2137,7 @@ function _combineResults(responses) {
  * @param requestOptions - options to pass through in the request
  * @returns A Promise that will resolve with metadata about the user
  */
-function getUser(requestOptions) {
+async function getUser(requestOptions) {
     let url;
     let options = { httpMethod: "GET" };
     // if a username is passed, assume ArcGIS Online
@@ -2100,8 +2146,8 @@ function getUser(requestOptions) {
     }
     else {
         // if an authenticated session is passed, default to that user/portal unless another username is provided manually
-        const username = requestOptions.username || requestOptions.authentication.username;
-        url = `${getPortalUrl(requestOptions)}/community/users/${encodeURIComponent(username)}`;
+        const username = await determineUsername(requestOptions);
+        url = `${getPortalUrl(requestOptions)}/community/users/${username}`;
         options = Object.assign(Object.assign({}, requestOptions), options);
     }
     // send the request
@@ -2126,9 +2172,9 @@ function getUser(requestOptions) {
  * @param IGetUserOptions - options to pass through in the request
  * @returns A Promise that will resolve with the user tag array
  */
-function getUserTags(requestOptions) {
-    const username = requestOptions.username || requestOptions.authentication.username;
-    const url = `${getPortalUrl(requestOptions)}/community/users/${encodeURIComponent(username)}/tags`;
+async function getUserTags(requestOptions) {
+    const username = await determineUsername(requestOptions);
+    const url = `${getPortalUrl(requestOptions)}/community/users/${username}/tags`;
     // send the request
     return request(url, requestOptions);
 }
@@ -2140,6 +2186,7 @@ function getUserTags(requestOptions) {
  *
  * @param session
  * @returns User url to be used in API requests.
+ * @deprecated This function requires a synchronous  `username` on the session object which is not guaranteed. Use `getUser` instead. This function will be removed in the next release.
  */
 function getUserUrl(session) {
     return `${getPortalUrl(session)}/community/users/${encodeURIComponent(session.username)}`;
@@ -2160,9 +2207,9 @@ function getUserUrl(session) {
  * @param requestOptions - options to pass through in the request
  * @returns A Promise that will resolve with the user's invitations
  */
-function getUserInvitations(requestOptions) {
+async function getUserInvitations(requestOptions) {
     let options = { httpMethod: "GET" };
-    const username = encodeURIComponent(requestOptions.authentication.username);
+    const username = await determineUsername(requestOptions);
     const portalUrl = getPortalUrl(requestOptions);
     const url = `${portalUrl}/community/users/${username}/invitations`;
     options = Object.assign(Object.assign({}, requestOptions), options);
@@ -2185,8 +2232,8 @@ function getUserInvitations(requestOptions) {
  * @param requestOptions - options to pass through in the request
  * @returns A Promise that will resolve with the invitation
  */
-function getUserInvitation(requestOptions) {
-    const username = encodeURIComponent(requestOptions.authentication.username);
+async function getUserInvitation(requestOptions) {
+    const username = await determineUsername(requestOptions);
     const portalUrl = getPortalUrl(requestOptions);
     const url = `${portalUrl}/community/users/${username}/invitations/${requestOptions.invitationId}`;
     let options = { httpMethod: "GET" };
@@ -2210,8 +2257,8 @@ function getUserInvitation(requestOptions) {
  * @param requestOptions - Options for the request
  * @returns A Promise that will resolve with the success/failure status of the request
  */
-function acceptInvitation(requestOptions) {
-    const username = encodeURIComponent(requestOptions.authentication.username);
+async function acceptInvitation(requestOptions) {
+    const username = await determineUsername(requestOptions);
     const portalUrl = getPortalUrl(requestOptions);
     const url = `${portalUrl}/community/users/${username}/invitations/${requestOptions.invitationId}/accept`;
     const options = Object.assign({}, requestOptions);
@@ -2233,8 +2280,8 @@ function acceptInvitation(requestOptions) {
  * @param requestOptions - Options for the request
  * @returns A Promise that will resolve with the success/failure status of the request
  */
-function declineInvitation(requestOptions) {
-    const username = encodeURIComponent(requestOptions.authentication.username);
+async function declineInvitation(requestOptions) {
+    const username = await determineUsername(requestOptions);
     const portalUrl = getPortalUrl(requestOptions);
     const url = `${portalUrl}/community/users/${username}/invitations/${requestOptions.invitationId}/decline`;
     const options = Object.assign({}, requestOptions);
@@ -2257,9 +2304,9 @@ function declineInvitation(requestOptions) {
  * @param requestOptions - options to pass through in the request
  * @returns A Promise that will resolve with the user's notifications
  */
-function getUserNotifications(requestOptions) {
+async function getUserNotifications(requestOptions) {
     let options = { httpMethod: "GET" };
-    const username = encodeURIComponent(requestOptions.authentication.username);
+    const username = await determineUsername(requestOptions);
     const portalUrl = getPortalUrl(requestOptions);
     const url = `${portalUrl}/community/users/${username}/notifications`;
     options = Object.assign(Object.assign({}, requestOptions), options);
@@ -2272,8 +2319,8 @@ function getUserNotifications(requestOptions) {
  * @param requestOptions - Options for the request
  * @returns A Promise that will resolve with the success/failure status of the request
  */
-function removeNotification(requestOptions) {
-    const username = encodeURIComponent(requestOptions.authentication.username);
+async function removeNotification(requestOptions) {
+    const username = await determineUsername(requestOptions);
     const portalUrl = getPortalUrl(requestOptions);
     const url = `${portalUrl}/community/users/${username}/notifications/${requestOptions.id}/delete`;
     return request(url, requestOptions);
@@ -2338,9 +2385,10 @@ function searchCommunityUsers(search) {
  * @param requestOptions - options to pass through in the request
  * @returns A Promise that will resolve with metadata about the user
  */
-function updateUser(requestOptions) {
+async function updateUser(requestOptions) {
     // default to the authenticated username unless another username is provided manually
-    const username = requestOptions.user.username || requestOptions.authentication.username;
+    const username = requestOptions.user.username ||
+        (await requestOptions.authentication.getUsername());
     const updateUrl = `${getPortalUrl(requestOptions)}/community/users/${encodeURIComponent(username)}/update`;
     // mixin custom params and the user information, then drop the user info
     requestOptions.params = Object.assign(Object.assign({}, requestOptions.user), requestOptions.params);
@@ -2409,9 +2457,10 @@ async function setUserProperties(username, properties, requestOptions) {
  * @param requestOptions - Options for the request.
  * @returns A Promise that will resolve with the data from the response.
  */
-function setItemAccess(requestOptions) {
-    const url = getSharingUrl(requestOptions);
-    if (isItemOwner(requestOptions)) {
+async function setItemAccess(requestOptions) {
+    const username = await requestOptions.authentication.getUsername();
+    const url = getSharingUrl(requestOptions, username);
+    if (isItemOwner(requestOptions, username)) {
         // if the user owns the item, proceed
         return updateItemAccess(url, requestOptions);
     }
@@ -2423,7 +2472,7 @@ function setItemAccess(requestOptions) {
             }
             else {
                 // if neither, updating the sharing isnt possible
-                throw Error(`This item can not be shared by ${requestOptions.authentication.username}. They are neither the item owner nor an organization admin.`);
+                throw Error(`This item can not be shared by ${username}. They are neither the item owner nor an organization admin.`);
             }
         });
     }
@@ -2504,9 +2553,9 @@ function isItemSharedWithGroup(requestOptions) {
  * @param requestOptions - Options for the request.
  * @returns A Promise that will resolve with the data from the response.
  */
-function shareItemWithGroup(requestOptions) {
+async function shareItemWithGroup(requestOptions) {
     return isItemSharedWithGroup(requestOptions)
-        .then((isShared) => {
+        .then(async (isShared) => {
         if (isShared) {
             // already shared, exit early with success response
             return {
@@ -2515,7 +2564,8 @@ function shareItemWithGroup(requestOptions) {
                 notSharedWith: []
             };
         }
-        const { authentication: { username }, owner, confirmItemControl } = requestOptions;
+        const { owner, confirmItemControl } = requestOptions;
+        const username = await requestOptions.authentication.getUsername();
         const itemOwner = owner || username;
         // non-item owner
         if (itemOwner !== username) {
@@ -2604,8 +2654,8 @@ function getMembershipAdjustments(currentUser, isSharedEditingGroup, membership,
     }
     return membershipGuarantees;
 }
-function shareToGroup(requestOptions, isAdmin = false, isCrossOrgSharing = false) {
-    const username = requestOptions.authentication.username;
+async function shareToGroup(requestOptions, isAdmin = false, isCrossOrgSharing = false) {
+    const username = await requestOptions.authentication.getUsername();
     const itemOwner = requestOptions.owner || username;
     // decide what url to use
     // default to the non-owner url...
@@ -2742,7 +2792,7 @@ function ensureMembership(currentUser, ownerUser, shouldPromote, errorMessage, r
  * @returns A Promise that will resolve with the data from the response.
  */
 function unshareItemWithGroup(requestOptions) {
-    return isItemSharedWithGroup(requestOptions).then((isShared) => {
+    return isItemSharedWithGroup(requestOptions).then(async (isShared) => {
         // not shared
         if (!isShared) {
             // exit early with success response
@@ -2752,7 +2802,8 @@ function unshareItemWithGroup(requestOptions) {
                 notUnsharedFrom: []
             });
         }
-        const { authentication: { username }, owner } = requestOptions;
+        const { owner } = requestOptions;
+        const username = await requestOptions.authentication.getUsername();
         // next check if the user is a member of the group
         return Promise.all([
             getUserMembership(requestOptions),
@@ -2785,8 +2836,8 @@ function unshareItemWithGroup(requestOptions) {
         });
     });
 }
-function unshareFromGroup(requestOptions) {
-    const username = requestOptions.authentication.username;
+async function unshareFromGroup(requestOptions) {
+    const username = await requestOptions.authentication.getUsername();
     const itemOwner = requestOptions.owner || username;
     // decide what url to use
     // default to the non-owner url...
@@ -2914,5 +2965,5 @@ function getPortalSettings(id, requestOptions) {
     return request(url, options);
 }
 
-export { SearchQueryBuilder, acceptInvitation, addGroupUsers, addItemData, addItemPart, addItemRelationship, addItemResource, bboxToString, cancelItemUpload, commitItemUpload, createFolder, createGroup, createGroupNotification, createItem, createItemInFolder, createOrgNotification, declineInvitation, determineOwner, ensureMembership, exportItem, getGroup, getGroupCategorySchema, getGroupContent, getGroupUsers, getItem, getItemBaseUrl, getItemData, getItemGroups, getItemInfo, getItemMetadata, getItemParts, getItemResource, getItemResources, getItemStatus, getPortal, getPortalSettings, getPortalUrl, getRelatedItems, getSelf, getSharingUrl, getUniqueServiceName, getUser, getUserContent, getUserInvitation, getUserInvitations, getUserMembership, getUserNotifications, getUserProperties, getUserTags, getUserUrl, inviteGroupUsers, isBBox, isItemOwner, isItemSharedWithGroup, isOrgAdmin, isServiceNameAvailable, joinGroup, leaveGroup, moveItem, protectGroup, protectItem, reassignItem, removeFolder, removeGroup, removeGroupUsers, removeItem, removeItemRelationship, removeItemResource, removeNotification, scrubControlChars, searchCommunityUsers, searchGroupContent, searchGroupUsers, searchGroups, searchItems, searchUsers, setItemAccess, setUserProperties, shareItemWithGroup, unprotectGroup, unprotectItem, unshareItemWithGroup, updateGroup, updateItem, updateItemInfo, updateItemResource, updateUser, updateUserMemberships };
+export { SearchQueryBuilder, acceptInvitation, addGroupUsers, addItemData, addItemPart, addItemRelationship, addItemResource, bboxToString, cancelItemUpload, commitItemUpload, createFolder, createGroup, createGroupNotification, createItem, createItemInFolder, createOrgNotification, declineInvitation, determineOwner, determineUsername, ensureMembership, exportItem, getGroup, getGroupCategorySchema, getGroupContent, getGroupUsers, getItem, getItemBaseUrl, getItemData, getItemGroups, getItemInfo, getItemMetadata, getItemParts, getItemResource, getItemResources, getItemStatus, getPortal, getPortalSettings, getPortalUrl, getRelatedItems, getSelf, getSharingUrl, getUniqueServiceName, getUser, getUserContent, getUserInvitation, getUserInvitations, getUserMembership, getUserNotifications, getUserProperties, getUserTags, getUserUrl, inviteGroupUsers, isBBox, isItemOwner, isItemSharedWithGroup, isOrgAdmin, isServiceNameAvailable, joinGroup, leaveGroup, moveItem, protectGroup, protectItem, reassignItem, removeFolder, removeGroup, removeGroupUsers, removeItem, removeItemRelationship, removeItemResource, removeItemThumbnail, removeNotification, scrubControlChars, searchCommunityUsers, searchGroupContent, searchGroupUsers, searchGroups, searchItems, searchUsers, setItemAccess, setUserProperties, shareItemWithGroup, unprotectGroup, unprotectItem, unshareItemWithGroup, updateGroup, updateItem, updateItemInfo, updateItemResource, updateUser, updateUserMemberships };
 //# sourceMappingURL=portal.esm.js.map