upcoming: [UIE-9569] - New IAM getUserEntitiesByPermission (types, queries, hooks, mocks) (linode#13070)

* save progress

* new hook = naming conventions

* improve hook and usage

* test

* cleanup

* comments

* comments

* Added changeset: New IAM getUserEntitiesByPermission (types, queries, hooks, mocks)

* Added changeset: New IAM getUserEntitiesByPermission endpoint

* Added changeset: New IAM getUserEntitiesByPermission queries

* test fix

Author: abailly-akamai

packages/api-v4/.changeset/pr-13070-upcoming-features-1762520053797.md

@@ -0,0 +1,5 @@
+---
+"@linode/api-v4": Upcoming Features
+---
+
+New IAM getUserEntitiesByPermission endpoint ([#13070](https://github.com/linode/manager/pull/13070))

packages/api-v4/src/iam/iam.ts

@@ -3,10 +3,12 @@ import Request, { setData, setMethod, setURL } from '../request';
 
 import type {
   AccessType,
+  EntityByPermission,
   IamAccountRoles,
   IamUserRoles,
   PermissionType,
 } from './types';
+import type { EntityType } from 'src/entities/types';
 
 /**
  * getUserRoles
@@ -100,3 +102,26 @@ export const getUserEntityPermissions = (
     ),
     setMethod('GET'),
   );
+
+/**
+ * getUserEntitiesByPermission
+ *
+ * Returns the available entities for a given permission.
+ */
+export interface GetEntitiesByPermissionParams {
+  entityType: EntityType;
+  permission: PermissionType;
+  username: string | undefined;
+}
+
+export const getUserEntitiesByPermission = ({
+  username,
+  entityType,
+  permission,
+}: GetEntitiesByPermissionParams) =>
+  Request<EntityByPermission[]>(
+    setURL(
+      `${BETA_API_ROOT}/iam/users/${username}/entities/${entityType}?permission=${permission}`,
+    ),
+    setMethod('GET'),
+  );

packages/api-v4/src/iam/types.ts

@@ -456,6 +456,11 @@ export interface Roles {
   name: RoleName;
   permissions: PermissionType[];
 }
+export interface EntityByPermission {
+  id: number;
+  label: string;
+  type: EntityType;
+}
 
 export type IamAccessType = keyof IamAccountRoles;
 

packages/manager/.changeset/pr-13070-upcoming-features-1762520005187.md

@@ -0,0 +1,5 @@
+---
+"@linode/manager": Upcoming Features
+---
+
+New IAM getUserEntitiesByPermission (types, queries, hooks, mocks) ([#13070](https://github.com/linode/manager/pull/13070))

packages/manager/src/features/IAM/hooks/adapters/permissionAdapters.ts

@@ -15,7 +15,7 @@ import type {
   Profile,
 } from '@linode/api-v4';
 
-export type EntityPermissionMap = Record<number, PermissionMap>;
+export type EntityPermissionMap = Record<number | string, PermissionMap>;
 
 export type PermissionMap = Record<PermissionType, boolean>;