@kwiz/common 1.0.78 → 1.0.80

package/src/utils/script.ts

@@ -1,171 +1,171 @@
-import { isDebug } from "../helpers/debug";
-import { noop } from "../helpers/objects";
-import { isNotEmptyArray, isNullOrEmptyString, isNullOrUndefined } from "../helpers/typecheckers";
-import { IKnownScript, ksGlobal } from "../types/knownscript.types";
-import Sod from "./sod";
-
-export interface IScriptUtils {
-    /** @deprecated - use wrapFunction instead from helpers/functions */
-    wrapFunction3?: (originalFunction: () => void, instance: any, doBefore: () => void, doAfter: () => void) => void;
-    loadKnownScript: (script: IKnownScript) => void;
-    loadKnownScript_Sync: (script: IKnownScript) => void;
-    ensureScript: (scriptUrl: string, global: ksGlobal, callback: () => void, sodName: string) => void;
-    ensureScripts: (scripts: { scriptUrl: string; global: ksGlobal; sodName: string; }[], callback: () => void) => void;
-}
-
-export default class script implements IScriptUtils {
-    private static instance: script = null;
-    public isRtl = false;
-    public static get Instance() {
-        if (script.instance === null) {
-            //share single instance between all imports
-            if (typeof (window as any).kSingleScripts !== 'undefined')
-                script.instance = (window as any).kSingleScripts;//a global instance already exists, use it
-            else {
-                script.instance = new script();
-                (window as any).kSingleScripts = script.instance;//place this instance in the global namespace for others to reuse
-            }
-        }
-        return script.instance;
-    }
-
-    public async loadKnownScript(knownScript: IKnownScript) {
-        var promisesDependencies: Promise<any>[] = [];
-        (knownScript.dependencies || []).forEach(dep => {
-            promisesDependencies.push(this.loadKnownScript(dep));
-        });
-
-        if (promisesDependencies.length > 0)
-            await Promise.all(promisesDependencies);
-
-        return new Promise((resolve, reject) => {
-            this.ensureKnownScriptInternal(knownScript, () => {
-                resolve(Sod.getGlobal(knownScript.global));
-            });
-        });
-    }
-    public loadKnownScript_Sync(knownScript: IKnownScript) {
-        try {
-            if (isNotEmptyArray(knownScript.dependencies)) {
-                (knownScript.dependencies || []).forEach(dep => {
-                    this.loadKnownScript_Sync(dep)
-                });
-            }
-        } catch {
-        }
-
-        this.ensureKnownScriptInternal(knownScript, noop, true);
-        return Sod.getGlobal(knownScript.global);
-    }
-
-    private ensureKnownScriptInternal(knownScript: IKnownScript, callback: () => void, sync = false) {
-        let url = isDebug() && !knownScript.forceMin ? knownScript.url.replace('.min.js', '.js') : knownScript.url;
-        if (url[0] === '/') url = "https://apps.kwizcom.com" + url;
-
-        if (sync === true)
-            this.ensureScriptSync(url, knownScript.global, callback, knownScript.sodName);
-        else
-            this.ensureScript(url, knownScript.global, callback, knownScript.sodName);
-
-        let cssFiles = this.isRtl === true && !isNullOrUndefined(knownScript.rtlCss) ? knownScript.rtlCss : knownScript.css;
-        if (!isNullOrUndefined(cssFiles))
-            cssFiles.forEach(css => {
-                if (!isNullOrEmptyString(css)) {
-                    let cssurl = isDebug() && !knownScript.forceMin ? css.replace('.min.css', '.css') : css;
-                    if (cssurl[0] === '/') cssurl = "https://apps.kwizcom.com" + cssurl;
-
-                    let knownStyles = document.getElementsByClassName("kwizcom_known_css");
-                    let found = false;
-                    for (let si = 0; si < knownStyles.length; si++) {
-                        let elm: HTMLLinkElement = knownStyles[si] as HTMLLinkElement;
-                        if (elm.href && elm.href.toLowerCase() === cssurl.toLowerCase()) {
-                            found = true;
-                            break;
-                        }
-                    }
-                    if (!found) {
-                        let link = document.createElement("link");
-                        link.rel = "stylesheet";
-                        link.className = "kwizcom_known_css";
-                        link.type = "text/css";
-                        link.href = cssurl;
-                        document.head.appendChild(link);
-                    }
-                }
-            });
-    }
-
-    public loadCss(cssUrl: string) {
-        let knownStyles = document.getElementsByClassName("kwizcom_known_css");
-        let found = false;
-        for (let si = 0; si < knownStyles.length; si++) {
-            let elm: HTMLLinkElement = knownStyles[si] as HTMLLinkElement;
-            if (elm.href && elm.href.toLowerCase() === cssUrl.toLowerCase()) {
-                found = true;
-                break;
-            }
-        }
-        if (!found) {
-            let link = document.createElement("link");
-            link.rel = "stylesheet";
-            link.className = "kwizcom_known_css";
-            link.type = "text/css";
-            link.href = cssUrl;
-            document.head.appendChild(link);
-        }
-    }
-
-    public ensureScriptSync(scriptUrl: string, global: ksGlobal, callback?: () => void, sodName?: string) {
-        //in IE there is no promise, we cannot use any async functions
-        return Sod.ensureScriptNoPromise(scriptUrl, global, callback, sodName, true);
-    }
-    public async ensureScript(scriptUrl: string, global: ksGlobal, callback?: () => void, sodName?: string) {
-        return Sod.ensureScript(scriptUrl, global, callback, sodName, false);
-    }
-    /** ensure a collection of scripts and call the callback when they are all done */
-    public async ensureScripts(scripts: { scriptUrl: string; global: ksGlobal; sodName: string; }[], callback: () => void) {
-        let promises: Promise<void>[] = [];
-        let length = scripts.length;
-        let finished = 0;
-        let onFinished = typeof (callback) !== "function" ? null : () => {
-            finished++;
-            if (finished === length)//all finished
-                callback();
-        };
-        scripts.forEach(scr => {
-            promises.push(Sod.ensureScript(scr.scriptUrl, scr.global, onFinished, scr.sodName));
-        });
-
-        return Promise.all(promises);
-    }
-
-    private _WrapFunctionArr: any[] = [];
-
-    /** @deprecated - use wrapFunction instead from helpers/functions */
-    public wrapFunction3(originalFunction: () => void, instance: any, doBefore: () => void, doAfter: () => void) {
-        try {
-            if (instance !== null) {
-                originalFunction.bind(instance);
-            }
-            var idx = this._WrapFunctionArr.length;
-            this._WrapFunctionArr[idx] = originalFunction;
-
-            originalFunction = function (...args: any[]) {
-                if (typeof (doBefore) === "function") {
-                    doBefore.apply(instance, args);
-                }
-                var returnValue = this._WrapFunctionArr[idx].apply(instance, args);
-                if (typeof (doAfter) === "function") {
-                    doAfter.apply(instance, args);
-                }
-
-                return returnValue;
-            };
-            if (instance !== null) {
-                originalFunction.bind(instance);
-            }
-        } catch (e) {
-            if (isDebug()) console.log('unhandled error in wrapFunction3');
-        }
-    }
+import { isDebug } from "../helpers/debug";
+import { noop } from "../helpers/objects";
+import { isNotEmptyArray, isNullOrEmptyString, isNullOrUndefined } from "../helpers/typecheckers";
+import { IKnownScript, ksGlobal } from "../types/knownscript.types";
+import Sod from "./sod";
+
+export interface IScriptUtils {
+    /** @deprecated - use wrapFunction instead from helpers/functions */
+    wrapFunction3?: (originalFunction: () => void, instance: any, doBefore: () => void, doAfter: () => void) => void;
+    loadKnownScript: (script: IKnownScript) => void;
+    loadKnownScript_Sync: (script: IKnownScript) => void;
+    ensureScript: (scriptUrl: string, global: ksGlobal, callback: () => void, sodName: string) => void;
+    ensureScripts: (scripts: { scriptUrl: string; global: ksGlobal; sodName: string; }[], callback: () => void) => void;
+}
+
+export default class script implements IScriptUtils {
+    private static instance: script = null;
+    public isRtl = false;
+    public static get Instance() {
+        if (script.instance === null) {
+            //share single instance between all imports
+            if (typeof (window as any).kSingleScripts !== 'undefined')
+                script.instance = (window as any).kSingleScripts;//a global instance already exists, use it
+            else {
+                script.instance = new script();
+                (window as any).kSingleScripts = script.instance;//place this instance in the global namespace for others to reuse
+            }
+        }
+        return script.instance;
+    }
+
+    public async loadKnownScript(knownScript: IKnownScript) {
+        var promisesDependencies: Promise<any>[] = [];
+        (knownScript.dependencies || []).forEach(dep => {
+            promisesDependencies.push(this.loadKnownScript(dep));
+        });
+
+        if (promisesDependencies.length > 0)
+            await Promise.all(promisesDependencies);
+
+        return new Promise((resolve, reject) => {
+            this.ensureKnownScriptInternal(knownScript, () => {
+                resolve(Sod.getGlobal(knownScript.global));
+            });
+        });
+    }
+    public loadKnownScript_Sync(knownScript: IKnownScript) {
+        try {
+            if (isNotEmptyArray(knownScript.dependencies)) {
+                (knownScript.dependencies || []).forEach(dep => {
+                    this.loadKnownScript_Sync(dep)
+                });
+            }
+        } catch {
+        }
+
+        this.ensureKnownScriptInternal(knownScript, noop, true);
+        return Sod.getGlobal(knownScript.global);
+    }
+
+    private ensureKnownScriptInternal(knownScript: IKnownScript, callback: () => void, sync = false) {
+        let url = isDebug() && !knownScript.forceMin ? knownScript.url.replace('.min.js', '.js') : knownScript.url;
+        if (url[0] === '/') url = "https://apps.kwizcom.com" + url;
+
+        if (sync === true)
+            this.ensureScriptSync(url, knownScript.global, callback, knownScript.sodName);
+        else
+            this.ensureScript(url, knownScript.global, callback, knownScript.sodName);
+
+        let cssFiles = this.isRtl === true && !isNullOrUndefined(knownScript.rtlCss) ? knownScript.rtlCss : knownScript.css;
+        if (!isNullOrUndefined(cssFiles))
+            cssFiles.forEach(css => {
+                if (!isNullOrEmptyString(css)) {
+                    let cssurl = isDebug() && !knownScript.forceMin ? css.replace('.min.css', '.css') : css;
+                    if (cssurl[0] === '/') cssurl = "https://apps.kwizcom.com" + cssurl;
+
+                    let knownStyles = document.getElementsByClassName("kwizcom_known_css");
+                    let found = false;
+                    for (let si = 0; si < knownStyles.length; si++) {
+                        let elm: HTMLLinkElement = knownStyles[si] as HTMLLinkElement;
+                        if (elm.href && elm.href.toLowerCase() === cssurl.toLowerCase()) {
+                            found = true;
+                            break;
+                        }
+                    }
+                    if (!found) {
+                        let link = document.createElement("link");
+                        link.rel = "stylesheet";
+                        link.className = "kwizcom_known_css";
+                        link.type = "text/css";
+                        link.href = cssurl;
+                        document.head.appendChild(link);
+                    }
+                }
+            });
+    }
+
+    public loadCss(cssUrl: string) {
+        let knownStyles = document.getElementsByClassName("kwizcom_known_css");
+        let found = false;
+        for (let si = 0; si < knownStyles.length; si++) {
+            let elm: HTMLLinkElement = knownStyles[si] as HTMLLinkElement;
+            if (elm.href && elm.href.toLowerCase() === cssUrl.toLowerCase()) {
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            let link = document.createElement("link");
+            link.rel = "stylesheet";
+            link.className = "kwizcom_known_css";
+            link.type = "text/css";
+            link.href = cssUrl;
+            document.head.appendChild(link);
+        }
+    }
+
+    public ensureScriptSync(scriptUrl: string, global: ksGlobal, callback?: () => void, sodName?: string) {
+        //in IE there is no promise, we cannot use any async functions
+        return Sod.ensureScriptNoPromise(scriptUrl, global, callback, sodName, true);
+    }
+    public async ensureScript(scriptUrl: string, global: ksGlobal, callback?: () => void, sodName?: string) {
+        return Sod.ensureScript(scriptUrl, global, callback, sodName, false);
+    }
+    /** ensure a collection of scripts and call the callback when they are all done */
+    public async ensureScripts(scripts: { scriptUrl: string; global: ksGlobal; sodName: string; }[], callback: () => void) {
+        let promises: Promise<void>[] = [];
+        let length = scripts.length;
+        let finished = 0;
+        let onFinished = typeof (callback) !== "function" ? null : () => {
+            finished++;
+            if (finished === length)//all finished
+                callback();
+        };
+        scripts.forEach(scr => {
+            promises.push(Sod.ensureScript(scr.scriptUrl, scr.global, onFinished, scr.sodName));
+        });
+
+        return Promise.all(promises);
+    }
+
+    private _WrapFunctionArr: any[] = [];
+
+    /** @deprecated - use wrapFunction instead from helpers/functions */
+    public wrapFunction3(originalFunction: () => void, instance: any, doBefore: () => void, doAfter: () => void) {
+        try {
+            if (instance !== null) {
+                originalFunction.bind(instance);
+            }
+            var idx = this._WrapFunctionArr.length;
+            this._WrapFunctionArr[idx] = originalFunction;
+
+            originalFunction = function (...args: any[]) {
+                if (typeof (doBefore) === "function") {
+                    doBefore.apply(instance, args);
+                }
+                var returnValue = this._WrapFunctionArr[idx].apply(instance, args);
+                if (typeof (doAfter) === "function") {
+                    doAfter.apply(instance, args);
+                }
+
+                return returnValue;
+            };
+            if (instance !== null) {
+                originalFunction.bind(instance);
+            }
+        } catch (e) {
+            if (isDebug()) console.log('unhandled error in wrapFunction3');
+        }
+    }
 }

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

@@ -1,155 +1,155 @@
-import { jsonParse } from "../../helpers/json";
-import { isNullOrEmptyString, isNullOrUndefined, isString, isValidGuid } from "../../helpers/typecheckers";
-import { makeServerRelativeUrl, normalizeUrl } from "../../helpers/url";
-import { IDictionary } from "../../types/common.types";
-import { IRestError } from "../../types/rest.types";
-import { FieldTypeAsString, IFieldInfoEX, IFieldTaxonomyInfo } from "../../types/sharepoint.types";
-import { ISPRestError } from "../../types/sharepoint.utils.types";
-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,Sealed,MobileDisplayFormUrl,MobileNewFormUrl,MobileEditFormUrl,NewFormTemplateName,DisplayFormTemplateName,EditFormTemplateName";
-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;
+import { jsonParse } from "../../helpers/json";
+import { isNullOrEmptyString, isNullOrUndefined, isString, isValidGuid } from "../../helpers/typecheckers";
+import { makeServerRelativeUrl, normalizeUrl } from "../../helpers/url";
+import { IDictionary } from "../../types/common.types";
+import { IRestError } from "../../types/rest.types";
+import { FieldTypeAsString, IFieldInfoEX, IFieldTaxonomyInfo } from "../../types/sharepoint.types";
+import { ISPRestError } from "../../types/sharepoint.utils.types";
+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,Sealed,MobileDisplayFormUrl,MobileNewFormUrl,MobileEditFormUrl,NewFormTemplateName,DisplayFormTemplateName,EditFormTemplateName";
+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;
 }