refactor(storage)!: migrate to TypeScript and match firebase-js-sdk API

[russellwheatley]

Description

• First TS migration to completely separate namespaced types from modular. namespaced types live in types/namespaced.ts and are almost identical to previous index.d.ts. This make it a really easy clean up when we switch off namespaced.
• Matches firebase-js-sdk as close as possible now which includes below noted breaking changes:

Breaking Changes

• breaking rename StorageReference to Reference to match firebase-js-sdk. See commit
• breaking remove methods from Reference and put on internal Reference type for modular See commit
• breaking remove methods from Storage and put on an internal Storage type for modular. See commit
• breaking Type Reference is now StorageReference. [See commit]
• breaking rename StorageReference class to Reference. See commit
• breaking ListOptions updated to match firebase-js-sdk. See commit
• breaking update ListResult to match firebase-js-sdk. See commit
• breaking match SettableMetadata, UploadMetadata & FullMetadata. Also using NativeFirebaseError rather than Error. See commit
• breaking updated TaskState and TaskEvent types to match firebase-js-sdk. See commit
• breaking remove storage.statics.* types from modular. Need to import individually. See commit
• breaking Task related API has been moved to match firebase-js-sdk. See commit.

Related issues

Release Summary

Checklist

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
  • Yes
• My change supports the following platforms;
  • Android
  • iOS
  • Other (macOS, web)
• My change includes tests;
  • e2e tests added or updated in packages/\*\*/e2e
  • jest tests added or updated in packages/\*\*/__tests__
• I have updated TypeScript types that are affected by my change.
• This is a breaking change;
  • Yes
  • No

Test Plan

---

Think react-native-firebase is great? Please consider supporting the project with any of the below:

• 👉 Star this repo on GitHub ⭐️
• 👉 Follow React Native Firebase and Invertase on Twitter

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
react-native-firebase	Ready	Preview, Comment	Feb 16, 2026 6:22pm

[github-actions]

Hello 👋, this PR has been opened for more than 14 days with no activity on it.

If you think this is a mistake please comment and ping a maintainer to get this merged ASAP! Thanks for contributing!

You have 7 days until this gets closed automatically