@mikezimm/fps-core-v7/lib/restAPIs/permissions/getWebRoleAssignmentsAPI.js

Library of reusable core interfaces, types and constants migrated from fps-library-v2

import { check4This, Check4 } from "../../logic/Links/CheckSearch";
import { doSpHttpFetchOrPostAndCheck } from "../../components/molecules/SpHttp/Sp/doSpHttpFetch";
import { SourcePropsNoWebUrl } from "../../components/molecules/source-props/ISourceProps";
import { makeAbsoluteUrl } from "../../logic/Strings/getSiteCollectionUrlFromLink";
import { createErrorFpsListReturn } from "../../components/molecules/process-results/createErrorFpsListItemsReturn";
/**
 * 2025-01-03:  Migrated from fps-library-v2/lib/pnpjs/Permissions, pnp2/lib/services/sp/perms
 * combination of v2:  getWebRoleAssignmentsD and pnp2: fetchWebPermsD
 *
 * getWebRoleAssignmentsAPI gets all the web's Members and RoleDefinitionBindings combined.
 *
 * import { getWebRoleAssignmentsAPI } from '@mikezimm/fps-core-v7/lib/restAPIs/permissions/getWebRoleAssignmentsAPI';
 *
 * @param fpsSpService
 * @param webUrl
 * @param alertMe
 * @param consoleLog
 * @returns
 */
export async function getWebRoleAssignmentsAPI(fpsSpService, webUrl, alertMe, consoleLog) {
    const useUrl = makeAbsoluteUrl(webUrl);
    if (!useUrl) {
        // NO WebURL... Throw Alert
        if (alertMe === true)
            alert(`getGroupInfoAPI: ${SourcePropsNoWebUrl}`);
        const results = createErrorFpsListReturn(useUrl, '');
        results.status = 'NoWeb';
        results.HasUniqueRoleAssignments = false;
        results.RoleAssignments = [];
        return results;
    }
    let fetchAPIWeb = `${useUrl}/_api/web?`;
    fetchAPIWeb += `$select=Title,ServerRelativeUrl,Id,HasUniqueRoleAssignments`;
    let fetchAPIRoles = `${useUrl}/_api/web/RoleAssignments?`;
    fetchAPIRoles += `$expand=Member,RoleDefinitionBindings`;
    /***
     * This little fetchAPI should get an array of items with:
     * PrinicpalId
     * Member: [],
     * RoleDefinitionBindings:
     */
    const [web, roles,] = await Promise.all([
        doSpHttpFetchOrPostAndCheck(fetchAPIWeb, 'GET', fpsSpService, '', alertMe, consoleLog, 'web', false, null),
        doSpHttpFetchOrPostAndCheck(fetchAPIRoles, 'GET', fpsSpService, '', alertMe, consoleLog, 'roles', false, null),
    ]);
    const result = web;
    result.HasUniqueRoleAssignments = web.item.HasUniqueRoleAssignments;
    result.RoleAssignments = roles.items;
    result.item = web;
    result.items = roles; // Just adding the full return object here for completeness
    if (check4This(Check4.fpsShowFetchResults_Eq_true) === true) {
        console.log(`fps-core-v7 COMPLETE: getWebRoleAssignmentsAPI ~ 65`, result);
    }
    ;
    return result;
}
//# sourceMappingURL=getWebRoleAssignmentsAPI.js.map