@kwiz/common 1.0.1

package/src/utils/sharepoint.rest/common.ts

@@ -0,0 +1,149 @@
+import { FieldTypeAsString, IDictionary, IFieldInfoEX, IFieldTaxonomyInfo, IRestError, ISPRestError, isNullOrEmptyString, isNullOrUndefined, isString, isValidGuid, jsonParse, makeServerRelativeUrl, normalizeUrl } from "../_dependencies";
+import { ConsoleLogger } from "../consolelogger";
+import { getCacheItem, setCacheItem } from "../localstoragecache";
+import { mediumLocalCache } from "../rest";
+import { GetWebIdSync, GetWebInfoSync } from "./web";
+
+const logger = ConsoleLogger.get("sharepoint.rest/common");
+
+export const LIST_SELECT = `ListExperienceOptions,EffectiveBasePermissions,Description,Title,EnableAttachments,EnableModeration,BaseTemplate,BaseType,Id,Hidden,IsApplicationList,IsPrivate,IsCatalog,ImageUrl,ItemCount,ParentWebUrl,EntityTypeName,DefaultViewUrl,ParentWeb/Id,ParentWeb/Title`;
+export const LIST_EXPAND = `ParentWeb/Id,ParentWeb/Title`;
+export const WEB_SELECT = "Title,ServerRelativeUrl,Id,WebTemplate,Description,SiteLogoUrl";
+export const CONTENT_TYPES_SELECT = "Name,Description,StringId,Group,Hidden,ReadOnly,NewFormUrl,DisplayFormUrl,EditFormUrl";
+export const CONTENT_TYPES_SELECT_WITH_FIELDS = `${CONTENT_TYPES_SELECT},Fields`;
+
+export function hasGlobalContext() {
+    //_spPageContextInfo.webServerRelativeUrl can be empty string
+    return typeof (_spPageContextInfo) !== "undefined" && isString(_spPageContextInfo.webServerRelativeUrl);
+}
+
+export function GetFileSiteUrl(fileUrl: string): string {
+    let siteUrl: string;
+    let urlParts = fileUrl.split('/');
+    if (urlParts[urlParts.length - 1].indexOf('.') > 0)//file name
+        urlParts.pop();//file name
+
+    let key = "GetSiteUrl|" + urlParts.join("/").toLowerCase();
+    siteUrl = getCacheItem<string>(key);
+    if (isNullOrUndefined(siteUrl)) {
+        while (!isValidGuid(GetWebIdSync(urlParts.join('/'))))
+            urlParts.pop();
+
+        siteUrl = normalizeUrl(urlParts.join('/'));
+        setCacheItem(key, siteUrl, mediumLocalCache.localStorageExpiration);//keep for 15 minutes
+    }
+    //must end with / otherwise root sites will return "" and we will think there is no site url.
+    return makeServerRelativeUrl(normalizeUrl(siteUrl, true));
+}
+
+/** gets a site URL or null, returns the current web URL or siteUrl as relative URL - end with /
+ * If you send a guid - it will look for a site with that ID in the current context site collection
+ */
+export function GetSiteUrl(siteUrlOrId?: string): string {
+    let siteUrl: string;
+    if (isNullOrUndefined(siteUrlOrId)) {
+        if (hasGlobalContext()) {
+            siteUrl = _spPageContextInfo.webServerRelativeUrl;
+            if (_spPageContextInfo.isAppWeb)//#1300 if in a classic app sub-site
+                siteUrl = siteUrl.substring(0, siteUrl.lastIndexOf("/"));
+        }
+        else {
+            siteUrl = GetFileSiteUrl(window.location.pathname);
+        }
+    }
+    else if (isValidGuid(siteUrlOrId)) {
+        //GetWebInfoSync calls GetSiteUrl recursively, but with null should not get in here
+        let webInfo = GetWebInfoSync(null, siteUrlOrId);
+        siteUrl = webInfo.ServerRelativeUrl;
+    }
+    else siteUrl = siteUrlOrId;
+
+    //must end with / otherwise root sites will return "" and we will think there is no site url.
+    return makeServerRelativeUrl(normalizeUrl(siteUrl, true));
+}
+
+/** gets a site url, returns its REST _api url */
+export function GetRestBaseUrl(siteUrl: string): string {
+    siteUrl = GetSiteUrl(siteUrl);
+    return siteUrl + '_api';
+}
+
+/** Get the field internal name as you can find it in item.FieldValuesAsText[name] (Or FieldValuesForEdit) */
+export function DecodeFieldValuesAsTextKey(key: string): string {
+    return key.replace(/_x005f_/g, "_").replace('OData__', '_');
+}
+
+/** Gets REST FieldValuesAsText or FieldValuesForEdit and fix their column names so that you can get a field value by its internal name */
+export function DecodeFieldValuesAsText(FieldValuesAsText: IDictionary<string>) {
+    return DecodeFieldValuesForEdit(FieldValuesAsText);
+}
+/** Gets REST FieldValuesAsText or FieldValuesForEdit and fix their column names so that you can get a field value by its internal name */
+export function DecodeFieldValuesForEdit(FieldValuesForEdit: IDictionary<string>) {
+    let result: IDictionary<string> = {};
+    Object.keys(FieldValuesForEdit).forEach(key => {
+        result[DecodeFieldValuesAsTextKey(key)] = FieldValuesForEdit[key];
+    });
+    return result;
+}
+
+/** Get the field internal name as you can find it in the item[name] to get raw values */
+export function GetFieldNameFromRawValues(
+    field: { InternalName: string; TypeAsString: FieldTypeAsString; },
+    //ISSUE: 1250
+    options: {
+        excludeIdFromName: boolean
+    } = {
+            excludeIdFromName: false
+        }): string {
+    let fieldName = field.InternalName;
+    if (options.excludeIdFromName !== true && (field.TypeAsString === "User" ||
+        field.TypeAsString === "UserMulti" ||
+        field.TypeAsString === "Lookup" ||
+        field.TypeAsString === "LookupMulti" ||
+        field.InternalName === "ContentType")) {
+        fieldName = fieldName += "Id";
+    }
+
+    //issue 6698 fields that are too short will encode their first letter, and will start with _. this will add OData_ as a prefix in REST
+    //Issue 336 _EndDate > OData__EndDate
+    if (fieldName.startsWith('_')) {
+        fieldName = "OData_" + fieldName;
+    }
+    return fieldName;
+}
+
+/** Get the field name to set on the item update REST request */
+export function getFieldNameForUpdate(field: IFieldInfoEX): string {
+    if (field.TypeAsString === "TaxonomyFieldTypeMulti") {
+        //Updating multi taxonomy value is allowed as string to the associated hidden text field
+        return (field as IFieldTaxonomyInfo).HiddenMultiValueFieldName;
+    }
+
+    return GetFieldNameFromRawValues(field);
+}
+
+export function __isIRestError(e: any): e is IRestError {
+    let x = e as IRestError;
+    return !isNullOrUndefined(x) && !isNullOrUndefined(x.xhr) && isString(x.message);
+}
+/** extract the error message from a SharePoint REST failed request */
+export function __getSPRestErrorData(restError: IRestError) {
+    let code = "Unknown";
+    let errorMessage = "Unspecified error";
+    if (restError && restError.message) errorMessage = restError.message;
+    if (restError && restError.xhr && !isNullOrEmptyString(restError.xhr.responseText)) {
+        let errorData = jsonParse<{ error: { code: string; message: { value: string; }; }; }>(restError.xhr.responseText);
+        let error = errorData && errorData.error;
+        if (!error && errorData)//in minimal rest - error is in "odata.error"
+            error = errorData && errorData["odata.error"];
+
+        if (error) {
+            if (error && error.message && error.message.value)
+                errorMessage = error.message.value;
+            if (error && error.code)
+                code = error.code;
+        }
+    }
+    logger.error(errorMessage);
+    return { code: code, message: errorMessage } as ISPRestError;
+}

package/src/utils/sharepoint.rest/date.ts

@@ -0,0 +1,61 @@
+import { DateOrNull, isDate, isISODate, isISODateUTC, isNullOrEmptyString, isNullOrUndefined } from "../_dependencies";
+import { toIsoDateFormat } from "../date";
+import { LocaleKnownScript } from "../knownscript";
+import { SPServerLocalTimeToUTCSync } from "./web";
+
+function _SPServerLocalTimeToUTC(dateValueStr: string) {
+    //yyyy-MM-ddTHH:mm or SPServerLocalTime (5/27/2021 11:34) to UTC
+    let utcTimeValue = SPServerLocalTimeToUTCSync(_spPageContextInfo.webServerRelativeUrl, dateValueStr);
+
+    if (!isNullOrEmptyString(utcTimeValue)) {
+        return new Date(utcTimeValue);
+    }
+    return null;
+}
+
+export function parseDate(value: string | Date): DateOrNull {
+    if (isNullOrUndefined(value) || (isNullOrEmptyString(value) && !isDate(value))) {
+        return null;
+    }
+
+    let dateValueStr = isDate(value) ? value.toISOString() : value;
+
+    var valueAsDate: DateOrNull = null;
+
+    if (isISODateUTC(dateValueStr)) {
+        valueAsDate = new Date(dateValueStr);
+    } else if (isISODate(dateValueStr)) {
+        //yyyy-MM-ddTHH:mm or SPServerLocalTime (5/27/2021 11:34) to UTC
+        valueAsDate = _SPServerLocalTimeToUTC(dateValueStr);
+    } else {
+        //Don't think this is necessary because the SPServerLocalTimeToUTCSync can accept date strings in non ISO format (5/27/2021 11:34)
+        var dateParts: string[] = dateValueStr.split(" ");
+        if (dateParts.length) {
+            let locales = LocaleKnownScript.loadSync();
+
+            valueAsDate = locales.ParseDate(dateValueStr);
+            dateValueStr = toIsoDateFormat(valueAsDate, { omitZ: true });
+            valueAsDate = _SPServerLocalTimeToUTC(dateValueStr);
+
+            if (valueAsDate instanceof Date && dateParts.length === 2) {
+                var time = dateParts[1];
+                if (time.length) {
+                    var timeParts = locales.GetCurrentCulture() ? locales.GetCurrentCulture().dateTimeFormat.TimeSeparator : ":";
+                    if (timeParts.length === 2) {
+                        var hours = Number(timeParts[0]);
+                        var minutes = Number(timeParts[1]);
+
+                        valueAsDate.setHours(hours);
+                        valueAsDate.setMinutes(minutes);
+                    }
+                }
+            }
+        }
+    }
+
+    if (!valueAsDate) {
+        valueAsDate = new Date(dateValueStr);
+    }
+
+    return isDate(valueAsDate) ? valueAsDate : null;
+}

package/src/utils/sharepoint.rest/file.folder.ts

@@ -0,0 +1,368 @@
+import { IDictionary, IFileInfo, IFolderBasicInfo, IRequestBody, IRestOptions, IRestResponseType, encodeURIComponentEX, isNotEmptyArray, isNullOrEmptyString, isNullOrUndefined, isNumber, isNumeric, jsonStringify, jsonTypes, makeServerRelativeUrl, newGuid, normalizeUrl } from "../_dependencies";
+import { ConsoleLogger } from "../consolelogger";
+import { GetJson, GetJsonSync, longLocalCache, noLocalCache, shortLocalCache } from "../rest";
+import { GetRestBaseUrl, GetSiteUrl } from "./common";
+import { GetListRestUrl } from "./list";
+
+const logger = ConsoleLogger.get("SharePoint.Rest.FileNFolder");
+
+let existingFolders: string[] = [];
+
+export async function EnsureFolderPath(siteUrl: string, folderServerRelativeUrl: string): Promise<boolean> {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    //issue 7176
+    folderServerRelativeUrl = makeServerRelativeUrl(folderServerRelativeUrl, siteUrl);
+    if (existingFolders.indexOf(folderServerRelativeUrl) >= 0) {
+        return true;
+    }
+
+    let url = `${GetRestBaseUrl(siteUrl)}/Web/getFolderByServerRelativeUrl(serverRelativeUrl='${folderServerRelativeUrl}')?$select=exists`;
+    let folder = await GetJson<{ d: { Exists: boolean; }; }>(url);
+    if (folder && folder.d.Exists) {
+        existingFolders.push(folderServerRelativeUrl);
+        return true;
+    }
+    else {
+        let parts = folderServerRelativeUrl.split('/');
+        if (parts.length > 1) {
+            let parentFolder = parts.slice(0, parts.length - 1).join('/');
+
+            //ensure parent
+            let parent = await EnsureFolderPath(siteUrl, parentFolder);
+            if (parent) {
+                //create it
+                let ensure = await EnsureFolder(siteUrl, parentFolder, parts[parts.length - 1]);
+                if (ensure.Exists) {
+                    existingFolders.push(folderServerRelativeUrl);
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
+}
+
+export function EnsureFolder(siteUrl: string, parentFolderServerRelativeUrl: string, folderName: string): Promise<{ Exists: boolean; ServerRelativeUrl?: string; }> {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    parentFolderServerRelativeUrl = makeServerRelativeUrl(parentFolderServerRelativeUrl, siteUrl);
+
+    return GetJson<{ d: { Exists: boolean; ServerRelativeUrl: string; }; }>(`${GetRestBaseUrl(siteUrl)}/Web/getFolderByServerRelativeUrl(serverRelativeUrl='${parentFolderServerRelativeUrl}')/folders/add(url='${folderName}')`, null, { method: "POST", spWebUrl: siteUrl })
+        .then(r => { return r.d; })
+        .catch<{ Exists: boolean; ServerRelativeUrl?: string; }>(() => { return { Exists: false }; });
+}
+
+
+export function DeleteFolder(siteUrl: string, folderUrl: string): Promise<boolean> {
+    siteUrl = GetSiteUrl(siteUrl);
+    folderUrl = makeServerRelativeUrl(folderUrl, siteUrl);
+    var requestUrl = `${GetRestBaseUrl(siteUrl)}/Web/getFolderByServerRelativeUrl(serverRelativeUrl='${folderUrl}')`;
+
+    return GetJson(requestUrl, null, {
+        method: "POST",
+        xHttpMethod: "DELETE"
+    })
+        .then(r => true)
+        .catch<boolean>((e) => false);
+}
+
+export function GetFolderFiles(siteUrl: string, folderUrl: string): Promise<IFileInfo[]> {
+    siteUrl = GetSiteUrl(siteUrl);
+    folderUrl = makeServerRelativeUrl(folderUrl, siteUrl);
+    var requestUrl = `${GetRestBaseUrl(siteUrl)}/Web/getFolderByServerRelativeUrl(serverRelativeUrl='${folderUrl}')`
+        + `/files?$select=Exists,Name,ServerRelativeUrl,Title,TimeCreated,TimeLastModified`;
+
+    return GetJson<{ d: { results: IFileInfo[]; }; }>(requestUrl).then(r => {
+        return r.d && r.d.results || [];
+    }).catch<IFileInfo[]>(() => {
+        return [];
+    });
+}
+
+export function UploadFileSync(siteUrl: string, folderServerRelativeUrl: string, fileName: string, fileContent: IRequestBody): {
+    Exists: boolean;
+    ServerRelativeUrl?: string;
+    ListItemAllFields?: { [fieldInternalName: string]: any; };
+} {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    folderServerRelativeUrl = makeServerRelativeUrl(folderServerRelativeUrl, siteUrl);
+
+    let res = GetJsonSync<{ d: { Exists: boolean; ServerRelativeUrl: string; }; }>(
+        `${GetRestBaseUrl(siteUrl)}/Web/getFolderByServerRelativeUrl(serverRelativeUrl='${folderServerRelativeUrl}')/files/add(url='${fileName}',overwrite=true)?$expand=ListItemAllFields`,
+        fileContent, {
+        method: 'POST',
+        spWebUrl: siteUrl
+    });
+
+    return res.success && res.result && res.result.d ? res.result.d : { Exists: false };
+}
+
+export function UploadFile(siteUrl: string, folderServerRelativeUrl: string, fileName: string, fileContent: IRequestBody, options?: { overwrite?: boolean; }): Promise<{
+    Exists: boolean;
+    ServerRelativeUrl?: string;
+    [fieldInternalName: string]: any;
+}> {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    options = options || { overwrite: true };
+
+    folderServerRelativeUrl = makeServerRelativeUrl(folderServerRelativeUrl, siteUrl);
+
+    return GetJson<{ d: { Exists: boolean; ServerRelativeUrl: string; }; }>(
+        `${GetRestBaseUrl(siteUrl)}/Web/getFolderByServerRelativeUrl(serverRelativeUrl='${folderServerRelativeUrl}')/files/add(url='${fileName}'${options.overwrite ? ',overwrite=true' : ''})?$expand=ListItemAllFields`,
+        fileContent, {
+        method: 'POST',
+        spWebUrl: siteUrl,
+        allowCache: false,
+        postCacheKey: null
+    })//Issue 6657 force set "POST" since we might send empty string as the value
+        .then(r => { return r.d; })
+        .catch<{
+            Exists: boolean;
+            ServerRelativeUrl?: string;
+            [fieldInternalName: string]: any;
+        }>(() => { return { Exists: false }; });
+}
+
+export function RecycleFile(siteUrl: string, fileServerRelativeUrl: string): Promise<boolean> {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    let fileRestUrl = GetFileRestUrl(siteUrl, fileServerRelativeUrl) + "/recycle()";
+
+    return GetJson(fileRestUrl, null, {
+        method: "POST",
+        headers: {
+            "IF-MATCH": "*"
+        }
+    })
+        .then(r => true)
+        .catch<boolean>((e) => false);
+}
+
+export function DeleteFile(siteUrl: string, fileServerRelativeUrl: string): Promise<boolean> {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    let fileRestUrl = GetFileRestUrl(siteUrl, fileServerRelativeUrl);
+
+    return GetJson(fileRestUrl, null, {
+        method: "POST",
+        xHttpMethod: "DELETE"
+    })
+        .then(r => true)
+        .catch<boolean>((e) => false);
+}
+
+/** get the REST url for the site/_api/web/getfile....() */
+function GetFileRestUrl(siteUrl: string, fileServerRelativeUrl: string) {
+    fileServerRelativeUrl = makeServerRelativeUrl(fileServerRelativeUrl, siteUrl);
+    let fileRestUrl = `${GetRestBaseUrl(siteUrl)}/Web/getFileByServerRelativeUrl('${fileServerRelativeUrl}')`;
+    return fileRestUrl;
+}
+
+export function GetFileSync<T>(siteUrl: string, fileServerRelativeUrl: string, responseType?: IRestResponseType, options?: {
+    /** default, short cache. */
+    cache?: "long" | "short" | "nocache";
+}): { Exists: boolean; Content?: T; } {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    let restOptions: IRestOptions = isNullOrUndefined(options) || options.cache !== "long"
+        ? { ...shortLocalCache }
+        : { ...longLocalCache };
+
+    if (options && options.cache === "nocache")
+        restOptions.forceCacheUpdate = true;
+
+    if (!isNullOrUndefined(responseType)) {
+        restOptions.responseType = responseType;
+    }
+
+    let fileRestUrl = GetFileRestUrl(siteUrl, fileServerRelativeUrl);
+    if (!restOptions.forceCacheUpdate && reloadCacheFileModifiedRecently(siteUrl, fileServerRelativeUrl)) {
+        restOptions.forceCacheUpdate = true;
+    }
+
+    let response = GetJsonSync<T>(`${fileRestUrl}/$value`, null, restOptions);
+    if (response && response.success)
+        return {
+            Exists: true,
+            Content: response.result
+        };
+    else
+        return {
+            Exists: false
+        };
+}
+export function GetFile<T>(siteUrl: string, fileServerRelativeUrl: string, allowCache?: boolean, responseType?: IRestResponseType): Promise<{ Exists: boolean; Content?: T; }> {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    let options: IRestOptions = { ...(allowCache === true ? shortLocalCache : noLocalCache), forceCacheUpdate: allowCache !== true };
+    if (!isNullOrUndefined(responseType)) {
+        options.responseType = responseType;
+    }
+
+    let fileRestUrl = GetFileRestUrl(siteUrl, fileServerRelativeUrl);
+    if (!options.forceCacheUpdate && reloadCacheFileModifiedRecently(siteUrl, fileServerRelativeUrl)) {
+        options.forceCacheUpdate = true;
+    }
+
+    return GetJson<T>(`${fileRestUrl}/$value`, null, options).then(r => {
+        return {
+            Exists: true,
+            Content: r
+        };
+    }).catch<{ Exists: boolean; Content?: T; }>(() => {
+        return {
+            Exists: false
+        };
+    });
+}
+
+var $reloadCacheFileModifiedRecentlyFlagged: string[] = [];
+function reloadCacheFileModifiedRecently(siteUrl: string, fileServerRelativeUrl: string) {
+    let fileRestUrl = GetFileRestUrl(siteUrl, fileServerRelativeUrl);
+    let key = fileRestUrl.toLowerCase();
+
+    //only flag it once, first time it is requested...
+    if (!$reloadCacheFileModifiedRecentlyFlagged.includes(key)) {
+        try {
+            $reloadCacheFileModifiedRecentlyFlagged.push(key);
+
+            let fileInfo = GetJsonSync<{ d: { TimeLastModified: string; }; }>(`${fileRestUrl}?$select=TimeLastModified`,
+                null, { allowCache: true });//only allow in-memory cache for this
+            if (fileInfo.success && fileInfo.result) {
+                let modified = new Date(fileInfo.result.d.TimeLastModified);
+                let now = new Date();
+                let difference = now.getTime() - modified.getTime();
+                if (difference < 5 * 60 * 1000) {
+                    //file has changed in the past 5 minutes - do not allow cache on it.
+                    //happens when user uses classic app to change settings, the clear cache does not clear it on the main
+                    //site URL ( support case - Issue 778 780 & 782 )
+                    return true;
+                }
+            }
+        } catch (e) { }
+    }
+
+    return false;
+}
+
+/** Get file size (bytes) by file server relative url - can also get this by selecting FileSizeDisplay field on the item */
+export async function GetFileSize(siteUrl: string, fileServerRelativeUrl: string, allowCache?: boolean);
+/** Get file size (bytes) by list item - can also get this by selecting FileSizeDisplay field on the item */
+export async function GetFileSize(siteUrl: string, listId: string, itemId: number, allowCache?: boolean);
+export async function GetFileSize(siteUrl: string, fileServerRelativeUrlOrListId: string, itemIdOrAllowCache?: number | boolean, allowCache?: boolean): Promise<number> {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    let requestUrl = "";
+    if (isNumber(itemIdOrAllowCache) || isNumeric(itemIdOrAllowCache)) {
+        requestUrl = GetListRestUrl(siteUrl, fileServerRelativeUrlOrListId) + `/items(${itemIdOrAllowCache})/File`;
+    }
+    else {
+        allowCache = itemIdOrAllowCache === true;
+        requestUrl = GetFileRestUrl(siteUrl, fileServerRelativeUrlOrListId);
+    }
+    let options: IRestOptions = { allowCache: allowCache === true, jsonMetadata: jsonTypes.nometadata };
+
+    try {
+        let result = await GetJson<{ vti_x005f_filesize: number; }>(`${requestUrl}/Properties?$select=vti_x005f_filesize`, null, options);
+        return result.vti_x005f_filesize;
+    } catch (e) {
+        return null;
+    }
+}
+
+export async function GetListFolders(siteUrl: string, listIdOrTitle: string): Promise<IFolderBasicInfo[]> {
+    siteUrl = GetSiteUrl(siteUrl);
+
+    //switched to get request with no meta data - much faster.
+    let url = GetListRestUrl(siteUrl, listIdOrTitle) + `/items?$Select=Folder/ServerRelativeUrl,Folder/Name&$filter=FSObjType eq 1&$expand=Folder`;
+
+    let results: IFolderBasicInfo[] = [];
+    try {
+        let requestResult = (await GetJson<{
+            value: { Folder: IFolderBasicInfo; }[];
+        }>(url, null, { allowCache: true, jsonMetadata: jsonTypes.nometadata }));
+
+        if (isNotEmptyArray(requestResult && requestResult.value)) {
+            results = requestResult.value.map(f => ({
+                Name: f.Folder.Name,
+                ServerRelativeUrl: normalizeUrl(f.Folder.ServerRelativeUrl)
+            }));
+        }
+    } catch (e) {
+        //Issue 7543 throttled library with lots of items will fail so return empty array
+        logger.error(`Could not get folders from ${listIdOrTitle}, check network for more infromation.`);
+    }
+
+    return results;
+}
+
+export async function GetFileItemId(siteUrl: string, fileServerRelativeUrl: string) {
+    siteUrl = GetSiteUrl(siteUrl);
+    const restUrl = `${GetRestBaseUrl(siteUrl)}/web/getFileByServerRelativeUrl('${encodeURIComponentEX(fileServerRelativeUrl)}')/ListItemAllFields/id`;
+    const result = await GetJson<{ value: number; }>(restUrl, null, { jsonMetadata: jsonTypes.nometadata });
+    return result.value;
+}
+interface iWebPartPageProps {
+    /** webpart id */
+    id: string;
+    /** unique instance id - random guid, or blank to auto-generate */
+    instanceId?: string;
+    title: string;
+    description: string;
+    dataVersion?: "1.0";
+    properties: IDictionary<string | boolean>
+}
+interface iWebPartPageResult {
+    /** site relative random page name, such as: "SitePages/y2k9xm8v.aspx" */
+    value: string;
+}
+/** Creates a modern single app page and return its URL. if a file in that name exists, it will return one with (1) appended to it. */
+export async function CreateAppPage(siteUrl: string, info: {
+    /** file name, without extension */
+    name: string; webPartDataAsJson: iWebPartPageProps
+}) {
+    //read more: 
+    //https://petelus.sharepoint.com/sites/CMSTest/_api/SitePages/Pages/CreateAppPage
+    //https://spblog.net/post/2019/03/05/what-s-new-and-what-s-changed-in-sharepoint-online-rest-api-in-january-february-2019
+
+    function getFileServerRelativeUrl(siteRelative: string) {
+        const fileRelativeUrl = makeServerRelativeUrl(`${siteUrl}${siteRelative}`);
+        return fileRelativeUrl;
+    }
+
+    let webPartDataAsJson = info.webPartDataAsJson;
+    if (isNullOrEmptyString(webPartDataAsJson.instanceId))
+        webPartDataAsJson.instanceId = newGuid();
+    if (isNullOrEmptyString(webPartDataAsJson.dataVersion))
+        webPartDataAsJson.dataVersion = "1.0";
+
+    return logger.groupAsync("CreateAppPage", async log => {
+        siteUrl = GetSiteUrl(siteUrl);
+        const restUrl = `${GetRestBaseUrl(siteUrl)}/SitePages/Pages/CreateAppPage`;
+        const result = await GetJson<iWebPartPageResult>(restUrl, jsonStringify({
+            webPartDataAsJson: jsonStringify(webPartDataAsJson)
+        }), { method: 'POST', jsonMetadata: jsonTypes.nometadata });
+        log(`created page`);
+        log(jsonStringify(result));
+
+        let fileRelativeUrl = getFileServerRelativeUrl(result.value);
+
+        const fileId = await GetFileItemId(siteUrl, fileRelativeUrl);
+        const updateRestUrl = `${GetRestBaseUrl(siteUrl)}/SitePages/Pages/UpdateAppPage`;
+        const updateResult = await GetJson<iWebPartPageResult>(updateRestUrl, jsonStringify({
+            pageId: fileId,
+            title: info.name,
+            webPartDataAsJson: jsonStringify(webPartDataAsJson)
+        }), { method: 'POST', jsonMetadata: jsonTypes.nometadata });
+
+        log(`updated page`);
+        log(jsonStringify(updateResult));
+
+        fileRelativeUrl = getFileServerRelativeUrl(updateResult.value);
+
+        return fileRelativeUrl;
+    });
+}

package/src/utils/sharepoint.rest/index.ts

@@ -0,0 +1,11 @@
+export * from "./common";
+export * from "./date";
+export * from "./file.folder";
+export * from "./item";
+export * from "./list";
+export * from "./listutils/GetListItemsByCaml";
+export * from "./listutils/GetListItemsById";
+export * from "./listutils/common";
+export * from "./user";
+export * from "./user-search";
+export * from "./web";