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.
• breaking refactor!: use ref() instead of refFromUrl like firebase-js-sdk. See commit
• breaking refactor!: remove toString() modular to match JS SDK. use ref.toString() instead. See commit
• breaking refactor!: remove child(), use ref() instead to match JS. See commit
• breaking refactor!: make ListOptions.pageToken nullable like 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	Error		Mar 27, 2026 11:14am

[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

[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

[russellwheatley]

/gemini summary

[gemini-code-assist]

Summary of Changes

This pull request performs a significant refactor of the storage package to improve alignment with the official firebase-js-sdk. By migrating to TypeScript and adopting a modular API structure, the changes aim to provide a more consistent developer experience while preparing the codebase for future deprecation of the namespaced API. Several breaking changes were introduced to ensure the API surface area matches the web SDK, including renaming key classes and updating method signatures.

Highlights

• TypeScript Migration: Initiated the migration to TypeScript by separating namespaced types into types/namespaced.ts and aligning the modular API with the firebase-js-sdk.
• API Alignment: Renamed StorageReference to Reference and refactored various methods (e.g., ref() instead of refFromUrl(), ref() instead of child()) to match the firebase-js-sdk.
• Breaking Changes: Removed several methods from Reference and Storage classes, moving them to internal types for modularity, and updated ListOptions, ListResult, and task-related types to match the official JS SDK.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Activity

• Pull request created by russellwheatley.
• Vercel deployment failed.
• Automated stale bot warnings posted on Jan 29 and Mar 19.
• Author requested a summary via /gemini command on Mar 27.