@openedx/frontend-app-admin-console 1.0.0-alpha.0

package/dist/authz-module/data/api.js

@@ -0,0 +1,107 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { camelCaseObject, getAuthenticatedHttpClient } from '@openedx/frontend-base';
+import { getApiUrl } from '../../data/utils';
+export const assignTeamMembersRole = (data) => __awaiter(void 0, void 0, void 0, function* () {
+    const res = yield getAuthenticatedHttpClient().put(getApiUrl('/api/authz/v1/roles/users/'), data);
+    return camelCaseObject(res.data);
+});
+export const validateUsers = (data) => __awaiter(void 0, void 0, void 0, function* () {
+    const res = yield getAuthenticatedHttpClient().post(getApiUrl('/api/authz/v1/users/validate/'), data);
+    return camelCaseObject(res.data);
+});
+export const revokeUserRoles = (data) => __awaiter(void 0, void 0, void 0, function* () {
+    const url = new URL(getApiUrl('/api/authz/v1/roles/users/'));
+    url.searchParams.append('users', data.users);
+    url.searchParams.append('role', data.role);
+    url.searchParams.append('scope', data.scope);
+    // If this is not transformed to string, it shows a 404 with the token CSRF acquisition request
+    const res = yield getAuthenticatedHttpClient().delete(url.toString());
+    return camelCaseObject(res.data);
+});
+export const getAllRoleAssignments = (querySettings) => __awaiter(void 0, void 0, void 0, function* () {
+    const url = new URL(getApiUrl('/api/authz/v1/assignments/'));
+    if (querySettings.roles) {
+        url.searchParams.set('roles', querySettings.roles);
+    }
+    if (querySettings.scopes) {
+        url.searchParams.set('scopes', querySettings.scopes);
+    }
+    if (querySettings.organizations) {
+        url.searchParams.set('orgs', querySettings.organizations);
+    }
+    if (querySettings.search) {
+        url.searchParams.set('search', querySettings.search);
+    }
+    if (querySettings.sortBy && querySettings.order) {
+        url.searchParams.set('sort_by', querySettings.sortBy);
+        url.searchParams.set('order', querySettings.order);
+    }
+    url.searchParams.set('page_size', querySettings.pageSize.toString());
+    url.searchParams.set('page', (querySettings.pageIndex + 1).toString());
+    const { data } = yield getAuthenticatedHttpClient().get(url);
+    return camelCaseObject(data);
+});
+export const getOrgs = (search, page, pageSize) => __awaiter(void 0, void 0, void 0, function* () {
+    const url = new URL(getApiUrl('/api/authz/v1/orgs/'));
+    if (search !== undefined) {
+        url.searchParams.set('search', search);
+    }
+    if (page !== undefined) {
+        url.searchParams.set('page', page.toString());
+    }
+    if (pageSize !== undefined) {
+        url.searchParams.set('page_size', pageSize.toString());
+    }
+    const { data } = yield getAuthenticatedHttpClient().get(url);
+    return camelCaseObject(data);
+});
+export const getScopes = (params) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c;
+    const url = new URL(getApiUrl('/api/authz/v1/scopes/'));
+    if (params.search)
+        url.searchParams.set('search', params.search);
+    if (params.scopeType)
+        url.searchParams.set('scope_type', params.scopeType);
+    if ((_a = params.orgs) === null || _a === void 0 ? void 0 : _a.length)
+        url.searchParams.set('orgs', params.orgs.join(','));
+    if (params.managementPermissionOnly)
+        url.searchParams.set('management_permission_only', 'true');
+    url.searchParams.set('page', ((_b = params.page) !== null && _b !== void 0 ? _b : 1).toString());
+    url.searchParams.set('page_size', ((_c = params.pageSize) !== null && _c !== void 0 ? _c : 10).toString());
+    const { data } = yield getAuthenticatedHttpClient().get(url);
+    return camelCaseObject(data);
+});
+export const getCourseAuthoringFlagStates = () => __awaiter(void 0, void 0, void 0, function* () {
+    const { data } = yield getAuthenticatedHttpClient().get(getApiUrl('/api/authz/v1/waffle-flag-states/'));
+    return camelCaseObject(data);
+});
+export const getUserAssignedRoles = (username, querySettings) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const url = new URL(getApiUrl(`/api/authz/v1/users/${username}/assignments/`));
+    if (querySettings === null || querySettings === void 0 ? void 0 : querySettings.roles) {
+        url.searchParams.set('roles', querySettings.roles);
+    }
+    if (querySettings === null || querySettings === void 0 ? void 0 : querySettings.organizations) {
+        url.searchParams.set('orgs', querySettings.organizations);
+    }
+    if (querySettings === null || querySettings === void 0 ? void 0 : querySettings.search) {
+        url.searchParams.set('search', querySettings.search);
+    }
+    if ((querySettings === null || querySettings === void 0 ? void 0 : querySettings.sortBy) && (querySettings === null || querySettings === void 0 ? void 0 : querySettings.order)) {
+        url.searchParams.set('sort_by', querySettings.sortBy);
+        url.searchParams.set('order', (querySettings === null || querySettings === void 0 ? void 0 : querySettings.order) || '');
+    }
+    url.searchParams.set('page_size', ((_a = querySettings === null || querySettings === void 0 ? void 0 : querySettings.pageSize) === null || _a === void 0 ? void 0 : _a.toString()) || '');
+    url.searchParams.set('page', (((_b = querySettings === null || querySettings === void 0 ? void 0 : querySettings.pageIndex) !== null && _b !== void 0 ? _b : 0) + 1).toString());
+    const { data } = yield getAuthenticatedHttpClient().get(url);
+    return camelCaseObject(data);
+});
+//# sourceMappingURL=api.js.map

package/dist/authz-module/data/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/authz-module/data/api.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Org, Scope,\n  UserRole,\n} from '@src/types';\nimport { camelCaseObject, getAuthenticatedHttpClient } from '@openedx/frontend-base';\nimport { getApiUrl } from '@src/data/utils';\n\nexport interface QuerySettings {\n  roles: string | null;\n  scopes: string | null;\n  organizations: string | null;\n  search: string | null;\n  order: string | null;\n  sortBy: string | null;\n  pageSize: number;\n  pageIndex: number;\n}\n\nexport interface GetUserAssignmentsResponse {\n  results: UserRole[];\n  count: number;\n  next: string | null;\n  previous: string | null;\n}\n\nexport interface RevokeUserRolesRequest {\n  users: string;\n  role: string;\n  scope: string;\n  querySettings?: QuerySettings;\n}\n\nexport interface DeleteRevokeUserRolesResponse {\n  completed: {\n    userIdentifiers: string;\n    status: string;\n  }[];\n  errors: {\n    userIdentifiers: string;\n    error: string;\n  }[];\n}\n\nexport interface PutAssignTeamMembersRoleResponse {\n  completed: { userIdentifier: string; status: string }[];\n  errors: { userIdentifier: string; scope: string; error: string }[];\n}\n\nexport interface AssignTeamMembersRoleRequest {\n  users: string[];\n  role: string;\n  scopes: string[];\n}\n\nexport interface GetAllRoleAssignmentsResponse {\n  results: UserRole[];\n  count: number;\n  next: string | null;\n  previous: string | null;\n}\n\nexport interface GetOrgsResponse {\n  count: number;\n  next: string | null;\n  previous: string | null;\n  results: Org[];\n}\n\nexport interface GetScopesResponse {\n  count: number;\n  next: string | null;\n  previous: string | null;\n  results: Scope[];\n}\nexport interface ValidateUsersRequest {\n  users: string[];\n}\n\nexport interface ValidateUsersResponse {\n  validUsers: string[];\n  invalidUsers: string[];\n  summary: {\n    total: number;\n    validCount: number;\n    invalidCount: number;\n  };\n}\n\nexport interface GetScopesParams {\n  scopeType?: string;\n  search?: string;\n  orgs?: string[];\n  page?: number;\n  pageSize?: number;\n  managementPermissionOnly?: boolean;\n}\n\nexport interface WaffleFlagOverrides {\n  on: string[];\n  off: string[];\n}\n\n/**\n * Enablement state of the course-authoring waffle flag across scopes.\n * `orgOverrides`/`courseOverrides` list the org short names / course ids whose\n * override differs from `global` (explicitly forced `on` or `off`).\n */\nexport interface CourseAuthoringFlagStates {\n  global: boolean;\n  orgOverrides: WaffleFlagOverrides;\n  courseOverrides: WaffleFlagOverrides;\n}\n\nexport const assignTeamMembersRole = async (\n  data: AssignTeamMembersRoleRequest,\n): Promise<PutAssignTeamMembersRoleResponse> => {\n  const res = await getAuthenticatedHttpClient().put(getApiUrl('/api/authz/v1/roles/users/'), data);\n  return camelCaseObject(res.data);\n};\n\nexport const validateUsers = async (\n  data: ValidateUsersRequest,\n): Promise<ValidateUsersResponse> => {\n  const res = await getAuthenticatedHttpClient().post(\n    getApiUrl('/api/authz/v1/users/validate/'),\n    data,\n  );\n  return camelCaseObject(res.data);\n};\n\nexport const revokeUserRoles = async (\n  data: RevokeUserRolesRequest,\n): Promise<DeleteRevokeUserRolesResponse> => {\n  const url = new URL(getApiUrl('/api/authz/v1/roles/users/'));\n  url.searchParams.append('users', data.users);\n  url.searchParams.append('role', data.role);\n  url.searchParams.append('scope', data.scope);\n\n  // If this is not transformed to string, it shows a 404 with the token CSRF acquisition request\n  const res = await getAuthenticatedHttpClient().delete(url.toString());\n  return camelCaseObject(res.data);\n};\n\nexport const getAllRoleAssignments = async (querySettings: QuerySettings): Promise<GetAllRoleAssignmentsResponse> => {\n  const url = new URL(getApiUrl('/api/authz/v1/assignments/'));\n\n  if (querySettings.roles) {\n    url.searchParams.set('roles', querySettings.roles);\n  }\n  if (querySettings.scopes) {\n    url.searchParams.set('scopes', querySettings.scopes);\n  }\n  if (querySettings.organizations) {\n    url.searchParams.set('orgs', querySettings.organizations);\n  }\n  if (querySettings.search) {\n    url.searchParams.set('search', querySettings.search);\n  }\n  if (querySettings.sortBy && querySettings.order) {\n    url.searchParams.set('sort_by', querySettings.sortBy);\n    url.searchParams.set('order', querySettings.order);\n  }\n  url.searchParams.set('page_size', querySettings.pageSize.toString());\n  url.searchParams.set('page', (querySettings.pageIndex + 1).toString());\n\n  const { data } = await getAuthenticatedHttpClient().get(url);\n  return camelCaseObject(data);\n};\n\nexport const getOrgs = async (search?: string, page?: number, pageSize?: number): Promise<GetOrgsResponse> => {\n  const url = new URL(getApiUrl('/api/authz/v1/orgs/'));\n  if (search !== undefined) {\n    url.searchParams.set('search', search);\n  }\n  if (page !== undefined) {\n    url.searchParams.set('page', page.toString());\n  }\n  if (pageSize !== undefined) {\n    url.searchParams.set('page_size', pageSize.toString());\n  }\n  const { data } = await getAuthenticatedHttpClient().get(url);\n  return camelCaseObject(data);\n};\n\nexport const getScopes = async (params: GetScopesParams): Promise<GetScopesResponse> => {\n  const url = new URL(getApiUrl('/api/authz/v1/scopes/'));\n  if (params.search) url.searchParams.set('search', params.search);\n  if (params.scopeType) url.searchParams.set('scope_type', params.scopeType);\n  if (params.orgs?.length) url.searchParams.set('orgs', params.orgs.join(','));\n  if (params.managementPermissionOnly) url.searchParams.set('management_permission_only', 'true');\n  url.searchParams.set('page', (params.page ?? 1).toString());\n  url.searchParams.set('page_size', (params.pageSize ?? 10).toString());\n  const { data } = await getAuthenticatedHttpClient().get(url);\n  return camelCaseObject(data);\n};\n\nexport const getCourseAuthoringFlagStates = async (): Promise<CourseAuthoringFlagStates> => {\n  const { data } = await getAuthenticatedHttpClient().get(getApiUrl('/api/authz/v1/waffle-flag-states/'));\n  return camelCaseObject(data);\n};\n\nexport const getUserAssignedRoles = async (username?: string, querySettings?: QuerySettings): Promise<GetUserAssignmentsResponse> => {\n  const url = new URL(getApiUrl(`/api/authz/v1/users/${username}/assignments/`));\n\n  if (querySettings?.roles) {\n    url.searchParams.set('roles', querySettings.roles);\n  }\n  if (querySettings?.organizations) {\n    url.searchParams.set('orgs', querySettings.organizations);\n  }\n  if (querySettings?.search) {\n    url.searchParams.set('search', querySettings.search);\n  }\n  if (querySettings?.sortBy && querySettings?.order) {\n    url.searchParams.set('sort_by', querySettings.sortBy);\n    url.searchParams.set('order', querySettings?.order || '');\n  }\n  url.searchParams.set('page_size', querySettings?.pageSize?.toString() || '');\n  url.searchParams.set('page', ((querySettings?.pageIndex ?? 0) + 1).toString());\n\n  const { data } = await getAuthenticatedHttpClient().get(url);\n  return camelCaseObject(data);\n};\n"]}

package/dist/authz-module/data/hooks.d.ts

@@ -0,0 +1,94 @@
+import { AssignTeamMembersRoleRequest, GetAllRoleAssignmentsResponse, GetOrgsResponse, GetScopesResponse, QuerySettings, RevokeUserRolesRequest, GetUserAssignmentsResponse, ValidateUsersRequest, GetScopesParams, CourseAuthoringFlagStates } from './api';
+/**
+ * React Query hook to add new team members to a specific scope or manage the corresponding roles.
+ * It provides a mutation function to add users with specified roles to the team or assign new roles.
+ *
+ * @example
+ * const { mutate: assignTeamMembersRole } = useAssignTeamMembersRole();
+ * assignTeamMembersRole({ data: { libraryId: 'lib:123', users: ['jdoe'], role: 'editor' } });
+ */
+export declare const useAssignTeamMembersRole: () => import("@tanstack/react-query").UseMutationResult<import("./api").PutAssignTeamMembersRoleResponse, Error, {
+    data: AssignTeamMembersRoleRequest;
+}, unknown>;
+/**
+ * React Query hook to validate users exist without assigning roles.
+ * It checks if the provided usernames/email addresses are valid.
+ *
+ * @example
+ * const { mutate: validateUsers } = useValidateUsers();
+ * validateUsers({ data: { users: ['jdoe', 'jane@example.com'] } });
+ */
+export declare const useValidateUsers: () => import("@tanstack/react-query").UseMutationResult<import("./api").ValidateUsersResponse, Error, {
+    data: ValidateUsersRequest;
+}, unknown>;
+/**
+ * React Query hook to remove roles for a specific team member within a scope.
+ *
+ * @example
+ * const { mutate: revokeUserRoles } = useRevokeUserRoles();
+ * revokeUserRoles({ data: { libraryId: 'lib:123', users: ['jdoe'], role: 'editor' } });
+ */
+export declare const useRevokeUserRoles: () => import("@tanstack/react-query").UseMutationResult<import("./api").DeleteRevokeUserRolesResponse, Error, {
+    data: RevokeUserRolesRequest;
+}, unknown>;
+/**
+ * React Query hook to fetch all role assignments across scopes and roles,
+ * with support for filtering, sorting, and pagination.
+ * It retrieves a comprehensive list of user-role assignments based
+ * on the provided query settings.
+ *
+ * @param querySettings - Optional parameters for filtering by roles, scopes,
+ * organizations, search term, sorting, and pagination.
+ *
+ * @example
+ * const { data: roleAssignments } = useAllRoleAssignments({ roles: 'editor', pageSize: 20 });
+ */
+export declare const useAllRoleAssignments: (querySettings: QuerySettings) => import("@tanstack/react-query").UseQueryResult<GetAllRoleAssignmentsResponse, Error>;
+/**
+ * React Query hook to fetch a paginated, searchable list of organizations.
+ * Results are cached for 30 minutes — suitable for both filter dropdowns and full listings.
+ *
+ * @param search - Optional text filter applied to organization names.
+ * @param page - 1-based page number; defaults to the first page when omitted.
+ * @param pageSize - Items per page; defaults to the API default when omitted.
+ * @returns A `QueryResult<GetOrgsResponse>` with `results`, `count`, `next`, and `previous`.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useOrgs('edX');
+ * const orgs = data?.results ?? [];
+ * ```
+ */
+export declare const useOrgs: (search?: string, page?: number, pageSize?: number) => import("@tanstack/react-query").UseQueryResult<GetOrgsResponse, Error>;
+/**
+ * React Query hook to fetch a paginated, filterable list of scopes (courses or libraries).
+ * Uses infinite query to support infinite scroll — call `fetchNextPage` to load more results.
+ *
+ * @param params - Filter parameters (all optional):
+ *   - `search` — text filter applied to scope names
+ *   - `scopeType` — filter by scope type (e.g. course, library)
+ *   - `org` — filter by organization
+ *   - `pageSize` — number of items per page
+ *   - `managementPermissionOnly` — when true, returns only scopes the requester can manage
+ * @returns An `InfiniteQueryResult` whose `data.pages` contains the accumulated `GetScopesResponse` pages.
+ *
+ * @example
+ * ```tsx
+ * const { data, fetchNextPage, hasNextPage } = useScopes({ search: 'intro', orgs: ['edX'] });
+ * const scopes = data?.pages.flatMap((p) => p.results) ?? [];
+ * ```
+ */
+export declare const useScopes: (params?: Omit<GetScopesParams, "page">) => import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/query-core").InfiniteData<GetScopesResponse, unknown>, Error>;
+export declare const useUserAssignedRoles: (username?: string, querySettings?: QuerySettings) => import("@tanstack/react-query").UseQueryResult<GetUserAssignmentsResponse, Error>;
+/**
+ * React Query hook to fetch the enablement state of the course-authoring waffle flag
+ * across scopes (global, org overrides, course overrides).
+ *
+ * Follows the same caching rules as the permission-validation hooks.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useCourseAuthoringFlagStates();
+ * ```
+ */
+export declare const useCourseAuthoringFlagStates: () => import("@tanstack/react-query").UseQueryResult<CourseAuthoringFlagStates, Error>;

package/dist/authz-module/data/hooks.js

@@ -0,0 +1,191 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { useInfiniteQuery, useMutation, useQuery, useQueryClient, } from '@tanstack/react-query';
+import { appId } from '../../constants';
+import { assignTeamMembersRole, getAllRoleAssignments, getOrgs, getScopes, revokeUserRoles, getUserAssignedRoles, validateUsers, getCourseAuthoringFlagStates, } from './api';
+const authzQueryKeys = {
+    all: [appId, 'authz'],
+    allRoleAssignments: (querySettings) => [...authzQueryKeys.all, 'allRoleAssignments', querySettings],
+    orgs: (search, page, pageSize) => [...authzQueryKeys.all, 'organizations', search, page, pageSize],
+    scopes: (params) => [...authzQueryKeys.all, 'scopes', params],
+    userRoles: (username, querySettings) => [...authzQueryKeys.all, 'userRoles', username, querySettings],
+    courseAuthoringFlagStates: () => [...authzQueryKeys.all, 'courseAuthoringFlagStates'],
+};
+/**
+ * React Query hook to add new team members to a specific scope or manage the corresponding roles.
+ * It provides a mutation function to add users with specified roles to the team or assign new roles.
+ *
+ * @example
+ * const { mutate: assignTeamMembersRole } = useAssignTeamMembersRole();
+ * assignTeamMembersRole({ data: { libraryId: 'lib:123', users: ['jdoe'], role: 'editor' } });
+ */
+export const useAssignTeamMembersRole = () => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (_a) => __awaiter(void 0, [_a], void 0, function* ({ data }) { return assignTeamMembersRole(data); }),
+        onSettled: (_data, error) => {
+            if (!error) {
+                queryClient.invalidateQueries({ queryKey: [...authzQueryKeys.all, 'userRoles'] });
+                queryClient.invalidateQueries({
+                    predicate: (query) => query.queryKey.includes('allRoleAssignments'),
+                });
+            }
+        },
+    });
+};
+/**
+ * React Query hook to validate users exist without assigning roles.
+ * It checks if the provided usernames/email addresses are valid.
+ *
+ * @example
+ * const { mutate: validateUsers } = useValidateUsers();
+ * validateUsers({ data: { users: ['jdoe', 'jane@example.com'] } });
+ */
+export const useValidateUsers = () => useMutation({
+    mutationFn: (_a) => __awaiter(void 0, [_a], void 0, function* ({ data }) { return validateUsers(data); }),
+});
+/**
+ * React Query hook to remove roles for a specific team member within a scope.
+ *
+ * @example
+ * const { mutate: revokeUserRoles } = useRevokeUserRoles();
+ * revokeUserRoles({ data: { libraryId: 'lib:123', users: ['jdoe'], role: 'editor' } });
+ */
+export const useRevokeUserRoles = () => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (_a) => __awaiter(void 0, [_a], void 0, function* ({ data }) { return revokeUserRoles(data); }),
+        onSettled: () => {
+            queryClient.invalidateQueries({
+                predicate: (query) => query.queryKey.includes('userRoles'),
+            });
+            queryClient.invalidateQueries({
+                predicate: (query) => query.queryKey.includes('allRoleAssignments'),
+            });
+        },
+    });
+};
+/**
+ * React Query hook to fetch all role assignments across scopes and roles,
+ * with support for filtering, sorting, and pagination.
+ * It retrieves a comprehensive list of user-role assignments based
+ * on the provided query settings.
+ *
+ * @param querySettings - Optional parameters for filtering by roles, scopes,
+ * organizations, search term, sorting, and pagination.
+ *
+ * @example
+ * const { data: roleAssignments } = useAllRoleAssignments({ roles: 'editor', pageSize: 20 });
+ */
+export const useAllRoleAssignments = (querySettings) => {
+    const result = useQuery({
+        queryKey: authzQueryKeys.allRoleAssignments(querySettings),
+        queryFn: () => getAllRoleAssignments(querySettings),
+        staleTime: 1000 * 60 * 30, // refetch after 30 minutes
+        retry: false,
+        refetchOnWindowFocus: false,
+    });
+    return result;
+};
+/**
+ * React Query hook to fetch a paginated, searchable list of organizations.
+ * Results are cached for 30 minutes — suitable for both filter dropdowns and full listings.
+ *
+ * @param search - Optional text filter applied to organization names.
+ * @param page - 1-based page number; defaults to the first page when omitted.
+ * @param pageSize - Items per page; defaults to the API default when omitted.
+ * @returns A `QueryResult<GetOrgsResponse>` with `results`, `count`, `next`, and `previous`.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useOrgs('edX');
+ * const orgs = data?.results ?? [];
+ * ```
+ */
+export const useOrgs = (search, page, pageSize) => useQuery({
+    queryKey: authzQueryKeys.orgs(search, page, pageSize),
+    queryFn: () => getOrgs(search, page, pageSize),
+    staleTime: 1000 * 60 * 30,
+    refetchOnWindowFocus: false,
+});
+/**
+ * React Query hook to fetch a paginated, filterable list of scopes (courses or libraries).
+ * Uses infinite query to support infinite scroll — call `fetchNextPage` to load more results.
+ *
+ * @param params - Filter parameters (all optional):
+ *   - `search` — text filter applied to scope names
+ *   - `scopeType` — filter by scope type (e.g. course, library)
+ *   - `org` — filter by organization
+ *   - `pageSize` — number of items per page
+ *   - `managementPermissionOnly` — when true, returns only scopes the requester can manage
+ * @returns An `InfiniteQueryResult` whose `data.pages` contains the accumulated `GetScopesResponse` pages.
+ *
+ * @example
+ * ```tsx
+ * const { data, fetchNextPage, hasNextPage } = useScopes({ search: 'intro', orgs: ['edX'] });
+ * const scopes = data?.pages.flatMap((p) => p.results) ?? [];
+ * ```
+ */
+export const useScopes = (params = {}) => useInfiniteQuery({
+    queryKey: authzQueryKeys.scopes(params),
+    queryFn: ({ pageParam }) => getScopes(Object.assign(Object.assign({}, params), { page: pageParam })),
+    getNextPageParam: (lastPage) => {
+        if (!lastPage.next)
+            return undefined;
+        try {
+            const nextUrl = new URL(lastPage.next);
+            const page = nextUrl.searchParams.get('page');
+            return page ? parseInt(page, 10) : undefined;
+        }
+        catch (_a) {
+            return undefined;
+        }
+    },
+    initialPageParam: 1,
+    staleTime: 1000 * 60 * 5,
+    refetchOnWindowFocus: false,
+});
+/*
+  * React Query hook to fetch all the roles assigned to a specific user.
+  * It retrieves the full list of roles with the corresponding permissions.
+  * @param username - The username of the user
+  * @param querySettings - Optional query parameters for filtering, sorting, and pagination
+  *
+  * @example
+  * ```tsx
+  * const { data: userRoles } = useUserAssignedRoles('jdoe', querySettings);
+  * ```
+*/
+export const useUserAssignedRoles = (username, querySettings) => useQuery({
+    queryKey: authzQueryKeys.userRoles(username, querySettings),
+    queryFn: () => getUserAssignedRoles(username, querySettings),
+    staleTime: 1000 * 60 * 30, // refetch after 30 minutes
+    enabled: !!username,
+    refetchOnWindowFocus: false,
+});
+/**
+ * React Query hook to fetch the enablement state of the course-authoring waffle flag
+ * across scopes (global, org overrides, course overrides).
+ *
+ * Follows the same caching rules as the permission-validation hooks.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useCourseAuthoringFlagStates();
+ * ```
+ */
+export const useCourseAuthoringFlagStates = () => useQuery({
+    queryKey: authzQueryKeys.courseAuthoringFlagStates(),
+    queryFn: () => getCourseAuthoringFlagStates(),
+    staleTime: 1000 * 60 * 30,
+    refetchOnWindowFocus: false,
+    retry: false,
+});
+//# sourceMappingURL=hooks.js.map

package/dist/authz-module/data/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/authz-module/data/hooks.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  useInfiniteQuery, useMutation, useQuery, useQueryClient,\n} from '@tanstack/react-query';\nimport { appId } from '@src/constants';\nimport {\n  assignTeamMembersRole, AssignTeamMembersRoleRequest, getAllRoleAssignments,\n  GetAllRoleAssignmentsResponse, getOrgs, GetOrgsResponse,\n  getScopes, GetScopesResponse, QuerySettings, revokeUserRoles,\n  RevokeUserRolesRequest, getUserAssignedRoles, GetUserAssignmentsResponse,\n  validateUsers, ValidateUsersRequest, GetScopesParams,\n  getCourseAuthoringFlagStates, CourseAuthoringFlagStates,\n} from './api';\n\nconst authzQueryKeys = {\n  all: [appId, 'authz'] as const,\n  allRoleAssignments: (querySettings?: QuerySettings) => [...authzQueryKeys.all, 'allRoleAssignments', querySettings] as const,\n  orgs: (search?: string, page?: number, pageSize?: number) => [...authzQueryKeys.all, 'organizations', search, page, pageSize] as const,\n  scopes: (params?: Omit<GetScopesParams, 'page'>) => [...authzQueryKeys.all, 'scopes', params] as const,\n  userRoles: (username?: string, querySettings?: QuerySettings) => [...authzQueryKeys.all, 'userRoles', username, querySettings] as const,\n  courseAuthoringFlagStates: () => [...authzQueryKeys.all, 'courseAuthoringFlagStates'] as const,\n};\n\n/**\n * React Query hook to add new team members to a specific scope or manage the corresponding roles.\n * It provides a mutation function to add users with specified roles to the team or assign new roles.\n *\n * @example\n * const { mutate: assignTeamMembersRole } = useAssignTeamMembersRole();\n * assignTeamMembersRole({ data: { libraryId: 'lib:123', users: ['jdoe'], role: 'editor' } });\n */\nexport const useAssignTeamMembersRole = () => {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async ({ data }: {\n      data: AssignTeamMembersRoleRequest;\n    }) => assignTeamMembersRole(data),\n    onSettled: (_data, error) => {\n      if (!error) {\n        queryClient.invalidateQueries({ queryKey: [...authzQueryKeys.all, 'userRoles'] });\n        queryClient.invalidateQueries({\n          predicate: (query) => query.queryKey.includes('allRoleAssignments'),\n        });\n      }\n    },\n  });\n};\n\n/**\n * React Query hook to validate users exist without assigning roles.\n * It checks if the provided usernames/email addresses are valid.\n *\n * @example\n * const { mutate: validateUsers } = useValidateUsers();\n * validateUsers({ data: { users: ['jdoe', 'jane@example.com'] } });\n */\nexport const useValidateUsers = () => useMutation({\n  mutationFn: async ({ data }: {\n    data: ValidateUsersRequest;\n  }) => validateUsers(data),\n});\n\n/**\n * React Query hook to remove roles for a specific team member within a scope.\n *\n * @example\n * const { mutate: revokeUserRoles } = useRevokeUserRoles();\n * revokeUserRoles({ data: { libraryId: 'lib:123', users: ['jdoe'], role: 'editor' } });\n */\nexport const useRevokeUserRoles = () => {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async ({ data }: {\n      data: RevokeUserRolesRequest;\n    }) => revokeUserRoles(data),\n    onSettled: () => {\n      queryClient.invalidateQueries({\n        predicate: (query) => query.queryKey.includes('userRoles'),\n      });\n      queryClient.invalidateQueries({\n        predicate: (query) => query.queryKey.includes('allRoleAssignments'),\n      });\n    },\n  });\n};\n\n/**\n * React Query hook to fetch all role assignments across scopes and roles,\n * with support for filtering, sorting, and pagination.\n * It retrieves a comprehensive list of user-role assignments based\n * on the provided query settings.\n *\n * @param querySettings - Optional parameters for filtering by roles, scopes,\n * organizations, search term, sorting, and pagination.\n *\n * @example\n * const { data: roleAssignments } = useAllRoleAssignments({ roles: 'editor', pageSize: 20 });\n */\nexport const useAllRoleAssignments = (querySettings: QuerySettings) => {\n  const result = useQuery<GetAllRoleAssignmentsResponse, Error>({\n    queryKey: authzQueryKeys.allRoleAssignments(querySettings),\n    queryFn: () => getAllRoleAssignments(querySettings),\n    staleTime: 1000 * 60 * 30, // refetch after 30 minutes\n    retry: false,\n    refetchOnWindowFocus: false,\n  });\n  return result;\n};\n\n/**\n * React Query hook to fetch a paginated, searchable list of organizations.\n * Results are cached for 30 minutes — suitable for both filter dropdowns and full listings.\n *\n * @param search - Optional text filter applied to organization names.\n * @param page - 1-based page number; defaults to the first page when omitted.\n * @param pageSize - Items per page; defaults to the API default when omitted.\n * @returns A `QueryResult<GetOrgsResponse>` with `results`, `count`, `next`, and `previous`.\n *\n * @example\n * ```tsx\n * const { data } = useOrgs('edX');\n * const orgs = data?.results ?? [];\n * ```\n */\nexport const useOrgs = (search?: string, page?: number, pageSize?: number) => useQuery<GetOrgsResponse, Error>({\n  queryKey: authzQueryKeys.orgs(search, page, pageSize),\n  queryFn: () => getOrgs(search, page, pageSize),\n  staleTime: 1000 * 60 * 30,\n  refetchOnWindowFocus: false,\n});\n\n/**\n * React Query hook to fetch a paginated, filterable list of scopes (courses or libraries).\n * Uses infinite query to support infinite scroll — call `fetchNextPage` to load more results.\n *\n * @param params - Filter parameters (all optional):\n *   - `search` — text filter applied to scope names\n *   - `scopeType` — filter by scope type (e.g. course, library)\n *   - `org` — filter by organization\n *   - `pageSize` — number of items per page\n *   - `managementPermissionOnly` — when true, returns only scopes the requester can manage\n * @returns An `InfiniteQueryResult` whose `data.pages` contains the accumulated `GetScopesResponse` pages.\n *\n * @example\n * ```tsx\n * const { data, fetchNextPage, hasNextPage } = useScopes({ search: 'intro', orgs: ['edX'] });\n * const scopes = data?.pages.flatMap((p) => p.results) ?? [];\n * ```\n */\nexport const useScopes = (params: Omit<GetScopesParams, 'page'> = {}) => useInfiniteQuery<GetScopesResponse, Error>({\n  queryKey: authzQueryKeys.scopes(params),\n  queryFn: ({ pageParam }) => getScopes({ ...params, page: pageParam as number }),\n  getNextPageParam: (lastPage) => {\n    if (!lastPage.next) return undefined;\n    try {\n      const nextUrl = new URL(lastPage.next);\n      const page = nextUrl.searchParams.get('page');\n      return page ? parseInt(page, 10) : undefined;\n    } catch {\n      return undefined;\n    }\n  },\n  initialPageParam: 1,\n  staleTime: 1000 * 60 * 5,\n  refetchOnWindowFocus: false,\n});\n\n/*\n  * React Query hook to fetch all the roles assigned to a specific user.\n  * It retrieves the full list of roles with the corresponding permissions.\n  * @param username - The username of the user\n  * @param querySettings - Optional query parameters for filtering, sorting, and pagination\n  *\n  * @example\n  * ```tsx\n  * const { data: userRoles } = useUserAssignedRoles('jdoe', querySettings);\n  * ```\n*/\nexport const useUserAssignedRoles = (\n  username?: string,\n  querySettings?: QuerySettings,\n) => useQuery<GetUserAssignmentsResponse, Error>({\n  queryKey: authzQueryKeys.userRoles(username, querySettings),\n  queryFn: () => getUserAssignedRoles(username, querySettings),\n  staleTime: 1000 * 60 * 30, // refetch after 30 minutes\n  enabled: !!username,\n  refetchOnWindowFocus: false,\n});\n\n/**\n * React Query hook to fetch the enablement state of the course-authoring waffle flag\n * across scopes (global, org overrides, course overrides).\n *\n * Follows the same caching rules as the permission-validation hooks.\n *\n * @example\n * ```tsx\n * const { data } = useCourseAuthoringFlagStates();\n * ```\n */\nexport const useCourseAuthoringFlagStates = () => useQuery<CourseAuthoringFlagStates, Error>({\n  queryKey: authzQueryKeys.courseAuthoringFlagStates(),\n  queryFn: () => getCourseAuthoringFlagStates(),\n  staleTime: 1000 * 60 * 30,\n  refetchOnWindowFocus: false,\n  retry: false,\n});\n"]}

package/dist/authz-module/hooks/useCourseAuthoringFlag.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Resolve the course-authoring waffle flag state, both at the coarse domain level and
+ * per individual course scope.
+ *
+ * `isCourseAuthoringEnabled` is the domain-level gate (enabled anywhere) used to decide
+ * whether the authoring category should appear in controls like the roles filter.
+ *
+ * `isCourseEnabled(courseId)` resolves a single course against the overrides, applying
+ * the precedence course override -> org override -> global. Overrides only appear when
+ * they differ from `global`, so membership in the `on`/`off` lists is authoritative.
+ *
+ * `isOrgAuthoringEnabled(org)` resolves whether authoring is enabled for at least one
+ * course within an org: the org override forces it on, some course in the org is forced
+ * on, or (absent an off override) the global flag is on.
+ *
+ * While the flag states are loading, everything resolves to `false` so authoring scopes
+ * and roles stay hidden until enablement is known. If the fetch fails, a generic error
+ * toast (with retry) is surfaced and everything keeps resolving to `false`.
+ */
+export declare const useCourseAuthoringFlag: () => {
+    isCourseAuthoringEnabled: boolean;
+    isCourseEnabled: (courseId: string) => boolean;
+    isOrgAuthoringEnabled: (org: string) => boolean;
+    isLoading: boolean;
+    isError: boolean;
+};

package/dist/authz-module/hooks/useCourseAuthoringFlag.js

@@ -0,0 +1,86 @@
+import { useEffect, useMemo } from 'react';
+import { useCourseAuthoringFlagStates } from '../data/hooks';
+import { useToastManager } from '../../components/ToastManager/ToastManagerContext';
+/**
+ * Extract the org short name from a course external key.
+ * e.g. `course-v1:testing+CT01+CT01-2024` -> `testing`
+ */
+const orgOf = (courseId) => { var _a; return (_a = courseId.split(':')[1]) === null || _a === void 0 ? void 0 : _a.split('+')[0]; };
+// Several components on the same page consume this hook and share the underlying query,
+// so they all observe the same error instance; track toasted errors to show one toast
+// per failure instead of one per consumer.
+const toastedErrors = new WeakSet();
+/**
+ * Resolve the course-authoring waffle flag state, both at the coarse domain level and
+ * per individual course scope.
+ *
+ * `isCourseAuthoringEnabled` is the domain-level gate (enabled anywhere) used to decide
+ * whether the authoring category should appear in controls like the roles filter.
+ *
+ * `isCourseEnabled(courseId)` resolves a single course against the overrides, applying
+ * the precedence course override -> org override -> global. Overrides only appear when
+ * they differ from `global`, so membership in the `on`/`off` lists is authoritative.
+ *
+ * `isOrgAuthoringEnabled(org)` resolves whether authoring is enabled for at least one
+ * course within an org: the org override forces it on, some course in the org is forced
+ * on, or (absent an off override) the global flag is on.
+ *
+ * While the flag states are loading, everything resolves to `false` so authoring scopes
+ * and roles stay hidden until enablement is known. If the fetch fails, a generic error
+ * toast (with retry) is surfaced and everything keeps resolving to `false`.
+ */
+export const useCourseAuthoringFlag = () => {
+    const { data: flagStates, isLoading, isError, error, refetch, } = useCourseAuthoringFlagStates();
+    const { showErrorToast } = useToastManager();
+    useEffect(() => {
+        if (error && !toastedErrors.has(error)) {
+            toastedErrors.add(error);
+            showErrorToast(error, refetch);
+        }
+    }, [error, refetch, showErrorToast]);
+    const isCourseAuthoringEnabled = flagStates
+        ? flagStates.global
+            || flagStates.orgOverrides.on.length > 0
+            || flagStates.courseOverrides.on.length > 0
+        : false;
+    const { isCourseEnabled, isOrgAuthoringEnabled } = useMemo(() => {
+        var _a, _b, _c, _d, _e;
+        const courseOn = new Set((_a = flagStates === null || flagStates === void 0 ? void 0 : flagStates.courseOverrides.on) !== null && _a !== void 0 ? _a : []);
+        const courseOff = new Set((_b = flagStates === null || flagStates === void 0 ? void 0 : flagStates.courseOverrides.off) !== null && _b !== void 0 ? _b : []);
+        const orgOn = new Set((_c = flagStates === null || flagStates === void 0 ? void 0 : flagStates.orgOverrides.on) !== null && _c !== void 0 ? _c : []);
+        const orgOff = new Set((_d = flagStates === null || flagStates === void 0 ? void 0 : flagStates.orgOverrides.off) !== null && _d !== void 0 ? _d : []);
+        const global = (_e = flagStates === null || flagStates === void 0 ? void 0 : flagStates.global) !== null && _e !== void 0 ? _e : false;
+        const courseEnabled = (courseId) => {
+            const courseFlagOverrideEnabled = courseOn.has(courseId);
+            const courseFlagOverrideDisabled = courseOff.has(courseId);
+            if (courseFlagOverrideEnabled)
+                return true;
+            if (courseFlagOverrideDisabled)
+                return false;
+            const org = orgOf(courseId);
+            const orgFlagOverrideEnabled = !!org && orgOn.has(org);
+            const orgFlagOverrideDisabled = !!org && orgOff.has(org);
+            if (orgFlagOverrideEnabled)
+                return true;
+            if (orgFlagOverrideDisabled)
+                return false;
+            return global;
+        };
+        const orgsWithForcedOnCourse = new Set([...courseOn].map(orgOf));
+        const orgAuthoringEnabled = (org) => {
+            const orgFlagOverrideEnabled = orgOn.has(org);
+            if (orgFlagOverrideEnabled)
+                return true;
+            if (orgsWithForcedOnCourse.has(org))
+                return true;
+            if (orgOff.has(org))
+                return false;
+            return global;
+        };
+        return { isCourseEnabled: courseEnabled, isOrgAuthoringEnabled: orgAuthoringEnabled };
+    }, [flagStates]);
+    return {
+        isCourseAuthoringEnabled, isCourseEnabled, isOrgAuthoringEnabled, isLoading, isError,
+    };
+};
+//# sourceMappingURL=useCourseAuthoringFlag.js.map

package/dist/authz-module/hooks/useCourseAuthoringFlag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCourseAuthoringFlag.js","sourceRoot":"","sources":["../../../src/authz-module/hooks/useCourseAuthoringFlag.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo } from 'react';\nimport { useCourseAuthoringFlagStates } from '@src/authz-module/data/hooks';\nimport { useToastManager } from '@src/components/ToastManager/ToastManagerContext';\n\n/**\n * Extract the org short name from a course external key.\n * e.g. `course-v1:testing+CT01+CT01-2024` -> `testing`\n */\nconst orgOf = (courseId: string): string | undefined => courseId.split(':')[1]?.split('+')[0];\n\n// Several components on the same page consume this hook and share the underlying query,\n// so they all observe the same error instance; track toasted errors to show one toast\n// per failure instead of one per consumer.\nconst toastedErrors = new WeakSet<Error>();\n\n/**\n * Resolve the course-authoring waffle flag state, both at the coarse domain level and\n * per individual course scope.\n *\n * `isCourseAuthoringEnabled` is the domain-level gate (enabled anywhere) used to decide\n * whether the authoring category should appear in controls like the roles filter.\n *\n * `isCourseEnabled(courseId)` resolves a single course against the overrides, applying\n * the precedence course override -> org override -> global. Overrides only appear when\n * they differ from `global`, so membership in the `on`/`off` lists is authoritative.\n *\n * `isOrgAuthoringEnabled(org)` resolves whether authoring is enabled for at least one\n * course within an org: the org override forces it on, some course in the org is forced\n * on, or (absent an off override) the global flag is on.\n *\n * While the flag states are loading, everything resolves to `false` so authoring scopes\n * and roles stay hidden until enablement is known. If the fetch fails, a generic error\n * toast (with retry) is surfaced and everything keeps resolving to `false`.\n */\nexport const useCourseAuthoringFlag = () => {\n  const {\n    data: flagStates, isLoading, isError, error, refetch,\n  } = useCourseAuthoringFlagStates();\n  const { showErrorToast } = useToastManager();\n\n  useEffect(() => {\n    if (error && !toastedErrors.has(error)) {\n      toastedErrors.add(error);\n      showErrorToast(error, refetch);\n    }\n  }, [error, refetch, showErrorToast]);\n\n  const isCourseAuthoringEnabled = flagStates\n    ? flagStates.global\n    || flagStates.orgOverrides.on.length > 0\n    || flagStates.courseOverrides.on.length > 0\n    : false;\n\n  const { isCourseEnabled, isOrgAuthoringEnabled } = useMemo(() => {\n    const courseOn = new Set(flagStates?.courseOverrides.on ?? []);\n    const courseOff = new Set(flagStates?.courseOverrides.off ?? []);\n    const orgOn = new Set(flagStates?.orgOverrides.on ?? []);\n    const orgOff = new Set(flagStates?.orgOverrides.off ?? []);\n    const global = flagStates?.global ?? false;\n\n    const courseEnabled = (courseId: string): boolean => {\n      const courseFlagOverrideEnabled = courseOn.has(courseId);\n      const courseFlagOverrideDisabled = courseOff.has(courseId);\n      if (courseFlagOverrideEnabled) return true;\n      if (courseFlagOverrideDisabled) return false;\n      const org = orgOf(courseId);\n      const orgFlagOverrideEnabled = !!org && orgOn.has(org);\n      const orgFlagOverrideDisabled = !!org && orgOff.has(org);\n      if (orgFlagOverrideEnabled) return true;\n      if (orgFlagOverrideDisabled) return false;\n      return global;\n    };\n\n    const orgsWithForcedOnCourse = new Set([...courseOn].map(orgOf));\n\n    const orgAuthoringEnabled = (org: string): boolean => {\n      const orgFlagOverrideEnabled = orgOn.has(org);\n      if (orgFlagOverrideEnabled) return true;\n      if (orgsWithForcedOnCourse.has(org)) return true;\n      if (orgOff.has(org)) return false;\n      return global;\n    };\n\n    return { isCourseEnabled: courseEnabled, isOrgAuthoringEnabled: orgAuthoringEnabled };\n  }, [flagStates]);\n\n  return {\n    isCourseAuthoringEnabled, isCourseEnabled, isOrgAuthoringEnabled, isLoading, isError,\n  };\n};\n"]}

package/dist/authz-module/hooks/useQuerySettings.d.ts

@@ -0,0 +1,27 @@
+import { QuerySettings } from '../data/api';
+interface DataTableFilters {
+    pageSize: number;
+    pageIndex: number;
+    sortBy: {
+        id: string;
+        desc: boolean;
+    }[];
+    filters: {
+        id: string;
+        value: any;
+    }[];
+}
+interface UseQuerySettingsReturn {
+    querySettings: QuerySettings;
+    handleTableFetch: (tableFilters: DataTableFilters) => void;
+}
+/**
+ * Custom hook to manage query settings for table data fetching
+ * Converts DataTable filter/sort/pagination settings to API query parameters
+ * and manages URL synchronization
+ *
+ * @param initialQuerySettings - Initial query settings
+ * @returns Object containing querySettings and handleTableFetch function
+ */
+export declare const useQuerySettings: (initialQuerySettings?: QuerySettings) => UseQuerySettingsReturn;
+export {};