iota-utools 0.1.1 → 0.1.2

package/lib/cjs/index.js

@@ -1,6 +1,8 @@
 'use strict';
 
-var index = require('./storage/index.js');
+var local = require('./storage/local.js');
+var session = require('./storage/session.js');
+var monitorStorage = require('./storage/monitorStorage.js');
 var _typeof = require('./utools/typeof.js');
 var sleep = require('./utools/sleep.js');
 var copyText = require('./utools/copyText.js');
@@ -24,12 +26,16 @@ var flattenObject = require('./object/flattenObject.js');
 var restoreObject = require('./object/restoreObject.js');
 var awitto = require('./async/awitto.js');
 var generateCalendar = require('./date/generateCalendar.js');
-var local = require('./storage/local.js');
-var session = require('./storage/session.js');
 
 
 
-exports.monitorStorage = index.monitorStorage;
+exports.getLocalStorage = local.getLocalStorage;
+exports.removeLocalStorageKey = local.removeLocalStorageKey;
+exports.setLocalStorage = local.setLocalStorage;
+exports.getSessionStorage = session.getSessionStorage;
+exports.removeSessionStorageKey = session.removeSessionStorageKey;
+exports.setSessionStorage = session.setSessionStorage;
+exports.monitorStorage = monitorStorage.monitorStorage;
 Object.defineProperty(exports, 'DataType', {
 	enumerable: true,
 	get: function () { return _typeof.DataType; }
@@ -78,9 +84,3 @@ exports.restoreObject = restoreObject.restoreObject;
 exports.unflattenObject = restoreObject.unflattenObject;
 exports.awitto = awitto.awitto;
 exports.generateCalendar = generateCalendar.generateCalendar;
-exports.getLocalStorage = local.getLocalStorage;
-exports.removeLocalStorageKey = local.removeLocalStorageKey;
-exports.setLocalStorage = local.setLocalStorage;
-exports.getSessionStorage = session.getSessionStorage;
-exports.removeSessionStorageKey = session.removeSessionStorageKey;
-exports.setSessionStorage = session.setSessionStorage;

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

@@ -1,34 +1,3 @@
-/**
- * Storage 变更事件的详细信息
- */
-export interface StorageChangeEvent extends Event {
-    key: string;
-    newValue: string;
-    oldValue: string | null;
-    storageArea: 'local' | 'session';
-}
-/**
- * Storage 监听器配置选项
- */
-export interface StorageMonitorOptions {
-    /** 监听类型：'local' | 'session' | 'both' */
-    type?: 'local' | 'session' | 'both';
-    /** 是否在值相同时也触发事件 */
-    emitUnchanged?: boolean;
-    /** 自定义错误处理函数 */
-    onError?: (error: Error) => void;
-}
-/**
- * 监控浏览器存储变化
- * @description 监听并增强 localStorage 和 sessionStorage 的变更事件
- * @param options - 监听器配置选项
- * @returns 清理函数
- * @example
- * const cleanup = monitorStorage({ type: 'both' });
- * window.addEventListener('local', e => console.log(e));
- * window.addEventListener('session', e => console.log(e));
- * cleanup();
- */
-export declare const monitorStorage: (options?: StorageMonitorOptions) => () => void;
 export * from "./local";
 export * from "./session";
+export * from "./monitorStorage";

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

@@ -0,0 +1,32 @@
+/**
+ * Storage 变更事件的详细信息
+ */
+export interface StorageChangeEvent extends Event {
+    key: string;
+    newValue: string;
+    oldValue: string | null;
+    storageArea: 'local' | 'session';
+}
+/**
+ * Storage 监听器配置选项
+ */
+export interface StorageMonitorOptions {
+    /** 监听类型：'local' | 'session' | 'both' */
+    type?: 'local' | 'session' | 'both';
+    /** 是否在值相同时也触发事件 */
+    emitUnchanged?: boolean;
+    /** 自定义错误处理函数 */
+    onError?: (error: Error) => void;
+}
+/**
+ * 监控浏览器存储变化
+ * @description 监听并增强 localStorage 和 sessionStorage 的变更事件
+ * @param options - 监听器配置选项
+ * @returns 清理函数
+ * @example
+ * const cleanup = monitorStorage({ type: 'both' });
+ * window.addEventListener('local', e => console.log(e));
+ * window.addEventListener('session', e => console.log(e));
+ * cleanup();
+ */
+export declare const monitorStorage: (options?: StorageMonitorOptions) => () => void;

package/lib/cjs/storage/monitorStorage.js

@@ -0,0 +1,79 @@
+'use strict';
+
+/**
+ * 监控浏览器存储变化
+ * @description 监听并增强 localStorage 和 sessionStorage 的变更事件
+ * @param options - 监听器配置选项
+ * @returns 清理函数
+ * @example
+ * const cleanup = monitorStorage({ type: 'both' });
+ * window.addEventListener('local', e => console.log(e));
+ * window.addEventListener('session', e => console.log(e));
+ * cleanup();
+ */
+const monitorStorage = (options = {}) => {
+    const { type = 'both', emitUnchanged = false, onError = console.error } = options;
+    const enhanceStorage = (storage, type) => {
+        const original = {
+            setItem: storage.setItem.bind(storage),
+            removeItem: storage.removeItem.bind(storage),
+            clear: storage.clear.bind(storage)
+        };
+        const createEvent = (key, newValue, oldValue = null) => {
+            const event = new Event(type);
+            event.key = key;
+            event.newValue = newValue;
+            event.oldValue = oldValue;
+            event.storageArea = type;
+            return event;
+        };
+        const dispatchStorageEvent = (event) => {
+            try {
+                window.dispatchEvent(event);
+            }
+            catch (error) {
+                onError(error);
+            }
+        };
+        // 增强 setItem
+        storage.setItem = (key, value) => {
+            const oldValue = storage.getItem(key);
+            if (!emitUnchanged && oldValue === value) {
+                return original.setItem(key, value);
+            }
+            original.setItem(key, value);
+            dispatchStorageEvent(createEvent(key, value, oldValue));
+        };
+        // 增强 removeItem
+        storage.removeItem = (key) => {
+            const oldValue = storage.getItem(key);
+            original.removeItem(key);
+            dispatchStorageEvent(createEvent(key, '', oldValue));
+        };
+        // 增强 clear
+        storage.clear = () => {
+            original.clear();
+            dispatchStorageEvent(createEvent('', ''));
+        };
+        return original;
+    };
+    const enhanced = {
+        local: type === 'local' || type === 'both'
+            ? enhanceStorage(localStorage, 'local')
+            : null,
+        session: type === 'session' || type === 'both'
+            ? enhanceStorage(sessionStorage, 'session')
+            : null
+    };
+    // 返回清理函数
+    return () => {
+        if (enhanced.local) {
+            Object.assign(localStorage, enhanced.local);
+        }
+        if (enhanced.session) {
+            Object.assign(sessionStorage, enhanced.session);
+        }
+    };
+};
+
+exports.monitorStorage = monitorStorage;

package/lib/es/index.js

@@ -1,4 +1,6 @@
-export { monitorStorage } from './storage/index.js';
+export { getLocalStorage, removeLocalStorageKey, setLocalStorage } from './storage/local.js';
+export { getSessionStorage, removeSessionStorageKey, setSessionStorage } from './storage/session.js';
+export { monitorStorage } from './storage/monitorStorage.js';
 export { DataType, getTypeInfo, getTypeof, isArray, isBigInt, isBoolean, isDate, isFunction, isMap, isNull, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isUndefined } from './utools/typeof.js';
 export { sleep } from './utools/sleep.js';
 export { copyText } from './utools/copyText.js';
@@ -22,5 +24,3 @@ export { flattenObject } from './object/flattenObject.js';
 export { restoreObject, unflattenObject } from './object/restoreObject.js';
 export { awitto } from './async/awitto.js';
 export { generateCalendar } from './date/generateCalendar.js';
-export { getLocalStorage, removeLocalStorageKey, setLocalStorage } from './storage/local.js';
-export { getSessionStorage, removeSessionStorageKey, setSessionStorage } from './storage/session.js';

package/lib/es/storage/index.d.ts

@@ -1,34 +1,3 @@
-/**
- * Storage 变更事件的详细信息
- */
-export interface StorageChangeEvent extends Event {
-    key: string;
-    newValue: string;
-    oldValue: string | null;
-    storageArea: 'local' | 'session';
-}
-/**
- * Storage 监听器配置选项
- */
-export interface StorageMonitorOptions {
-    /** 监听类型：'local' | 'session' | 'both' */
-    type?: 'local' | 'session' | 'both';
-    /** 是否在值相同时也触发事件 */
-    emitUnchanged?: boolean;
-    /** 自定义错误处理函数 */
-    onError?: (error: Error) => void;
-}
-/**
- * 监控浏览器存储变化
- * @description 监听并增强 localStorage 和 sessionStorage 的变更事件
- * @param options - 监听器配置选项
- * @returns 清理函数
- * @example
- * const cleanup = monitorStorage({ type: 'both' });
- * window.addEventListener('local', e => console.log(e));
- * window.addEventListener('session', e => console.log(e));
- * cleanup();
- */
-export declare const monitorStorage: (options?: StorageMonitorOptions) => () => void;
 export * from "./local";
 export * from "./session";
+export * from "./monitorStorage";

package/lib/es/storage/monitorStorage.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Storage 变更事件的详细信息
+ */
+export interface StorageChangeEvent extends Event {
+    key: string;
+    newValue: string;
+    oldValue: string | null;
+    storageArea: 'local' | 'session';
+}
+/**
+ * Storage 监听器配置选项
+ */
+export interface StorageMonitorOptions {
+    /** 监听类型：'local' | 'session' | 'both' */
+    type?: 'local' | 'session' | 'both';
+    /** 是否在值相同时也触发事件 */
+    emitUnchanged?: boolean;
+    /** 自定义错误处理函数 */
+    onError?: (error: Error) => void;
+}
+/**
+ * 监控浏览器存储变化
+ * @description 监听并增强 localStorage 和 sessionStorage 的变更事件
+ * @param options - 监听器配置选项
+ * @returns 清理函数
+ * @example
+ * const cleanup = monitorStorage({ type: 'both' });
+ * window.addEventListener('local', e => console.log(e));
+ * window.addEventListener('session', e => console.log(e));
+ * cleanup();
+ */
+export declare const monitorStorage: (options?: StorageMonitorOptions) => () => void;

package/lib/es/storage/monitorStorage.js

@@ -0,0 +1,77 @@
+/**
+ * 监控浏览器存储变化
+ * @description 监听并增强 localStorage 和 sessionStorage 的变更事件
+ * @param options - 监听器配置选项
+ * @returns 清理函数
+ * @example
+ * const cleanup = monitorStorage({ type: 'both' });
+ * window.addEventListener('local', e => console.log(e));
+ * window.addEventListener('session', e => console.log(e));
+ * cleanup();
+ */
+const monitorStorage = (options = {}) => {
+    const { type = 'both', emitUnchanged = false, onError = console.error } = options;
+    const enhanceStorage = (storage, type) => {
+        const original = {
+            setItem: storage.setItem.bind(storage),
+            removeItem: storage.removeItem.bind(storage),
+            clear: storage.clear.bind(storage)
+        };
+        const createEvent = (key, newValue, oldValue = null) => {
+            const event = new Event(type);
+            event.key = key;
+            event.newValue = newValue;
+            event.oldValue = oldValue;
+            event.storageArea = type;
+            return event;
+        };
+        const dispatchStorageEvent = (event) => {
+            try {
+                window.dispatchEvent(event);
+            }
+            catch (error) {
+                onError(error);
+            }
+        };
+        // 增强 setItem
+        storage.setItem = (key, value) => {
+            const oldValue = storage.getItem(key);
+            if (!emitUnchanged && oldValue === value) {
+                return original.setItem(key, value);
+            }
+            original.setItem(key, value);
+            dispatchStorageEvent(createEvent(key, value, oldValue));
+        };
+        // 增强 removeItem
+        storage.removeItem = (key) => {
+            const oldValue = storage.getItem(key);
+            original.removeItem(key);
+            dispatchStorageEvent(createEvent(key, '', oldValue));
+        };
+        // 增强 clear
+        storage.clear = () => {
+            original.clear();
+            dispatchStorageEvent(createEvent('', ''));
+        };
+        return original;
+    };
+    const enhanced = {
+        local: type === 'local' || type === 'both'
+            ? enhanceStorage(localStorage, 'local')
+            : null,
+        session: type === 'session' || type === 'both'
+            ? enhanceStorage(sessionStorage, 'session')
+            : null
+    };
+    // 返回清理函数
+    return () => {
+        if (enhanced.local) {
+            Object.assign(localStorage, enhanced.local);
+        }
+        if (enhanced.session) {
+            Object.assign(sessionStorage, enhanced.session);
+        }
+    };
+};
+
+export { monitorStorage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iota-utools",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "",
   "type": "module",
   "main": "lib/es/index.js",