Introduce a typed error surface and refactor async/hooks/storage plumbing for better safety and tree-shaking.

Key changes:
- Add src/errors.ts: typed SensitiveInfoError subclasses, ErrorCode constants, adapters (toSensitiveInfoError) and predicate helpers.
- Wrap native calls in src/core/storage.ts to throw/return typed errors, and add rotateKeys and getKeyVersion; expose a SensitiveInfo namespace and named exports for tree-shaking.
- Add useAsync abstraction (src/hooks/useAsync.ts) and refactor hooks (useHasSecret, useSecretItem, useSecurityAvailability) to use it. Add a new useKeyRotation hook.
- Update hooks index exports to include new hooks and types.
- Rework internal helpers: normalizeOptions improved and internal/errors re-exports updated to forward to the new typed helpers.
- Add strong types file src/sensitive-info.nitro.ts and update top-level exports in src/index.ts to include errors and new storage APIs.
- Add unit tests for errors and public index surface (src/__tests__/errors.test.ts, src/__tests__/index.test.ts).
- package.json: add "exports" map and sideEffects:false, and align react-dom version.

These changes modernize error handling, centralize async lifecycle management for hooks, and add support for key rotation while keeping backward-compatible exports.

Introduce versioned key rotation support and related developer ergonomics: add native stubs (rotateKeys, getKeyVersion) on Android, document the new useKeyRotation hook and imperative rotateKeys/getKeyVersion APIs, and wire a KeyRotationPanel into the example app. Update README and CHANGELOG for 6.0.0-rc.13, add hook docs in HOOKS.md, and include new tests for key rotation/hooks. Remove .prettierrc, apply consistent formatting/style updates across examples and components (node:path imports, minor TSX/JS formatting), and adjust expo/config plugin and other config files.

…nd update related components

- Added HMAC-SHA256 integrity tags to entries, enhancing tamper detection.
- Introduced AES-GCM AAD for additional security against cross-entry attacks.
- Implemented zeroization of plaintext buffers post-use on both platforms.
- Updated error handling to include IntegrityViolationError for tampering cases.
- Enhanced metadata structure to include integrity tags and AAD usage flags.
- Updated tests to verify integrity tag propagation and error handling for integrity violations.

Co-authored-by: Copilot <copilot@github.com>

Introduce a shared useAsyncQuery hook to centralize stable-options → skip → memoize → useAsync semantics and ensure consistent abort/skip behavior across hooks. Refactor useHasSecret and useSecretItem to use the new hook. Add deterministic test fixtures (buildTestItem/buildTestMetadata) and update unit tests to use them. Adjust error imports to prefer the public errors surface and remove legacy re-exports from src/internal/errors.ts. Bump package version to 6.0.0-rc.13. Files added: src/hooks/useAsyncQuery.ts, src/__tests__/__mocks__/fixtures.ts; files updated: multiple hooks, tests, and internal error helpers.

Co-authored-by: Copilot <copilot@github.com>

…uery integration

Co-authored-by: Copilot <copilot@github.com>

….json and nitro.json

…used components

- Introduced AccessControlCard for managing access modes with visual feedback.
- Added DiagnosticsCard to display security availability and key version information.
- Removed ActionButton, ActionsPanel, Card, Header, KeyRotationPanel, ModeSelector, SecretForm, SecretsList, and formatError utility as they were no longer needed.
- Updated constants to streamline access modes and added biometric prompt configuration.
- Enhanced StorageCard to manage secure storage with improved UI and functionality.
- Introduced Section and StatusLine components for better layout and error handling.
- Updated TypeScript configuration to include hooks and errors paths for improved module resolution.

Co-authored-by: Copilot <copilot@github.com>

…or subpath imports

Split option handling into readOptions/writeOptions via resolveOptions and update components to use them (Storage, KeyRotation, Diagnostics, AccessControl). Add reusable Button and Footer components and a useAsyncAction hook. Improve Storage UI: reveal-with-TTL, async actions for save/reveal/delete/clear, item list with badges, and better loading/status handling. Adjust AccessControl to show capability labels and fallback state for unavailable biometry. Update KeyRotation/Diagnostics to use imperative getKeyVersion and avoid unnecessary auth prompts. Replace manual memset_s zeroization with Data.resetBytes on iOS. Tweak tsconfig for bundler module resolution and stricter checks. Also add GITHUB_URL constant and minor style/UX polish across the example app.

Add extensive JSDoc, examples and type refinements across the library. Introduces a SensitiveInfoApi facade, documents all core APIs (setItem/getItem/hasItem/deleteItem/getAllItems/clearService/getSupportedSecurityLevels/rotateKeys/getKeyVersion) with params, returns, errors and examples. Expands and documents typed error classes and predicates in errors.ts, improves hook-related types and helpers (HookError, AsyncState, mutation results) in hooks/types.ts, clarifies useSecureStorage usage docs, and enriches the Nitro interface and payload types in sensitive-info.nitro.ts (SecurityLevel, AccessControl, request/response shapes, StorageMetadata). Also updates package root docs and quick-start in index.ts. Changes are primarily documentation and typing improvements; no behavioral changes intended.

Add comprehensive JSDoc to useSecret and useSecretItem to clarify parameters, return shapes, and behavior. Highlights: useSecret now documents that it combines a read subscription with saveSecret/deleteSecret that refresh the cache on success and that mutation helpers return a discriminated HookMutationResult (do not throw). useSecretItem docs explain includeValue:false (metadata-only, avoids iOS biometric prompt), that NotFoundError is surfaced as data:null, and include usage examples and @see references. No functional changes — only documentation improvements.

Add comprehensive JSDoc comments to useHasSecret, useKeyRotation, useSecureOperation, and useSecurityAvailability. The updates document params, return types, remarks, examples, and related links; clarify behaviors such as avoiding biometric prompts when only checking existence, lazy vs eager key rotation and its biometric implications, execute() swallowing errors and exposing AuthenticationCanceledError as a cause, and caching/refetch semantics for security capability queries. Improves developer guidance and API discoverability.