@alwatr/local-storage 6.3.4 → 7.0.1

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [7.0.1](https://github.com/Alwatr/nanolib/compare/@alwatr/local-storage@7.0.0...@alwatr/local-storage@7.0.1) (2025-11-04)
+
+**Note:** Version bump only for package @alwatr/local-storage
+
+## [7.0.0](https://github.com/Alwatr/nanolib/compare/@alwatr/local-storage@6.3.4...@alwatr/local-storage@7.0.0) (2025-10-06)
+
+### ⚠ BREAKING CHANGES
+
+* api changed and defaultValue removed
+
+### ✨ Features
+
+* implement static method to check existence of versioned item in localStorage ([c622595](https://github.com/Alwatr/nanolib/commit/c622595bcd793746133733b22c7704463d50314d))
+
+### 🔨 Code Refactoring
+
+* enhance documentation for LocalStorageProviderConfig interface ([11407cd](https://github.com/Alwatr/nanolib/commit/11407cd80ee9def06bcb21c6bb426e92caa7d702))
+* improve documentation for LocalStorageProvider's static methods ([145ac5c](https://github.com/Alwatr/nanolib/commit/145ac5c0d947c9d3f1e91a25e5ca749e0e56d85b))
+* simplify LocalStorageProvider configuration and remove unused types ([b839299](https://github.com/Alwatr/nanolib/commit/b839299d3950f1662773fd8f3a0e6b2189c3d140))
+
+### 🔗 Dependencies update
+
+* bump the npm-dependencies group with 4 updates ([9825815](https://github.com/Alwatr/nanolib/commit/982581552bbb4b97dca52af5e93a80937f0c3109))
+
 ## [6.3.4](https://github.com/Alwatr/nanolib/compare/@alwatr/local-storage@6.3.3...@alwatr/local-storage@6.3.4) (2025-09-27)
 
 ### 🧹 Miscellaneous Chores

package/README.md

@@ -14,13 +14,13 @@ It's designed to handle data structure migrations automatically, preventing issu
 
 This library is built upon a few simple but powerful concepts:
 
-1. **Provider Pattern**: Instead of using static functions, you create an _instance_ of a `LocalStorageProvider` for each unique data item you want to manage. This instance is configured once with a name, schemaVersion, and default value, and then used to interact with that specific item.
+1. **Provider Pattern**: Instead of using static functions, you create an _instance_ of a `LocalStorageProvider` for each unique data item you want to manage. This instance is configured once with a name and schemaVersion, and then used to interact with that specific item.
 
 2. **Versioning & Automatic Migration**: When you initialize a provider with a new `schemaVersion` number, it automatically removes all older versions of that data from `localStorage`. This prevents conflicts and ensures the application is working with the correct data structure.
 
 3. **Facade Factory Function**: The `createLocalStorageProvider` function acts as a clean entry point (Facade) to the library. This simplifies the API and decouples your code from the internal class implementation, making future library upgrades safer and easier.
 
-4. **Static Existence Check**: The static method `LocalStorageProvider.has()` allows you to check if data exists _before_ creating a provider instance. This is highly efficient for scenarios where you only need to know if the data is present, without needing the data itself or a default value.
+4. **Static Existence Check**: The static method `LocalStorageProvider.has()` allows you to check if data exists _before_ creating a provider instance. This is highly efficient for scenarios where you only need to know if the data is present, without needing the data itself.
 
 ## Installation
 
@@ -52,11 +52,6 @@ interface UserSettings {
 const userSettingsProvider = createLocalStorageProvider<UserSettings>({
   name: 'user-settings',
   schemaVersion: 1,
-  defaultValue: {
-    theme: 'light',
-    notifications: true,
-    lastLogin: null,
-  },
 });
 ```
 
@@ -77,20 +72,24 @@ userSettingsProvider.write({
 Use the `.read()` method to retrieve the data.
 
 - If a value exists in `localStorage` and is valid JSON, it will be parsed and returned.
-- If no value exists or if the stored value is corrupted (invalid JSON), the `defaultValue` will be written to `localStorage` and then returned. This guarantees you always receive a value of the correct type.
+- If no value exists or if the stored value is corrupted (invalid JSON), it returns `null`.
 
 <!-- end list -->
 
 ```typescript
 const currentSettings = userSettingsProvider.read();
-console.log(currentSettings.theme); // "dark"
+if (currentSettings) {
+  console.log(currentSettings.theme); // "dark"
+} else {
+  // Handle the case where no data exists
+}
 ```
 
 ### 4\. Checking for Data Existence (The Recommended Way)
 
 This is a critical feature for many applications. Before rendering a component or creating a full provider instance, you might need to check if the user has already saved data. Use the static `LocalStorageProvider.has()` method for this.
 
-This method is highly efficient as it **does not** require a `defaultValue` and does not create a class instance.
+This method is highly efficient as it **does not** require creating a class instance.
 
 ```typescript
 import {LocalStorageProvider} from '@alwatr/local-storage';
@@ -118,7 +117,7 @@ userSettingsProvider.remove();
 ## Best Practices
 
 - **Always use the `createLocalStorageProvider` factory function.** It provides a stable API that protects your code from internal library changes.
-- **Prefer `LocalStorageProvider.has()` for existence checks.** It's the most performant and cleanest way to check for data without the overhead of creating an instance and providing a `defaultValue`.
+- **Prefer `LocalStorageProvider.has()` for existence checks.** It's the most performant and cleanest way to check for data without the overhead of creating an instance.
 - **Increment the `schemaVersion` number** whenever you make a breaking change to your data structure. The library will handle the cleanup of old data automatically.
 
 ---
@@ -152,13 +151,13 @@ Contributions are welcome! Please read our [contribution guidelines](https://git
 
 این کتابخانه بر پایه چند مفهوم ساده اما قدرتمند بنا شده است:
 
-1. **الگوی Provider (ارائه‌دهنده)**: به جای استفاده از توابع استاتیک، شما برای هر آیتم داده‌ای که می‌خواهید مدیریت کنید، یک _نمونه (instance)_ از `LocalStorageProvider` می‌سازید. این نمونه یک بار با `name`, `schemaVersion` و `defaultValue` پیکربندی شده و سپس برای تعامل با آن آیتم خاص استفاده می‌شود.
+1. **الگوی Provider (ارائه‌دهنده)**: به جای استفاده از توابع استاتیک، شما برای هر آیتم داده‌ای که می‌خواهید مدیریت کنید، یک _نمونه (instance)_ از `LocalStorageProvider` می‌سازید. این نمونه یک بار با `name` و `schemaVersion` پیکربندی شده و سپس برای تعامل با آن آیتم خاص استفاده می‌شود.
 
 2. **نسخه‌بندی و مهاجرت خودکار**: هنگامی که شما یک Provider را با شماره `schemaVersion` جدیدی مقداردهی اولیه می‌کنید، این کتابخانه به طور خودکار تمام نسخه‌های قدیمی‌تر آن داده را از `localStorage` حذف می‌کند. این کار از تداخل جلوگیری کرده و تضمین می‌کند که اپلیکیشن همیشه با ساختار داده صحیح کار می‌کند.
 
 3. **تابع سازنده Facade**: تابع `createLocalStorageProvider` به عنوان یک نقطه ورود تمیز (Facade) به کتابخانه عمل می‌کند. این کار API را ساده کرده و کد شما را از پیاده‌سازی داخلی کلاس‌ها جدا (decouple) می‌سازد، که باعث می‌شود ارتقاء کتابخانه در آینده امن‌تر و آسان‌تر باشد.
 
-4. **بررسی استاتیک وجود داده**: متد استاتیک `LocalStorageProvider.has()` به شما اجازه می‌دهد وجود داده را _قبل_ از ساختن یک نمونه از Provider بررسی کنید. این روش برای سناریوهایی که فقط نیاز دارید بدانید داده‌ای وجود دارد یا نه (بدون نیاز به خود داده یا مقدار پیش‌فرض) بسیار کارآمد است.
+4. **بررسی استاتیک وجود داده**: متد استاتیک `LocalStorageProvider.has()` به شما اجازه می‌دهد وجود داده را _قبل_ از ساختن یک نمونه از Provider بررسی کنید. این روش برای سناریوهایی که فقط نیاز دارید بدانید داده‌ای وجود دارد یا نه بسیار کارآمد است.
 
 ## نصب
 
@@ -190,11 +189,6 @@ interface UserSettings {
 const userSettingsProvider = createLocalStorageProvider<UserSettings>({
   name: 'user-settings',
   schemaVersion: 1,
-  defaultValue: {
-    theme: 'light',
-    notifications: true,
-    lastLogin: null,
-  },
 });
 ```
 
@@ -215,20 +209,24 @@ userSettingsProvider.write({
 از متد `.read()` برای بازیابی داده استفاده کنید.
 
 - اگر مقداری در `localStorage` وجود داشته باشد و JSON معتبر باشد، آن مقدار parse شده و برگردانده می‌شود.
-- اگر مقداری وجود نداشته باشد یا مقدار ذخیره شده خراب باشد (JSON نامعتبر)، `defaultValue` در `localStorage` نوشته شده و سپس برگردانده می‌شود. این تضمین می‌کند که شما همیشه یک مقدار با نوع صحیح دریافت می‌کنید.
+- اگر مقداری وجود نداشته باشد یا مقدار ذخیره شده خراب باشد (JSON نامعتبر)، `null` برگردانده می‌شود.
 
 <!-- end list -->
 
 ```typescript
 const currentSettings = userSettingsProvider.read();
-console.log(currentSettings.theme); // "dark"
+if (currentSettings) {
+  console.log(currentSettings.theme); // "dark"
+} else {
+  // مدیریت حالت عدم وجود داده
+}
 ```
 
 ### ۴. بررسی وجود داده (روش پیشنهادی)
 
 این یک قابلیت حیاتی برای بسیاری از اپلیکیشن‌ها است. قبل از رندر کردن یک کامپوننت یا ساختن یک نمونه کامل از Provider، ممکن است لازم باشد بررسی کنید که آیا کاربر قبلاً داده‌ای ذخیره کرده است یا خیر. برای این کار از متد استاتیک `LocalStorageProvider.has()` استفاده کنید.
 
-این متد بسیار کارآمد است زیرا **نیازی** به `defaultValue` ندارد و یک نمونه از کلاس نمی‌سازد.
+این متد بسیار کارآمد است زیرا یک نمونه از کلاس نمی‌سازد.
 
 ```typescript
 import {LocalStorageProvider} from '@alwatr/local-storage';
@@ -256,7 +254,7 @@ userSettingsProvider.remove();
 ## بهترین روش‌ها (Best Practices)
 
 - **همیشه از تابع سازنده `createLocalStorageProvider` استفاده کنید.** این تابع یک API پایدار فراهم می‌کند که کد شما را در برابر تغییرات داخلی کتابخانه محافظت می‌کند.
-- **برای بررسی وجود داده، `LocalStorageProvider.has()` را ترجیح دهید.** این کارآمدترین و تمیزترین روش برای بررسی وجود داده بدون سربار ساختن یک نمونه و تعریف `defaultValue` است.
+- **برای بررسی وجود داده، `LocalStorageProvider.has()` را ترجیح دهید.** این کارآمدترین و تمیزترین روش برای بررسی وجود داده بدون سربار ساختن یک نمونه است.
 - **هر زمان که یک تغییر ساختاری در داده‌های خود ایجاد کردید که با نسخه‌های قبلی ناسازگار است، شماره `schemaVersion` را افزایش دهید.** کتابخانه پاک‌سازی داده‌های قدیمی را به صورت خودکار انجام خواهد داد.
 
 ## حامیان (Sponsors)

package/dist/facade.d.ts

@@ -10,8 +10,7 @@ import type { LocalStorageProviderConfig } from './type.js';
  * ```typescript
  * const userSettings = createLocalStorageProvider({
  *   name: 'user-settings',
- *   schemaVersion: 1,
- *   defaultValue: { theme: 'light', notifications: true }
+ *   schemaVersion: 1
  * });
  *
  * // Write new settings
@@ -22,5 +21,5 @@ import type { LocalStorageProviderConfig } from './type.js';
  * console.log(currentSettings); // { theme: 'dark', notifications: false }
  * ```
  */
-export declare function createLocalStorageProvider<T extends JsonValue>(config: LocalStorageProviderConfig<T>): LocalStorageProvider<T>;
+export declare function createLocalStorageProvider<T extends JsonValue>(config: LocalStorageProviderConfig): LocalStorageProvider<T>;
 //# sourceMappingURL=facade.d.ts.map

package/dist/facade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["../src/facade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAC,0BAA0B,EAAC,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAE9H"}
+{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["../src/facade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAC,0BAA0B,EAAC,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,0BAA0B,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAE3H"}

package/dist/local-storage.provider.d.ts

@@ -1,4 +1,4 @@
-import type { LocalStorageProviderConfig, StorageMeta } from './type.js';
+import type { LocalStorageProviderConfig } from './type.js';
 /**
  * A provider class for managing a specific, versioned item in localStorage.
  * It encapsulates the logic for key generation, serialization, and migration.
@@ -7,8 +7,7 @@ import type { LocalStorageProviderConfig, StorageMeta } from './type.js';
  * ```typescript
  * const userSettings = new LocalStorageProvider({
  *   name: 'user-settings',
- *   version: 1,
- *   defaultValue: { theme: 'light', notifications: true }
+ *   version: 1
  * });
  *
  * // Write new settings
@@ -23,54 +22,50 @@ export declare class LocalStorageProvider<T extends JsonValue> {
     static readonly version: string;
     private readonly key__;
     protected readonly logger_: import("@alwatr/logger").AlwatrLogger;
-    private readonly meta__;
-    protected readonly defaultValue__: T;
-    constructor(config: LocalStorageProviderConfig<T>);
+    constructor(config: LocalStorageProviderConfig);
     /**
      * Generates the versioned storage key.
      * @param meta - An object containing the name and schemaVersion.
      * @returns The versioned key string.
      */
-    static getKey(meta: StorageMeta): string;
+    static getKey(config: LocalStorageProviderConfig): string;
     /**
-     * Statically checks if a versioned item exists in localStorage.
-     * This method provides a high-performance way to check for data existence without the overhead of creating a full provider instance.
+     * Manages data migration by removing all previous versions of the item.
+     */
+    static clearPreviousStorageVersions(config: LocalStorageProviderConfig): void;
+    /**
+     * Checks if a versioned item exists in localStorage for the given configuration.
+     * This static method allows checking for the existence of a specific versioned item
+     * without instantiating the provider.
      *
-     * @param meta - An object containing the name and version of the item to check.
-     * @returns `true` if the item exists, otherwise `false`.
+     * @param config - The configuration object containing the name and schemaVersion.
+     * @returns `true` if the item exists in localStorage, otherwise `false`.
      *
      * @example
      * ```typescript
-     * const formExists = LocalStorageProvider.has({ name: 'user-form', schemaVersion: 1 });
-     * if (formExists) {
-     *   // Show the "Thank you" message
-     * } else {
-     *   // Show the form
-     * }
+     * const exists = LocalStorageProvider.has({ name: 'user-form', schemaVersion: 1 });
      * ```
      */
-    static has(meta: StorageMeta): boolean;
+    static has(config: LocalStorageProviderConfig): boolean;
     /**
-     * Writes the default value to localStorage and returns it.
-     */
-    private handleDefault__;
-    /**
-     * Converts the provided data to a JSON-compatible format by simulating
-     * a serialization/deserialization cycle. This ensures that the data
-     * conforms to the `T` type.
+     * Checks if the current versioned item exists in localStorage.
+     *
+     * @returns `true` if the item exists in localStorage, otherwise `false`.
      *
-     * @template T - The type of the input data.
-     * @param data - The data to be converted to a JSON-compatible format.
-     * @returns The converted data as `T`.
-     * @throws {Error} If the serialization/deserialization process fails.
+     * @example
+     * ```typescript
+     * const provider = new LocalStorageProvider({ name: 'profile', schemaVersion: 2 });
+     * if (provider.has()) {
+     *   // Item exists
+     * }
+     * ```
      */
-    private convertDataType__;
+    has(): boolean;
     /**
      * Reads and parses the value from localStorage.
-     * If the item doesn't exist, is invalid JSON, or doesn't match the expected type,
-     * it writes and returns the default value.
+     * If the item doesn't exist or is invalid JSON, returns null.
      */
-    read(): T;
+    read(): T | null;
     /**
      * Serializes and writes a value to localStorage.
      */
@@ -79,9 +74,5 @@ export declare class LocalStorageProvider<T extends JsonValue> {
      * Removes the item from localStorage.
      */
     remove(): void;
-    /**
-     * Manages data migration by removing all previous versions of the item.
-     */
-    private migrate__;
 }
 //# sourceMappingURL=local-storage.provider.d.ts.map

package/dist/local-storage.provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.provider.d.ts","sourceRoot":"","sources":["../src/local-storage.provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,0BAA0B,EAAE,WAAW,EAAC,MAAM,WAAW,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,oBAAoB,CAAC,CAAC,SAAS,SAAS;IACnD,gBAAuB,OAAO,SAAuB;IAErD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;gBAEzB,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAYjD;;;;OAIG;WACW,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM;IAI/C;;;;;;;;;;;;;;;;OAgBG;WACW,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAK7C;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;;OAIG;IACI,IAAI,IAAI,CAAC;IAyBhB;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAmB5B;;OAEG;IACI,MAAM,IAAI,IAAI;IAIrB;;OAEG;IACH,OAAO,CAAC,SAAS;CASlB"}
+{"version":3,"file":"local-storage.provider.d.ts","sourceRoot":"","sources":["../src/local-storage.provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,0BAA0B,EAAC,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,oBAAoB,CAAC,CAAC,SAAS,SAAS;IACnD,gBAAuB,OAAO,SAAuB;IAErD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAAC;gBAEf,MAAM,EAAE,0BAA0B;IAO9C;;;;OAIG;WACW,MAAM,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM;IAIhE;;OAEG;WACW,4BAA4B,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI;IAUpF;;;;;;;;;;;;OAYG;WACW,GAAG,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO;IAK9D;;;;;;;;;;;;OAYG;IACI,GAAG,IAAI,OAAO;IAIrB;;;OAGG;IACI,IAAI,IAAI,CAAC,GAAG,IAAI;IA0BvB;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAmB5B;;OAEG;IACI,MAAM,IAAI,IAAI;CAGtB"}

package/dist/main.cjs

@@ -1,4 +1,4 @@
-/** 📦 @alwatr/local-storage v6.3.4 */
-__dev_mode__: console.debug("📦 @alwatr/local-storage v6.3.4");
-"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true})};var __copyProps=(to,from,except,desc)=>{if(from&&typeof from==="object"||typeof from==="function"){for(let key of __getOwnPropNames(from))if(!__hasOwnProp.call(to,key)&&key!==except)__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable})}return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:true}),mod);var main_exports={};__export(main_exports,{LocalStorageProvider:()=>LocalStorageProvider,createLocalStorageProvider:()=>createLocalStorageProvider});module.exports=__toCommonJS(main_exports);var import_logger=require("@alwatr/logger");var LocalStorageProvider=class _LocalStorageProvider{static{this.version="6.3.4"}constructor(config){this.logger_=(0,import_logger.createLogger)(`local-storage-provider: ${config.name}, v: ${config.schemaVersion}`);this.logger_.logMethodArgs?.("constructor",{config});this.meta__={name:config.name,schemaVersion:config.schemaVersion};this.key__=_LocalStorageProvider.getKey(this.meta__);this.defaultValue__=this.convertDataType__(config.defaultValue);this.migrate__()}static getKey(meta){return`${meta.name}.v${meta.schemaVersion}`}static has(meta){const key=_LocalStorageProvider.getKey(meta);return localStorage.getItem(key)!==null}handleDefault__(){this.logger_.logMethodArgs?.("handleDefault__",this.defaultValue__);try{this.write(this.defaultValue__)}catch(err){this.logger_.error("write","write_default_error",{err})}return this.defaultValue__}convertDataType__(data){this.logger_.logMethod?.("convertDataType");try{return JSON.parse(JSON.stringify(data))}catch(err){this.logger_.error("convertDataType__","convert_data_type_error",{err});throw new Error("convert_data_type_error")}}read(){let value=null;try{value=localStorage.getItem(this.key__)}catch(err){this.logger_.error("read","read_local_storage_error",{err})}if(value===null){this.logger_.logMethod?.("read//no_value");return this.handleDefault__()}try{const parsedValue=JSON.parse(value);this.logger_.logMethodFull?.("read//value",void 0,{parsedValue});return parsedValue}catch(err){this.logger_.error("read","read_parse_error",{err});return this.handleDefault__()}}write(value){this.logger_.logMethodArgs?.("write",{value});let valueStr;try{valueStr=JSON.stringify(value)}catch(err){this.logger_.error("write","write_stringify_error",{err});throw new Error("write_stringify_error")}try{localStorage.setItem(this.key__,valueStr)}catch(err){this.logger_.error("write","write_local_storage_error",{err})}}remove(){localStorage.removeItem(this.key__)}migrate__(){if(this.meta__.schemaVersion<=1)return;for(let i=1;i<this.meta__.schemaVersion;i++){const oldKey=_LocalStorageProvider.getKey({name:this.meta__.name,schemaVersion:i});localStorage.removeItem(oldKey)}}};function createLocalStorageProvider(config){return new LocalStorageProvider(config)}0&&(module.exports={LocalStorageProvider,createLocalStorageProvider});
+/** 📦 @alwatr/local-storage v7.0.1 */
+__dev_mode__: console.debug("📦 @alwatr/local-storage v7.0.1");
+"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true})};var __copyProps=(to,from,except,desc)=>{if(from&&typeof from==="object"||typeof from==="function"){for(let key of __getOwnPropNames(from))if(!__hasOwnProp.call(to,key)&&key!==except)__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable})}return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:true}),mod);var main_exports={};__export(main_exports,{LocalStorageProvider:()=>LocalStorageProvider,createLocalStorageProvider:()=>createLocalStorageProvider});module.exports=__toCommonJS(main_exports);var import_logger=require("@alwatr/logger");var LocalStorageProvider=class _LocalStorageProvider{static{this.version="7.0.1"}constructor(config){this.logger_=(0,import_logger.createLogger)(`local-storage-provider: ${config.name}, v: ${config.schemaVersion}`);this.logger_.logMethodArgs?.("constructor",{config});this.key__=_LocalStorageProvider.getKey(config);_LocalStorageProvider.clearPreviousStorageVersions(config)}static getKey(config){return`${config.name}.v${config.schemaVersion}`}static clearPreviousStorageVersions(config){if(config.schemaVersion<1)return;for(let i=0;i<config.schemaVersion;i++){const oldKey=_LocalStorageProvider.getKey({name:config.name,schemaVersion:i});localStorage.removeItem(oldKey)}}static has(config){const key=_LocalStorageProvider.getKey(config);return localStorage.getItem(key)!==null}has(){return localStorage.getItem(this.key__)!==null}read(){let value=null;try{value=localStorage.getItem(this.key__)}catch(err){this.logger_.error("read","read_local_storage_error",{err})}if(!value){this.logger_.logMethod?.("read//no_value");return null}try{const parsedValue=JSON.parse(value);this.logger_.logMethodFull?.("read//value",void 0,{parsedValue});return parsedValue}catch(err){this.logger_.error("read","read_parse_error",{err});return null}}write(value){this.logger_.logMethodArgs?.("write",{value});let valueStr;try{valueStr=JSON.stringify(value)}catch(err){this.logger_.error("write","write_stringify_error",{err});throw new Error("write_stringify_error")}try{localStorage.setItem(this.key__,valueStr)}catch(err){this.logger_.error("write","write_local_storage_error",{err})}}remove(){localStorage.removeItem(this.key__)}};function createLocalStorageProvider(config){return new LocalStorageProvider(config)}0&&(module.exports={LocalStorageProvider,createLocalStorageProvider});
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts", "../src/local-storage.provider.ts", "../src/facade.ts"],
-  "sourcesContent": ["export * from './local-storage.provider.js';\nexport * from './facade.js';\nexport type * from './type.js';\n", "import {createLogger} from '@alwatr/logger';\n\nimport type {LocalStorageProviderConfig, StorageMeta} from './type.js';\n\n/**\n * A provider class for managing a specific, versioned item in localStorage.\n * It encapsulates the logic for key generation, serialization, and migration.\n *\n * @example\n * ```typescript\n * const userSettings = new LocalStorageProvider({\n *   name: 'user-settings',\n *   version: 1,\n *   defaultValue: { theme: 'light', notifications: true }\n * });\n *\n * // Write new settings\n * userSettings.write({ theme: 'dark', notifications: false });\n *\n * // Read the current settings\n * const currentSettings = userSettings.read();\n * console.log(currentSettings); // { theme: 'dark', notifications: false }\n * ```\n */\nexport class LocalStorageProvider<T extends JsonValue> {\n  public static readonly version = __package_version__;\n\n  private readonly key__: string;\n  protected readonly logger_;\n\n  private readonly meta__: Readonly<StorageMeta>;\n\n  protected readonly defaultValue__: T;\n\n  constructor(config: LocalStorageProviderConfig<T>) {\n    this.logger_ = createLogger(`local-storage-provider: ${config.name}, v: ${config.schemaVersion}`);\n    this.logger_.logMethodArgs?.('constructor', {config});\n    this.meta__ = {\n      name: config.name,\n      schemaVersion: config.schemaVersion,\n    };\n    this.key__ = LocalStorageProvider.getKey(this.meta__);\n    this.defaultValue__ = this.convertDataType__(config.defaultValue);\n    this.migrate__();\n  }\n\n  /**\n   * Generates the versioned storage key.\n   * @param meta - An object containing the name and schemaVersion.\n   * @returns The versioned key string.\n   */\n  public static getKey(meta: StorageMeta): string {\n    return `${meta.name}.v${meta.schemaVersion}`;\n  }\n\n  /**\n   * Statically checks if a versioned item exists in localStorage.\n   * This method provides a high-performance way to check for data existence without the overhead of creating a full provider instance.\n   *\n   * @param meta - An object containing the name and version of the item to check.\n   * @returns `true` if the item exists, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const formExists = LocalStorageProvider.has({ name: 'user-form', schemaVersion: 1 });\n   * if (formExists) {\n   *   // Show the \"Thank you\" message\n   * } else {\n   *   // Show the form\n   * }\n   * ```\n   */\n  public static has(meta: StorageMeta): boolean {\n    const key = LocalStorageProvider.getKey(meta);\n    return localStorage.getItem(key) !== null;\n  }\n\n  /**\n   * Writes the default value to localStorage and returns it.\n   */\n  private handleDefault__(): T {\n    this.logger_.logMethodArgs?.('handleDefault__', this.defaultValue__);\n    try {\n      this.write(this.defaultValue__);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_default_error', {err});\n    }\n    return this.defaultValue__;\n  }\n\n  /**\n   * Converts the provided data to a JSON-compatible format by simulating\n   * a serialization/deserialization cycle. This ensures that the data\n   * conforms to the `T` type.\n   *\n   * @template T - The type of the input data.\n   * @param data - The data to be converted to a JSON-compatible format.\n   * @returns The converted data as `T`.\n   * @throws {Error} If the serialization/deserialization process fails.\n   */\n  private convertDataType__(data: T): T {\n    this.logger_.logMethod?.('convertDataType');\n    // Simulate real serialization/deserialization cycle for real types\n    try {\n      return JSON.parse(JSON.stringify(data)) as T;\n    }\n    catch (err) {\n      this.logger_.error('convertDataType__', 'convert_data_type_error', {err});\n      throw new Error('convert_data_type_error');\n    }\n  }\n\n  /**\n   * Reads and parses the value from localStorage.\n   * If the item doesn't exist, is invalid JSON, or doesn't match the expected type,\n   * it writes and returns the default value.\n   */\n  public read(): T {\n    let value: string | null = null;\n    try {\n      value = localStorage.getItem(this.key__);\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_local_storage_error', {err});\n    }\n\n    if (value === null) {\n      this.logger_.logMethod?.('read//no_value');\n      return this.handleDefault__();\n    }\n\n    try {\n      const parsedValue = JSON.parse(value) as T;\n      this.logger_.logMethodFull?.('read//value', undefined, {parsedValue});\n      return parsedValue;\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_parse_error', {err});\n      return this.handleDefault__();\n    }\n  }\n\n  /**\n   * Serializes and writes a value to localStorage.\n   */\n  public write(value: T): void {\n    this.logger_.logMethodArgs?.('write', {value});\n    let valueStr: string;\n    try {\n      valueStr = JSON.stringify(value);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_stringify_error', {err});\n      throw new Error('write_stringify_error');\n    }\n\n    try {\n      localStorage.setItem(this.key__, valueStr);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_local_storage_error', {err});\n    }\n  }\n\n  /**\n   * Removes the item from localStorage.\n   */\n  public remove(): void {\n    localStorage.removeItem(this.key__);\n  }\n\n  /**\n   * Manages data migration by removing all previous versions of the item.\n   */\n  private migrate__(): void {\n    if (this.meta__.schemaVersion <= 1) return;\n\n    // Iterate from v1 up to the version just before the current one and remove them.\n    for (let i = 1; i < this.meta__.schemaVersion; i++) {\n      const oldKey = LocalStorageProvider.getKey({name: this.meta__.name, schemaVersion: i});\n      localStorage.removeItem(oldKey);\n    }\n  }\n}\n", "import {LocalStorageProvider} from './local-storage.provider.js';\n\nimport type {LocalStorageProviderConfig} from './type.js';\n\n/**\n * Factory function to create a new LocalStorageProvider.\n *\n * @param config - The configuration for the provider.\n * @returns An instance of LocalStorageProvider.\n *\n * @example\n * ```typescript\n * const userSettings = createLocalStorageProvider({\n *   name: 'user-settings',\n *   schemaVersion: 1,\n *   defaultValue: { theme: 'light', notifications: true }\n * });\n *\n * // Write new settings\n * userSettings.write({ theme: 'dark', notifications: false });\n *\n * // Read the current settings\n * const currentSettings = userSettings.read();\n * console.log(currentSettings); // { theme: 'dark', notifications: false }\n * ```\n */\nexport function createLocalStorageProvider<T extends JsonValue>(config: LocalStorageProviderConfig<T>): LocalStorageProvider<T> {\n  return new LocalStorageProvider<T>(config);\n}\n"],
-  "mappings": ";;qqBAAA,+LCAA,kBAA2B,0BAwBpB,IAAM,qBAAN,MAAM,qBAA0C,CACrD,YAAuB,QAAU,QASjC,YAAY,OAAuC,CACjD,KAAK,WAAU,4BAAa,2BAA2B,OAAO,IAAI,QAAQ,OAAO,aAAa,EAAE,EAChG,KAAK,QAAQ,gBAAgB,cAAe,CAAC,MAAM,CAAC,EACpD,KAAK,OAAS,CACZ,KAAM,OAAO,KACb,cAAe,OAAO,aACxB,EACA,KAAK,MAAQ,sBAAqB,OAAO,KAAK,MAAM,EACpD,KAAK,eAAiB,KAAK,kBAAkB,OAAO,YAAY,EAChE,KAAK,UAAU,CACjB,CAOA,OAAc,OAAO,KAA2B,CAC9C,MAAO,GAAG,KAAK,IAAI,KAAK,KAAK,aAAa,EAC5C,CAmBA,OAAc,IAAI,KAA4B,CAC5C,MAAM,IAAM,sBAAqB,OAAO,IAAI,EAC5C,OAAO,aAAa,QAAQ,GAAG,IAAM,IACvC,CAKQ,iBAAqB,CAC3B,KAAK,QAAQ,gBAAgB,kBAAmB,KAAK,cAAc,EACnE,GAAI,CACF,KAAK,MAAM,KAAK,cAAc,CAChC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,sBAAuB,CAAC,GAAG,CAAC,CAC1D,CACA,OAAO,KAAK,cACd,CAYQ,kBAAkB,KAAY,CACpC,KAAK,QAAQ,YAAY,iBAAiB,EAE1C,GAAI,CACF,OAAO,KAAK,MAAM,KAAK,UAAU,IAAI,CAAC,CACxC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,oBAAqB,0BAA2B,CAAC,GAAG,CAAC,EACxE,MAAM,IAAI,MAAM,yBAAyB,CAC3C,CACF,CAOO,MAAU,CACf,IAAI,MAAuB,KAC3B,GAAI,CACF,MAAQ,aAAa,QAAQ,KAAK,KAAK,CACzC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,2BAA4B,CAAC,GAAG,CAAC,CAC9D,CAEA,GAAI,QAAU,KAAM,CAClB,KAAK,QAAQ,YAAY,gBAAgB,EACzC,OAAO,KAAK,gBAAgB,CAC9B,CAEA,GAAI,CACF,MAAM,YAAc,KAAK,MAAM,KAAK,EACpC,KAAK,QAAQ,gBAAgB,cAAe,OAAW,CAAC,WAAW,CAAC,EACpE,OAAO,WACT,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,mBAAoB,CAAC,GAAG,CAAC,EACpD,OAAO,KAAK,gBAAgB,CAC9B,CACF,CAKO,MAAM,MAAgB,CAC3B,KAAK,QAAQ,gBAAgB,QAAS,CAAC,KAAK,CAAC,EAC7C,IAAI,SACJ,GAAI,CACF,SAAW,KAAK,UAAU,KAAK,CACjC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,wBAAyB,CAAC,GAAG,CAAC,EAC1D,MAAM,IAAI,MAAM,uBAAuB,CACzC,CAEA,GAAI,CACF,aAAa,QAAQ,KAAK,MAAO,QAAQ,CAC3C,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,4BAA6B,CAAC,GAAG,CAAC,CAChE,CACF,CAKO,QAAe,CACpB,aAAa,WAAW,KAAK,KAAK,CACpC,CAKQ,WAAkB,CACxB,GAAI,KAAK,OAAO,eAAiB,EAAG,OAGpC,QAAS,EAAI,EAAG,EAAI,KAAK,OAAO,cAAe,IAAK,CAClD,MAAM,OAAS,sBAAqB,OAAO,CAAC,KAAM,KAAK,OAAO,KAAM,cAAe,CAAC,CAAC,EACrF,aAAa,WAAW,MAAM,CAChC,CACF,CACF,EC9JO,SAAS,2BAAgD,OAAgE,CAC9H,OAAO,IAAI,qBAAwB,MAAM,CAC3C",
+  "sourcesContent": ["export * from './local-storage.provider.js';\nexport * from './facade.js';\nexport type * from './type.js';\n", "import {createLogger} from '@alwatr/logger';\n\nimport type {LocalStorageProviderConfig} from './type.js';\n\n/**\n * A provider class for managing a specific, versioned item in localStorage.\n * It encapsulates the logic for key generation, serialization, and migration.\n *\n * @example\n * ```typescript\n * const userSettings = new LocalStorageProvider({\n *   name: 'user-settings',\n *   version: 1\n * });\n *\n * // Write new settings\n * userSettings.write({ theme: 'dark', notifications: false });\n *\n * // Read the current settings\n * const currentSettings = userSettings.read();\n * console.log(currentSettings); // { theme: 'dark', notifications: false }\n * ```\n */\nexport class LocalStorageProvider<T extends JsonValue> {\n  public static readonly version = __package_version__;\n\n  private readonly key__: string;\n  protected readonly logger_;\n\n  constructor(config: LocalStorageProviderConfig) {\n    this.logger_ = createLogger(`local-storage-provider: ${config.name}, v: ${config.schemaVersion}`);\n    this.logger_.logMethodArgs?.('constructor', {config});\n    this.key__ = LocalStorageProvider.getKey(config);\n    LocalStorageProvider.clearPreviousStorageVersions(config);\n  }\n\n  /**\n   * Generates the versioned storage key.\n   * @param meta - An object containing the name and schemaVersion.\n   * @returns The versioned key string.\n   */\n  public static getKey(config: LocalStorageProviderConfig): string {\n    return `${config.name}.v${config.schemaVersion}`;\n  }\n\n  /**\n   * Manages data migration by removing all previous versions of the item.\n   */\n  public static clearPreviousStorageVersions(config: LocalStorageProviderConfig): void {\n    if (config.schemaVersion < 1) return;\n\n    // Iterate from v1 up to the version just before the current one and remove them.\n    for (let i = 0; i < config.schemaVersion; i++) {\n      const oldKey = LocalStorageProvider.getKey({name: config.name, schemaVersion: i});\n      localStorage.removeItem(oldKey);\n    }\n  }\n\n  /**\n   * Checks if a versioned item exists in localStorage for the given configuration.\n   * This static method allows checking for the existence of a specific versioned item\n   * without instantiating the provider.\n   *\n   * @param config - The configuration object containing the name and schemaVersion.\n   * @returns `true` if the item exists in localStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const exists = LocalStorageProvider.has({ name: 'user-form', schemaVersion: 1 });\n   * ```\n   */\n  public static has(config: LocalStorageProviderConfig): boolean {\n    const key = LocalStorageProvider.getKey(config);\n    return localStorage.getItem(key) !== null;\n  }\n\n  /**\n   * Checks if the current versioned item exists in localStorage.\n   *\n   * @returns `true` if the item exists in localStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const provider = new LocalStorageProvider({ name: 'profile', schemaVersion: 2 });\n   * if (provider.has()) {\n   *   // Item exists\n   * }\n   * ```\n   */\n  public has(): boolean {\n    return localStorage.getItem(this.key__) !== null;\n  }\n\n  /**\n   * Reads and parses the value from localStorage.\n   * If the item doesn't exist or is invalid JSON, returns null.\n   */\n  public read(): T | null {\n    let value: string | null = null;\n\n    try {\n      value = localStorage.getItem(this.key__);\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_local_storage_error', {err});\n    }\n\n    if (!value) {\n      this.logger_.logMethod?.('read//no_value');\n      return null;\n    }\n\n    try {\n      const parsedValue = JSON.parse(value) as T;\n      this.logger_.logMethodFull?.('read//value', undefined, {parsedValue});\n      return parsedValue;\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_parse_error', {err});\n      return null;\n    }\n  }\n\n  /**\n   * Serializes and writes a value to localStorage.\n   */\n  public write(value: T): void {\n    this.logger_.logMethodArgs?.('write', {value});\n    let valueStr: string;\n    try {\n      valueStr = JSON.stringify(value);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_stringify_error', {err});\n      throw new Error('write_stringify_error');\n    }\n\n    try {\n      localStorage.setItem(this.key__, valueStr);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_local_storage_error', {err});\n    }\n  }\n\n  /**\n   * Removes the item from localStorage.\n   */\n  public remove(): void {\n    localStorage.removeItem(this.key__);\n  }\n}\n", "import {LocalStorageProvider} from './local-storage.provider.js';\n\nimport type {LocalStorageProviderConfig} from './type.js';\n\n/**\n * Factory function to create a new LocalStorageProvider.\n *\n * @param config - The configuration for the provider.\n * @returns An instance of LocalStorageProvider.\n *\n * @example\n * ```typescript\n * const userSettings = createLocalStorageProvider({\n *   name: 'user-settings',\n *   schemaVersion: 1\n * });\n *\n * // Write new settings\n * userSettings.write({ theme: 'dark', notifications: false });\n *\n * // Read the current settings\n * const currentSettings = userSettings.read();\n * console.log(currentSettings); // { theme: 'dark', notifications: false }\n * ```\n */\nexport function createLocalStorageProvider<T extends JsonValue>(config: LocalStorageProviderConfig): LocalStorageProvider<T> {\n  return new LocalStorageProvider<T>(config);\n}\n"],
+  "mappings": ";;qqBAAA,+LCAA,kBAA2B,0BAuBpB,IAAM,qBAAN,MAAM,qBAA0C,CACrD,YAAuB,QAAU,QAKjC,YAAY,OAAoC,CAC9C,KAAK,WAAU,4BAAa,2BAA2B,OAAO,IAAI,QAAQ,OAAO,aAAa,EAAE,EAChG,KAAK,QAAQ,gBAAgB,cAAe,CAAC,MAAM,CAAC,EACpD,KAAK,MAAQ,sBAAqB,OAAO,MAAM,EAC/C,sBAAqB,6BAA6B,MAAM,CAC1D,CAOA,OAAc,OAAO,OAA4C,CAC/D,MAAO,GAAG,OAAO,IAAI,KAAK,OAAO,aAAa,EAChD,CAKA,OAAc,6BAA6B,OAA0C,CACnF,GAAI,OAAO,cAAgB,EAAG,OAG9B,QAAS,EAAI,EAAG,EAAI,OAAO,cAAe,IAAK,CAC7C,MAAM,OAAS,sBAAqB,OAAO,CAAC,KAAM,OAAO,KAAM,cAAe,CAAC,CAAC,EAChF,aAAa,WAAW,MAAM,CAChC,CACF,CAeA,OAAc,IAAI,OAA6C,CAC7D,MAAM,IAAM,sBAAqB,OAAO,MAAM,EAC9C,OAAO,aAAa,QAAQ,GAAG,IAAM,IACvC,CAeO,KAAe,CACpB,OAAO,aAAa,QAAQ,KAAK,KAAK,IAAM,IAC9C,CAMO,MAAiB,CACtB,IAAI,MAAuB,KAE3B,GAAI,CACF,MAAQ,aAAa,QAAQ,KAAK,KAAK,CACzC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,2BAA4B,CAAC,GAAG,CAAC,CAC9D,CAEA,GAAI,CAAC,MAAO,CACV,KAAK,QAAQ,YAAY,gBAAgB,EACzC,OAAO,IACT,CAEA,GAAI,CACF,MAAM,YAAc,KAAK,MAAM,KAAK,EACpC,KAAK,QAAQ,gBAAgB,cAAe,OAAW,CAAC,WAAW,CAAC,EACpE,OAAO,WACT,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,mBAAoB,CAAC,GAAG,CAAC,EACpD,OAAO,IACT,CACF,CAKO,MAAM,MAAgB,CAC3B,KAAK,QAAQ,gBAAgB,QAAS,CAAC,KAAK,CAAC,EAC7C,IAAI,SACJ,GAAI,CACF,SAAW,KAAK,UAAU,KAAK,CACjC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,wBAAyB,CAAC,GAAG,CAAC,EAC1D,MAAM,IAAI,MAAM,uBAAuB,CACzC,CAEA,GAAI,CACF,aAAa,QAAQ,KAAK,MAAO,QAAQ,CAC3C,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,4BAA6B,CAAC,GAAG,CAAC,CAChE,CACF,CAKO,QAAe,CACpB,aAAa,WAAW,KAAK,KAAK,CACpC,CACF,EC9HO,SAAS,2BAAgD,OAA6D,CAC3H,OAAO,IAAI,qBAAwB,MAAM,CAC3C",
   "names": []
 }

package/dist/main.mjs

@@ -1,4 +1,4 @@
-/** 📦 @alwatr/local-storage v6.3.4 */
-__dev_mode__: console.debug("📦 @alwatr/local-storage v6.3.4");
-import{createLogger}from"@alwatr/logger";var LocalStorageProvider=class _LocalStorageProvider{static{this.version="6.3.4"}constructor(config){this.logger_=createLogger(`local-storage-provider: ${config.name}, v: ${config.schemaVersion}`);this.logger_.logMethodArgs?.("constructor",{config});this.meta__={name:config.name,schemaVersion:config.schemaVersion};this.key__=_LocalStorageProvider.getKey(this.meta__);this.defaultValue__=this.convertDataType__(config.defaultValue);this.migrate__()}static getKey(meta){return`${meta.name}.v${meta.schemaVersion}`}static has(meta){const key=_LocalStorageProvider.getKey(meta);return localStorage.getItem(key)!==null}handleDefault__(){this.logger_.logMethodArgs?.("handleDefault__",this.defaultValue__);try{this.write(this.defaultValue__)}catch(err){this.logger_.error("write","write_default_error",{err})}return this.defaultValue__}convertDataType__(data){this.logger_.logMethod?.("convertDataType");try{return JSON.parse(JSON.stringify(data))}catch(err){this.logger_.error("convertDataType__","convert_data_type_error",{err});throw new Error("convert_data_type_error")}}read(){let value=null;try{value=localStorage.getItem(this.key__)}catch(err){this.logger_.error("read","read_local_storage_error",{err})}if(value===null){this.logger_.logMethod?.("read//no_value");return this.handleDefault__()}try{const parsedValue=JSON.parse(value);this.logger_.logMethodFull?.("read//value",void 0,{parsedValue});return parsedValue}catch(err){this.logger_.error("read","read_parse_error",{err});return this.handleDefault__()}}write(value){this.logger_.logMethodArgs?.("write",{value});let valueStr;try{valueStr=JSON.stringify(value)}catch(err){this.logger_.error("write","write_stringify_error",{err});throw new Error("write_stringify_error")}try{localStorage.setItem(this.key__,valueStr)}catch(err){this.logger_.error("write","write_local_storage_error",{err})}}remove(){localStorage.removeItem(this.key__)}migrate__(){if(this.meta__.schemaVersion<=1)return;for(let i=1;i<this.meta__.schemaVersion;i++){const oldKey=_LocalStorageProvider.getKey({name:this.meta__.name,schemaVersion:i});localStorage.removeItem(oldKey)}}};function createLocalStorageProvider(config){return new LocalStorageProvider(config)}export{LocalStorageProvider,createLocalStorageProvider};
+/** 📦 @alwatr/local-storage v7.0.1 */
+__dev_mode__: console.debug("📦 @alwatr/local-storage v7.0.1");
+import{createLogger}from"@alwatr/logger";var LocalStorageProvider=class _LocalStorageProvider{static{this.version="7.0.1"}constructor(config){this.logger_=createLogger(`local-storage-provider: ${config.name}, v: ${config.schemaVersion}`);this.logger_.logMethodArgs?.("constructor",{config});this.key__=_LocalStorageProvider.getKey(config);_LocalStorageProvider.clearPreviousStorageVersions(config)}static getKey(config){return`${config.name}.v${config.schemaVersion}`}static clearPreviousStorageVersions(config){if(config.schemaVersion<1)return;for(let i=0;i<config.schemaVersion;i++){const oldKey=_LocalStorageProvider.getKey({name:config.name,schemaVersion:i});localStorage.removeItem(oldKey)}}static has(config){const key=_LocalStorageProvider.getKey(config);return localStorage.getItem(key)!==null}has(){return localStorage.getItem(this.key__)!==null}read(){let value=null;try{value=localStorage.getItem(this.key__)}catch(err){this.logger_.error("read","read_local_storage_error",{err})}if(!value){this.logger_.logMethod?.("read//no_value");return null}try{const parsedValue=JSON.parse(value);this.logger_.logMethodFull?.("read//value",void 0,{parsedValue});return parsedValue}catch(err){this.logger_.error("read","read_parse_error",{err});return null}}write(value){this.logger_.logMethodArgs?.("write",{value});let valueStr;try{valueStr=JSON.stringify(value)}catch(err){this.logger_.error("write","write_stringify_error",{err});throw new Error("write_stringify_error")}try{localStorage.setItem(this.key__,valueStr)}catch(err){this.logger_.error("write","write_local_storage_error",{err})}}remove(){localStorage.removeItem(this.key__)}};function createLocalStorageProvider(config){return new LocalStorageProvider(config)}export{LocalStorageProvider,createLocalStorageProvider};
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/local-storage.provider.ts", "../src/facade.ts"],
-  "sourcesContent": ["import {createLogger} from '@alwatr/logger';\n\nimport type {LocalStorageProviderConfig, StorageMeta} from './type.js';\n\n/**\n * A provider class for managing a specific, versioned item in localStorage.\n * It encapsulates the logic for key generation, serialization, and migration.\n *\n * @example\n * ```typescript\n * const userSettings = new LocalStorageProvider({\n *   name: 'user-settings',\n *   version: 1,\n *   defaultValue: { theme: 'light', notifications: true }\n * });\n *\n * // Write new settings\n * userSettings.write({ theme: 'dark', notifications: false });\n *\n * // Read the current settings\n * const currentSettings = userSettings.read();\n * console.log(currentSettings); // { theme: 'dark', notifications: false }\n * ```\n */\nexport class LocalStorageProvider<T extends JsonValue> {\n  public static readonly version = __package_version__;\n\n  private readonly key__: string;\n  protected readonly logger_;\n\n  private readonly meta__: Readonly<StorageMeta>;\n\n  protected readonly defaultValue__: T;\n\n  constructor(config: LocalStorageProviderConfig<T>) {\n    this.logger_ = createLogger(`local-storage-provider: ${config.name}, v: ${config.schemaVersion}`);\n    this.logger_.logMethodArgs?.('constructor', {config});\n    this.meta__ = {\n      name: config.name,\n      schemaVersion: config.schemaVersion,\n    };\n    this.key__ = LocalStorageProvider.getKey(this.meta__);\n    this.defaultValue__ = this.convertDataType__(config.defaultValue);\n    this.migrate__();\n  }\n\n  /**\n   * Generates the versioned storage key.\n   * @param meta - An object containing the name and schemaVersion.\n   * @returns The versioned key string.\n   */\n  public static getKey(meta: StorageMeta): string {\n    return `${meta.name}.v${meta.schemaVersion}`;\n  }\n\n  /**\n   * Statically checks if a versioned item exists in localStorage.\n   * This method provides a high-performance way to check for data existence without the overhead of creating a full provider instance.\n   *\n   * @param meta - An object containing the name and version of the item to check.\n   * @returns `true` if the item exists, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const formExists = LocalStorageProvider.has({ name: 'user-form', schemaVersion: 1 });\n   * if (formExists) {\n   *   // Show the \"Thank you\" message\n   * } else {\n   *   // Show the form\n   * }\n   * ```\n   */\n  public static has(meta: StorageMeta): boolean {\n    const key = LocalStorageProvider.getKey(meta);\n    return localStorage.getItem(key) !== null;\n  }\n\n  /**\n   * Writes the default value to localStorage and returns it.\n   */\n  private handleDefault__(): T {\n    this.logger_.logMethodArgs?.('handleDefault__', this.defaultValue__);\n    try {\n      this.write(this.defaultValue__);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_default_error', {err});\n    }\n    return this.defaultValue__;\n  }\n\n  /**\n   * Converts the provided data to a JSON-compatible format by simulating\n   * a serialization/deserialization cycle. This ensures that the data\n   * conforms to the `T` type.\n   *\n   * @template T - The type of the input data.\n   * @param data - The data to be converted to a JSON-compatible format.\n   * @returns The converted data as `T`.\n   * @throws {Error} If the serialization/deserialization process fails.\n   */\n  private convertDataType__(data: T): T {\n    this.logger_.logMethod?.('convertDataType');\n    // Simulate real serialization/deserialization cycle for real types\n    try {\n      return JSON.parse(JSON.stringify(data)) as T;\n    }\n    catch (err) {\n      this.logger_.error('convertDataType__', 'convert_data_type_error', {err});\n      throw new Error('convert_data_type_error');\n    }\n  }\n\n  /**\n   * Reads and parses the value from localStorage.\n   * If the item doesn't exist, is invalid JSON, or doesn't match the expected type,\n   * it writes and returns the default value.\n   */\n  public read(): T {\n    let value: string | null = null;\n    try {\n      value = localStorage.getItem(this.key__);\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_local_storage_error', {err});\n    }\n\n    if (value === null) {\n      this.logger_.logMethod?.('read//no_value');\n      return this.handleDefault__();\n    }\n\n    try {\n      const parsedValue = JSON.parse(value) as T;\n      this.logger_.logMethodFull?.('read//value', undefined, {parsedValue});\n      return parsedValue;\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_parse_error', {err});\n      return this.handleDefault__();\n    }\n  }\n\n  /**\n   * Serializes and writes a value to localStorage.\n   */\n  public write(value: T): void {\n    this.logger_.logMethodArgs?.('write', {value});\n    let valueStr: string;\n    try {\n      valueStr = JSON.stringify(value);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_stringify_error', {err});\n      throw new Error('write_stringify_error');\n    }\n\n    try {\n      localStorage.setItem(this.key__, valueStr);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_local_storage_error', {err});\n    }\n  }\n\n  /**\n   * Removes the item from localStorage.\n   */\n  public remove(): void {\n    localStorage.removeItem(this.key__);\n  }\n\n  /**\n   * Manages data migration by removing all previous versions of the item.\n   */\n  private migrate__(): void {\n    if (this.meta__.schemaVersion <= 1) return;\n\n    // Iterate from v1 up to the version just before the current one and remove them.\n    for (let i = 1; i < this.meta__.schemaVersion; i++) {\n      const oldKey = LocalStorageProvider.getKey({name: this.meta__.name, schemaVersion: i});\n      localStorage.removeItem(oldKey);\n    }\n  }\n}\n", "import {LocalStorageProvider} from './local-storage.provider.js';\n\nimport type {LocalStorageProviderConfig} from './type.js';\n\n/**\n * Factory function to create a new LocalStorageProvider.\n *\n * @param config - The configuration for the provider.\n * @returns An instance of LocalStorageProvider.\n *\n * @example\n * ```typescript\n * const userSettings = createLocalStorageProvider({\n *   name: 'user-settings',\n *   schemaVersion: 1,\n *   defaultValue: { theme: 'light', notifications: true }\n * });\n *\n * // Write new settings\n * userSettings.write({ theme: 'dark', notifications: false });\n *\n * // Read the current settings\n * const currentSettings = userSettings.read();\n * console.log(currentSettings); // { theme: 'dark', notifications: false }\n * ```\n */\nexport function createLocalStorageProvider<T extends JsonValue>(config: LocalStorageProviderConfig<T>): LocalStorageProvider<T> {\n  return new LocalStorageProvider<T>(config);\n}\n"],
-  "mappings": ";;AAAA,OAAQ,iBAAmB,iBAwBpB,IAAM,qBAAN,MAAM,qBAA0C,CACrD,YAAuB,QAAU,QASjC,YAAY,OAAuC,CACjD,KAAK,QAAU,aAAa,2BAA2B,OAAO,IAAI,QAAQ,OAAO,aAAa,EAAE,EAChG,KAAK,QAAQ,gBAAgB,cAAe,CAAC,MAAM,CAAC,EACpD,KAAK,OAAS,CACZ,KAAM,OAAO,KACb,cAAe,OAAO,aACxB,EACA,KAAK,MAAQ,sBAAqB,OAAO,KAAK,MAAM,EACpD,KAAK,eAAiB,KAAK,kBAAkB,OAAO,YAAY,EAChE,KAAK,UAAU,CACjB,CAOA,OAAc,OAAO,KAA2B,CAC9C,MAAO,GAAG,KAAK,IAAI,KAAK,KAAK,aAAa,EAC5C,CAmBA,OAAc,IAAI,KAA4B,CAC5C,MAAM,IAAM,sBAAqB,OAAO,IAAI,EAC5C,OAAO,aAAa,QAAQ,GAAG,IAAM,IACvC,CAKQ,iBAAqB,CAC3B,KAAK,QAAQ,gBAAgB,kBAAmB,KAAK,cAAc,EACnE,GAAI,CACF,KAAK,MAAM,KAAK,cAAc,CAChC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,sBAAuB,CAAC,GAAG,CAAC,CAC1D,CACA,OAAO,KAAK,cACd,CAYQ,kBAAkB,KAAY,CACpC,KAAK,QAAQ,YAAY,iBAAiB,EAE1C,GAAI,CACF,OAAO,KAAK,MAAM,KAAK,UAAU,IAAI,CAAC,CACxC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,oBAAqB,0BAA2B,CAAC,GAAG,CAAC,EACxE,MAAM,IAAI,MAAM,yBAAyB,CAC3C,CACF,CAOO,MAAU,CACf,IAAI,MAAuB,KAC3B,GAAI,CACF,MAAQ,aAAa,QAAQ,KAAK,KAAK,CACzC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,2BAA4B,CAAC,GAAG,CAAC,CAC9D,CAEA,GAAI,QAAU,KAAM,CAClB,KAAK,QAAQ,YAAY,gBAAgB,EACzC,OAAO,KAAK,gBAAgB,CAC9B,CAEA,GAAI,CACF,MAAM,YAAc,KAAK,MAAM,KAAK,EACpC,KAAK,QAAQ,gBAAgB,cAAe,OAAW,CAAC,WAAW,CAAC,EACpE,OAAO,WACT,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,mBAAoB,CAAC,GAAG,CAAC,EACpD,OAAO,KAAK,gBAAgB,CAC9B,CACF,CAKO,MAAM,MAAgB,CAC3B,KAAK,QAAQ,gBAAgB,QAAS,CAAC,KAAK,CAAC,EAC7C,IAAI,SACJ,GAAI,CACF,SAAW,KAAK,UAAU,KAAK,CACjC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,wBAAyB,CAAC,GAAG,CAAC,EAC1D,MAAM,IAAI,MAAM,uBAAuB,CACzC,CAEA,GAAI,CACF,aAAa,QAAQ,KAAK,MAAO,QAAQ,CAC3C,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,4BAA6B,CAAC,GAAG,CAAC,CAChE,CACF,CAKO,QAAe,CACpB,aAAa,WAAW,KAAK,KAAK,CACpC,CAKQ,WAAkB,CACxB,GAAI,KAAK,OAAO,eAAiB,EAAG,OAGpC,QAAS,EAAI,EAAG,EAAI,KAAK,OAAO,cAAe,IAAK,CAClD,MAAM,OAAS,sBAAqB,OAAO,CAAC,KAAM,KAAK,OAAO,KAAM,cAAe,CAAC,CAAC,EACrF,aAAa,WAAW,MAAM,CAChC,CACF,CACF,EC9JO,SAAS,2BAAgD,OAAgE,CAC9H,OAAO,IAAI,qBAAwB,MAAM,CAC3C",
+  "sourcesContent": ["import {createLogger} from '@alwatr/logger';\n\nimport type {LocalStorageProviderConfig} from './type.js';\n\n/**\n * A provider class for managing a specific, versioned item in localStorage.\n * It encapsulates the logic for key generation, serialization, and migration.\n *\n * @example\n * ```typescript\n * const userSettings = new LocalStorageProvider({\n *   name: 'user-settings',\n *   version: 1\n * });\n *\n * // Write new settings\n * userSettings.write({ theme: 'dark', notifications: false });\n *\n * // Read the current settings\n * const currentSettings = userSettings.read();\n * console.log(currentSettings); // { theme: 'dark', notifications: false }\n * ```\n */\nexport class LocalStorageProvider<T extends JsonValue> {\n  public static readonly version = __package_version__;\n\n  private readonly key__: string;\n  protected readonly logger_;\n\n  constructor(config: LocalStorageProviderConfig) {\n    this.logger_ = createLogger(`local-storage-provider: ${config.name}, v: ${config.schemaVersion}`);\n    this.logger_.logMethodArgs?.('constructor', {config});\n    this.key__ = LocalStorageProvider.getKey(config);\n    LocalStorageProvider.clearPreviousStorageVersions(config);\n  }\n\n  /**\n   * Generates the versioned storage key.\n   * @param meta - An object containing the name and schemaVersion.\n   * @returns The versioned key string.\n   */\n  public static getKey(config: LocalStorageProviderConfig): string {\n    return `${config.name}.v${config.schemaVersion}`;\n  }\n\n  /**\n   * Manages data migration by removing all previous versions of the item.\n   */\n  public static clearPreviousStorageVersions(config: LocalStorageProviderConfig): void {\n    if (config.schemaVersion < 1) return;\n\n    // Iterate from v1 up to the version just before the current one and remove them.\n    for (let i = 0; i < config.schemaVersion; i++) {\n      const oldKey = LocalStorageProvider.getKey({name: config.name, schemaVersion: i});\n      localStorage.removeItem(oldKey);\n    }\n  }\n\n  /**\n   * Checks if a versioned item exists in localStorage for the given configuration.\n   * This static method allows checking for the existence of a specific versioned item\n   * without instantiating the provider.\n   *\n   * @param config - The configuration object containing the name and schemaVersion.\n   * @returns `true` if the item exists in localStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const exists = LocalStorageProvider.has({ name: 'user-form', schemaVersion: 1 });\n   * ```\n   */\n  public static has(config: LocalStorageProviderConfig): boolean {\n    const key = LocalStorageProvider.getKey(config);\n    return localStorage.getItem(key) !== null;\n  }\n\n  /**\n   * Checks if the current versioned item exists in localStorage.\n   *\n   * @returns `true` if the item exists in localStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const provider = new LocalStorageProvider({ name: 'profile', schemaVersion: 2 });\n   * if (provider.has()) {\n   *   // Item exists\n   * }\n   * ```\n   */\n  public has(): boolean {\n    return localStorage.getItem(this.key__) !== null;\n  }\n\n  /**\n   * Reads and parses the value from localStorage.\n   * If the item doesn't exist or is invalid JSON, returns null.\n   */\n  public read(): T | null {\n    let value: string | null = null;\n\n    try {\n      value = localStorage.getItem(this.key__);\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_local_storage_error', {err});\n    }\n\n    if (!value) {\n      this.logger_.logMethod?.('read//no_value');\n      return null;\n    }\n\n    try {\n      const parsedValue = JSON.parse(value) as T;\n      this.logger_.logMethodFull?.('read//value', undefined, {parsedValue});\n      return parsedValue;\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_parse_error', {err});\n      return null;\n    }\n  }\n\n  /**\n   * Serializes and writes a value to localStorage.\n   */\n  public write(value: T): void {\n    this.logger_.logMethodArgs?.('write', {value});\n    let valueStr: string;\n    try {\n      valueStr = JSON.stringify(value);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_stringify_error', {err});\n      throw new Error('write_stringify_error');\n    }\n\n    try {\n      localStorage.setItem(this.key__, valueStr);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_local_storage_error', {err});\n    }\n  }\n\n  /**\n   * Removes the item from localStorage.\n   */\n  public remove(): void {\n    localStorage.removeItem(this.key__);\n  }\n}\n", "import {LocalStorageProvider} from './local-storage.provider.js';\n\nimport type {LocalStorageProviderConfig} from './type.js';\n\n/**\n * Factory function to create a new LocalStorageProvider.\n *\n * @param config - The configuration for the provider.\n * @returns An instance of LocalStorageProvider.\n *\n * @example\n * ```typescript\n * const userSettings = createLocalStorageProvider({\n *   name: 'user-settings',\n *   schemaVersion: 1\n * });\n *\n * // Write new settings\n * userSettings.write({ theme: 'dark', notifications: false });\n *\n * // Read the current settings\n * const currentSettings = userSettings.read();\n * console.log(currentSettings); // { theme: 'dark', notifications: false }\n * ```\n */\nexport function createLocalStorageProvider<T extends JsonValue>(config: LocalStorageProviderConfig): LocalStorageProvider<T> {\n  return new LocalStorageProvider<T>(config);\n}\n"],
+  "mappings": ";;AAAA,OAAQ,iBAAmB,iBAuBpB,IAAM,qBAAN,MAAM,qBAA0C,CACrD,YAAuB,QAAU,QAKjC,YAAY,OAAoC,CAC9C,KAAK,QAAU,aAAa,2BAA2B,OAAO,IAAI,QAAQ,OAAO,aAAa,EAAE,EAChG,KAAK,QAAQ,gBAAgB,cAAe,CAAC,MAAM,CAAC,EACpD,KAAK,MAAQ,sBAAqB,OAAO,MAAM,EAC/C,sBAAqB,6BAA6B,MAAM,CAC1D,CAOA,OAAc,OAAO,OAA4C,CAC/D,MAAO,GAAG,OAAO,IAAI,KAAK,OAAO,aAAa,EAChD,CAKA,OAAc,6BAA6B,OAA0C,CACnF,GAAI,OAAO,cAAgB,EAAG,OAG9B,QAAS,EAAI,EAAG,EAAI,OAAO,cAAe,IAAK,CAC7C,MAAM,OAAS,sBAAqB,OAAO,CAAC,KAAM,OAAO,KAAM,cAAe,CAAC,CAAC,EAChF,aAAa,WAAW,MAAM,CAChC,CACF,CAeA,OAAc,IAAI,OAA6C,CAC7D,MAAM,IAAM,sBAAqB,OAAO,MAAM,EAC9C,OAAO,aAAa,QAAQ,GAAG,IAAM,IACvC,CAeO,KAAe,CACpB,OAAO,aAAa,QAAQ,KAAK,KAAK,IAAM,IAC9C,CAMO,MAAiB,CACtB,IAAI,MAAuB,KAE3B,GAAI,CACF,MAAQ,aAAa,QAAQ,KAAK,KAAK,CACzC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,2BAA4B,CAAC,GAAG,CAAC,CAC9D,CAEA,GAAI,CAAC,MAAO,CACV,KAAK,QAAQ,YAAY,gBAAgB,EACzC,OAAO,IACT,CAEA,GAAI,CACF,MAAM,YAAc,KAAK,MAAM,KAAK,EACpC,KAAK,QAAQ,gBAAgB,cAAe,OAAW,CAAC,WAAW,CAAC,EACpE,OAAO,WACT,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,mBAAoB,CAAC,GAAG,CAAC,EACpD,OAAO,IACT,CACF,CAKO,MAAM,MAAgB,CAC3B,KAAK,QAAQ,gBAAgB,QAAS,CAAC,KAAK,CAAC,EAC7C,IAAI,SACJ,GAAI,CACF,SAAW,KAAK,UAAU,KAAK,CACjC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,wBAAyB,CAAC,GAAG,CAAC,EAC1D,MAAM,IAAI,MAAM,uBAAuB,CACzC,CAEA,GAAI,CACF,aAAa,QAAQ,KAAK,MAAO,QAAQ,CAC3C,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,4BAA6B,CAAC,GAAG,CAAC,CAChE,CACF,CAKO,QAAe,CACpB,aAAa,WAAW,KAAK,KAAK,CACpC,CACF,EC9HO,SAAS,2BAAgD,OAA6D,CAC3H,OAAO,IAAI,qBAAwB,MAAM,CAC3C",
   "names": []
 }

package/dist/type.d.ts

@@ -1,18 +1,15 @@
-export interface StorageMeta {
+/**
+ * Configuration options for a local storage provider.
+ */
+export interface LocalStorageProviderConfig {
     /**
      * The unique name for the storage item.
      */
     name: string;
     /**
-     * The data structure version.
-     * starting from 1 and incrementing by 1 for each new version.
+     * The version of the data structure.
+     * Start from 1 for production, 0 for development mode, and increment by 1 for each new data schema change.
      */
     schemaVersion: number;
 }
-export interface LocalStorageProviderConfig<T extends JsonValue> extends StorageMeta {
-    /**
-     * The default value to use if no value is stored.
-     */
-    defaultValue: T;
-}
 //# sourceMappingURL=type.d.ts.map

package/dist/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,SAAS,CAAE,SAAQ,WAAW;IAClF;;OAEG;IACH,YAAY,EAAE,CAAC,CAAC;CACjB"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@alwatr/local-storage",
   "description": "A modern, simple, and robust solution for managing versioned JSON objects in the browser's `localStorage`. This package provides a clean, class-based API with a factory function to ensure your application's data persistence is safe, maintainable, and future-proof.",
-  "version": "6.3.4",
+  "version": "7.0.1",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "bugs": "https://github.com/Alwatr/nanolib/issues",
   "dependencies": {
-    "@alwatr/logger": "6.0.8"
+    "@alwatr/logger": "6.0.10"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "6.3.4",
+    "@alwatr/nano-build": "6.3.6",
     "@alwatr/prettier-config": "5.0.5",
     "@alwatr/tsconfig-base": "6.0.3",
-    "@alwatr/type-helper": "6.1.4",
-    "@jest/globals": "^30.1.2",
-    "typescript": "^5.9.2"
+    "@alwatr/type-helper": "6.1.5",
+    "@jest/globals": "^30.2.0",
+    "typescript": "^5.9.3"
   },
   "exports": {
     ".": {
@@ -76,5 +76,5 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/main.d.ts",
-  "gitHead": "c013ded43aff3937cf347de4e99125ab807d99e1"
+  "gitHead": "d6abdbdc75d4a2c5e0b3f739c7c3de4193308031"
 }