Merge pull request #8 from JoaoPauloCMarra/v0.2.0

V0.3.0

Author: JoaoPauloCMarra

.github/workflows/ci.yml

@@ -13,15 +13,15 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: latest
+          bun-version: 1.3.9
 
       - name: Cache dependencies
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: |
             ~/.bun/install/cache
@@ -41,9 +41,10 @@ jobs:
         run: bun run test
 
       - name: Run JavaScript tests with coverage
-        run: |
-          cd packages/react-native-nitro-storage
-          bun run test:coverage
+        run: bun run test:coverage
+
+      - name: Run benchmark regression checks
+        run: bun run benchmark
 
       - name: Setup CMake (for C++ tests)
         run: |

CHANGELOG.md

@@ -4,6 +4,62 @@ All notable changes to this project are documented in this file.
 
 The format follows Keep a Changelog and the project adheres to SemVer.
 
+## 0.3.0 - 2026-02-15
+
+### Added
+- Add `useStorageSelector(item, selector, isEqual?)` to reduce rerenders from unrelated object updates.
+- Add opt-in `coalesceSecureWrites` and per-item `readCache` controls in `createStorageItem` config.
+- Add benchmark regression gate (`benchmark` task/script) and wire it into CI and publish checks.
+
+### Changed
+- Switch default serialization to a primitive fast path for primitives while preserving JSON compatibility for objects and legacy values.
+- Replace broad listener fan-out with key-indexed registries and automatic pruning for memory/native/web paths.
+- Rework Turbo task graph so `build` depends on `codegen`, `test`/`typecheck` run from source, and `codegen` can be cached.
+
+### Fixed
+- Route native batch calls through true adapter-level batch APIs (HybridStorage + iOS/Android adapters) instead of per-key loops.
+- Add read-through cache invalidation on scoped/key change events and native/web clear paths.
+
+## 0.2.1 - 2026-02-15
+
+### Added
+- Add explicit package `exports` for ESM/CJS/react-native/web resolution.
+
+### Fixed
+- Preserve validation and TTL semantics in batch APIs by falling back to per-item paths when needed.
+- Preserve item-level semantics in transaction `setItem`/`removeItem` by using item methods directly.
+- Decode native batch missing values correctly to avoid empty-string ambiguity on iOS/Android C++ bindings.
+- Avoid duplicate observer updates on native/web `setBatch` paths.
+- Scope iOS disk storage to a dedicated UserDefaults suite and avoid clearing unrelated app defaults.
+- Use a package-specific Android master-key alias for encrypted storage initialization and recovery.
+- Expo config plugin now preserves existing `NSFaceIDUsageDescription` values.
+- Expo config plugin makes Android biometric permissions opt-in.
+
+### Changed
+- Raise `react` peer dependency floor to `>=18.2.0`.
+- Update CI workflow action versions and Bun runtime pin to latest stable releases.
+
+## 0.2.0 - 2026-02-15
+
+### Added
+- Export `migrateFromMMKV` from the package root entrypoint.
+- Add dedicated web storage tests and include `index.web.ts` in coverage collection.
+- Add `runTransaction(scope, fn)` with rollback on thrown errors.
+- Add versioned migration APIs: `registerMigration` and `migrateToLatest`.
+- Add schema-aware storage options: `validate` and `onValidationError`.
+- Add per-item TTL support via `expiration.ttlMs`.
+
+### Fixed
+- Validate batch operation scope to prevent mixed-scope usage.
+- Avoid duplicate native remove calls in `removeBatch`.
+- Clear cached item values on `delete()` to prevent stale reads (native and web).
+
+### Changed
+- Standardize internal package scripts and README contributor commands to Bun/Bunx.
+- Remove the Turbo `test` outputs config to avoid warnings on non-coverage test runs.
+- Expand README with complete API behavior/throws documentation.
+- Strengthen native and web test coverage for validation, TTL, migrations, and transactions.
+
 ## 0.1.4 - 2026-02-09
 
 ### Added