@putkoff/abstract-utilities 0.1.163 → 0.1.165

package/dist/functions/safe_utils/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './safe_utils';
+export * from './safe_window';

package/dist/functions/safe_utils/src/safe_utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns `window` if running in a browser, otherwise `undefined`.
+ */
+export declare function getSafeLocalStorage(): Storage | undefined;
+/**
+ * Call a Storage method by name, silencing any errors or missing storage.
+ *
+ * @param method  One of the keys of the Storage interface: "getItem", "setItem", etc.
+ * @param args    The arguments you’d normally pass to that method.
+ * @returns       The method’s return value, or undefined if storage/method isn’t available.
+ */
+export declare function callStorage<K extends keyof Storage>(method: K, ...args: Parameters<Storage[K]>): ReturnType<Storage[K]> | undefined;

package/dist/functions/safe_utils/src/safe_window.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns the global window object if it exists, otherwise undefined.
+ */
+export declare function getSafeWindow(): Window | undefined;
+/**
+ * Safely call a method on window by name.
+ *
+ * @param method  The Window method to call (e.g. "alert", "open", etc.).
+ * @param args    Arguments to pass to that method.
+ * @returns       The method’s return value, or undefined if
+ *                 window/method isn’t available or throws.
+ */
+export declare function callWindowMethod<K extends keyof Window, F extends Window[K] = Window[K], Args extends any[] = F extends (...a: infer P) => any ? P : never, R = F extends (...a: any) => infer U ? U : void>(method: K, ...args: Args): R | undefined;
+/** overloads for 1‐ and 2‐level deep props */
+export declare function getWindowProp<K1 extends keyof Window>(prop1: K1): Window[K1] | undefined;
+export declare function getWindowProp<K1 extends keyof Window, K2 extends keyof NonNullable<Window[K1]>>(prop1: K1, prop2: K2): NonNullable<Window[K1]>[K2] | undefined;
+export declare function getWindowHost(): string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@putkoff/abstract-utilities",
-    "version": "0.1.163",
+    "version": "0.1.165",
     "type": "module",
     "description": "A reusable React Login component with JWT authentication",
     "main": "dist/cjs/index.js",
@@ -30,21 +30,21 @@
     },
     "devDependencies": {
         "@rollup/plugin-commonjs": "^25.0.7",
+        "@rollup/plugin-json": "^6.1.0",
         "@rollup/plugin-node-resolve": "^15.2.3",
         "@rollup/plugin-typescript": "^11.1.5",
-        "@rollup/plugin-json": "^6.1.0",
-        "rollup": "^4.12.0",
-        "rollup-plugin-dts": "^6.1.0",
-        "rollup-plugin-peer-deps-external": "^2.2.4",
-        "rollup-plugin-postcss": "^4.0.2",
-        "postcss": "^8.5.6",
         "@testing-library/jest-dom": "^6.4.2",
         "@testing-library/react": "^14.2.1",
         "@types/jest": "^29.5.12",
         "@types/node": "^24.0.13",
-        "@types/react": "^18.2.55",
-        "@types/react-dom": "^18.2.19",
+        "@types/react": "^18.3.23",
+        "@types/react-dom": "^18.3.7",
         "jest": "^29.7.0",
+        "postcss": "^8.5.6",
+        "rollup": "^4.12.0",
+        "rollup-plugin-dts": "^6.1.0",
+        "rollup-plugin-peer-deps-external": "^2.2.4",
+        "rollup-plugin-postcss": "^4.0.2",
         "ts-jest": "^29.1.2",
         "ts-node": "^10.9.2",
         "tslib": "^2.8.1",