Skip to content

v6.1.6

Latest

Choose a tag to compare

@mCodex mCodex released this 06 Nov 14:29

6.1.6 (2026-11-06)

Storage that fails loudly instead of silently. This release makes Android writes durable, verifies that reused Keystore keys match the access policy you asked for, and stops iOS updates from deleting a secret before the replacement is accepted.

No breaking API changes. React Native 0.88.1 is the verified baseline; the New Architecture and react-native-nitro-modules 0.37.x are still required.

Android

  • Builds on AGP 9. The module no longer applies the Kotlin plugin when AGP already registered the kotlin extension, which failed configuration with Cannot add extension with name 'kotlin'. Also covers AGP 10.
  • Writes are durable. Saving, deleting and clearing entries now use a synchronous commit and raise an error when persistence fails. Previously the write was queued with apply() and a killed process could lose the secret without any error.
  • Key policy is verified. When an existing Keystore key is reused, the library checks it against the requested access control: authentication required, invalidation on biometric enrollment, authenticator type and StrongBox. A mismatch throws a message telling you to rotate the key, instead of quietly giving you weaker protection than you asked for.
  • Device lock check fixed. The availability check now uses isDeviceSecure rather than isDeviceLocked, so protected storage is no longer reported as unavailable just because the screen is unlocked.
  • Authenticator policy mapping fixed. Requested biometric and device-credential policies are now translated to the correct Keystore authentication types.
  • Deletes clean up after themselves. deleteItem removes the Keystore key even when the stored record is corrupt or unparsable, and returns false when nothing was removed, so orphaned keys no longer accumulate.
  • Key rotation no longer removes legacy aliases that existing entries still point to.

iOS

  • Updates no longer delete before writing. Keychain entries are updated in place, falling back to an add. A failed write can no longer wipe the last readable copy of a secret.

React hooks

  • skip now cancels in-flight work and clears the state, so a late response cannot overwrite the result.
  • Effects replayed by React Strict Mode now publish their results instead of leaving a hook stuck in isLoading.

Errors

  • cause is passed through the standard Error constructor, so it is a regular non-enumerable cause and survives serialization and tooling that inspects errors.

Expo config plugin

  • Importable as react-native-sensitive-info/app.plugin.js, with type declarations shipped.
  • Plugin options are validated: faceIDPermission must be a string or null, enableNewArchitecture must be a boolean.
  • The plugin no longer overwrites expo.jsEngine.

Security documentation

  • The README and threat model now describe what actually protects your data: the protection level depends on the requested policy and the device, so check the returned securityLevel instead of assuming hardware-backed storage.
  • Documented limits: integrity tags do not prevent replay of an older valid record, entries written by earlier versions stay readable without a tag, and metadata-only reads do not verify the tag.

For contributors

  • TypeScript 7.0.2, Yarn 4.18.1 and React Native 0.88.1 in the example app.
  • New yarn typecheck:tests script; CI checks the library, the tests and the example separately.
  • Release automation now targets main.