@etsoo/shared 1.0.81 → 1.0.85

package/README.md

@@ -15,6 +15,9 @@ Using yarn:
 $ yarn add @etsoo/shared
 ```
 
+## storage
+Storage interface and browser storage implementation
+
 ## DataTypes
 Data type definitions and type safe functions
 
@@ -92,8 +95,6 @@ DOM/window related utilities
 |isJSONContentType|Is JSON content type|
 |mergeFormData|Merge form data to primary one|
 |mergeURLSearchParams|Merge URL search parameters|
-|saveCountry|Save country name|
-|saveCulture|Save culture name|
 |setFocus|Set HTML element focus by name|
 
 ## ExtendUtils

package/lib/cjs/DomUtils.d.ts

@@ -8,11 +8,11 @@ export declare namespace DomUtils {
     /**
      * Language cache parameter name
      */
-    const Culture = "culture";
+    const CultureField = "culture";
     /**
      * Country cache parameter name
      */
-    const Country = "country";
+    const CountryField = "country";
     /**
      * Clear form data
      * @param data Form data
@@ -94,16 +94,6 @@ export declare namespace DomUtils {
      * @param data New simple object data to merge
      */
     function mergeURLSearchParams(base: URLSearchParams, data: DataTypes.SimpleObject): URLSearchParams;
-    /**
-     * Save country name
-     * @param country Country name
-     */
-    function saveCountry(country: string): void;
-    /**
-     * Save culture name
-     * @param culture Culture name
-     */
-    function saveCulture(culture: string): void;
     /**
      * Set HTML element focus by name
      * @param name Element name or first collection item

package/lib/cjs/DomUtils.js

@@ -16,11 +16,11 @@ var DomUtils;
     /**
      * Language cache parameter name
      */
-    DomUtils.Culture = 'culture';
+    DomUtils.CultureField = 'culture';
     /**
      * Country cache parameter name
      */
-    DomUtils.Country = 'country';
+    DomUtils.CountryField = 'country';
     /**
      * Clear form data
      * @param data Form data
@@ -156,12 +156,12 @@ var DomUtils;
      * Current detected country
      */
     DomUtils.detectedCountry = (() => {
+        var _a, _b;
         // URL first, then local storage
         let country;
         try {
             country =
-                new URL(location.href).searchParams.get(DomUtils.Country) ||
-                    localStorage.getItem(DomUtils.Country);
+                (_b = (_a = new URL(location.href).searchParams.get(DomUtils.CountryField)) !== null && _a !== void 0 ? _a : sessionStorage.getItem(DomUtils.CountryField)) !== null && _b !== void 0 ? _b : localStorage.getItem(DomUtils.CountryField);
         }
         catch {
             country = null;
@@ -173,12 +173,12 @@ var DomUtils;
      * Current detected culture
      */
     DomUtils.detectedCulture = (() => {
+        var _a, _b;
         // URL first, then local storage
         let culture;
         try {
             culture =
-                new URL(location.href).searchParams.get(DomUtils.Culture) ||
-                    localStorage.getItem(DomUtils.Culture);
+                (_b = (_a = new URL(location.href).searchParams.get(DomUtils.CultureField)) !== null && _a !== void 0 ? _a : sessionStorage.getItem(DomUtils.CultureField)) !== null && _b !== void 0 ? _b : localStorage.getItem(DomUtils.CultureField);
         }
         catch {
             culture = null;
@@ -342,22 +342,6 @@ var DomUtils;
         return base;
     }
     DomUtils.mergeURLSearchParams = mergeURLSearchParams;
-    /**
-     * Save country name
-     * @param country Country name
-     */
-    function saveCountry(country) {
-        localStorage.setItem(DomUtils.Country, country);
-    }
-    DomUtils.saveCountry = saveCountry;
-    /**
-     * Save culture name
-     * @param culture Culture name
-     */
-    function saveCulture(culture) {
-        localStorage.setItem(DomUtils.Culture, culture);
-    }
-    DomUtils.saveCulture = saveCulture;
     /**
      * Set HTML element focus by name
      * @param name Element name or first collection item

package/lib/cjs/StorageUtils.d.ts

@@ -15,12 +15,17 @@ export declare namespace StorageUtils {
      * @param data Data, null for removal
      */
     function setSessionData(key: string, data: unknown): void;
+    /**
+     * Get local storage data
+     * @param key Key name
+     */
+    function getLocalData<T>(key: string): T | undefined;
     /**
      * Get local storage data
      * @param key Key name
      * @param defaultValue Default value
      */
-    function getLocalData<T, M = T | undefined>(key: string, defaultValue?: M): M extends T ? M : undefined;
+    function getLocalData<T>(key: string, defaultValue: T): T;
     /**
      * Get local storage object data
      * @param key Key name
@@ -30,7 +35,13 @@ export declare namespace StorageUtils {
      * Get session storage data
      * @param key Key name
      */
-    function getSessionData<T, M = T | undefined>(key: string, defaultValue?: M): M extends T ? M : undefined;
+    function getSessionData<T>(key: string): T | undefined;
+    /**
+     * Get session storage data with default value
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    function getSessionData<T>(key: string, defaultValue: T): T;
     /**
      * Get session storage object data
      * @param key Key name

package/lib/cjs/StorageUtils.js

@@ -47,6 +47,9 @@ var StorageUtils;
     function getLocalData(key, defaultValue) {
         // Get storage
         const data = localStorage.getItem(key);
+        // No default value
+        if (defaultValue == null)
+            return Utils_1.Utils.parseString(data);
         // Return
         return Utils_1.Utils.parseString(data, defaultValue);
     }
@@ -66,10 +69,14 @@ var StorageUtils;
     /**
      * Get session storage data
      * @param key Key name
+     * @param defaultValue Default value
      */
     function getSessionData(key, defaultValue) {
         // Get storage
         const data = sessionStorage.getItem(key);
+        // No default value
+        if (defaultValue == null)
+            return Utils_1.Utils.parseString(data);
         // Return
         return Utils_1.Utils.parseString(data, defaultValue);
     }

package/lib/cjs/Utils.d.ts

@@ -134,6 +134,13 @@ export declare namespace Utils {
      * @returns Updated fields
      */
     function objectUpdated(objNew: {}, objPrev: {}, ignoreFields?: string[], strict?: number): string[];
+    /**
+     * Parse string (JSON) to specific type, no type conversion
+     * For type conversion, please use DataTypes.convert
+     * @param input Input string
+     * @returns Parsed value
+     */
+    function parseString<T>(input: string | undefined | null): T | undefined;
     /**
      * Parse string (JSON) to specific type, no type conversion
      * For type conversion, please use DataTypes.convert
@@ -141,7 +148,7 @@ export declare namespace Utils {
      * @param defaultValue Default value
      * @returns Parsed value
      */
-    function parseString<T, M = T | undefined>(input: string | undefined | null, defaultValue?: M): M extends T ? M : undefined;
+    function parseString<T>(input: string | undefined | null, defaultValue: T): T;
     /**
      * Remove non letters
      * @param input Input string

package/lib/cjs/Utils.js

@@ -268,6 +268,7 @@ var Utils;
     Utils.objectUpdated = objectUpdated;
     /**
      * Parse string (JSON) to specific type, no type conversion
+     * When return type depends on parameter value, uses function overloading, otherwise uses conditional type
      * For type conversion, please use DataTypes.convert
      * @param input Input string
      * @param defaultValue Default value

package/lib/cjs/index.d.ts

@@ -1,4 +1,6 @@
 export * from './types/FormData';
+export * from './storage/IStorage';
+export * from './storage/WindowStorage';
 export * from './DataTypes';
 export * from './DateUtils';
 export * from './DomUtils';

package/lib/cjs/index.js

@@ -11,6 +11,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types/FormData"), exports);
+__exportStar(require("./storage/IStorage"), exports);
+__exportStar(require("./storage/WindowStorage"), exports);
 __exportStar(require("./DataTypes"), exports);
 __exportStar(require("./DateUtils"), exports);
 __exportStar(require("./DomUtils"), exports);

package/lib/cjs/storage/IStorage.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Storage interface
+ */
+export interface IStorage {
+    /**
+     * Get data
+     * @param key Key name
+     */
+    getData<T>(key: string): T | undefined;
+    /**
+     * Get data with default value
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    getData<T>(key: string, defaultValue: T): T;
+    /**
+     * Get session storage object data
+     * @param key Key name
+     */
+    getObject<T extends {}>(key: string): T | undefined;
+    /**
+     * Set data
+     * @param key Key name
+     * @param data  Data, null for removal
+     */
+    setData(key: string, data: unknown): void;
+}
+/**
+ * Storage constructor interface
+ */
+export interface IStorageConstructor {
+    new (globalFields: string[]): IStorage;
+}

package/lib/cjs/storage/IStorage.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/storage/WindowStorage.d.ts

@@ -0,0 +1,35 @@
+import { IStorage } from './IStorage';
+/**
+ * Window storage
+ * https://developer.mozilla.org/en-US/docs/Web/API/Storage
+ */
+export declare class WindowStorage implements IStorage {
+    private globalFields;
+    /**
+     * Constructor
+     * @param globalFields Global fields
+     */
+    constructor(globalFields: string[]);
+    /**
+     * Get data
+     * @param key Key name
+     */
+    getData<T>(key: string): T | undefined;
+    /**
+     * Get data with default value
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    getData<T>(key: string, defaultValue: T): T;
+    /**
+     * Get object data
+     * @param key Key name
+     */
+    getObject<T extends {}>(key: string): T | undefined;
+    /**
+     * Set data
+     * @param key Key name
+     * @param data  Data, null for removal
+     */
+    setData(key: string, data: unknown): void;
+}

package/lib/cjs/storage/WindowStorage.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WindowStorage = void 0;
+const StorageUtils_1 = require("../StorageUtils");
+const Utils_1 = require("../Utils");
+/**
+ * Window storage
+ * https://developer.mozilla.org/en-US/docs/Web/API/Storage
+ */
+class WindowStorage {
+    /**
+     * Constructor
+     * @param globalFields Global fields
+     */
+    constructor(globalFields) {
+        this.globalFields = globalFields;
+        if (globalFields.length == 0)
+            return;
+        // Copy global fields to session storage where first item does not exist
+        // Duplicate browser tab would copy the session storage
+        const firsItem = sessionStorage.getItem(globalFields[0]);
+        if (firsItem)
+            return;
+        globalFields.forEach((field) => {
+            const data = localStorage.getItem(field);
+            if (data != null) {
+                sessionStorage.setItem(field, data);
+            }
+        });
+    }
+    /**
+     * Get data
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    getData(key, defaultValue) {
+        // Get storage
+        const data = sessionStorage.getItem(key);
+        // No default value
+        if (defaultValue == null)
+            return Utils_1.Utils.parseString(data);
+        // Return
+        return Utils_1.Utils.parseString(data, defaultValue);
+    }
+    /**
+     * Get object data
+     * @param key Key name
+     */
+    getObject(key) {
+        // Get storage
+        const data = sessionStorage.getItem(key);
+        if (data == null)
+            return undefined;
+        return JSON.parse(data);
+    }
+    /**
+     * Set data
+     * @param key Key name
+     * @param data  Data, null for removal
+     */
+    setData(key, data) {
+        StorageUtils_1.StorageUtils.setSessionData(key, data);
+        if (this.globalFields.includes(key)) {
+            StorageUtils_1.StorageUtils.setLocalData(key, data);
+        }
+    }
+}
+exports.WindowStorage = WindowStorage;

package/lib/mjs/DomUtils.d.ts

@@ -8,11 +8,11 @@ export declare namespace DomUtils {
     /**
      * Language cache parameter name
      */
-    const Culture = "culture";
+    const CultureField = "culture";
     /**
      * Country cache parameter name
      */
-    const Country = "country";
+    const CountryField = "country";
     /**
      * Clear form data
      * @param data Form data
@@ -94,16 +94,6 @@ export declare namespace DomUtils {
      * @param data New simple object data to merge
      */
     function mergeURLSearchParams(base: URLSearchParams, data: DataTypes.SimpleObject): URLSearchParams;
-    /**
-     * Save country name
-     * @param country Country name
-     */
-    function saveCountry(country: string): void;
-    /**
-     * Save culture name
-     * @param culture Culture name
-     */
-    function saveCulture(culture: string): void;
     /**
      * Set HTML element focus by name
      * @param name Element name or first collection item

package/lib/mjs/DomUtils.js

@@ -13,11 +13,11 @@ export var DomUtils;
     /**
      * Language cache parameter name
      */
-    DomUtils.Culture = 'culture';
+    DomUtils.CultureField = 'culture';
     /**
      * Country cache parameter name
      */
-    DomUtils.Country = 'country';
+    DomUtils.CountryField = 'country';
     /**
      * Clear form data
      * @param data Form data
@@ -153,12 +153,12 @@ export var DomUtils;
      * Current detected country
      */
     DomUtils.detectedCountry = (() => {
+        var _a, _b;
         // URL first, then local storage
         let country;
         try {
             country =
-                new URL(location.href).searchParams.get(DomUtils.Country) ||
-                    localStorage.getItem(DomUtils.Country);
+                (_b = (_a = new URL(location.href).searchParams.get(DomUtils.CountryField)) !== null && _a !== void 0 ? _a : sessionStorage.getItem(DomUtils.CountryField)) !== null && _b !== void 0 ? _b : localStorage.getItem(DomUtils.CountryField);
         }
         catch {
             country = null;
@@ -170,12 +170,12 @@ export var DomUtils;
      * Current detected culture
      */
     DomUtils.detectedCulture = (() => {
+        var _a, _b;
         // URL first, then local storage
         let culture;
         try {
             culture =
-                new URL(location.href).searchParams.get(DomUtils.Culture) ||
-                    localStorage.getItem(DomUtils.Culture);
+                (_b = (_a = new URL(location.href).searchParams.get(DomUtils.CultureField)) !== null && _a !== void 0 ? _a : sessionStorage.getItem(DomUtils.CultureField)) !== null && _b !== void 0 ? _b : localStorage.getItem(DomUtils.CultureField);
         }
         catch {
             culture = null;
@@ -339,22 +339,6 @@ export var DomUtils;
         return base;
     }
     DomUtils.mergeURLSearchParams = mergeURLSearchParams;
-    /**
-     * Save country name
-     * @param country Country name
-     */
-    function saveCountry(country) {
-        localStorage.setItem(DomUtils.Country, country);
-    }
-    DomUtils.saveCountry = saveCountry;
-    /**
-     * Save culture name
-     * @param culture Culture name
-     */
-    function saveCulture(culture) {
-        localStorage.setItem(DomUtils.Culture, culture);
-    }
-    DomUtils.saveCulture = saveCulture;
     /**
      * Set HTML element focus by name
      * @param name Element name or first collection item

package/lib/mjs/StorageUtils.d.ts

@@ -15,12 +15,17 @@ export declare namespace StorageUtils {
      * @param data Data, null for removal
      */
     function setSessionData(key: string, data: unknown): void;
+    /**
+     * Get local storage data
+     * @param key Key name
+     */
+    function getLocalData<T>(key: string): T | undefined;
     /**
      * Get local storage data
      * @param key Key name
      * @param defaultValue Default value
      */
-    function getLocalData<T, M = T | undefined>(key: string, defaultValue?: M): M extends T ? M : undefined;
+    function getLocalData<T>(key: string, defaultValue: T): T;
     /**
      * Get local storage object data
      * @param key Key name
@@ -30,7 +35,13 @@ export declare namespace StorageUtils {
      * Get session storage data
      * @param key Key name
      */
-    function getSessionData<T, M = T | undefined>(key: string, defaultValue?: M): M extends T ? M : undefined;
+    function getSessionData<T>(key: string): T | undefined;
+    /**
+     * Get session storage data with default value
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    function getSessionData<T>(key: string, defaultValue: T): T;
     /**
      * Get session storage object data
      * @param key Key name

package/lib/mjs/StorageUtils.js

@@ -44,6 +44,9 @@ export var StorageUtils;
     function getLocalData(key, defaultValue) {
         // Get storage
         const data = localStorage.getItem(key);
+        // No default value
+        if (defaultValue == null)
+            return Utils.parseString(data);
         // Return
         return Utils.parseString(data, defaultValue);
     }
@@ -63,10 +66,14 @@ export var StorageUtils;
     /**
      * Get session storage data
      * @param key Key name
+     * @param defaultValue Default value
      */
     function getSessionData(key, defaultValue) {
         // Get storage
         const data = sessionStorage.getItem(key);
+        // No default value
+        if (defaultValue == null)
+            return Utils.parseString(data);
         // Return
         return Utils.parseString(data, defaultValue);
     }

package/lib/mjs/Utils.d.ts

@@ -134,6 +134,13 @@ export declare namespace Utils {
      * @returns Updated fields
      */
     function objectUpdated(objNew: {}, objPrev: {}, ignoreFields?: string[], strict?: number): string[];
+    /**
+     * Parse string (JSON) to specific type, no type conversion
+     * For type conversion, please use DataTypes.convert
+     * @param input Input string
+     * @returns Parsed value
+     */
+    function parseString<T>(input: string | undefined | null): T | undefined;
     /**
      * Parse string (JSON) to specific type, no type conversion
      * For type conversion, please use DataTypes.convert
@@ -141,7 +148,7 @@ export declare namespace Utils {
      * @param defaultValue Default value
      * @returns Parsed value
      */
-    function parseString<T, M = T | undefined>(input: string | undefined | null, defaultValue?: M): M extends T ? M : undefined;
+    function parseString<T>(input: string | undefined | null, defaultValue: T): T;
     /**
      * Remove non letters
      * @param input Input string

package/lib/mjs/Utils.js

@@ -265,6 +265,7 @@ export var Utils;
     Utils.objectUpdated = objectUpdated;
     /**
      * Parse string (JSON) to specific type, no type conversion
+     * When return type depends on parameter value, uses function overloading, otherwise uses conditional type
      * For type conversion, please use DataTypes.convert
      * @param input Input string
      * @param defaultValue Default value

package/lib/mjs/index.d.ts

@@ -1,4 +1,6 @@
 export * from './types/FormData';
+export * from './storage/IStorage';
+export * from './storage/WindowStorage';
 export * from './DataTypes';
 export * from './DateUtils';
 export * from './DomUtils';

package/lib/mjs/index.js

@@ -1,4 +1,6 @@
 export * from './types/FormData';
+export * from './storage/IStorage';
+export * from './storage/WindowStorage';
 export * from './DataTypes';
 export * from './DateUtils';
 export * from './DomUtils';

package/lib/mjs/storage/IStorage.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Storage interface
+ */
+export interface IStorage {
+    /**
+     * Get data
+     * @param key Key name
+     */
+    getData<T>(key: string): T | undefined;
+    /**
+     * Get data with default value
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    getData<T>(key: string, defaultValue: T): T;
+    /**
+     * Get session storage object data
+     * @param key Key name
+     */
+    getObject<T extends {}>(key: string): T | undefined;
+    /**
+     * Set data
+     * @param key Key name
+     * @param data  Data, null for removal
+     */
+    setData(key: string, data: unknown): void;
+}
+/**
+ * Storage constructor interface
+ */
+export interface IStorageConstructor {
+    new (globalFields: string[]): IStorage;
+}

package/lib/mjs/storage/IStorage.js

@@ -0,0 +1 @@
+export {};

package/lib/mjs/storage/WindowStorage.d.ts

@@ -0,0 +1,35 @@
+import { IStorage } from './IStorage';
+/**
+ * Window storage
+ * https://developer.mozilla.org/en-US/docs/Web/API/Storage
+ */
+export declare class WindowStorage implements IStorage {
+    private globalFields;
+    /**
+     * Constructor
+     * @param globalFields Global fields
+     */
+    constructor(globalFields: string[]);
+    /**
+     * Get data
+     * @param key Key name
+     */
+    getData<T>(key: string): T | undefined;
+    /**
+     * Get data with default value
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    getData<T>(key: string, defaultValue: T): T;
+    /**
+     * Get object data
+     * @param key Key name
+     */
+    getObject<T extends {}>(key: string): T | undefined;
+    /**
+     * Set data
+     * @param key Key name
+     * @param data  Data, null for removal
+     */
+    setData(key: string, data: unknown): void;
+}

package/lib/mjs/storage/WindowStorage.js

@@ -0,0 +1,64 @@
+import { StorageUtils } from '../StorageUtils';
+import { Utils } from '../Utils';
+/**
+ * Window storage
+ * https://developer.mozilla.org/en-US/docs/Web/API/Storage
+ */
+export class WindowStorage {
+    /**
+     * Constructor
+     * @param globalFields Global fields
+     */
+    constructor(globalFields) {
+        this.globalFields = globalFields;
+        if (globalFields.length == 0)
+            return;
+        // Copy global fields to session storage where first item does not exist
+        // Duplicate browser tab would copy the session storage
+        const firsItem = sessionStorage.getItem(globalFields[0]);
+        if (firsItem)
+            return;
+        globalFields.forEach((field) => {
+            const data = localStorage.getItem(field);
+            if (data != null) {
+                sessionStorage.setItem(field, data);
+            }
+        });
+    }
+    /**
+     * Get data
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    getData(key, defaultValue) {
+        // Get storage
+        const data = sessionStorage.getItem(key);
+        // No default value
+        if (defaultValue == null)
+            return Utils.parseString(data);
+        // Return
+        return Utils.parseString(data, defaultValue);
+    }
+    /**
+     * Get object data
+     * @param key Key name
+     */
+    getObject(key) {
+        // Get storage
+        const data = sessionStorage.getItem(key);
+        if (data == null)
+            return undefined;
+        return JSON.parse(data);
+    }
+    /**
+     * Set data
+     * @param key Key name
+     * @param data  Data, null for removal
+     */
+    setData(key, data) {
+        StorageUtils.setSessionData(key, data);
+        if (this.globalFields.includes(key)) {
+            StorageUtils.setLocalData(key, data);
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@etsoo/shared",
-    "version": "1.0.81",
+    "version": "1.0.85",
     "description": "TypeScript shared utilities and functions",
     "main": "lib/cjs/index.js",
     "module": "lib/mjs/index.js",

package/src/DomUtils.ts

@@ -15,12 +15,12 @@ export namespace DomUtils {
     /**
      * Language cache parameter name
      */
-    export const Culture = 'culture';
+    export const CultureField = 'culture';
 
     /**
      * Country cache parameter name
      */
-    export const Country = 'country';
+    export const CountryField = 'country';
 
     /**
      * Clear form data
@@ -198,8 +198,9 @@ export namespace DomUtils {
         let country: string | null;
         try {
             country =
-                new URL(location.href).searchParams.get(Country) ||
-                localStorage.getItem(Country);
+                new URL(location.href).searchParams.get(CountryField) ??
+                sessionStorage.getItem(CountryField) ??
+                localStorage.getItem(CountryField);
         } catch {
             country = null;
         }
@@ -216,8 +217,9 @@ export namespace DomUtils {
         let culture: string | null;
         try {
             culture =
-                new URL(location.href).searchParams.get(Culture) ||
-                localStorage.getItem(Culture);
+                new URL(location.href).searchParams.get(CultureField) ??
+                sessionStorage.getItem(CultureField) ??
+                localStorage.getItem(CultureField);
         } catch {
             culture = null;
         }
@@ -415,22 +417,6 @@ export namespace DomUtils {
         return base;
     }
 
-    /**
-     * Save country name
-     * @param country Country name
-     */
-    export function saveCountry(country: string) {
-        localStorage.setItem(Country, country);
-    }
-
-    /**
-     * Save culture name
-     * @param culture Culture name
-     */
-    export function saveCulture(culture: string) {
-        localStorage.setItem(Culture, culture);
-    }
-
     /**
      * Set HTML element focus by name
      * @param name Element name or first collection item

package/src/StorageUtils.ts

@@ -44,20 +44,36 @@ export namespace StorageUtils {
         );
     }
 
+    /**
+     * Get local storage data
+     * @param key Key name
+     */
+    export function getLocalData<T>(key: string): T | undefined;
+
+    /**
+     * Get local storage data
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    export function getLocalData<T>(key: string, defaultValue: T): T;
+
     /**
      * Get local storage data
      * @param key Key name
      * @param defaultValue Default value
      */
-    export function getLocalData<T, M = T | undefined>(
+    export function getLocalData<T>(
         key: string,
-        defaultValue?: M
-    ): M extends T ? M : undefined {
+        defaultValue?: T
+    ): T | undefined {
         // Get storage
         const data = localStorage.getItem(key);
 
+        // No default value
+        if (defaultValue == null) return Utils.parseString<T>(data);
+
         // Return
-        return Utils.parseString<T, M>(data, defaultValue);
+        return Utils.parseString<T>(data, defaultValue);
     }
 
     /**
@@ -75,15 +91,32 @@ export namespace StorageUtils {
      * Get session storage data
      * @param key Key name
      */
-    export function getSessionData<T, M = T | undefined>(
+    export function getSessionData<T>(key: string): T | undefined;
+
+    /**
+     * Get session storage data with default value
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    export function getSessionData<T>(key: string, defaultValue: T): T;
+
+    /**
+     * Get session storage data
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    export function getSessionData<T>(
         key: string,
-        defaultValue?: M
-    ): M extends T ? M : undefined {
+        defaultValue?: T
+    ): T | undefined {
         // Get storage
         const data = sessionStorage.getItem(key);
 
+        // No default value
+        if (defaultValue == null) return Utils.parseString<T>(data);
+
         // Return
-        return Utils.parseString<T, M>(data, defaultValue);
+        return Utils.parseString<T>(data, defaultValue);
     }
 
     /**

package/src/Utils.ts

@@ -365,15 +365,38 @@ export namespace Utils {
      * Parse string (JSON) to specific type, no type conversion
      * For type conversion, please use DataTypes.convert
      * @param input Input string
+     * @returns Parsed value
+     */
+    export function parseString<T>(
+        input: string | undefined | null
+    ): T | undefined;
+
+    /**
+     * Parse string (JSON) to specific type, no type conversion
+     * For type conversion, please use DataTypes.convert
+     * @param input Input string
+     * @param defaultValue Default value
+     * @returns Parsed value
+     */
+    export function parseString<T>(
+        input: string | undefined | null,
+        defaultValue: T
+    ): T;
+
+    /**
+     * Parse string (JSON) to specific type, no type conversion
+     * When return type depends on parameter value, uses function overloading, otherwise uses conditional type
+     * For type conversion, please use DataTypes.convert
+     * @param input Input string
      * @param defaultValue Default value
      * @returns Parsed value
      */
-    export function parseString<T, M = T | undefined>(
+    export function parseString<T>(
         input: string | undefined | null,
-        defaultValue?: M
-    ): M extends T ? M : undefined {
+        defaultValue?: T
+    ): T | undefined {
         // Undefined and empty case, return default value
-        if (input == null || input === '') return <any>defaultValue;
+        if (input == null || input === '') return <T>defaultValue;
 
         // String
         if (typeof defaultValue === 'string') return <any>input;
@@ -390,10 +413,10 @@ export namespace Utils {
             const json = JSON.parse(input);
 
             // Return
-            return json;
+            return <T>json;
         } catch {
             if (defaultValue == null) return <any>input;
-            return <any>defaultValue;
+            return <T>defaultValue;
         }
     }
 

package/src/index.ts

@@ -1,4 +1,8 @@
 export * from './types/FormData';
+
+export * from './storage/IStorage';
+export * from './storage/WindowStorage';
+
 export * from './DataTypes';
 export * from './DateUtils';
 export * from './DomUtils';

package/src/storage/IStorage.ts

@@ -0,0 +1,37 @@
+/**
+ * Storage interface
+ */
+export interface IStorage {
+    /**
+     * Get data
+     * @param key Key name
+     */
+    getData<T>(key: string): T | undefined;
+
+    /**
+     * Get data with default value
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    getData<T>(key: string, defaultValue: T): T;
+
+    /**
+     * Get session storage object data
+     * @param key Key name
+     */
+    getObject<T extends {}>(key: string): T | undefined;
+
+    /**
+     * Set data
+     * @param key Key name
+     * @param data  Data, null for removal
+     */
+    setData(key: string, data: unknown): void;
+}
+
+/**
+ * Storage constructor interface
+ */
+export interface IStorageConstructor {
+    new (globalFields: string[]): IStorage;
+}

package/src/storage/WindowStorage.ts

@@ -0,0 +1,81 @@
+import { StorageUtils } from '../StorageUtils';
+import { Utils } from '../Utils';
+import { IStorage } from './IStorage';
+
+/**
+ * Window storage
+ * https://developer.mozilla.org/en-US/docs/Web/API/Storage
+ */
+export class WindowStorage implements IStorage {
+    /**
+     * Constructor
+     * @param globalFields Global fields
+     */
+    constructor(private globalFields: string[]) {
+        if (globalFields.length == 0) return;
+
+        // Copy global fields to session storage where first item does not exist
+        // Duplicate browser tab would copy the session storage
+        const firsItem = sessionStorage.getItem(globalFields[0]);
+        if (firsItem) return;
+
+        globalFields.forEach((field) => {
+            const data = localStorage.getItem(field);
+            if (data != null) {
+                sessionStorage.setItem(field, data);
+            }
+        });
+    }
+
+    /**
+     * Get data
+     * @param key Key name
+     */
+    getData<T>(key: string): T | undefined;
+
+    /**
+     * Get data with default value
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    getData<T>(key: string, defaultValue: T): T;
+
+    /**
+     * Get data
+     * @param key Key name
+     * @param defaultValue Default value
+     */
+    getData<T>(key: string, defaultValue?: T): T | undefined {
+        // Get storage
+        const data = sessionStorage.getItem(key);
+
+        // No default value
+        if (defaultValue == null) return Utils.parseString<T>(data);
+
+        // Return
+        return Utils.parseString<T>(data, defaultValue);
+    }
+
+    /**
+     * Get object data
+     * @param key Key name
+     */
+    getObject<T extends {}>(key: string) {
+        // Get storage
+        const data = sessionStorage.getItem(key);
+        if (data == null) return undefined;
+        return <T>JSON.parse(data);
+    }
+
+    /**
+     * Set data
+     * @param key Key name
+     * @param data  Data, null for removal
+     */
+    setData(key: string, data: unknown) {
+        StorageUtils.setSessionData(key, data);
+        if (this.globalFields.includes(key)) {
+            StorageUtils.setLocalData(key, data);
+        }
+    }
+}