react-version-control v1.1.2
REACT-VERSION-CONTROL
A version control package developed by oscmedgon to be used on React projects. You can see and test the library at the demo
This package it's under construction, will be available soon as an npm package
INSTALATION
To install the package run the following command
npm install -S react-version-control
USAGE
The usage of the component is simple, You need to wrap your application on if, the higher level better, the bet scenario its to wrap your entire app inside it.
prop | type | required | default value | description |
---|---|---|---|---|
children | react node | true | A react node as children to be rendered can be your app component | |
version | string | true | null | Current version depending on your app, recommended to use process.env |
latestVersion | string | true | null | Latest available version in string, the fetch should be managed in the host app, you need to pass the raw version string |
checkVersion | function | true | Function executed each iteration where the version manager wants to check an update this function should update the latest and the current version running on the app. | |
renderHotUpdate | function | true | Function that returns a react node, it's executed when te manager detects a new update on run time, this way you can create your own notification and styles | |
debug | boolean | false | If debug is true version control will mount some dev enhancers see the dedicated section DEV-ENHANCERS | |
enabled | boolean | false | The module only works if it's enabled, otherwise will only render the children, this can be use for example to test it in determined environments |
The method renderHotUpdate will receive an argument with type function, this function when executed will force the reload of the page ignoring cache, you can assign this action to a button, so when you click it, the page will start reload.
import VersionControl from 'react-version-control';
<VersionControl
getLatestVersion={() => 'latestVersion'}
version='currentVersion'
enabled
debug
renderHotUpdate={renderUpdateContent}
>
<Children />
</VersionControl>
DEV-ENHANCERS
If you initialize the module with in debug mode this will mount two methods under window. The module can find updates in two different moments, at the mount point, and at run time.
- Mount point
window.setLoadUpdate();
At mount point when detects an update the app will force refresh of the page ignoring the cache, this will force the browser to download new bundles or assets.
- Run time
window.setHotUpdate();
The method setHotUpdate will force the component to execute the renderUpdateContent method passed by props.
TODO
- Add custom time between check possibility.
- Unit Test and demo test.
- Ensure that the version manager does not get stucked in a update loop caused by a app misconfiguration