@mikezimm/fps-core-v7 1.0.73 → 1.0.75

package/lib/restAPIs/logging/Permissions/savePermissionAnalyticsAPI.js

@@ -0,0 +1,150 @@
+import { getHelpfullError } from '../../../logic/Errors/friendly';
+import { getCurrentPageLink, getUrlVarsAsStrings, getWebUrlFromLink, makeListLink, makeSiteLink } from '../../../logic/Links/UrlFunctions';
+import * as AL from '../interfaces/EasyContents';
+import { check4This } from '../../../logic/Links/CheckSearch';
+import { createAnalyticsSourceProps } from '../../../components/atoms/easy-analytics/functions/createAnalyticsSourceProps';
+import { postSourceItemAPI } from '../../lists/items/postSourceItemAPI';
+import { makeAbsoluteUrl } from '../../../logic/Strings/getSiteCollectionUrlFromLink';
+/**
+ * 2024-12-08:  EVALUATE Refactoring this...  it may be really close to saveAnalytics2,3,4
+ *    After further review, this could be condensed and combined with savePermissionHistoryD.
+ *    Just add it in the if-save loop once it's smaller.
+ *    And of course, send to saveAnalytics4
+ *
+ * 2025-01-03:  Migrated from fps-library-v2/lib/pnpjs/Permissions, pnp2/lib/services/sp/perms
+ * combination of v2:  savePermissionAnalyticsD,
+ *
+ * import { savePermissionAnalyticsAPI } from "@mikezimm/fps-core-v7/lib/restAPIs/Logging/Permissions/savePermissionAnalyticsAPI";
+ *
+ *
+ * @param analyticsWeb
+ * @param analyticsList
+ * @param SiteLink
+ * @param webTitle
+ * @param saveTitle
+ * @param TargetSite
+ * @param TargetList
+ * @param itemInfo1
+ * @param itemInfo2
+ * @param result
+ * @param RichTextJSON1
+ * @param Setting
+ * @param RichTextJSON2
+ * @param RichTextJSON3
+ * @returns
+ */
+export async function savePermissionAnalyticsAPI(fpsSpService, analyticsWeb, analyticsList, SiteLink, webTitle, saveTitle, TargetSite, TargetList, itemInfo1, itemInfo2, result, RichTextJSON1, Setting, RichTextJSON2, RichTextJSON3) {
+    //Do nothing if either of these strings is blank
+    if (!analyticsList) {
+        return;
+    }
+    if (!analyticsWeb) {
+        return;
+    }
+    let finalSaveObject = {
+        Title: saveTitle,
+        Result: result,
+        PageLink: getCurrentPageLink(), // REFACTOR NOTE:  saveAnalytics2 handles the PageLink for you.
+    };
+    let startTime = getTheCurrentTime();
+    finalSaveObject.zzzText1 = startTime.now;
+    finalSaveObject.zzzText2 = startTime.theTime;
+    let TargetListValues = TargetList ? TargetList.split('|') : [null];
+    finalSaveObject.getParams = getUrlVarsAsStrings().join(' & ');
+    finalSaveObject.Setting = Setting;
+    /**
+     * REFACTOR NOTE:  saveAnalytics2 handles the strignifying this automatically.
+     */
+    // console.log('saveAnalytics StringifyActionJson: ', RichTextJSON1, RichTextJSON2, RichTextJSON3 );
+    if (RichTextJSON1)
+        finalSaveObject.zzzRichText1 = JSON.stringify(RichTextJSON1);
+    if (RichTextJSON2)
+        finalSaveObject.zzzRichText2 = JSON.stringify(RichTextJSON2);
+    if (RichTextJSON3)
+        finalSaveObject.zzzRichText3 = JSON.stringify(RichTextJSON3);
+    // ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+    if (analyticsList === AL.EasyContentsRailsGroups ||
+        analyticsList === AL.EasyContentsRailsApply ||
+        analyticsList === AL.PermissionsHistory) { //Rails Off
+        finalSaveObject.ListTitle = itemInfo1;
+        let infos2 = itemInfo2 ? itemInfo2.split('|') : [];
+        finalSaveObject.zzzText3 = infos2[0];
+        finalSaveObject.zzzText7 = infos2[1] ? parseInt(infos2[1]) < 10 ? '0' + infos2[1] : infos2[1] : undefined; //stepOrder
+        finalSaveObject.zzzNumber4 = infos2[2] ? parseInt(infos2[2]) : undefined;
+        finalSaveObject.zzzNumber5 = infos2[3] ? parseInt(infos2[3]) : undefined;
+        finalSaveObject.zzzText1 = infos2[4] ? infos2[4] : undefined;
+        finalSaveObject.zzzText4 = infos2[5] ? infos2[5] : undefined;
+        let tempSite = TargetSite ? TargetSite.split('|') : [];
+        TargetSite = tempSite[0] ? tempSite[0] : null;
+        finalSaveObject.WebID = tempSite[1] ? tempSite[1] : null;
+        finalSaveObject.CollectionUrl = tempSite[2] ? tempSite[2] : null;
+        finalSaveObject.SiteID = tempSite[3] ? tempSite[3] : null;
+        finalSaveObject.zzzText5 = finalSaveObject.SiteID;
+        //Add List ID if it's available
+        if (TargetListValues.length > 0 && TargetListValues[1]) {
+            finalSaveObject.ListID = TargetListValues[1];
+        }
+        let tempTitle = saveTitle.split('|');
+        finalSaveObject.zzzText6 = tempTitle[1] ? tempTitle[1] : undefined; //Get scope - site or list
+    }
+    else {
+        finalSaveObject.zzzText3 = itemInfo1;
+        finalSaveObject.zzzText4 = itemInfo2;
+    }
+    /**
+     * WARNING, ALWAYS be sure to add this saving items - Pivot Tiles Permissions Save ;(
+     */
+    // finalSaveObject.__metadata = { type: `SP.Data.${analyticsList}ListItem` };
+    /**
+     * REFACTOR NOTE:  saveAnalytics2 handles the Site Link for you automatically.
+     */
+    SiteLink = getWebUrlFromLink(SiteLink, 'abs');
+    if (webTitle === '' || !webTitle) {
+        finalSaveObject.SiteTitle = SiteLink.substring(SiteLink.lastIndexOf("/") + 1);
+    }
+    finalSaveObject.SiteLink = {
+        'Url': makeAbsoluteUrl(SiteLink),
+        'Description': finalSaveObject.SiteTitle,
+    };
+    // ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+    /**
+     * REFACTOR NOTE:  saveAnalytics2 handles TargetSite and TargetList automatically.
+     *  NOTE:  You need to just add the url to the subproperty:  loadProperties.TargetSite, loadProperties.TargetList
+     */
+    if (TargetSite)
+        finalSaveObject.TargetSite = makeSiteLink(TargetSite, finalSaveObject.SiteTitle);
+    if (TargetList)
+        finalSaveObject.TargetList = makeListLink(TargetListValues[0], webTitle);
+    // ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+    /**
+     * REFACTOR NOTE:  saveAnalytics2 handles creating SourceProps, DigestValue and the call
+     *  NOTE:  You need to just add the url to the subproperty:  loadProperties.TargetSite, loadProperties.TargetList
+     */
+    // https://github.com/mikezimm/pivottiles7/issues/417
+    const sourceProps = createAnalyticsSourceProps(fpsSpService, `${analyticsList}`, analyticsWeb);
+    // 2024-12-22:  digestValue not required when using SpHTTPClient
+    // sourceProps.digestValue = await getThisFPSDigestValueFromUrl(analyticsWeb);
+    const saveResult = await postSourceItemAPI(sourceProps, finalSaveObject, false, true);
+    // ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+    // This was the Pnp2 call:
+    // const saveResult = await saveThisLogItemAsync( analyticsWeb, analyticsList, finalSaveObject, false );
+    if (saveResult.status !== 'Success') {
+        const err = getHelpfullError(saveResult, false, false, true);
+        if (check4This(`fpsShowFetchResults=true`) === true) {
+            console.log(`fps-core-v7 ERROR: savePermissionAnalytics ~ 181`, err);
+            alert(`saveThisLogItemError\n\n${err.friendly}`);
+        }
+        ;
+    }
+}
+export function getTheCurrentTime() {
+    const now = new Date();
+    const theTime = now.getHours() + ":" + now.getMinutes() + ":" + now.getSeconds() + "." + now.getMilliseconds();
+    let result = {
+        'now': now,
+        'theTime': theTime,
+        'milliseconds': now.getMilliseconds(),
+    };
+    return result;
+}
+//# sourceMappingURL=savePermissionAnalyticsAPI.js.map

package/lib/restAPIs/logging/Permissions/savePermissionAnalyticsAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savePermissionAnalyticsAPI.js","sourceRoot":"","sources":["../../../../src/restAPIs/logging/Permissions/savePermissionAnalyticsAPI.ts"],"names":[],"mappings":"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"}

package/lib/restAPIs/logging/Permissions/savePermissionHistory.d.ts

@@ -0,0 +1,26 @@
+import { IFpsSpHttpServiceMIN } from '../../../components/molecules/SpHttp/Sp/IFpsSpHttpServiceMIN';
+/**
+ * 2025-01-03:  Migrated from fps-library-v2/lib/pnpjs/Permissions, pnp2/lib/services/sp/perms
+ * combination of v2:  savePermissionHistoryD, savePermissionAnalyticsD fetchAnalyticsDD
+ *
+ * import { savePermissionHistory } from "@mikezimm/fps-core-v7/lib/restAPIs/Logging/Permissions/savePermissionHistory";
+ *
+ *
+ * This function is for automatically saving permissions from a web, list or library to list for later comparison.
+ * In Easy Contents, it's fired upon viewing rail function to view list permissions.
+ * It's also intended to be used in Pivot Tiles when clicking to view list and web permissions.
+ *
+ * It does require the list and web with the correct struture to save and then be recoverd in this webpart for comparison.
+ *
+ * So it's only going to execute in certain tenanats.
+ * If you see this and want to re-purpose it, update the function to suit your needs and adjust the window.location.origin check
+ *
+ * Best practice is just to update your site and list Url in strings:
+ *  Or just create the site:  SharePointAssist
+ *  And create the list:  Assists
+ *  And add the columns listed below in the save item
+    "analyticsListPermissionsHistory": "PermissionsHistory",
+ *
+*/
+export declare function savePermissionHistory(fpsSpService: IFpsSpHttpServiceMIN, analyticsWeb: string, analyticsList: string, SiteLink: any, webTitle: string, saveTitle: string, TargetSite: any, TargetList: any, itemInfo1: string, itemInfo2: string, result: string, RichTextJSON1: any, Setting: string, RichTextJSON2: any, RichTextJSON3: any, userName: string, BaseTrace: string): Promise<string>;
+//# sourceMappingURL=savePermissionHistory.d.ts.map

package/lib/restAPIs/logging/Permissions/savePermissionHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"savePermissionHistory.d.ts","sourceRoot":"","sources":["../../../../src/restAPIs/logging/Permissions/savePermissionHistory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AAGpG;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAEF,wBAAsB,qBAAqB,CAAE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EACjO,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6GxK"}

package/lib/restAPIs/logging/Permissions/savePermissionHistory.js

@@ -0,0 +1,119 @@
+import { msPerDay } from '../../../logic/Time/constants';
+import { savePermissionAnalyticsAPI } from './savePermissionAnalyticsAPI';
+import { getAnalyticsAPI } from '../Analytics/getAnalyticsAPI';
+/**
+ * 2025-01-03:  Migrated from fps-library-v2/lib/pnpjs/Permissions, pnp2/lib/services/sp/perms
+ * combination of v2:  savePermissionHistoryD, savePermissionAnalyticsD fetchAnalyticsDD
+ *
+ * import { savePermissionHistory } from "@mikezimm/fps-core-v7/lib/restAPIs/Logging/Permissions/savePermissionHistory";
+ *
+ *
+ * This function is for automatically saving permissions from a web, list or library to list for later comparison.
+ * In Easy Contents, it's fired upon viewing rail function to view list permissions.
+ * It's also intended to be used in Pivot Tiles when clicking to view list and web permissions.
+ *
+ * It does require the list and web with the correct struture to save and then be recoverd in this webpart for comparison.
+ *
+ * So it's only going to execute in certain tenanats.
+ * If you see this and want to re-purpose it, update the function to suit your needs and adjust the window.location.origin check
+ *
+ * Best practice is just to update your site and list Url in strings:
+ *  Or just create the site:  SharePointAssist
+ *  And create the list:  Assists
+ *  And add the columns listed below in the save item
+    "analyticsListPermissionsHistory": "PermissionsHistory",
+ *
+*/
+export async function savePermissionHistory(fpsSpService, analyticsWeb, analyticsList, SiteLink, webTitle, saveTitle, TargetSite, TargetList, itemInfo1, itemInfo2, result, RichTextJSON1, Setting, RichTextJSON2, RichTextJSON3, userName, BaseTrace) {
+    let prefetchStart = new Date();
+    let pickedWebguid = TargetSite.split('|')[1];
+    let theListId = TargetList.split('|')[1];
+    let fetchColumns = ['Created', 'Modified', 'Author/Name', 'Author/Id', 'Author/Title', 'Id',
+        'Title', 'zzzRichText3', 'zzzText3', 'Result', 'WebID', 'SiteID', 'CollectionUrl', 'ListID'
+    ];
+    /**
+     * In this case I chose to fetch the last 200 items to compare and see if the current user had any history.
+     * If not, it will save the permissions even if it has not changed since another user checked.
+     * Choose 200 to make sure that it should almost always be enough to check the last day's worth of items.
+     */
+    /**
+     * REFACTOR NOTES:  IN place of this, review fetchAnalytics from EasyAnalytics, BUT just update the restFilter and top number
+     *  NOTE:  restFilter should be based on the pickedWebguid and theListId
+     */
+    //2022-08-29:  Refactored return statement to fix compile warning.
+    const analyticsResults = await getAnalyticsAPI(fpsSpService, analyticsWeb, analyticsList, pickedWebguid, theListId, true, fetchColumns, 200, BaseTrace);
+    let items = analyticsResults.items;
+    let lastIsSame = false;
+    // console.log('RichTextJSON3', RichTextJSON3 );
+    RichTextJSON3 = JSON.stringify(RichTextJSON3);
+    //console.log('RichTextJSON3 length = ', RichTextJSON3.length, RichTextJSON3 );
+    let lastTimeCurrentUserSaved = null;
+    let saveThisSnapshot = false;
+    let checkedOtherUsers = false;
+    let foundMyItem = false;
+    //2022-08-29:  Refactored return statement to fix compile warning.
+    //Wrapped items.map in if ( items ) check to make sure items has a value.
+    if (items) {
+        items.map((item, index) => {
+            if (saveThisSnapshot === false && foundMyItem === false) {
+                let itemFromCurrentUser = false;
+                let itemAny = item;
+                if (itemAny.Author.Name.indexOf(userName) > -1) {
+                    //   console.log('You saved this item:', item );
+                    lastTimeCurrentUserSaved = new Date(item.Created);
+                    itemFromCurrentUser = true;
+                    foundMyItem = true;
+                }
+                let userDeltaTime = itemFromCurrentUser === false ? null : prefetchStart.getTime() - lastTimeCurrentUserSaved.getTime();
+                if (itemFromCurrentUser === true && userDeltaTime > msPerDay) { //one day = 24*60*60*1000
+                    saveThisSnapshot = true; //Save this item if the current user has not saved permissions in last 24 hours
+                }
+                else if (checkedOtherUsers === false && lastIsSame === false) { //this check happens if
+                    //This section checks if the current item has the same permissions settings as the current check
+                    let zzzRichText3 = item.zzzRichText3.replace(/\\\"/g, '"');
+                    zzzRichText3 = zzzRichText3.slice(1, -1); //Have to remove the leading and trailing ""
+                    //   console.log('zzzRichText3 length = ', zzzRichText3.length, zzzRichText3 );
+                    let thisHasUniqueRoleAssignments = itemInfo2.split('|')[0];
+                    console.log('compareHasUnique ~ perm.ts 83', item.zzzText3, thisHasUniqueRoleAssignments);
+                    if (item.zzzText3 === thisHasUniqueRoleAssignments
+                        && zzzRichText3.length === RichTextJSON3.length
+                        && zzzRichText3 === RichTextJSON3) {
+                        lastIsSame = true;
+                    }
+                    checkedOtherUsers = true; //This is used so it only does this check one time.
+                }
+            }
+        });
+        //Final check for other conditions to save.
+        if (saveThisSnapshot === true) {
+            //No need for further checks
+        }
+        if (foundMyItem === false) { //automatically save since this user never saved permissions
+            saveThisSnapshot = true;
+        }
+        else if (lastIsSame === false) { //Save if the last item is not the same as current permissions
+            saveThisSnapshot = true;
+        }
+        let prefetchEnd = new Date();
+        let timeToPreFetch = prefetchEnd.getTime() - prefetchStart.getTime();
+        itemInfo2 += `||Time to check old Permissions: ${items.length} snaps / ${timeToPreFetch}ms`;
+        console.log('savePermissionHistory lastIsSame', lastIsSame);
+        if (saveThisSnapshot === true) {
+            RichTextJSON1 = JSON.stringify(RichTextJSON1);
+            RichTextJSON2 = JSON.stringify(RichTextJSON2);
+            savePermissionAnalyticsAPI(fpsSpService, analyticsWeb, analyticsList, //analyticsWeb, analyticsList,
+            SiteLink, webTitle, //serverRelativeUrl, webTitle,
+            saveTitle, TargetSite, TargetList, //saveTitle, TargetSite, TargetList
+            itemInfo1, itemInfo2, result, //itemInfo1, itemInfo2, result,
+            RichTextJSON1, Setting, RichTextJSON2, RichTextJSON3); //richText, Setting, richText2, richText3
+        }
+        return `Success`;
+    }
+    else {
+        //2022-08-29:  Refactored return statement to fix compile warning.
+        const errMessage = `Unable to fetch permission analytics....`;
+        console.log(`restAPIs/Logging/Permissions: ${errMessage}`);
+        return errMessage;
+    }
+}
+//# sourceMappingURL=savePermissionHistory.js.map

package/lib/restAPIs/logging/Permissions/savePermissionHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savePermissionHistory.js","sourceRoot":"","sources":["../../../../src/restAPIs/logging/Permissions/savePermissionHistory.ts"],"names":[],"mappings":"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"}

package/lib/restAPIs/logging/Provisioning/saveProvisioning.d.ts

@@ -0,0 +1,35 @@
+/***
+ *    d88888b d8888b. .d8888.      d8888b. d8888b. d88888b .d8888. d88888b d888888b .d8888.
+ *    88'     88  `8D 88'  YP      88  `8D 88  `8D 88'     88'  YP 88'     `~~88~~' 88'  YP
+ *    88ooo   88oodD' `8bo.        88oodD' 88oobY' 88ooooo `8bo.   88ooooo    88    `8bo.
+ *    88~~~   88~~~     `Y8b.      88~~~   88`8b   88~~~~~   `Y8b. 88~~~~~    88      `Y8b.
+ *    88      88      db   8D      88      88 `88. 88.     db   8D 88.        88    db   8D
+ *    YP      88      `8888Y'      88      88   YD Y88888P `8888Y' Y88888P    YP    `8888Y'
+ *
+ *
+ */
+import { ILoadPerformance } from '../../../components/molecules/Performance/IPerformance';
+import { WebPartContextCopy_15_2 } from '../../../types/@msft/1.15.2/WebPartContext';
+import { IListInfo } from '../../../types/@pnp/@2.14.0/sp/lists';
+import { IMakeThisList } from '../../../components/molecules/Provisioning/interfaces/IMakeThisList';
+import { IFpsSpHttpServiceMIN } from '../../../components/molecules/SpHttp/Sp/IFpsSpHttpServiceMIN';
+/**
+ * 2025-01-03:  Migrated from fps-library-v2/lib/pnpjs/Permissions, pnp2/lib/services/sp/perms
+ * combination of v2:  saveProvisioningD and pnp2: saveAnalytics4D
+ *
+  import { saveProvisioning } from "@mikezimm/fps-core-v7/lib/restAPIs/Logging/Provisioning/saveProvisioning";
+
+ * @param context : WebPart Context
+ * @param analyticsListRailsApply :  Which Provisioning was applied => `${ApplyTemplate_Rail_SaveTitle} - v2.0.0.2`
+ * @param Title : `${ApplyTemplate_Rail_SaveTitle} - v2.0.0.2`
+ * @param Result
+ * @param panelVersionNumber
+ * @param zzzRichText1Obj : mapThisList
+ * @param Setting : this.props.railFunction
+ * @param zzzRichText2Obj : this.state.progress
+ * @param zzzRichText3Obj : this.state.history
+ * @param performanceObj
+ * @returns
+ */
+export declare function saveProvisioning(context: WebPartContextCopy_15_2, fpsSpService: IFpsSpHttpServiceMIN, analyticsListRailsApply: string, Title: string, Result: string, panelVersionNumber: string, makeList: IMakeThisList, targetList: Partial<IListInfo>, Setting: string, progress: any, history: any, performanceObj?: ILoadPerformance): boolean;
+//# sourceMappingURL=saveProvisioning.d.ts.map

package/lib/restAPIs/logging/Provisioning/saveProvisioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveProvisioning.d.ts","sourceRoot":"","sources":["../../../../src/restAPIs/logging/Provisioning/saveProvisioning.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AAE1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AAGpG;;;;;;;;;;;;;;;;;GAiBG;AAEH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,EAChC,YAAY,EAAE,oBAAoB,EAClC,uBAAuB,EAAE,MAAM,EAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,EAC1B,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,GAAG,EACZ,cAAc,GAAE,gBAAsD,GAAK,OAAO,CAuFnF"}

package/lib/restAPIs/logging/Provisioning/saveProvisioning.js

@@ -0,0 +1,110 @@
+/***
+ *    d88888b d8888b. .d8888.      d8888b. d8888b. d88888b .d8888. d88888b d888888b .d8888.
+ *    88'     88  `8D 88'  YP      88  `8D 88  `8D 88'     88'  YP 88'     `~~88~~' 88'  YP
+ *    88ooo   88oodD' `8bo.        88oodD' 88oobY' 88ooooo `8bo.   88ooooo    88    `8bo.
+ *    88~~~   88~~~     `Y8b.      88~~~   88`8b   88~~~~~   `Y8b. 88~~~~~    88      `Y8b.
+ *    88      88      db   8D      88      88 `88. 88.     db   8D 88.        88    db   8D
+ *    YP      88      `8888Y'      88      88   YD Y88888P `8888Y' Y88888P    YP    `8888Y'
+ *
+ *
+ */
+import { saveAnalytics4, getMinPerformanceString } from '../Analytics/saveAnalyticsAPI';
+import { check4Gulp } from '../../../logic/Links/CheckGulping';
+import { getTheCurrentTime } from '../Permissions/savePermissionAnalyticsAPI';
+import { EasyContentsRailsApply } from '../interfaces/EasyContents';
+/**
+ * 2025-01-03:  Migrated from fps-library-v2/lib/pnpjs/Permissions, pnp2/lib/services/sp/perms
+ * combination of v2:  saveProvisioningD and pnp2: saveAnalytics4D
+ *
+  import { saveProvisioning } from "@mikezimm/fps-core-v7/lib/restAPIs/Logging/Provisioning/saveProvisioning";
+
+ * @param context : WebPart Context
+ * @param analyticsListRailsApply :  Which Provisioning was applied => `${ApplyTemplate_Rail_SaveTitle} - v2.0.0.2`
+ * @param Title : `${ApplyTemplate_Rail_SaveTitle} - v2.0.0.2`
+ * @param Result
+ * @param panelVersionNumber
+ * @param zzzRichText1Obj : mapThisList
+ * @param Setting : this.props.railFunction
+ * @param zzzRichText2Obj : this.state.progress
+ * @param zzzRichText3Obj : this.state.history
+ * @param performanceObj
+ * @returns
+ */
+export function saveProvisioning(context, fpsSpService, analyticsListRailsApply, Title, Result, panelVersionNumber, makeList, targetList, Setting, progress, history, performanceObj = null) {
+    const site = context.pageContext.site;
+    const web = context.pageContext.web;
+    const loadProperties = {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        SiteID: site.id['_guid'],
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        WebID: web.id['_guid'],
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        SiteTitle: web.serverRelativeUrl,
+        TargetSite: web.absoluteUrl,
+        ListID: `${targetList.Id}`,
+        ListTitle: `${makeList.title}`,
+    };
+    const performance = getMinPerformanceString(performanceObj);
+    const startTime = getTheCurrentTime();
+    const saveObject = {
+        // https://github.com/fps-solutions/HubCon/issues/103
+        // __metadata: { type: `` },
+        loadProperties: loadProperties,
+        Title: Title,
+        Result: Result,
+        CodeVersion: panelVersionNumber,
+        zzzText1: startTime.now,
+        zzzText2: startTime.theTime,
+        zzzText5: site.id['_guid'],
+        // PageURL: undefined,
+        // PageLink: undefined,
+        // SiteID: undefined,
+        // SiteTitle: undefined,
+        // WebID: undefined,
+        // ListID: undefined,
+        // ListTitle: undefined,
+        // memory: undefined,
+        // browser: undefined,
+        // JSHeapSize: undefined,
+        // screen: undefined,
+        // screenSize: undefined,
+        // device: undefined,
+        // FPSItem: undefined,
+    };
+    //This will get rid of all the escaped characters in the summary (since it's all numbers)
+    // let zzzRichText3 = ''; //JSON.stringify( fetchInfo.summary ).replace('\\','');
+    //This will get rid of the leading and trailing quotes which have to be removed to make it real json object
+    // zzzRichText3 = zzzRichText3.slice(1, zzzRichText3.length - 1);
+    if (makeList)
+        saveObject.zzzRichText1 = JSON.stringify(makeList);
+    if (progress)
+        saveObject.zzzRichText2 = JSON.stringify(progress);
+    if (history)
+        saveObject.zzzRichText3 = JSON.stringify(history);
+    if (Setting)
+        saveObject.Setting = typeof Setting === 'string' ? Setting : JSON.stringify(Setting);
+    if (performance)
+        saveObject.performance = performance;
+    saveObject.TargetList = {
+        'Url': makeList.listURL,
+        'Description': makeList.listURL,
+    }; //Saved as link column.  Displayed as Relative Url
+    saveObject.SiteLink = {
+        'Url': site.absoluteUrl,
+        'Description': site.absoluteUrl,
+    };
+    // https://github.com/fps-solutions/HubCon/issues/103
+    // Required for non-PnpJS POST operations
+    // saveObject.__metadata = { type: `SP.Data.${EasyContentsRailsApply}ListItem` }
+    if (check4Gulp() === true) {
+        console.log('saveViewAnalytics', `${EasyContentsRailsApply}`);
+    }
+    if (check4Gulp() === true) {
+        console.log('saveViewAnalytics', saveObject);
+    }
+    saveAnalytics4(fpsSpService, `${EasyContentsRailsApply}`, saveObject, true);
+    const saved = true;
+    console.log('saved view info');
+    return saved;
+}
+//# sourceMappingURL=saveProvisioning.js.map

package/lib/restAPIs/logging/Provisioning/saveProvisioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveProvisioning.js","sourceRoot":"","sources":["../../../../src/restAPIs/logging/Provisioning/saveProvisioning.ts"],"names":[],"mappings":"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"}

package/lib/restAPIs/logging/interfaces/RailConstants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Be sure to update your analyticsList and analyticsWeb in en-us.js strings file
+
+    import { ApplyTemplate_Rail_SaveTitle } from "@mikezimm/fps-core-v7/lib/restAPIs/Logging/interfaces/RailConstants";
+
+ */
+export declare const ApplyTemplate_Rail_SaveTitle = "Apply Template Rail";
+export declare const ApplyTemplate_Page_SaveTitle = "Apply Template Page";
+export declare const ProvisionListsSaveTitle = "Provision Lists";
+//# sourceMappingURL=RailConstants.d.ts.map

package/lib/restAPIs/logging/interfaces/RailConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RailConstants.d.ts","sourceRoot":"","sources":["../../../../src/restAPIs/logging/interfaces/RailConstants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAClE,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAClE,eAAO,MAAM,uBAAuB,oBAAoB,CAAC"}

package/lib/restAPIs/logging/interfaces/RailConstants.js

@@ -0,0 +1,10 @@
+/**
+ * Be sure to update your analyticsList and analyticsWeb in en-us.js strings file
+
+    import { ApplyTemplate_Rail_SaveTitle } from "@mikezimm/fps-core-v7/lib/restAPIs/Logging/interfaces/RailConstants";
+
+ */
+export const ApplyTemplate_Rail_SaveTitle = 'Apply Template Rail';
+export const ApplyTemplate_Page_SaveTitle = 'Apply Template Page';
+export const ProvisionListsSaveTitle = 'Provision Lists';
+//# sourceMappingURL=RailConstants.js.map

package/lib/restAPIs/logging/interfaces/RailConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RailConstants.js","sourceRoot":"","sources":["../../../../src/restAPIs/logging/interfaces/RailConstants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAAC;AAClE,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAAC;AAClE,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC"}

package/lib/restAPIs/permissions/IFpsRoleAssignmentInfo.d.ts

@@ -0,0 +1,40 @@
+/**
+ * CodeAnalizerComment: Updated 1 imports on 2024-09-22 14:49:52
+ * Update:: import { IFpsErrorObject } to '../../types/fps-returns/common/IFpsErrorObject;'
+
+ */
+/**
+ * CodeAnalizerComment: Updated 2 imports on 2024-09-21 23:07:24
+ * Update:: import { IFpsErrorObject } to '../../types/fps-returns/common/IFpsErrorObject;'
+ * Update:: import { IRoleAssignmentInfo } to '../../types/@pnp/@2.14.0/sp/security;'
+
+ */
+/**
+ * 2024-12-07:  MOVE THIS TO fps-core-v7 ???
+ *         MIGRATION CANDIDATE
+ */
+import { IFpsErrorObject } from "../../types/fps-returns/common/IFpsErrorObject";
+import { IRoleAssignmentInfo, IRoleDefinitionInfo } from "../../types/@pnp/@2.14.0/sp/security";
+import { ISiteGroupInfo } from "../../types/@pnp/@2.14.0/sp/site-groups";
+import { ISiteUserInfo } from "../../types/@pnp/@2.14.0/sp/site-users";
+export interface IFpsRoleAssignmentInfo extends IFpsErrorObject {
+    items?: any;
+    item?: any;
+    RoleAssignments: IFpsRoleAssignmentAsFetched[];
+    HasUniqueRoleAssignments: boolean | 'Unknown' | 'TBD';
+}
+/**
+ * 2025-01-04:  Verified this is common with SPHTTP endpoint:
+ *  /_api/web/RoleAssignments?$expand=Member,RoleDefinitionBindings
+ *    The return is an array of these for web or list or item.
+ *
+ *  /_api/web/RoleAssignments(3)?$expand=Member,RoleDefinitionBindings
+ *    The return is a single one of these if you use the (id) selector
+ *
+ */
+export interface IFpsRoleAssignmentAsFetched extends IRoleAssignmentInfo {
+    PrincipalId: number;
+    RoleDefinitionBindings: IRoleDefinitionInfo[];
+    Member: ISiteGroupInfo | ISiteUserInfo;
+}
+//# sourceMappingURL=IFpsRoleAssignmentInfo.d.ts.map

package/lib/restAPIs/permissions/IFpsRoleAssignmentInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFpsRoleAssignmentInfo.d.ts","sourceRoot":"","sources":["../../../src/restAPIs/permissions/IFpsRoleAssignmentInfo.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AAEH;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,eAAe,EAAE,2BAA2B,EAAE,CAAC;IAC/C,wBAAwB,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;CACvD;AAGD;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,mBAAmB,EAAE,CAAC;IAC9C,MAAM,EAAE,cAAc,GAAG,aAAa,CAAC;CACxC"}

package/lib/restAPIs/permissions/IFpsRoleAssignmentInfo.js

@@ -0,0 +1,7 @@
+/**
+ * CodeAnalizerComment: Updated 1 imports on 2024-09-22 14:49:52
+ * Update:: import { IFpsErrorObject } to '../../types/fps-returns/common/IFpsErrorObject;'
+
+ */
+export {};
+//# sourceMappingURL=IFpsRoleAssignmentInfo.js.map

package/lib/restAPIs/permissions/IFpsRoleAssignmentInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFpsRoleAssignmentInfo.js","sourceRoot":"","sources":["../../../src/restAPIs/permissions/IFpsRoleAssignmentInfo.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/lib/restAPIs/permissions/getListRoleAssignmentsAPI.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 2024-12-07:  MOVE THIS TO fps-core-v7 ???
+ *         MIGRATION CANDIDATE
+ */
+import { IFpsRoleAssignmentInfo } from "./IFpsRoleAssignmentInfo";
+import { IFpsSpHttpServiceMIN } from "../../components/molecules/SpHttp/Sp/IFpsSpHttpServiceMIN";
+/**
+ * 2025-01-03:  Migrated from fps-library-v2/lib/pnpjs/Permissions, pnp2/lib/services/sp/perms
+ * combination of v2:  getListRoleAssignmentsD and pnp2: fetchListPermsD
+ *
+ * getListRoleAssignmentsAPI gets lists's Members and RoleDefinitionBindings combined.
+ *
+ * import { getListRoleAssignmentsAPI } from '@mikezimm/fps-core-v7/lib/restAPIs/permissions/getListRoleAssignmentsAPI';
+ *
+ * @param fpsSpService
+ * @param webUrl
+ * @param listTitle
+ * @param alertMe
+ * @param consoleLog
+ * @returns
+ */
+export declare function getListRoleAssignmentsAPI(fpsSpService: IFpsSpHttpServiceMIN, webUrl: string, listTitle: string, alertMe: boolean | undefined, consoleLog: boolean | undefined): Promise<IFpsRoleAssignmentInfo>;
+//# sourceMappingURL=getListRoleAssignmentsAPI.d.ts.map

package/lib/restAPIs/permissions/getListRoleAssignmentsAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getListRoleAssignmentsAPI.d.ts","sourceRoot":"","sources":["../../../src/restAPIs/permissions/getListRoleAssignmentsAPI.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,EAA+B,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AAOjG;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EACpH,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,SAAS,GAAK,OAAO,CAAC,sBAAsB,CAAC,CA2ClG"}