1.1.2 • Published 4 years ago

react-version-control v1.1.2

Weekly downloads
20
License
MIT
Repository
github
Last release
4 years ago

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.

proptyperequireddefault valuedescription
childrenreact nodetrueA react node as children to be rendered can be your app component
versionstringtruenullCurrent version depending on your app, recommended to use process.env
latestVersionstringtruenullLatest available version in string, the fetch should be managed in the host app, you need to pass the raw version string
checkVersionfunctiontrueFunction 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.
renderHotUpdatefunctiontrueFunction 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
debugbooleanfalseIf debug is true version control will mount some dev enhancers see the dedicated section DEV-ENHANCERS
enabledbooleanfalseThe 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
1.1.2

4 years ago

1.1.1

5 years ago

1.1.0

5 years ago

1.0.8

5 years ago

1.0.7

5 years ago

1.0.6

5 years ago

1.0.5

5 years ago

1.0.4

5 years ago

1.0.3

5 years ago

1.0.2

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago