Skip to content

Commit ee47d1e

Browse files
authored
v3.0.1
* fix(types): update see links to point to base docs site * fix(docs): update see links to point to base docs site * fix(docs): update README to include old versions section instead of note about `next`
1 parent 489be8c commit ee47d1e

11 files changed

+63
-61
lines changed

README.md

+5-3
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ The [Material Example](https://github.com/prescottprue/react-redux-firebase/tree
2323

2424
* Out of the box support for authentication (with auto load user profile)
2525
* Full Firebase Platform Support Including Real Time Database, Firestore, and Storage
26-
* Automatic binding/unbinding of listeners through React Higher Order Components (`firebaseConnect` and `firestoreConnect`)
26+
* Automatic binding/unbinding of listeners through React Hooks (`useFirebaseConnect`, `useFirestoreConnect`) or Higher Order Components (`firebaseConnect` and `firestoreConnect`)
2727
* [Population capability](http://react-redux-firebase.com/docs/populate) (similar to mongoose's `populate` or SQL's `JOIN`)
2828
* Support small data ( using `value` ) or large datasets ( using `child_added`, `child_removed`, `child_changed` )
2929
* Multiple queries types supported including `orderByChild`, `orderByKey`, `orderByValue`, `orderByPriority`, `limitToLast`, `limitToFirst`, `startAt`, `endAt`, `equalTo`
@@ -33,8 +33,6 @@ The [Material Example](https://github.com/prescottprue/react-redux-firebase/tree
3333

3434
## Installation
3535

36-
Interested in support for [`react-redux@^6`](https://github.com/reduxjs/react-redux) or the [new react context API](https://reactjs.org/docs/context.html)? Checkout [the `next` branch which contains the next upcoming major version](https://github.com/prescottprue/react-redux-firebase/tree/next) (installed through `npm i --save react-redux-firebase@next`).
37-
3836
```bash
3937
npm install --save react-redux-firebase
4038
```
@@ -43,6 +41,10 @@ This assumes you are using [npm](https://www.npmjs.com/) as your package manager
4341

4442
If you're not, you can access the library on [unpkg](https://unpkg.com/redux-firestore@latest/dist/redux-firestore.min.js), download it, or point your package manager to it. Theres more on this in the [Builds section below](#builds).
4543

44+
### Older Versions
45+
46+
Interested in support for versions of [`react-redux`](https://github.com/reduxjs/react-redux) before v6 or the [new react context API](https://reactjs.org/docs/context.html)? Checkout the `v2.*.*` versions (installed through `npm i --save react-redux-firebase^@2.5.0`).
47+
4648
## Use
4749

4850
Include `firebaseReducer` (reducer) while creating your redux store then pass dispatch and your firebase instance to `ReactReduxFirebaseProvider` (context provider):

index.d.ts

+36-36
Large diffs are not rendered by default.

package-lock.json

+1-1
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "react-redux-firebase",
3-
"version": "3.0.0",
3+
"version": "3.0.1",
44
"description": "Redux integration for Firebase. Comes with a Higher Order Components for use with React.",
55
"main": "lib/index.js",
66
"module": "es/index.js",

src/ReactReduxFirebaseProvider.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ import ReduxFirestoreProvider from './ReduxFirestoreProvider'
1515
* @param {Function} props.createFirestoreInstance - Function for creating
1616
* extended firestore instance
1717
* @returns {React.Context.Provider} Provider for react-redux-firebase context
18-
* @see http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/ReactReduxFirebaseProvider.html
18+
* @see https://react-redux-firebase.com/api/ReactReduxFirebaseProvider.html
1919
*/
2020
function ReactReduxFirebaseProvider(props = {}) {
2121
const {

src/ReduxFirestoreProvider.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ import createFirebaseInstance from './createFirebaseInstance'
1414
* @param {Function} props.createFirestoreInstance - Function for creating
1515
* extended firestore instance
1616
* @returns {React.Context.Provider} Provider for redux-firestore context
17-
* @see http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/ReduxFirestoreProvider.html
17+
* @see https://react-redux-firebase.com/api/ReduxFirestoreProvider.html
1818
*/
1919
function ReduxFirestoreProvider(props = {}) {
2020
const {

src/createFirebaseInstance.js

+14-14
Original file line numberDiff line numberDiff line change
@@ -71,13 +71,13 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
7171

7272
/**
7373
* Sets data to Firebase. More info available in
74-
* [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#set).
74+
* [the docs](https://react-redux-firebase.com/api/props-firebase.html#set).
7575
* @param {string} path - Path to location on Firebase which to set
7676
* @param {object|string|boolean|number} value - Value to write to Firebase
7777
* @param {Function} onComplete - Function to run on complete (`not required`)
7878
* @returns {Promise} Containing reference snapshot
7979
* @example <caption>Basic</caption>
80-
* @see http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/firebaseInstance.html#set
80+
* @see https://react-redux-firebase.com/api/firebaseInstance.html#set
8181
* import React, { Component } from 'react'
8282
* import PropTypes from 'prop-types'
8383
* import { firebaseConnect } from 'react-redux-firebase'
@@ -100,7 +100,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
100100
* Sets data to Firebase along with meta data. Currently,
101101
* this includes createdAt and createdBy. *Warning* using this function
102102
* may have unintented consequences (setting createdAt even if data already
103-
* exists). More info available in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#update).
103+
* exists). More info available in [the docs](https://react-redux-firebase.com/api/props-firebase.html#update).
104104
* @param {string} path - Path to location on Firebase which to set
105105
* @param {object|string|boolean|number} value - Value to write to Firebase
106106
* @param {Function} onComplete - Function to run on complete (`not required`)
@@ -111,7 +111,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
111111

112112
/**
113113
* Pushes data to Firebase. More info
114-
* available in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#push).
114+
* available in [the docs](https://react-redux-firebase.com/api/props-firebase.html#push).
115115
* @param {string} path - Path to location on Firebase which to push
116116
* @param {object|string|boolean|number} value - Value to push to Firebase
117117
* @param {Function} onComplete - Function to run on complete (`not required`)
@@ -139,7 +139,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
139139
/**
140140
* Pushes data to Firebase along with meta data. Currently,
141141
* this includes createdAt and createdBy. More info
142-
* available in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#pushWithMeta).
142+
* available in [the docs](https://react-redux-firebase.com/api/props-firebase.html#pushWithMeta).
143143
* @param {string} path - Path to location on Firebase which to set
144144
* @param {object|string|boolean|number} value - Value to write to Firebase
145145
* @param {Function} onComplete - Function to run on complete (`not required`)
@@ -150,7 +150,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
150150

151151
/**
152152
* Updates data on Firebase and sends new data. More info
153-
* available in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#update).
153+
* available in [the docs](https://react-redux-firebase.com/api/props-firebase.html#update).
154154
* @param {string} path - Path to location on Firebase which to update
155155
* @param {object|string|boolean|number} value - Value to update to Firebase
156156
* @param {Function} onComplete - Function to run on complete (`not required`)
@@ -183,7 +183,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
183183
* Updates data on Firebase along with meta. *Warning*
184184
* using this function may have unintented consequences (setting
185185
* createdAt even if data already exists). More info available
186-
* in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#updateWithMeta).
186+
* in [the docs](https://react-redux-firebase.com/api/props-firebase.html#updateWithMeta).
187187
* @param {string} path - Path to location on Firebase which to update
188188
* @param {object|string|boolean|number} value - Value to update to Firebase
189189
* @param {Function} onComplete - Function to run on complete (`not required`)
@@ -197,7 +197,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
197197
* seperate action is not dispatched unless `dispatchRemoveAction: true` is
198198
* provided to config on store creation. That means that a listener must
199199
* be attached in order for state to be updated when calling remove.
200-
* More info available in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#remove).
200+
* More info available in [the docs](https://react-redux-firebase.com/api/props-firebase.html#remove).
201201
* @param {string} path - Path to location on Firebase which to remove
202202
* @param {Function} onComplete - Function to run on complete (`not required`)
203203
* @param {Function} options - Options object
@@ -226,7 +226,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
226226
* Sets data to Firebase only if the path does not already
227227
* exist, otherwise it rejects. Internally uses a Firebase transaction to
228228
* prevent a race condition between seperate clients calling uniqueSet.
229-
* More info available in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#uniqueSet).
229+
* More info available in [the docs](https://react-redux-firebase.com/api/props-firebase.html#uniqueSet).
230230
* @param {string} path - Path to location on Firebase which to set
231231
* @param {object|string|boolean|number} value - Value to write to Firebase
232232
* @param {Function} onComplete - Function to run on complete (`not required`)
@@ -263,7 +263,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
263263
/**
264264
* Upload a file to Firebase Storage with the option to store
265265
* its metadata in Firebase Database. More info available
266-
* in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#uploadFile).
266+
* in [the docs](https://react-redux-firebase.com/api/props-firebase.html#uploadFile).
267267
* @param {string} path - Path to location on Firebase which to set
268268
* @param {File} file - File object to upload (usually first element from
269269
* array output of select-file or a drag/drop `onDrop`)
@@ -285,7 +285,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
285285
/**
286286
* Upload multiple files to Firebase Storage with the option
287287
* to store their metadata in Firebase Database. More info available
288-
* in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#uploadFiles).
288+
* in [the docs](https://react-redux-firebase.com/api/props-firebase.html#uploadFiles).
289289
* @param {string} path - Path to location on Firebase which to set
290290
* @param {Array} files - Array of File objects to upload (usually from
291291
* a select-file or a drag/drop `onDrop`)
@@ -305,7 +305,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
305305
/**
306306
* Delete a file from Firebase Storage with the option to
307307
* remove its metadata in Firebase Database. More info available
308-
* in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#deleteFile).
308+
* in [the docs](https://react-redux-firebase.com/api/props-firebase.html#deleteFile).
309309
* @param {string} path - Path to location on Firebase which to set
310310
* @param {string} dbPath - Database path to place uploaded file metadata
311311
* @returns {Promise} Containing the File object
@@ -316,7 +316,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
316316
/**
317317
* Watch event. **Note:** this method is used internally
318318
* so examples have not yet been created, and it may not work as expected.
319-
* More info available in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#watchEvent).
319+
* More info available in [the docs](https://react-redux-firebase.com/api/props-firebase.html#watchEvent).
320320
* @param {string} type - Type of watch event
321321
* @param {string} path - Path to location on Firebase which to set listener
322322
* @param {string} storeAs - Name of listener results within redux store
@@ -336,7 +336,7 @@ export default function createFirebaseInstance(firebase, configs, dispatch) {
336336
/**
337337
* Unset a listener watch event. **Note:** this method is used
338338
* internally so examples have not yet been created, and it may not work
339-
* as expected. More info available in [the docs](http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/props-firebase.html#unwatchevent).
339+
* as expected. More info available in [the docs](https://react-redux-firebase.com/api/props-firebase.html#unwatchevent).
340340
* @param {string} type - Type of watch event
341341
* @param {string} path - Path to location on Firebase which to unset listener
342342
* @param {string} queryId - Id of the listener

src/useFirebase.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import ReactReduxFirebaseContext from './ReactReduxFirebaseContext'
1010
* and functionality which give it it's capabilities such as dispatching
1111
* actions.
1212
* @returns {object} - Extended Firebase instance
13-
* @see http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/useFirebase.html
13+
* @see https://react-redux-firebase.com/api/useFirebase.html
1414
* @example <caption>Basic</caption>
1515
* import { useFirebase } from 'react-redux-firebase'
1616
*

src/useFirebaseConnect.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import useFirebase from './useFirebase'
1111
* array contains object or string for path to sync from Firebase or null if
1212
* hook doesn't need to sync. Can also be a function that returns an object,
1313
* a path string, or array of an object or a path string.
14-
* @see http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/useFirebaseConnect.html
14+
* @see https://react-redux-firebase.com/api/useFirebaseConnect.html
1515
* @example <caption>Ordered Data</caption>
1616
* import { useSelector } from 'react-redux'
1717
* import { useFirebaseConnect } from 'react-redux-firebase'

src/useFirestore.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ import ReduxFirestoreContext from './ReduxFirestoreContext'
88
* to store by the store enhancer (`reduxFirestore`) during setup of
99
* [`redux-firestore`](https://github.com/prescottprue/redux-firestore)
1010
* @returns {object} - Extended Firestore instance
11-
* @see http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/useFirestore.html
11+
* @see https://react-redux-firebase.com/api/useFirestore.html
1212
* @example <caption>Basic</caption>
1313
* import React from 'react'
1414
* import { useFirestore } from 'react-redux-firebase'

src/useFirestoreConnect.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import useFirestore from './useFirestore'
1111
* @param {object|string|Array|Function} queriesConfigs - An object, string,
1212
* or array of object or string for paths to sync from firestore. Can also be
1313
* a function that returns the object, string, or array of object or string.
14-
* @see http://docs.react-redux-firebase.com/history/v3.0.0/docs/api/useFirestoreConnect.html
14+
* @see https://react-redux-firebase.com/api/useFirestoreConnect.html
1515
* @example <caption>Basic</caption>
1616
* import React from 'react'
1717
* import { map } from 'lodash'

0 commit comments

Comments
 (0)