kvozy 0.3.0 → 0.4.0

package/README.md

@@ -22,6 +22,7 @@ This architecture makes it easy to add connectors for other frameworks (Vue, Sve
 - Subscription-based reactivity
 - TypeScript support
 - Required default values for safety
+- Schema versioning and migration support
 - Easy to extend to other frameworks
 
 ## Installation
@@ -87,6 +88,8 @@ Options for creating a BindValue instance.
 - `serialize` (function, required) - Convert value to string: `(value: T) => string`
 - `deserialize` (function, required) - Convert string to value: `(serialized: string) => T`
 - `storage` (Storage, optional) - localStorage, sessionStorage, or undefined for in-memory
+- `version` (string, optional) - Schema version for migration support
+- `migrate` (function, optional) - Migration function: `(oldSerialized: string, oldVersion: string | undefined) => T`
 
 ### useStorage<T>(binding)
 
@@ -322,6 +325,124 @@ const Counter = () => {
 };
 ```
 
+## Schema Versioning and Migration
+
+Kvozy supports schema evolution through optional versioning and migration functions. This allows you to safely update your data structure without breaking existing users' stored data.
+
+### Basic Versioning
+
+```typescript
+const userBinding = bindValue<User>({
+  key: "user",
+  defaultValue: { name: "", age: 0 },
+  serialize: (v) => JSON.stringify(v),
+  deserialize: (s) => JSON.parse(s),
+  version: "1.0.0",
+});
+```
+
+### Migration Example
+
+When you change your data structure, provide a migration function:
+
+```typescript
+// Version 1.0.0: stored as string
+const themeBindingV1 = bindValue<string>({
+  key: "theme",
+  defaultValue: "light",
+  serialize: (v) => v,
+  deserialize: (s) => s,
+});
+
+// Version 2.0.0: store as object with additional metadata
+const themeBindingV2 = bindValue<{ value: string; lastUpdated: number }>({
+  key: "theme",
+  defaultValue: { value: "light", lastUpdated: Date.now() },
+  serialize: (v) => JSON.stringify(v),
+  deserialize: (s) => JSON.parse(s),
+  version: "2.0.0",
+  migrate: (oldSerialized, oldVersion) => {
+    if (oldVersion === "1.0.0" || oldVersion === undefined) {
+      // Migrate from string to object
+      return {
+        value: oldSerialized,
+        lastUpdated: Date.now(),
+      };
+    }
+    // Fallback to default for unknown versions
+    return { value: "light", lastUpdated: Date.now() };
+  },
+});
+```
+
+### Common Migration Patterns
+
+**Add new field:**
+
+```typescript
+migrate: (oldSerialized, oldVersion) => {
+  const oldData = JSON.parse(oldSerialized);
+  return { ...oldData, newField: "default" };
+};
+```
+
+**Rename field:**
+
+```typescript
+migrate: (oldSerialized) => {
+  const oldData = JSON.parse(oldSerialized);
+  return { newName: oldData.oldName };
+};
+```
+
+**Change data type:**
+
+```typescript
+migrate: (oldSerialized) => {
+  const dateString = oldSerialized;
+  return { date: new Date(dateString) };
+};
+```
+
+### Migration Behavior
+
+- When `version` is provided, values are stored with a version prefix
+- On load, if versions mismatch, the `migrate` function is called
+- If `migrate` is undefined or fails, the `defaultValue` is used
+- Old data is automatically cleaned up when using default fallback
+- Migration receives the raw serialized string (not deserialized)
+- Migration failures are handled silently
+
+This ensures your application works even when users have old data formats, and new users get the default structure.
+
+```typescript
+const counterBinding = bindValue<number>({
+  key: 'counter',
+  defaultValue: 0,
+  serialize: (v) => String(v),
+  deserialize: (s) => Number(s),
+});
+
+const Counter = () => {
+  const { value, setValue } = useStorage(counterBinding);
+
+  return (
+    <div>
+      <p>Count: {value}</p>
+      <button onClick={() => setValue(value + 1)}>
+        Increment
+      </button>
+      <button onClick={() => setValue(value - 1)}>
+        Decrement
+      </button>
+      <button onClick={() => setValue(0)}>
+        Reset
+      </button>
+    </div>
+  );
+};
+```
+
 ## Architecture
 
 ### Core: bindValue

package/__compiled__/cjs/src/bindValue.d.ts

@@ -4,6 +4,8 @@ export interface BindValueOptions<T> {
     serialize: (value: T) => string;
     deserialize: (serialized: string) => T;
     storage?: Storage;
+    version?: string;
+    migrate?: (oldSerialized: string, oldVersion: string | undefined) => T;
 }
 export declare class BindValue<T> {
     private options;

package/__compiled__/cjs/src/bindValue.js

@@ -54,8 +54,40 @@ class BindValue {
     if (rawValue === null) {
       return this.options.defaultValue;
     }
+    let oldVersion;
+    let serializedValue;
+    if (rawValue.startsWith("\0")) {
+      const parts = rawValue.split("\0");
+      if (parts.length >= 3) {
+        oldVersion = parts[1];
+        serializedValue = parts.slice(2).join("\0");
+      } else {
+        serializedValue = rawValue;
+      }
+    } else {
+      serializedValue = rawValue;
+    }
+    const currentVersion = this.options.version;
+    if (oldVersion !== currentVersion) {
+      if (this.options.migrate) {
+        try {
+          const migratedValue = this.options.migrate(
+            serializedValue,
+            oldVersion
+          );
+          this.saveToStorage(migratedValue);
+          return migratedValue;
+        } catch {
+          this.storage.removeItem(this.options.key);
+          return this.options.defaultValue;
+        }
+      } else {
+        this.storage.removeItem(this.options.key);
+        return this.options.defaultValue;
+      }
+    }
     try {
-      return this.options.deserialize(rawValue);
+      return this.options.deserialize(serializedValue);
     } catch {
       return this.options.defaultValue;
     }
@@ -63,7 +95,15 @@ class BindValue {
   saveToStorage(value) {
     try {
       const serialized = this.options.serialize(value);
-      this.storage.setItem(this.options.key, serialized);
+      const version = this.options.version;
+      if (version) {
+        this.storage.setItem(
+          this.options.key,
+          `\0${version}\0${serialized}`
+        );
+      } else {
+        this.storage.setItem(this.options.key, serialized);
+      }
     } catch {
     }
   }

package/__compiled__/cjs/src/bindValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"bindValue.js","sources":["../../../../src/bindValue.ts"],"sourcesContent":["export interface BindValueOptions<T> {\n  key: string;\n  defaultValue: T;\n  serialize: (value: T) => string;\n  deserialize: (serialized: string) => T;\n  storage?: Storage;\n}\n\nconst memoryStorage = new Map<string, string>();\n\nconst inMemoryStorage: Storage = {\n  get length() {\n    return memoryStorage.size;\n  },\n  clear() {\n    memoryStorage.clear();\n  },\n  getItem(key: string) {\n    return memoryStorage.get(key) ?? null;\n  },\n  key(index: number) {\n    const keys = Array.from(memoryStorage.keys());\n    return keys[index] ?? null;\n  },\n  removeItem(key: string) {\n    memoryStorage.delete(key);\n  },\n  setItem(key: string, value: string) {\n    memoryStorage.set(key, value);\n  },\n};\n\nexport class BindValue<T> {\n  private value: T;\n  private subscribers: Set<(value: T) => void>;\n  private storage: Storage;\n\n  constructor(private options: BindValueOptions<T>) {\n    this.storage = options.storage ?? inMemoryStorage;\n    this.subscribers = new Set();\n    this.value = this.loadFromStorage();\n  }\n\n  getValue(): T {\n    return this.value;\n  }\n\n  set(newValue: T): void {\n    this.value = newValue;\n    this.saveToStorage(newValue);\n    this.notifySubscribers();\n  }\n\n  subscribe(callback: (value: T) => void): () => void {\n    this.subscribers.add(callback);\n    return () => {\n      this.subscribers.delete(callback);\n    };\n  }\n\n  private loadFromStorage(): T {\n    const rawValue = this.storage.getItem(this.options.key);\n\n    if (rawValue === null) {\n      return this.options.defaultValue;\n    }\n\n    try {\n      return this.options.deserialize(rawValue);\n    } catch {\n      return this.options.defaultValue;\n    }\n  }\n\n  private saveToStorage(value: T): void {\n    try {\n      const serialized = this.options.serialize(value);\n      this.storage.setItem(this.options.key, serialized);\n    } catch {}\n  }\n\n  private notifySubscribers(): void {\n    for (const subscriber of this.subscribers) {\n      subscriber(this.value);\n    }\n  }\n}\n\nexport function bindValue<T>(options: BindValueOptions<T>): BindValue<T> {\n  return new BindValue(options);\n}\n"],"names":[],"mappings":";;;;;AAQA,MAAM,oCAAoB,IAAA;AAE1B,MAAM,kBAA2B;AAAA,EAC/B,IAAI,SAAS;AACX,WAAO,cAAc;AAAA,EACvB;AAAA,EACA,QAAQ;AACN,kBAAc,MAAA;AAAA,EAChB;AAAA,EACA,QAAQ,KAAa;AACnB,WAAO,cAAc,IAAI,GAAG,KAAK;AAAA,EACnC;AAAA,EACA,IAAI,OAAe;AACjB,UAAM,OAAO,MAAM,KAAK,cAAc,MAAM;AAC5C,WAAO,KAAK,KAAK,KAAK;AAAA,EACxB;AAAA,EACA,WAAW,KAAa;AACtB,kBAAc,OAAO,GAAG;AAAA,EAC1B;AAAA,EACA,QAAQ,KAAa,OAAe;AAClC,kBAAc,IAAI,KAAK,KAAK;AAAA,EAC9B;AACF;AAEO,MAAM,UAAa;AAAA,EAKxB,YAAoB,SAA8B;AAJ1C;AACA;AACA;AAEY,SAAA,UAAA;AAClB,SAAK,UAAU,QAAQ,WAAW;AAClC,SAAK,kCAAkB,IAAA;AACvB,SAAK,QAAQ,KAAK,gBAAA;AAAA,EACpB;AAAA,EAEA,WAAc;AACZ,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,UAAmB;AACrB,SAAK,QAAQ;AACb,SAAK,cAAc,QAAQ;AAC3B,SAAK,kBAAA;AAAA,EACP;AAAA,EAEA,UAAU,UAA0C;AAClD,SAAK,YAAY,IAAI,QAAQ;AAC7B,WAAO,MAAM;AACX,WAAK,YAAY,OAAO,QAAQ;AAAA,IAClC;AAAA,EACF;AAAA,EAEQ,kBAAqB;AAC3B,UAAM,WAAW,KAAK,QAAQ,QAAQ,KAAK,QAAQ,GAAG;AAEtD,QAAI,aAAa,MAAM;AACrB,aAAO,KAAK,QAAQ;AAAA,IACtB;AAEA,QAAI;AACF,aAAO,KAAK,QAAQ,YAAY,QAAQ;AAAA,IAC1C,QAAQ;AACN,aAAO,KAAK,QAAQ;AAAA,IACtB;AAAA,EACF;AAAA,EAEQ,cAAc,OAAgB;AACpC,QAAI;AACF,YAAM,aAAa,KAAK,QAAQ,UAAU,KAAK;AAC/C,WAAK,QAAQ,QAAQ,KAAK,QAAQ,KAAK,UAAU;AAAA,IACnD,QAAQ;AAAA,IAAC;AAAA,EACX;AAAA,EAEQ,oBAA0B;AAChC,eAAW,cAAc,KAAK,aAAa;AACzC,iBAAW,KAAK,KAAK;AAAA,IACvB;AAAA,EACF;AACF;AAEO,SAAS,UAAa,SAA4C;AACvE,SAAO,IAAI,UAAU,OAAO;AAC9B;;;"}
+{"version":3,"file":"bindValue.js","sources":["../../../../src/bindValue.ts"],"sourcesContent":["export interface BindValueOptions<T> {\n  key: string;\n  defaultValue: T;\n  serialize: (value: T) => string;\n  deserialize: (serialized: string) => T;\n  storage?: Storage;\n  version?: string;\n  migrate?: (oldSerialized: string, oldVersion: string | undefined) => T;\n}\n\nconst memoryStorage = new Map<string, string>();\n\nconst inMemoryStorage: Storage = {\n  get length() {\n    return memoryStorage.size;\n  },\n  clear() {\n    memoryStorage.clear();\n  },\n  getItem(key: string) {\n    return memoryStorage.get(key) ?? null;\n  },\n  key(index: number) {\n    const keys = Array.from(memoryStorage.keys());\n    return keys[index] ?? null;\n  },\n  removeItem(key: string) {\n    memoryStorage.delete(key);\n  },\n  setItem(key: string, value: string) {\n    memoryStorage.set(key, value);\n  },\n};\n\nexport class BindValue<T> {\n  private value: T;\n  private subscribers: Set<(value: T) => void>;\n  private storage: Storage;\n\n  constructor(private options: BindValueOptions<T>) {\n    this.storage = options.storage ?? inMemoryStorage;\n    this.subscribers = new Set();\n    this.value = this.loadFromStorage();\n  }\n\n  getValue(): T {\n    return this.value;\n  }\n\n  set(newValue: T): void {\n    this.value = newValue;\n    this.saveToStorage(newValue);\n    this.notifySubscribers();\n  }\n\n  subscribe(callback: (value: T) => void): () => void {\n    this.subscribers.add(callback);\n    return () => {\n      this.subscribers.delete(callback);\n    };\n  }\n\n  private loadFromStorage(): T {\n    const rawValue = this.storage.getItem(this.options.key);\n\n    if (rawValue === null) {\n      return this.options.defaultValue;\n    }\n\n    let oldVersion: string | undefined;\n    let serializedValue: string;\n\n    if (rawValue.startsWith(\"\\x00\")) {\n      const parts = rawValue.split(\"\\x00\");\n      if (parts.length >= 3) {\n        oldVersion = parts[1];\n        serializedValue = parts.slice(2).join(\"\\x00\");\n      } else {\n        serializedValue = rawValue;\n      }\n    } else {\n      serializedValue = rawValue;\n    }\n\n    const currentVersion = this.options.version;\n\n    if (oldVersion !== currentVersion) {\n      if (this.options.migrate) {\n        try {\n          const migratedValue = this.options.migrate(\n            serializedValue,\n            oldVersion,\n          );\n          this.saveToStorage(migratedValue);\n          return migratedValue;\n        } catch {\n          this.storage.removeItem(this.options.key);\n          return this.options.defaultValue;\n        }\n      } else {\n        this.storage.removeItem(this.options.key);\n        return this.options.defaultValue;\n      }\n    }\n\n    try {\n      return this.options.deserialize(serializedValue);\n    } catch {\n      return this.options.defaultValue;\n    }\n  }\n\n  private saveToStorage(value: T): void {\n    try {\n      const serialized = this.options.serialize(value);\n      const version = this.options.version;\n\n      if (version) {\n        this.storage.setItem(\n          this.options.key,\n          `\\x00${version}\\x00${serialized}`,\n        );\n      } else {\n        this.storage.setItem(this.options.key, serialized);\n      }\n    } catch {}\n  }\n\n  private notifySubscribers(): void {\n    for (const subscriber of this.subscribers) {\n      subscriber(this.value);\n    }\n  }\n}\n\nexport function bindValue<T>(options: BindValueOptions<T>): BindValue<T> {\n  return new BindValue(options);\n}\n"],"names":[],"mappings":"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"}

package/__compiled__/esm/src/bindValue.d.mts

@@ -4,6 +4,8 @@ export interface BindValueOptions<T> {
     serialize: (value: T) => string;
     deserialize: (serialized: string) => T;
     storage?: Storage;
+    version?: string;
+    migrate?: (oldSerialized: string, oldVersion: string | undefined) => T;
 }
 export declare class BindValue<T> {
     private options;

package/__compiled__/esm/src/bindValue.mjs

@@ -52,8 +52,40 @@ class BindValue {
     if (rawValue === null) {
       return this.options.defaultValue;
     }
+    let oldVersion;
+    let serializedValue;
+    if (rawValue.startsWith("\0")) {
+      const parts = rawValue.split("\0");
+      if (parts.length >= 3) {
+        oldVersion = parts[1];
+        serializedValue = parts.slice(2).join("\0");
+      } else {
+        serializedValue = rawValue;
+      }
+    } else {
+      serializedValue = rawValue;
+    }
+    const currentVersion = this.options.version;
+    if (oldVersion !== currentVersion) {
+      if (this.options.migrate) {
+        try {
+          const migratedValue = this.options.migrate(
+            serializedValue,
+            oldVersion
+          );
+          this.saveToStorage(migratedValue);
+          return migratedValue;
+        } catch {
+          this.storage.removeItem(this.options.key);
+          return this.options.defaultValue;
+        }
+      } else {
+        this.storage.removeItem(this.options.key);
+        return this.options.defaultValue;
+      }
+    }
     try {
-      return this.options.deserialize(rawValue);
+      return this.options.deserialize(serializedValue);
     } catch {
       return this.options.defaultValue;
     }
@@ -61,7 +93,15 @@ class BindValue {
   saveToStorage(value) {
     try {
       const serialized = this.options.serialize(value);
-      this.storage.setItem(this.options.key, serialized);
+      const version = this.options.version;
+      if (version) {
+        this.storage.setItem(
+          this.options.key,
+          `\0${version}\0${serialized}`
+        );
+      } else {
+        this.storage.setItem(this.options.key, serialized);
+      }
     } catch {
     }
   }

package/__compiled__/esm/src/bindValue.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bindValue.mjs","sources":["../../../../src/bindValue.ts"],"sourcesContent":["export interface BindValueOptions<T> {\n  key: string;\n  defaultValue: T;\n  serialize: (value: T) => string;\n  deserialize: (serialized: string) => T;\n  storage?: Storage;\n}\n\nconst memoryStorage = new Map<string, string>();\n\nconst inMemoryStorage: Storage = {\n  get length() {\n    return memoryStorage.size;\n  },\n  clear() {\n    memoryStorage.clear();\n  },\n  getItem(key: string) {\n    return memoryStorage.get(key) ?? null;\n  },\n  key(index: number) {\n    const keys = Array.from(memoryStorage.keys());\n    return keys[index] ?? null;\n  },\n  removeItem(key: string) {\n    memoryStorage.delete(key);\n  },\n  setItem(key: string, value: string) {\n    memoryStorage.set(key, value);\n  },\n};\n\nexport class BindValue<T> {\n  private value: T;\n  private subscribers: Set<(value: T) => void>;\n  private storage: Storage;\n\n  constructor(private options: BindValueOptions<T>) {\n    this.storage = options.storage ?? inMemoryStorage;\n    this.subscribers = new Set();\n    this.value = this.loadFromStorage();\n  }\n\n  getValue(): T {\n    return this.value;\n  }\n\n  set(newValue: T): void {\n    this.value = newValue;\n    this.saveToStorage(newValue);\n    this.notifySubscribers();\n  }\n\n  subscribe(callback: (value: T) => void): () => void {\n    this.subscribers.add(callback);\n    return () => {\n      this.subscribers.delete(callback);\n    };\n  }\n\n  private loadFromStorage(): T {\n    const rawValue = this.storage.getItem(this.options.key);\n\n    if (rawValue === null) {\n      return this.options.defaultValue;\n    }\n\n    try {\n      return this.options.deserialize(rawValue);\n    } catch {\n      return this.options.defaultValue;\n    }\n  }\n\n  private saveToStorage(value: T): void {\n    try {\n      const serialized = this.options.serialize(value);\n      this.storage.setItem(this.options.key, serialized);\n    } catch {}\n  }\n\n  private notifySubscribers(): void {\n    for (const subscriber of this.subscribers) {\n      subscriber(this.value);\n    }\n  }\n}\n\nexport function bindValue<T>(options: BindValueOptions<T>): BindValue<T> {\n  return new BindValue(options);\n}\n"],"names":[],"mappings":";;;AAQA,MAAM,oCAAoB,IAAA;AAE1B,MAAM,kBAA2B;AAAA,EAC/B,IAAI,SAAS;AACX,WAAO,cAAc;AAAA,EACvB;AAAA,EACA,QAAQ;AACN,kBAAc,MAAA;AAAA,EAChB;AAAA,EACA,QAAQ,KAAa;AACnB,WAAO,cAAc,IAAI,GAAG,KAAK;AAAA,EACnC;AAAA,EACA,IAAI,OAAe;AACjB,UAAM,OAAO,MAAM,KAAK,cAAc,MAAM;AAC5C,WAAO,KAAK,KAAK,KAAK;AAAA,EACxB;AAAA,EACA,WAAW,KAAa;AACtB,kBAAc,OAAO,GAAG;AAAA,EAC1B;AAAA,EACA,QAAQ,KAAa,OAAe;AAClC,kBAAc,IAAI,KAAK,KAAK;AAAA,EAC9B;AACF;AAEO,MAAM,UAAa;AAAA,EAKxB,YAAoB,SAA8B;AAJ1C;AACA;AACA;AAEY,SAAA,UAAA;AAClB,SAAK,UAAU,QAAQ,WAAW;AAClC,SAAK,kCAAkB,IAAA;AACvB,SAAK,QAAQ,KAAK,gBAAA;AAAA,EACpB;AAAA,EAEA,WAAc;AACZ,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,UAAmB;AACrB,SAAK,QAAQ;AACb,SAAK,cAAc,QAAQ;AAC3B,SAAK,kBAAA;AAAA,EACP;AAAA,EAEA,UAAU,UAA0C;AAClD,SAAK,YAAY,IAAI,QAAQ;AAC7B,WAAO,MAAM;AACX,WAAK,YAAY,OAAO,QAAQ;AAAA,IAClC;AAAA,EACF;AAAA,EAEQ,kBAAqB;AAC3B,UAAM,WAAW,KAAK,QAAQ,QAAQ,KAAK,QAAQ,GAAG;AAEtD,QAAI,aAAa,MAAM;AACrB,aAAO,KAAK,QAAQ;AAAA,IACtB;AAEA,QAAI;AACF,aAAO,KAAK,QAAQ,YAAY,QAAQ;AAAA,IAC1C,QAAQ;AACN,aAAO,KAAK,QAAQ;AAAA,IACtB;AAAA,EACF;AAAA,EAEQ,cAAc,OAAgB;AACpC,QAAI;AACF,YAAM,aAAa,KAAK,QAAQ,UAAU,KAAK;AAC/C,WAAK,QAAQ,QAAQ,KAAK,QAAQ,KAAK,UAAU;AAAA,IACnD,QAAQ;AAAA,IAAC;AAAA,EACX;AAAA,EAEQ,oBAA0B;AAChC,eAAW,cAAc,KAAK,aAAa;AACzC,iBAAW,KAAK,KAAK;AAAA,IACvB;AAAA,EACF;AACF;AAEO,SAAS,UAAa,SAA4C;AACvE,SAAO,IAAI,UAAU,OAAO;AAC9B;"}
+{"version":3,"file":"bindValue.mjs","sources":["../../../../src/bindValue.ts"],"sourcesContent":["export interface BindValueOptions<T> {\n  key: string;\n  defaultValue: T;\n  serialize: (value: T) => string;\n  deserialize: (serialized: string) => T;\n  storage?: Storage;\n  version?: string;\n  migrate?: (oldSerialized: string, oldVersion: string | undefined) => T;\n}\n\nconst memoryStorage = new Map<string, string>();\n\nconst inMemoryStorage: Storage = {\n  get length() {\n    return memoryStorage.size;\n  },\n  clear() {\n    memoryStorage.clear();\n  },\n  getItem(key: string) {\n    return memoryStorage.get(key) ?? null;\n  },\n  key(index: number) {\n    const keys = Array.from(memoryStorage.keys());\n    return keys[index] ?? null;\n  },\n  removeItem(key: string) {\n    memoryStorage.delete(key);\n  },\n  setItem(key: string, value: string) {\n    memoryStorage.set(key, value);\n  },\n};\n\nexport class BindValue<T> {\n  private value: T;\n  private subscribers: Set<(value: T) => void>;\n  private storage: Storage;\n\n  constructor(private options: BindValueOptions<T>) {\n    this.storage = options.storage ?? inMemoryStorage;\n    this.subscribers = new Set();\n    this.value = this.loadFromStorage();\n  }\n\n  getValue(): T {\n    return this.value;\n  }\n\n  set(newValue: T): void {\n    this.value = newValue;\n    this.saveToStorage(newValue);\n    this.notifySubscribers();\n  }\n\n  subscribe(callback: (value: T) => void): () => void {\n    this.subscribers.add(callback);\n    return () => {\n      this.subscribers.delete(callback);\n    };\n  }\n\n  private loadFromStorage(): T {\n    const rawValue = this.storage.getItem(this.options.key);\n\n    if (rawValue === null) {\n      return this.options.defaultValue;\n    }\n\n    let oldVersion: string | undefined;\n    let serializedValue: string;\n\n    if (rawValue.startsWith(\"\\x00\")) {\n      const parts = rawValue.split(\"\\x00\");\n      if (parts.length >= 3) {\n        oldVersion = parts[1];\n        serializedValue = parts.slice(2).join(\"\\x00\");\n      } else {\n        serializedValue = rawValue;\n      }\n    } else {\n      serializedValue = rawValue;\n    }\n\n    const currentVersion = this.options.version;\n\n    if (oldVersion !== currentVersion) {\n      if (this.options.migrate) {\n        try {\n          const migratedValue = this.options.migrate(\n            serializedValue,\n            oldVersion,\n          );\n          this.saveToStorage(migratedValue);\n          return migratedValue;\n        } catch {\n          this.storage.removeItem(this.options.key);\n          return this.options.defaultValue;\n        }\n      } else {\n        this.storage.removeItem(this.options.key);\n        return this.options.defaultValue;\n      }\n    }\n\n    try {\n      return this.options.deserialize(serializedValue);\n    } catch {\n      return this.options.defaultValue;\n    }\n  }\n\n  private saveToStorage(value: T): void {\n    try {\n      const serialized = this.options.serialize(value);\n      const version = this.options.version;\n\n      if (version) {\n        this.storage.setItem(\n          this.options.key,\n          `\\x00${version}\\x00${serialized}`,\n        );\n      } else {\n        this.storage.setItem(this.options.key, serialized);\n      }\n    } catch {}\n  }\n\n  private notifySubscribers(): void {\n    for (const subscriber of this.subscribers) {\n      subscriber(this.value);\n    }\n  }\n}\n\nexport function bindValue<T>(options: BindValueOptions<T>): BindValue<T> {\n  return new BindValue(options);\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kvozy",
   "type": "commonjs",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "types": "./__compiled__/cjs/src/index.d.ts",
   "module": "./__compiled__/esm/src/index.mjs",
   "main": "./__compiled__/cjs/src/index.js",