@putkoff/abstract-utilities 0.1.171 → 0.1.172

package/dist/cjs/index.js

@@ -4,6 +4,19 @@ var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+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`.
  */
@@ -39,6 +52,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.
@@ -83,19 +135,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`.
@@ -1583,6 +1622,8 @@ exports.readFileContents = readFileContents;
 exports.readJsonFile = readJsonFile;
 exports.requestPatch = requestPatch;
 exports.requireToken = requireToken;
+exports.safeGlobalProp = safeGlobalProp;
+exports.safeStorage = safeStorage;
 exports.sanitizeFilename = sanitizeFilename;
 exports.secureFetchIt = secureFetchIt;
 exports.stripPrefixes = stripPrefixes;