fix: normalize native storage errors without throwing

[OskarEichler]

Summary

Return existing AsyncStorageError instances, handle null rejection values safely, and classify LegacyStorageException as OtherStorageError.

Compatibility / observable behavior

The factory now returns (rather than throws) an existing AsyncStorageError, as its return type specifies. LegacyStorageException classification changes from Unknown to OtherStorageError.

Related to #1331. This is a focused part of a source review; it does not claim the entire repository is bug-free.

Test Plan

• Actual error factory: baseline throws for null and its own error, and labels LegacyStorageException Unknown; fixed returns the original error, handles null and uses OtherStorageError.
• Upstream yarn build:js, yarn test:ts (6 tasks), yarn test:lint (6 tasks), yarn test:format and git diff --check pass on the combined review checkout.
• No checked-in test/spec files changed. Reproductions were isolated and used synthetic data, not production/user storage.
• The combined 3.1.1 backport passes consumer immutable install/lint, both products' Android Debug and iOS Simulator Debug builds, four production Metro bundles, 13 web targets and four browser-extension targets. Published native framework binaries are unchanged. React Doctor: 100/100.
• Shared-storage testAndroidHostTest, macosArm64Test and iosSimulatorArm64Test pass with Java 21. The first Android run used Java 17 and failed Robolectric's SDK 36/JDK check; rerunning with the project's documented JDK fixed the environment failure without a source workaround.
• Windows/WinRT runtime, signed releases and physical-device behavior have not been verified locally.

[changeset-bot]

🦋 Changeset detected

Latest commit: c708ae7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@react-native-async-storage/async-storage	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[krizzu]

coolio, thanks