reactfire 4.0.0-exp.e80fc49 → 4.0.0-exp.eb1428b

package/README.md

@@ -3,12 +3,6 @@
 Hooks, Context Providers, and Components that make it easy to interact with
 Firebase.
 
----
-
-> **WARNING**: This branch is the work in progress for version 4 of ReactFire. [You can find version 3 here](https://github.com/firebaseextended/reactfire/tree/v3), if you're looking for documentation or to contribute to stable.
-
----
-
 ## What is ReactFire?
 
 - **Easy realtime updates for your function components** - Hooks
@@ -21,12 +15,12 @@ Firebase.
 
 ```bash
 # npm
-npm install --save reactfire@exp firebase@exp
+npm install --save firebase reactfire
 
 # or
 
 # yarn
-yarn add reactfire@exp firebase@exp
+yarn add firebase reactfire
 ```
 
 Depending on your targeted platforms you may need to install polyfills. The most commonly needed will be [globalThis](https://caniuse.com/#search=globalThis) and [Proxy](https://caniuse.com/#search=Proxy).
@@ -34,7 +28,6 @@ Depending on your targeted platforms you may need to install polyfills. The most
 ## Docs
 
 - [**Quickstart**](./docs/quickstart.md)
-  - Advanced: If you're using Concurrent Mode, check out the [Concurrent Mode quickstart](./docs/quickstart-concurrent-mode.md)
 - [**Common Use Cases**](./docs/use.md)
 - [**API Reference**](./docs/reference)
 - [**v3 -> v4 Upgrade Guide**](./docs/upgrade-guide.md)
@@ -90,10 +83,6 @@ render(
 
 ---
 
-> If you're looking for docs for the _deprecated_ ReactFire v1 (the one that
-> uses mixins), click
-> [here](https://github.com/FirebaseExtended/reactfire/tree/v1.0.0)
-
 ## Status
 
 ![Status: Experimental](https://img.shields.io/badge/Status-Experimental-blue)
@@ -102,7 +91,17 @@ This repository is maintained by Googlers but is not a supported Firebase produc
 
 ### Extra Experimental [concurrent mode](https://reactjs.org/docs/concurrent-mode-suspense.html) features
 
+These features are marked as *extra experimental* because they use experimental React features that [will not be stable until sometime after React 18 is released](https://github.com/reactwg/react-18/discussions/47#:~:text=Likely%20after%20React%2018.0%3A%20Suspense%20for%20Data%20Fetching).
+
 - **Loading states handled by `<Suspense>`** - ReactFire's hooks throw promises
-  that Suspense can catch. No more `isLoaded ?...` - let React
-  [handle it for you](https://reactjs.org/docs/concurrent-mode-suspense.html).
+  that Suspense can catch. Let React
+  [handle loading states for you](https://reactjs.org/docs/concurrent-mode-suspense.html).
 - **Automatically instrument your `Suspense` load times** - Need to automatically instrument your `Suspense` load times with [RUM](https://firebase.google.com/docs/perf-mon)? Use `<SuspenseWithPerf />`.
+
+Enable concurrent mode features by following the [concurrent mode setup guide](https://reactjs.org/docs/concurrent-mode-adoption.html#installation) and then setting the `suspense` prop in `FirebaseAppProvider`:
+
+```jsx
+<FirebaseAppProvider firebaseConfig={firebaseConfig} suspense={true}>
+```
+
+See concurrent mode code samples in [example/withSuspense](https://github.com/FirebaseExtended/reactfire/tree/main/example/withSuspense)

package/dist/SuspenseSubject.d.ts

@@ -12,7 +12,7 @@ export declare class SuspenseSubject<T> extends Subject<T> {
     private _resolveFirstEmission;
     constructor(innerObservable: Observable<T>, _timeoutWindow: number);
     get hasValue(): boolean;
-    get value(): T | undefined;
+    get value(): T;
     get firstEmission(): Promise<void>;
     private _next;
     private _reset;

package/dist/functions.d.ts

@@ -0,0 +1,12 @@
+import { ReactFireOptions, ObservableStatus } from './';
+import type { HttpsCallableOptions } from 'firebase/functions';
+/**
+ * Calls a callable function.
+ *
+ * @param functionName - The name of the function to call
+ * @param options
+ */
+export declare function useCallableFunctionResponse<RequestData, ResponseData>(functionName: string, options?: ReactFireOptions<ResponseData> & {
+    httpsCallableOptions?: HttpsCallableOptions;
+    data?: RequestData;
+}): ObservableStatus<ResponseData>;

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export * from './auth';
 export * from './database';
 export * from './firebaseApp';
 export * from './firestore';
+export * from './functions';
 export * from './performance';
 export * from './remote-config';
 export * from './storage';