nhb-toolbox 4.26.73 → 4.26.74

package/CHANGELOG.md

@@ -6,6 +6,10 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.26.74] - 2025-11-23
+
+- **Added** optional `serializer` and `deserializer` for *local and session storage* utilities with *improved error handling*.
+
 ## [4.26.73] - 2025-11-22
 
 - **Added** the **missing** *closing parenthesis* in `INDIA_VEDIC_SEASONS` *constant* within the `seasons` module.

package/dist/cjs/dom/storage.js

@@ -1,33 +1,62 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeFromSessionStorage = exports.saveToSessionStorage = exports.getFromSessionStorage = exports.removeFromLocalStorage = exports.saveToLocalStorage = exports.getFromLocalStorage = void 0;
-const getFromLocalStorage = (key) => {
-    const item = localStorage.getItem(key);
-    if (!item)
-        return null;
-    return JSON.parse(item);
-};
 exports.getFromLocalStorage = getFromLocalStorage;
-const saveToLocalStorage = (key, value) => {
-    localStorage.setItem(key, JSON.stringify(value));
-};
 exports.saveToLocalStorage = saveToLocalStorage;
-const removeFromLocalStorage = (key) => {
-    localStorage.removeItem(key);
-};
 exports.removeFromLocalStorage = removeFromLocalStorage;
-const getFromSessionStorage = (key) => {
-    const item = sessionStorage.getItem(key);
-    if (!item)
-        return null;
-    return JSON.parse(item);
-};
 exports.getFromSessionStorage = getFromSessionStorage;
-const saveToSessionStorage = (key, value) => {
-    sessionStorage.setItem(key, JSON.stringify(value));
-};
 exports.saveToSessionStorage = saveToSessionStorage;
-const removeFromSessionStorage = (key) => {
-    sessionStorage.removeItem(key);
-};
 exports.removeFromSessionStorage = removeFromSessionStorage;
+function getFromLocalStorage(key, deserialize) {
+    const deserializer = deserialize ?? JSON.parse;
+    try {
+        const item = localStorage.getItem(key);
+        return item ? deserializer(item) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function saveToLocalStorage(key, value, serialize) {
+    const serializer = serialize ?? JSON.stringify;
+    try {
+        localStorage.setItem(key, serializer(value));
+    }
+    catch (error) {
+        console.error(`Error saving item with key "${key}" in local storage:`, error);
+    }
+}
+function removeFromLocalStorage(key) {
+    try {
+        localStorage.removeItem(key);
+    }
+    catch (error) {
+        console.error(`Error removing item with key "${key}" from local storage:`, error);
+    }
+}
+function getFromSessionStorage(key, deserialize) {
+    const deserializer = deserialize ?? JSON.parse;
+    try {
+        const item = sessionStorage.getItem(key);
+        return item ? deserializer(item) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function saveToSessionStorage(key, value, serialize) {
+    const serializer = serialize ?? JSON.stringify;
+    try {
+        sessionStorage.setItem(key, serializer(value));
+    }
+    catch (error) {
+        console.error(`Error saving item with key "${key}" in session storage:`, error);
+    }
+}
+function removeFromSessionStorage(key) {
+    try {
+        sessionStorage.removeItem(key);
+    }
+    catch (error) {
+        console.error(`Error removing item with key "${key}" from session storage:`, error);
+    }
+}

package/dist/dts/dom/storage.d.ts

@@ -1,40 +1,45 @@
+import type { Deserializer, Serializer } from '../types/index';
 /**
- * * Get item(s) from local storage.
+ * * Get item from local storage.
  *
- * @param key - Key to get item(s) from local storage.
- * @returns Returns saved item(s) from local storage if it exists with that key.
+ * @param key - Key to get item from local storage.
+ * @param deserialize - Optional deserializer function to convert the stored value back to type `T`. Defaults to `JSON.parse`.
+ * @returns Returns saved item from local storage if it exists with that key.
  */
-export declare const getFromLocalStorage: <T>(key: string) => T | null;
+export declare function getFromLocalStorage<T>(key: string, deserialize?: Deserializer<T>): T | null;
 /**
- * * Save item(s) in local storage.
+ * * Save item in local storage.
  *
- * @param key - Key to save an item(s).
- * @param value - The item(s)/value to save.
+ * @param key - Key to save an item.
+ * @param value - The item/value to save.
+ * @param serialize - Optional serializer function to convert the value of type `T` to a string. Defaults to `JSON.stringify`.
  */
-export declare const saveToLocalStorage: <T>(key: string, value: T) => void;
+export declare function saveToLocalStorage<T>(key: string, value: T, serialize?: Serializer<T>): void;
 /**
- * * Remove item(s) from local storage.
+ * * Remove item from local storage.
  *
- * @param key - Key to delete item(s) from local storage.
+ * @param key - Key to delete item from local storage.
  */
-export declare const removeFromLocalStorage: (key: string) => void;
+export declare function removeFromLocalStorage(key: string): void;
 /**
- * * Get item(s) from session storage.
+ * * Get item from session storage.
  *
- * @param key - Key to get item(s) from session storage.
- * @returns Returns saved item(s) from session storage if it exists with that key.
+ * @param key - Key to get item from session storage.
+ * @param deserialize - Optional deserializer function to convert the stored value back to type `T`. Defaults to `JSON.parse`.
+ * @returns Returns saved item from session storage if it exists with that key.
  */
-export declare const getFromSessionStorage: <T>(key: string) => T | null;
+export declare function getFromSessionStorage<T>(key: string, deserialize?: Deserializer<T>): T | null;
 /**
- * * Save item(s) in session storage.
+ * * Save item in session storage.
  *
- * @param key - Key to save an item(s).
- * @param value - The item(s)/value to save.
+ * @param key - Key to save an item.
+ * @param value - The item/value to save.
+ * @param serialize - Optional serializer function to convert the value of type `T` to a string. Defaults to `JSON.stringify`.
  */
-export declare const saveToSessionStorage: <T>(key: string, value: T) => void;
+export declare function saveToSessionStorage<T>(key: string, value: T, serialize?: Serializer<T>): void;
 /**
- * * Remove item(s) from session storage.
+ * * Remove item from session storage.
  *
- * @param key - Key to delete item(s) from session storage.
+ * @param key - Key to delete item from session storage.
  */
-export declare const removeFromSessionStorage: (key: string) => void;
+export declare function removeFromSessionStorage(key: string): void;

package/dist/dts/types/index.d.ts

@@ -133,4 +133,8 @@ export type ValidArray<T> = [T, ...Array<T>];
  * arr.push(4);                   	// ❌ Error (readonly)
  */
 export type List<T = any> = ReadonlyArray<T>;
+/** Function type for serializing a value of type `T` to a string. */
+export type Serializer<T> = (value: T) => string;
+/** Function type for deserializing a string to a value of type `T`. */
+export type Deserializer<T> = (value: string) => T;
 export {};

package/dist/esm/dom/storage.js

@@ -1,24 +1,54 @@
-export const getFromLocalStorage = (key) => {
-    const item = localStorage.getItem(key);
-    if (!item)
+export function getFromLocalStorage(key, deserialize) {
+    const deserializer = deserialize ?? JSON.parse;
+    try {
+        const item = localStorage.getItem(key);
+        return item ? deserializer(item) : null;
+    }
+    catch {
         return null;
-    return JSON.parse(item);
-};
-export const saveToLocalStorage = (key, value) => {
-    localStorage.setItem(key, JSON.stringify(value));
-};
-export const removeFromLocalStorage = (key) => {
-    localStorage.removeItem(key);
-};
-export const getFromSessionStorage = (key) => {
-    const item = sessionStorage.getItem(key);
-    if (!item)
+    }
+}
+export function saveToLocalStorage(key, value, serialize) {
+    const serializer = serialize ?? JSON.stringify;
+    try {
+        localStorage.setItem(key, serializer(value));
+    }
+    catch (error) {
+        console.error(`Error saving item with key "${key}" in local storage:`, error);
+    }
+}
+export function removeFromLocalStorage(key) {
+    try {
+        localStorage.removeItem(key);
+    }
+    catch (error) {
+        console.error(`Error removing item with key "${key}" from local storage:`, error);
+    }
+}
+export function getFromSessionStorage(key, deserialize) {
+    const deserializer = deserialize ?? JSON.parse;
+    try {
+        const item = sessionStorage.getItem(key);
+        return item ? deserializer(item) : null;
+    }
+    catch {
         return null;
-    return JSON.parse(item);
-};
-export const saveToSessionStorage = (key, value) => {
-    sessionStorage.setItem(key, JSON.stringify(value));
-};
-export const removeFromSessionStorage = (key) => {
-    sessionStorage.removeItem(key);
-};
+    }
+}
+export function saveToSessionStorage(key, value, serialize) {
+    const serializer = serialize ?? JSON.stringify;
+    try {
+        sessionStorage.setItem(key, serializer(value));
+    }
+    catch (error) {
+        console.error(`Error saving item with key "${key}" in session storage:`, error);
+    }
+}
+export function removeFromSessionStorage(key) {
+    try {
+        sessionStorage.removeItem(key);
+    }
+    catch (error) {
+        console.error(`Error removing item with key "${key}" from session storage:`, error);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.26.73",
+  "version": "4.26.74",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -42,20 +42,20 @@
     "@eslint/js": "^9.39.1",
     "@types/jest": "^30.0.0",
     "@types/node": "^24.10.1",
-    "@typescript-eslint/eslint-plugin": "^8.46.4",
-    "@typescript-eslint/parser": "^8.46.4",
+    "@typescript-eslint/eslint-plugin": "^8.47.0",
+    "@typescript-eslint/parser": "^8.47.0",
     "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "globals": "^16.5.0",
     "husky": "^9.1.7",
     "jest": "^30.2.0",
-    "lint-staged": "^16.2.6",
-    "nhb-scripts": "^1.8.86",
+    "lint-staged": "^16.2.7",
+    "nhb-scripts": "^1.8.88",
     "prettier": "^3.6.2",
     "ts-jest": "^29.4.5",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.4"
+    "typescript-eslint": "^8.47.0"
   },
   "keywords": [
     "toolbox",