@putkoff/abstract-utilities 0.1.171 → 0.1.172

package/dist/esm/index.js

@@ -1,6 +1,19 @@
 export { useCallback, useEffect, useRef, useState } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
+function getSafeDocument() {
+    return typeof document !== 'undefined' ? document : undefined;
+}
+function getDocumentProp(...keys) {
+    let obj = getSafeDocument();
+    for (const k of keys) {
+        if (obj == null || typeof obj !== 'object')
+            return undefined;
+        obj = obj[k];
+    }
+    return obj;
+}
+
 /**
  * Returns `window` if running in a browser, otherwise `undefined`.
  */
@@ -36,6 +49,45 @@ function callStorage(method, ...args) {
         return undefined;
     }
 }
+/**
+ * Safely call localStorage / sessionStorage / any Storage API.
+ *
+ * @param storageName  "localStorage" or "sessionStorage"
+ * @param method       one of the Storage methods, e.g. "getItem", "setItem", etc.
+ * @param args         arguments to pass along (e.g. key, value)
+ * @returns            whatever the underlying method returns, or undefined if unavailable/fails
+ */
+function safeStorage(storageName, method, ...args) {
+    try {
+        const storage = globalThis[storageName];
+        if (!storage)
+            return undefined;
+        const fn = storage[method];
+        if (typeof fn !== "function")
+            return undefined;
+        // @ts-ignore
+        return fn.apply(storage, args);
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+
+/**
+ * Safely walk `window` or `document` to grab nested props without blowing up in Node.
+ *
+ * @param rootName   "window" or "document"
+ * @param path       sequence of property names, e.g. ["location","host"] or ["baseURI"]
+ */
+function safeGlobalProp(rootName, ...path) {
+    let obj = globalThis[rootName];
+    for (const key of path) {
+        if (obj == null)
+            return undefined;
+        obj = obj[key];
+    }
+    return obj;
+}
 
 /**
  * Returns the global window object if it exists, otherwise undefined.
@@ -80,19 +132,6 @@ function getWindowHost() {
     return getWindowProp('location', 'host');
 }
 
-function getSafeDocument() {
-    return typeof document !== 'undefined' ? document : undefined;
-}
-function getDocumentProp(...keys) {
-    let obj = getSafeDocument();
-    for (const k of keys) {
-        if (obj == null || typeof obj !== 'object')
-            return undefined;
-        obj = obj[k];
-    }
-    return obj;
-}
-
 /**
 ***Changes**:
 *- Updated import path for `InputProps` to `../../types/interfaces`.
@@ -1472,5 +1511,5 @@ function readJsonFile(relativeOrAbsolutePath) {
     });
 }
 
-export { API_PREFIX, BASE_URL, Button, Checkbox, DEV_PREFIX, DOMAIN_NAME, Input, PROD_PREFIX, PROTOCOL, SUB_DIR, Spinner, alertit, api, callStorage, callWindowMethod, checkResponse, currentUsername, currentUsernames, decodeJwt, eatAll, eatEnd, eatInner, eatOuter, ensureAbstractUrl, ensure_list, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, fetchSharePatch, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, getAbsDir, getAbsPath, getAuthorizationHeader, getBaseDir, getBody, getComponentsUtilsDirectory, getConfig, getDbConfigsPath, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getFetchVars, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getLibUtilsDirectory, getMethod, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSrcDir, getSubstring, getToken, getWindowHost, getWindowProp, get_app_config_url, get_basename, get_dirname, get_extname, get_filename, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, isLoggedIn, isTokenExpired, loadConfig, make_path, make_sanitized_path, normalizeUrl, parseResult, readFileContents, readJsonFile, requestPatch, requireToken, sanitizeFilename, secureFetchIt, stripPrefixes, truncateString };
+export { API_PREFIX, BASE_URL, Button, Checkbox, DEV_PREFIX, DOMAIN_NAME, Input, PROD_PREFIX, PROTOCOL, SUB_DIR, Spinner, alertit, api, callStorage, callWindowMethod, checkResponse, currentUsername, currentUsernames, decodeJwt, eatAll, eatEnd, eatInner, eatOuter, ensureAbstractUrl, ensure_list, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, fetchSharePatch, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, getAbsDir, getAbsPath, getAuthorizationHeader, getBaseDir, getBody, getComponentsUtilsDirectory, getConfig, getDbConfigsPath, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getFetchVars, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getLibUtilsDirectory, getMethod, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSrcDir, getSubstring, getToken, getWindowHost, getWindowProp, get_app_config_url, get_basename, get_dirname, get_extname, get_filename, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, isLoggedIn, isTokenExpired, loadConfig, make_path, make_sanitized_path, normalizeUrl, parseResult, readFileContents, readJsonFile, requestPatch, requireToken, safeGlobalProp, safeStorage, sanitizeFilename, secureFetchIt, stripPrefixes, truncateString };
 //# sourceMappingURL=index.js.map