@lytjs/common-storage 6.0.0

package/dist/index.cjs

@@ -0,0 +1,133 @@
+'use strict';
+
+// src/index.ts
+function parseJSON(value, fallback) {
+  try {
+    return JSON.parse(value);
+  } catch {
+    return fallback;
+  }
+}
+function isStorageAvailable(storage) {
+  if (!storage) {
+    try {
+      storage = window.localStorage;
+    } catch {
+      return false;
+    }
+  }
+  try {
+    const testKey = "__lytjs_storage_test__";
+    storage.setItem(testKey, "1");
+    storage.removeItem(testKey);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function createStorage(options) {
+  const {
+    key,
+    storage,
+    serializer = JSON.stringify,
+    deserializer = (v) => parseJSON(v, options.default),
+    default: defaultValue
+  } = options;
+  const listeners = /* @__PURE__ */ new Set();
+  const getStorage = () => {
+    if (storage) return storage;
+    if (typeof window !== "undefined") {
+      return window.localStorage;
+    }
+    return void 0;
+  };
+  const notifyListeners = (value) => {
+    for (const listener of listeners) {
+      try {
+        listener(value);
+      } catch {
+      }
+    }
+  };
+  const handleStorageEvent = (event) => {
+    if (event.key === key) {
+      const newValue = event.newValue ? deserializer(event.newValue) : null;
+      notifyListeners(newValue);
+    }
+  };
+  const adapter = {
+    get() {
+      const s = getStorage();
+      if (!s) return defaultValue;
+      try {
+        const raw = s.getItem(key);
+        if (raw === null) return defaultValue;
+        return deserializer(raw);
+      } catch {
+        return defaultValue;
+      }
+    },
+    set(value) {
+      const s = getStorage();
+      if (!s) return;
+      try {
+        s.setItem(key, serializer(value));
+        notifyListeners(value);
+      } catch {
+        if (__DEV__) {
+          console.warn(`[storage] Failed to set item "${key}"`);
+        }
+      }
+    },
+    remove() {
+      const s = getStorage();
+      if (!s) return;
+      try {
+        s.removeItem(key);
+        notifyListeners(null);
+      } catch {
+      }
+    },
+    has() {
+      const s = getStorage();
+      if (!s) return false;
+      try {
+        return s.getItem(key) !== null;
+      } catch {
+        return false;
+      }
+    },
+    onChange(callback) {
+      listeners.add(callback);
+      if (typeof window !== "undefined" && listeners.size === 1) {
+        window.addEventListener("storage", handleStorageEvent);
+      }
+      return () => {
+        listeners.delete(callback);
+        if (typeof window !== "undefined" && listeners.size === 0) {
+          window.removeEventListener("storage", handleStorageEvent);
+        }
+      };
+    }
+  };
+  return adapter;
+}
+function createSessionStorage(options) {
+  const getSessionStorage = () => {
+    if (typeof window !== "undefined") {
+      return window.sessionStorage;
+    }
+    return void 0;
+  };
+  return createStorage({
+    ...options,
+    storage: getSessionStorage()
+  });
+}
+
+exports.createSessionStorage = createSessionStorage;
+exports.createStorage = createStorage;
+exports.isStorageAvailable = isStorageAvailable;
+exports.parseJSON = parseJSON;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * @lytjs/common-storage\r\n * 轻量级类型安全的存储工具\r\n */\r\n\r\ndeclare const __DEV__: boolean;\r\n\r\nexport interface StorageOptions<T> {\r\n  key: string;\r\n  storage?: Storage;\r\n  serializer?: (value: T) => string;\r\n  deserializer?: (value: string) => T;\r\n  default?: T;\r\n}\r\n\r\nexport interface StorageAdapter<T> {\r\n  get(): T;\r\n  set(value: T): void;\r\n  remove(): void;\r\n  has(): boolean;\r\n  onChange(callback: (value: T | null) => void): () => void;\r\n}\r\n\r\n/**\r\n * 安全的 JSON 解析，解析失败返回 fallback\r\n */\r\nexport function parseJSON<T>(value: string, fallback: T): T {\r\n  try {\r\n    return JSON.parse(value) as T;\r\n  } catch {\r\n    return fallback;\r\n  }\r\n}\r\n\r\n/**\r\n * 检查存储是否可用（处理隐私模式等场景）\r\n */\r\nexport function isStorageAvailable(storage?: Storage): boolean {\r\n  if (!storage) {\r\n    try {\r\n      storage = window.localStorage;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  try {\r\n    const testKey = '__lytjs_storage_test__';\r\n    storage.setItem(testKey, '1');\r\n    storage.removeItem(testKey);\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * 创建类型安全的存储适配器\r\n *\r\n * @param options - 存储配置\r\n * @returns StorageAdapter 实例\r\n */\r\nexport function createStorage<T>(options: StorageOptions<T>): StorageAdapter<T> {\r\n  const {\r\n    key,\r\n    storage,\r\n    serializer = JSON.stringify,\r\n    deserializer = (v: string) => parseJSON<T>(v, options.default as T),\r\n    default: defaultValue,\r\n  } = options;\r\n\r\n  const listeners = new Set<(value: T | null) => void>();\r\n\r\n  const getStorage = (): Storage | undefined => {\r\n    if (storage) return storage;\r\n    if (typeof window !== 'undefined') {\r\n      return window.localStorage;\r\n    }\r\n    return undefined;\r\n  };\r\n\r\n  const notifyListeners = (value: T | null) => {\r\n    for (const listener of listeners) {\r\n      try {\r\n        listener(value);\r\n      } catch {\r\n        // Ignore listener errors\r\n      }\r\n    }\r\n  };\r\n\r\n  const handleStorageEvent = (event: StorageEvent) => {\r\n    if (event.key === key) {\r\n      const newValue = event.newValue\r\n        ? deserializer(event.newValue)\r\n        : null;\r\n      notifyListeners(newValue);\r\n    }\r\n  };\r\n\r\n  const adapter: StorageAdapter<T> = {\r\n    get(): T {\r\n      const s = getStorage();\r\n      if (!s) return defaultValue as T;\r\n      try {\r\n        const raw = s.getItem(key);\r\n        if (raw === null) return defaultValue as T;\r\n        return deserializer(raw);\r\n      } catch {\r\n        return defaultValue as T;\r\n      }\r\n    },\r\n\r\n    set(value: T): void {\r\n      const s = getStorage();\r\n      if (!s) return;\r\n      try {\r\n        s.setItem(key, serializer(value));\r\n        notifyListeners(value);\r\n      } catch {\r\n        if (__DEV__) {\r\n          console.warn(`[storage] Failed to set item \"${key}\"`);\r\n        }\r\n      }\r\n    },\r\n\r\n    remove(): void {\r\n      const s = getStorage();\r\n      if (!s) return;\r\n      try {\r\n        s.removeItem(key);\r\n        notifyListeners(null);\r\n      } catch {\r\n        // Ignore\r\n      }\r\n    },\r\n\r\n    has(): boolean {\r\n      const s = getStorage();\r\n      if (!s) return false;\r\n      try {\r\n        return s.getItem(key) !== null;\r\n      } catch {\r\n        return false;\r\n      }\r\n    },\r\n\r\n    onChange(callback: (value: T | null) => void): () => void {\r\n      listeners.add(callback);\r\n      if (typeof window !== 'undefined' && listeners.size === 1) {\r\n        window.addEventListener('storage', handleStorageEvent);\r\n      }\r\n      return () => {\r\n        listeners.delete(callback);\r\n        if (typeof window !== 'undefined' && listeners.size === 0) {\r\n          window.removeEventListener('storage', handleStorageEvent);\r\n        }\r\n      };\r\n    },\r\n  };\r\n\r\n  return adapter;\r\n}\r\n\r\n/**\r\n * 使用 sessionStorage 的快捷方式\r\n *\r\n * @param options - 存储配置（不含 storage 字段）\r\n * @returns StorageAdapter 实例\r\n */\r\nexport function createSessionStorage<T>(\r\n  options: Omit<StorageOptions<T>, 'storage'>,\r\n): StorageAdapter<T> {\r\n  const getSessionStorage = (): Storage | undefined => {\r\n    if (typeof window !== 'undefined') {\r\n      return window.sessionStorage;\r\n    }\r\n    return undefined;\r\n  };\r\n\r\n  return createStorage<T>({\r\n    ...options,\r\n    storage: getSessionStorage(),\r\n  });\r\n}\r\n"]}

package/dist/index.d.mts

@@ -0,0 +1,42 @@
+/**
+ * @lytjs/common-storage
+ * 轻量级类型安全的存储工具
+ */
+interface StorageOptions<T> {
+    key: string;
+    storage?: Storage;
+    serializer?: (value: T) => string;
+    deserializer?: (value: string) => T;
+    default?: T;
+}
+interface StorageAdapter<T> {
+    get(): T;
+    set(value: T): void;
+    remove(): void;
+    has(): boolean;
+    onChange(callback: (value: T | null) => void): () => void;
+}
+/**
+ * 安全的 JSON 解析，解析失败返回 fallback
+ */
+declare function parseJSON<T>(value: string, fallback: T): T;
+/**
+ * 检查存储是否可用（处理隐私模式等场景）
+ */
+declare function isStorageAvailable(storage?: Storage): boolean;
+/**
+ * 创建类型安全的存储适配器
+ *
+ * @param options - 存储配置
+ * @returns StorageAdapter 实例
+ */
+declare function createStorage<T>(options: StorageOptions<T>): StorageAdapter<T>;
+/**
+ * 使用 sessionStorage 的快捷方式
+ *
+ * @param options - 存储配置（不含 storage 字段）
+ * @returns StorageAdapter 实例
+ */
+declare function createSessionStorage<T>(options: Omit<StorageOptions<T>, 'storage'>): StorageAdapter<T>;
+
+export { type StorageAdapter, type StorageOptions, createSessionStorage, createStorage, isStorageAvailable, parseJSON };

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @lytjs/common-storage
+ * 轻量级类型安全的存储工具
+ */
+interface StorageOptions<T> {
+    key: string;
+    storage?: Storage;
+    serializer?: (value: T) => string;
+    deserializer?: (value: string) => T;
+    default?: T;
+}
+interface StorageAdapter<T> {
+    get(): T;
+    set(value: T): void;
+    remove(): void;
+    has(): boolean;
+    onChange(callback: (value: T | null) => void): () => void;
+}
+/**
+ * 安全的 JSON 解析，解析失败返回 fallback
+ */
+declare function parseJSON<T>(value: string, fallback: T): T;
+/**
+ * 检查存储是否可用（处理隐私模式等场景）
+ */
+declare function isStorageAvailable(storage?: Storage): boolean;
+/**
+ * 创建类型安全的存储适配器
+ *
+ * @param options - 存储配置
+ * @returns StorageAdapter 实例
+ */
+declare function createStorage<T>(options: StorageOptions<T>): StorageAdapter<T>;
+/**
+ * 使用 sessionStorage 的快捷方式
+ *
+ * @param options - 存储配置（不含 storage 字段）
+ * @returns StorageAdapter 实例
+ */
+declare function createSessionStorage<T>(options: Omit<StorageOptions<T>, 'storage'>): StorageAdapter<T>;
+
+export { type StorageAdapter, type StorageOptions, createSessionStorage, createStorage, isStorageAvailable, parseJSON };

package/dist/index.mjs

@@ -0,0 +1,128 @@
+// src/index.ts
+function parseJSON(value, fallback) {
+  try {
+    return JSON.parse(value);
+  } catch {
+    return fallback;
+  }
+}
+function isStorageAvailable(storage) {
+  if (!storage) {
+    try {
+      storage = window.localStorage;
+    } catch {
+      return false;
+    }
+  }
+  try {
+    const testKey = "__lytjs_storage_test__";
+    storage.setItem(testKey, "1");
+    storage.removeItem(testKey);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function createStorage(options) {
+  const {
+    key,
+    storage,
+    serializer = JSON.stringify,
+    deserializer = (v) => parseJSON(v, options.default),
+    default: defaultValue
+  } = options;
+  const listeners = /* @__PURE__ */ new Set();
+  const getStorage = () => {
+    if (storage) return storage;
+    if (typeof window !== "undefined") {
+      return window.localStorage;
+    }
+    return void 0;
+  };
+  const notifyListeners = (value) => {
+    for (const listener of listeners) {
+      try {
+        listener(value);
+      } catch {
+      }
+    }
+  };
+  const handleStorageEvent = (event) => {
+    if (event.key === key) {
+      const newValue = event.newValue ? deserializer(event.newValue) : null;
+      notifyListeners(newValue);
+    }
+  };
+  const adapter = {
+    get() {
+      const s = getStorage();
+      if (!s) return defaultValue;
+      try {
+        const raw = s.getItem(key);
+        if (raw === null) return defaultValue;
+        return deserializer(raw);
+      } catch {
+        return defaultValue;
+      }
+    },
+    set(value) {
+      const s = getStorage();
+      if (!s) return;
+      try {
+        s.setItem(key, serializer(value));
+        notifyListeners(value);
+      } catch {
+        if (__DEV__) {
+          console.warn(`[storage] Failed to set item "${key}"`);
+        }
+      }
+    },
+    remove() {
+      const s = getStorage();
+      if (!s) return;
+      try {
+        s.removeItem(key);
+        notifyListeners(null);
+      } catch {
+      }
+    },
+    has() {
+      const s = getStorage();
+      if (!s) return false;
+      try {
+        return s.getItem(key) !== null;
+      } catch {
+        return false;
+      }
+    },
+    onChange(callback) {
+      listeners.add(callback);
+      if (typeof window !== "undefined" && listeners.size === 1) {
+        window.addEventListener("storage", handleStorageEvent);
+      }
+      return () => {
+        listeners.delete(callback);
+        if (typeof window !== "undefined" && listeners.size === 0) {
+          window.removeEventListener("storage", handleStorageEvent);
+        }
+      };
+    }
+  };
+  return adapter;
+}
+function createSessionStorage(options) {
+  const getSessionStorage = () => {
+    if (typeof window !== "undefined") {
+      return window.sessionStorage;
+    }
+    return void 0;
+  };
+  return createStorage({
+    ...options,
+    storage: getSessionStorage()
+  });
+}
+
+export { createSessionStorage, createStorage, isStorageAvailable, parseJSON };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AA0BO,SAAS,SAAA,CAAa,OAAe,QAAA,EAAgB;AAC1D,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,CAAK,MAAM,KAAK,CAAA;AAAA,EACzB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAKO,SAAS,mBAAmB,OAAA,EAA4B;AAC7D,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,IAAI;AACF,MAAA,OAAA,GAAU,MAAA,CAAO,YAAA;AAAA,IACnB,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,wBAAA;AAChB,IAAA,OAAA,CAAQ,OAAA,CAAQ,SAAS,GAAG,CAAA;AAC5B,IAAA,OAAA,CAAQ,WAAW,OAAO,CAAA;AAC1B,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAQO,SAAS,cAAiB,OAAA,EAA+C;AAC9E,EAAA,MAAM;AAAA,IACJ,GAAA;AAAA,IACA,OAAA;AAAA,IACA,aAAa,IAAA,CAAK,SAAA;AAAA,IAClB,eAAe,CAAC,CAAA,KAAc,SAAA,CAAa,CAAA,EAAG,QAAQ,OAAY,CAAA;AAAA,IAClE,OAAA,EAAS;AAAA,GACX,GAAI,OAAA;AAEJ,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAA+B;AAErD,EAAA,MAAM,aAAa,MAA2B;AAC5C,IAAA,IAAI,SAAS,OAAO,OAAA;AACpB,IAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,MAAA,OAAO,MAAA,CAAO,YAAA;AAAA,IAChB;AACA,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AAEA,EAAA,MAAM,eAAA,GAAkB,CAAC,KAAA,KAAoB;AAC3C,IAAA,KAAA,MAAW,YAAY,SAAA,EAAW;AAChC,MAAA,IAAI;AACF,QAAA,QAAA,CAAS,KAAK,CAAA;AAAA,MAChB,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,kBAAA,GAAqB,CAAC,KAAA,KAAwB;AAClD,IAAA,IAAI,KAAA,CAAM,QAAQ,GAAA,EAAK;AACrB,MAAA,MAAM,WAAW,KAAA,CAAM,QAAA,GACnB,YAAA,CAAa,KAAA,CAAM,QAAQ,CAAA,GAC3B,IAAA;AACJ,MAAA,eAAA,CAAgB,QAAQ,CAAA;AAAA,IAC1B;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,OAAA,GAA6B;AAAA,IACjC,GAAA,GAAS;AACP,MAAA,MAAM,IAAI,UAAA,EAAW;AACrB,MAAA,IAAI,CAAC,GAAG,OAAO,YAAA;AACf,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,GAAM,CAAA,CAAE,OAAA,CAAQ,GAAG,CAAA;AACzB,QAAA,IAAI,GAAA,KAAQ,MAAM,OAAO,YAAA;AACzB,QAAA,OAAO,aAAa,GAAG,CAAA;AAAA,MACzB,CAAA,CAAA,MAAQ;AACN,QAAA,OAAO,YAAA;AAAA,MACT;AAAA,IACF,CAAA;AAAA,IAEA,IAAI,KAAA,EAAgB;AAClB,MAAA,MAAM,IAAI,UAAA,EAAW;AACrB,MAAA,IAAI,CAAC,CAAA,EAAG;AACR,MAAA,IAAI;AACF,QAAA,CAAA,CAAE,OAAA,CAAQ,GAAA,EAAK,UAAA,CAAW,KAAK,CAAC,CAAA;AAChC,QAAA,eAAA,CAAgB,KAAK,CAAA;AAAA,MACvB,CAAA,CAAA,MAAQ;AACN,QAAA,IAAI,OAAA,EAAS;AACX,UAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAA,CAAG,CAAA;AAAA,QACtD;AAAA,MACF;AAAA,IACF,CAAA;AAAA,IAEA,MAAA,GAAe;AACb,MAAA,MAAM,IAAI,UAAA,EAAW;AACrB,MAAA,IAAI,CAAC,CAAA,EAAG;AACR,MAAA,IAAI;AACF,QAAA,CAAA,CAAE,WAAW,GAAG,CAAA;AAChB,QAAA,eAAA,CAAgB,IAAI,CAAA;AAAA,MACtB,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF,CAAA;AAAA,IAEA,GAAA,GAAe;AACb,MAAA,MAAM,IAAI,UAAA,EAAW;AACrB,MAAA,IAAI,CAAC,GAAG,OAAO,KAAA;AACf,MAAA,IAAI;AACF,QAAA,OAAO,CAAA,CAAE,OAAA,CAAQ,GAAG,CAAA,KAAM,IAAA;AAAA,MAC5B,CAAA,CAAA,MAAQ;AACN,QAAA,OAAO,KAAA;AAAA,MACT;AAAA,IACF,CAAA;AAAA,IAEA,SAAS,QAAA,EAAiD;AACxD,MAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AACtB,MAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,SAAA,CAAU,SAAS,CAAA,EAAG;AACzD,QAAA,MAAA,CAAO,gBAAA,CAAiB,WAAW,kBAAkB,CAAA;AAAA,MACvD;AACA,MAAA,OAAO,MAAM;AACX,QAAA,SAAA,CAAU,OAAO,QAAQ,CAAA;AACzB,QAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,SAAA,CAAU,SAAS,CAAA,EAAG;AACzD,UAAA,MAAA,CAAO,mBAAA,CAAoB,WAAW,kBAAkB,CAAA;AAAA,QAC1D;AAAA,MACF,CAAA;AAAA,IACF;AAAA,GACF;AAEA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,qBACd,OAAA,EACmB;AACnB,EAAA,MAAM,oBAAoB,MAA2B;AACnD,IAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,MAAA,OAAO,MAAA,CAAO,cAAA;AAAA,IAChB;AACA,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO,aAAA,CAAiB;AAAA,IACtB,GAAG,OAAA;AAAA,IACH,SAAS,iBAAA;AAAkB,GAC5B,CAAA;AACH","file":"index.mjs","sourcesContent":["/**\r\n * @lytjs/common-storage\r\n * 轻量级类型安全的存储工具\r\n */\r\n\r\ndeclare const __DEV__: boolean;\r\n\r\nexport interface StorageOptions<T> {\r\n  key: string;\r\n  storage?: Storage;\r\n  serializer?: (value: T) => string;\r\n  deserializer?: (value: string) => T;\r\n  default?: T;\r\n}\r\n\r\nexport interface StorageAdapter<T> {\r\n  get(): T;\r\n  set(value: T): void;\r\n  remove(): void;\r\n  has(): boolean;\r\n  onChange(callback: (value: T | null) => void): () => void;\r\n}\r\n\r\n/**\r\n * 安全的 JSON 解析，解析失败返回 fallback\r\n */\r\nexport function parseJSON<T>(value: string, fallback: T): T {\r\n  try {\r\n    return JSON.parse(value) as T;\r\n  } catch {\r\n    return fallback;\r\n  }\r\n}\r\n\r\n/**\r\n * 检查存储是否可用（处理隐私模式等场景）\r\n */\r\nexport function isStorageAvailable(storage?: Storage): boolean {\r\n  if (!storage) {\r\n    try {\r\n      storage = window.localStorage;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  try {\r\n    const testKey = '__lytjs_storage_test__';\r\n    storage.setItem(testKey, '1');\r\n    storage.removeItem(testKey);\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * 创建类型安全的存储适配器\r\n *\r\n * @param options - 存储配置\r\n * @returns StorageAdapter 实例\r\n */\r\nexport function createStorage<T>(options: StorageOptions<T>): StorageAdapter<T> {\r\n  const {\r\n    key,\r\n    storage,\r\n    serializer = JSON.stringify,\r\n    deserializer = (v: string) => parseJSON<T>(v, options.default as T),\r\n    default: defaultValue,\r\n  } = options;\r\n\r\n  const listeners = new Set<(value: T | null) => void>();\r\n\r\n  const getStorage = (): Storage | undefined => {\r\n    if (storage) return storage;\r\n    if (typeof window !== 'undefined') {\r\n      return window.localStorage;\r\n    }\r\n    return undefined;\r\n  };\r\n\r\n  const notifyListeners = (value: T | null) => {\r\n    for (const listener of listeners) {\r\n      try {\r\n        listener(value);\r\n      } catch {\r\n        // Ignore listener errors\r\n      }\r\n    }\r\n  };\r\n\r\n  const handleStorageEvent = (event: StorageEvent) => {\r\n    if (event.key === key) {\r\n      const newValue = event.newValue\r\n        ? deserializer(event.newValue)\r\n        : null;\r\n      notifyListeners(newValue);\r\n    }\r\n  };\r\n\r\n  const adapter: StorageAdapter<T> = {\r\n    get(): T {\r\n      const s = getStorage();\r\n      if (!s) return defaultValue as T;\r\n      try {\r\n        const raw = s.getItem(key);\r\n        if (raw === null) return defaultValue as T;\r\n        return deserializer(raw);\r\n      } catch {\r\n        return defaultValue as T;\r\n      }\r\n    },\r\n\r\n    set(value: T): void {\r\n      const s = getStorage();\r\n      if (!s) return;\r\n      try {\r\n        s.setItem(key, serializer(value));\r\n        notifyListeners(value);\r\n      } catch {\r\n        if (__DEV__) {\r\n          console.warn(`[storage] Failed to set item \"${key}\"`);\r\n        }\r\n      }\r\n    },\r\n\r\n    remove(): void {\r\n      const s = getStorage();\r\n      if (!s) return;\r\n      try {\r\n        s.removeItem(key);\r\n        notifyListeners(null);\r\n      } catch {\r\n        // Ignore\r\n      }\r\n    },\r\n\r\n    has(): boolean {\r\n      const s = getStorage();\r\n      if (!s) return false;\r\n      try {\r\n        return s.getItem(key) !== null;\r\n      } catch {\r\n        return false;\r\n      }\r\n    },\r\n\r\n    onChange(callback: (value: T | null) => void): () => void {\r\n      listeners.add(callback);\r\n      if (typeof window !== 'undefined' && listeners.size === 1) {\r\n        window.addEventListener('storage', handleStorageEvent);\r\n      }\r\n      return () => {\r\n        listeners.delete(callback);\r\n        if (typeof window !== 'undefined' && listeners.size === 0) {\r\n          window.removeEventListener('storage', handleStorageEvent);\r\n        }\r\n      };\r\n    },\r\n  };\r\n\r\n  return adapter;\r\n}\r\n\r\n/**\r\n * 使用 sessionStorage 的快捷方式\r\n *\r\n * @param options - 存储配置（不含 storage 字段）\r\n * @returns StorageAdapter 实例\r\n */\r\nexport function createSessionStorage<T>(\r\n  options: Omit<StorageOptions<T>, 'storage'>,\r\n): StorageAdapter<T> {\r\n  const getSessionStorage = (): Storage | undefined => {\r\n    if (typeof window !== 'undefined') {\r\n      return window.sessionStorage;\r\n    }\r\n    return undefined;\r\n  };\r\n\r\n  return createStorage<T>({\r\n    ...options,\r\n    storage: getSessionStorage(),\r\n  });\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@lytjs/common-storage",
+  "version": "6.0.0",
+  "description": "Lightweight type-safe storage utilities for LytJS",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint \"src/**/*.ts\"",
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "devDependencies": {
+    "jsdom": "^26.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.7"
+  }
+}

package/src/index.ts

@@ -0,0 +1,185 @@
+/**
+ * @lytjs/common-storage
+ * 轻量级类型安全的存储工具
+ */
+
+declare const __DEV__: boolean;
+
+export interface StorageOptions<T> {
+  key: string;
+  storage?: Storage;
+  serializer?: (value: T) => string;
+  deserializer?: (value: string) => T;
+  default?: T;
+}
+
+export interface StorageAdapter<T> {
+  get(): T;
+  set(value: T): void;
+  remove(): void;
+  has(): boolean;
+  onChange(callback: (value: T | null) => void): () => void;
+}
+
+/**
+ * 安全的 JSON 解析，解析失败返回 fallback
+ */
+export function parseJSON<T>(value: string, fallback: T): T {
+  try {
+    return JSON.parse(value) as T;
+  } catch {
+    return fallback;
+  }
+}
+
+/**
+ * 检查存储是否可用（处理隐私模式等场景）
+ */
+export function isStorageAvailable(storage?: Storage): boolean {
+  if (!storage) {
+    try {
+      storage = window.localStorage;
+    } catch {
+      return false;
+    }
+  }
+
+  try {
+    const testKey = '__lytjs_storage_test__';
+    storage.setItem(testKey, '1');
+    storage.removeItem(testKey);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 创建类型安全的存储适配器
+ *
+ * @param options - 存储配置
+ * @returns StorageAdapter 实例
+ */
+export function createStorage<T>(options: StorageOptions<T>): StorageAdapter<T> {
+  const {
+    key,
+    storage,
+    serializer = JSON.stringify,
+    deserializer = (v: string) => parseJSON<T>(v, options.default as T),
+    default: defaultValue,
+  } = options;
+
+  const listeners = new Set<(value: T | null) => void>();
+
+  const getStorage = (): Storage | undefined => {
+    if (storage) return storage;
+    if (typeof window !== 'undefined') {
+      return window.localStorage;
+    }
+    return undefined;
+  };
+
+  const notifyListeners = (value: T | null) => {
+    for (const listener of listeners) {
+      try {
+        listener(value);
+      } catch {
+        // Ignore listener errors
+      }
+    }
+  };
+
+  const handleStorageEvent = (event: StorageEvent) => {
+    if (event.key === key) {
+      const newValue = event.newValue
+        ? deserializer(event.newValue)
+        : null;
+      notifyListeners(newValue);
+    }
+  };
+
+  const adapter: StorageAdapter<T> = {
+    get(): T {
+      const s = getStorage();
+      if (!s) return defaultValue as T;
+      try {
+        const raw = s.getItem(key);
+        if (raw === null) return defaultValue as T;
+        return deserializer(raw);
+      } catch {
+        return defaultValue as T;
+      }
+    },
+
+    set(value: T): void {
+      const s = getStorage();
+      if (!s) return;
+      try {
+        s.setItem(key, serializer(value));
+        notifyListeners(value);
+      } catch {
+        if (__DEV__) {
+          console.warn(`[storage] Failed to set item "${key}"`);
+        }
+      }
+    },
+
+    remove(): void {
+      const s = getStorage();
+      if (!s) return;
+      try {
+        s.removeItem(key);
+        notifyListeners(null);
+      } catch {
+        // Ignore
+      }
+    },
+
+    has(): boolean {
+      const s = getStorage();
+      if (!s) return false;
+      try {
+        return s.getItem(key) !== null;
+      } catch {
+        return false;
+      }
+    },
+
+    onChange(callback: (value: T | null) => void): () => void {
+      listeners.add(callback);
+      if (typeof window !== 'undefined' && listeners.size === 1) {
+        window.addEventListener('storage', handleStorageEvent);
+      }
+      return () => {
+        listeners.delete(callback);
+        if (typeof window !== 'undefined' && listeners.size === 0) {
+          window.removeEventListener('storage', handleStorageEvent);
+        }
+      };
+    },
+  };
+
+  return adapter;
+}
+
+/**
+ * 使用 sessionStorage 的快捷方式
+ *
+ * @param options - 存储配置（不含 storage 字段）
+ * @returns StorageAdapter 实例
+ */
+export function createSessionStorage<T>(
+  options: Omit<StorageOptions<T>, 'storage'>,
+): StorageAdapter<T> {
+  const getSessionStorage = (): Storage | undefined => {
+    if (typeof window !== 'undefined') {
+      return window.sessionStorage;
+    }
+    return undefined;
+  };
+
+  return createStorage<T>({
+    ...options,
+    storage: getSessionStorage(),
+  });
+}