@react-native-firebase/storage 21.12.0 → 21.12.1

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [21.12.1](https://github.com/invertase/react-native-firebase/compare/v21.12.0...v21.12.1) (2025-03-22)
+
+### Bug Fixes
+
+- **storage:** Type defs storage ([#8387](https://github.com/invertase/react-native-firebase/issues/8387)) ([12ddc18](https://github.com/invertase/react-native-firebase/commit/12ddc18205a763913a45b2b6962276f80f022f4c))
+
 ## [21.12.0](https://github.com/invertase/react-native-firebase/compare/v21.11.0...v21.12.0) (2025-03-03)
 
 **Note:** Version bump only for package @react-native-firebase/storage

package/lib/modular/index.d.ts

@@ -27,6 +27,7 @@ import Task = FirebaseStorageTypes.Task;
 import ListOptions = FirebaseStorageTypes.ListOptions;
 import SettableMetadata = FirebaseStorageTypes.SettableMetadata;
 import EmulatorMockTokenOptions = FirebaseStorageTypes.EmulatorMockTokenOptions;
+import StringFormat = FirebaseStorageTypes.StringFormat;
 import FirebaseApp = ReactNativeFirebase.FirebaseApp;
 
 export const StringFormat: FirebaseStorageTypes.StringFormat;
@@ -37,10 +38,11 @@ export const TaskState: FirebaseStorageTypes.TaskState;
  * Returns the existing default {@link Storage} instance that is associated with the
  * default {@link FirebaseApp}. The default storage bucket is used. If no instance exists, initializes a new
  * instance with default settings.
- *
+ * @param app -	Firebase app to get FirebaseStorage instance for.
+ * @param bucketUrl - The gs:// url to your Firebase Storage Bucket. If not passed, uses the app's default Storage Bucket.
  * @returns The {@link Storage} instance of the provided app.
  */
-export declare function getStorage(): Storage;
+export declare function getStorage(app?: FirebaseApp, bucketUrl?: string): Storage;
 
 /**
  * Returns the existing default {@link Storage} instance that is associated with the
@@ -99,18 +101,22 @@ export function deleteObject(storageRef: Reference): Promise<void>;
 /**
  * Retrieves the blob at the given reference's location. Throws an error if the object is not found.
  * @param storageRef - The {@link Reference} to the object.
+ * @param maxDownloadSizeBytes - Optional. Maximum size in bytes to retrieve.
  * @returns A promise resolving to the Blob.
  */
-export function getBlob(storageRef: Reference): Promise<Blob>;
+export function getBlob(storageRef: Reference, maxDownloadSizeBytes?: number): Promise<Blob>;
 
 /**
  * Retrieves bytes (up to the specified max size) from an object at the given reference's location.
  * Throws an error if the object is not found or if the size exceeds the maximum allowed.
  * @param storageRef - The {@link Reference} to the object.
- * @param maxDownloadSizeBytes - Maximum size in bytes to retrieve.
+ * @param maxDownloadSizeBytes - Optional. Maximum size in bytes to retrieve.
  * @returns A promise resolving to an ArrayBuffer.
  */
-export function getBytes(storageRef: Reference, maxDownloadSizeBytes: number): Promise<ArrayBuffer>;
+export function getBytes(
+  storageRef: Reference,
+  maxDownloadSizeBytes?: number,
+): Promise<ArrayBuffer>;
 
 /**
  * Retrieves a long-lived download URL for the object at the given reference's location.
@@ -129,12 +135,12 @@ export function getMetadata(storageRef: Reference): Promise<FullMetadata>;
 /**
  * Retrieves a readable stream for the object at the given reference's location. This API is only available in Node.js.
  * @param storageRef - The {@link Reference} to the object.
- * @param maxDownloadSizeBytes - Maximum size in bytes to retrieve.
+ * @param maxDownloadSizeBytes - Optional. Maximum size in bytes to retrieve.
  * @returns A NodeJS ReadableStream.
  */
 export function getStream(
   storageRef: Reference,
-  maxDownloadSizeBytes: number,
+  maxDownloadSizeBytes?: number,
 ): NodeJS.ReadableStream;
 
 /**
@@ -200,7 +206,7 @@ export function uploadBytesResumable(
 export function uploadString(
   storageRef: Reference,
   data: string,
-  format?: 'raw' | 'base64' | 'base64url' | 'data_url',
+  format?: StringFormat,
   metadata?: SettableMetadata,
 ): Task;
 

package/lib/modular/index.js

@@ -90,7 +90,7 @@ export function deleteObject(storageRef) {
  * @returns {Promise<Blob>}
  */
 // eslint-disable-next-line
-export function getBlob(storageRef) {
+export function getBlob(storageRef, maxDownloadSizeBytes) {
   throw new Error('`getBlob()` is not implemented');
 }
 

package/lib/version.js

@@ -1,2 +1,2 @@
 // Generated by genversion.
-module.exports = '21.12.0';
+module.exports = '21.12.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-firebase/storage",
-  "version": "21.12.0",
+  "version": "21.12.1",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "React Native Firebase - React Native Firebase provides native integration with Cloud Storage, providing support to upload and download files directly from your device and from your Firebase Cloud Storage bucket.",
   "main": "lib/index.js",
@@ -29,10 +29,10 @@
     "download"
   ],
   "peerDependencies": {
-    "@react-native-firebase/app": "21.12.0"
+    "@react-native-firebase/app": "21.12.1"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "00a5540bc2d8007858dd01903d8f8c171587a766"
+  "gitHead": "6dc1da978ce5c9cd193a7903b218f7b741c02b9b"
 }