feature-redux

# Change Log The **feature-redux** project adheres to [Semantic Versioning](http://semver.org/). Each release is documented on this page *(in addition to the [Github Release Notes](https://github.com/KevinAst/feature-redux/releases))*, and **contains migration instructions**. ## Summary: Release | What | *When* ---------|----------------------------------------------------------|------------------ [v3.0.0] | Redux Enhancer Injection and Aspect Plugin Changes | *February, 5, 2020* [v1.0.1] | Address Security Alerts | *December 10, 2019* [v1.0.0] | feature-u V1 Integration | *August 14, 2018* [v0.1.3] | Establish Polyfill Strategy | *July 2, 2018* [v0.1.2] | Auto Redux DevTools Integration | *March 29, 2018* [v0.1.1] | react-native android patch | *March 7, 2018* [v0.1.0] | Initial Release | *March 6, 2018* [v3.0.0]: #v300---redux-enhancer-injection-and-aspect-plugin-changes-february-5-2020 [v1.0.1]: #v101---address-security-alerts-december-10-2019 [v1.0.0]: #v100---feature-u-v1-integration-august-14-2018 [v0.1.3]: #v013---establish-polyfill-strategy-july-2-2018 [v0.1.2]: #v012---auto-redux-devtools-integration-march-29-2018 [v0.1.1]: #v011---react-native-android-patch-march-7-2018 [v0.1.0]: #v010---initial-release-march-6-2018   ## v3.0.0 - Redux Enhancer Injection and Aspect Plugin Changes *(February, 5, 2020)* [GitHub Content](https://github.com/KevinAst/feature-redux/tree/v3.0.0) • [GitHub Release](https://github.com/KevinAst/feature-redux/releases/tag/v3.0.0) • [Diff](https://github.com/KevinAst/feature-redux/compare/v1.0.1...v3.0.0) **NOTE**: This release contains **minor breaking changes** from prior releases ... some API changes, at minimum a new version of the **feature-u** peer dependency _(also v3.0.0)_. _A trivial retrofit of client code is necessary_! - Pardon the version bump (from v1.0.1 to v3.0.0). We skipped v2 strictly as an internal management convenience - to match the required peer dependency of **feature-u** _(which is also v3.0.0)_. - **Added**: External Aspects may now introduce their own enhancers to the redux store through the `Aspect.getReduxEnhancer()` API _(an "aspect cross-communication mechanism")_ **... thanks [@sylvainlg](https://github.com/sylvainlg)!!** _This similar to how External Aspects have always been able to introduce their own redux middleware_. Please refer to the "Enhancer Integration" [Inputs](./README.md#inputs) section for more information. - **Added**: This Aspect Plugin now promotes the redux `getState`/`dispatch` functions in the namedParams of **feature-u**'s Application Life Cycle Hooks ... see [Interface Points / Exposure](./README.md#exposure) Previously, these parameters were promoted directly by **feature-u**, but that coupling has been removed in favor of a new internal mechanism allowing any Aspect to inject their namedParams. As a result, this **feature-redux** release (V3) requires **feature-u** V3 or greater (and is reflected in it's **feature-u** peerDependency: `">=3.0.0"`). - **Changed**: The `createReducerAspect()` creator function now accepts only named parameters ... see [API](./README.md#reduceraspect-aspect) - **Added**: A new optional `initialState` parameter was introduced _(in the `createReducerAspect()` creator function)_, that provides a pre-loaded initial state of your store ... see [API](./README.md#reduceraspect-aspect) - **Added**: A new optional `allowNoReducers` parameter was introduced _(in the `createReducerAspect()` creator function)_, that directs what happens when no reducers were specified on your features ... see [API](./README.md#reduceraspect-aspect) - **Internal**: All initialization/validation was moved from the genesis() hook into our constructor.  ## v1.0.1 - Address Security Alerts *(December 10, 2019)* [GitHub Content](https://github.com/KevinAst/feature-redux/tree/v1.0.1) • [GitHub Release](https://github.com/KevinAst/feature-redux/releases/tag/v1.0.1) • [Diff](https://github.com/KevinAst/feature-redux/compare/v1.0.0...v1.0.1) **NOTE**: This release is a **non-breaking change** _(i.e. no API was affected)_. - **Security**: Address potential security vulnerabilities in dependent libs (mostly devDependencies completely unrelated to deployment)!  ## v1.0.0 - feature-u V1 Integration *(August 14, 2018)* [GitHub Content](https://github.com/KevinAst/feature-redux/tree/v1.0.0) • [GitHub Release](https://github.com/KevinAst/feature-redux/releases/tag/v1.0.0) • [Diff](https://github.com/KevinAst/feature-redux/compare/v0.1.3...v1.0.0) **NOTE**: This release contains **breaking changes** from prior releases _(i.e. a retrofit of client code is necessary)_. - **Added/Removed**: Eliminate singletons in favor of creators The singleton: `reducerAspect`, has been replaced with a new creator: `createReducerAspect()`. This is useful in both testing and server side rendering. - **Internal**: Integrate to [**feature-u V1**](https://feature-u.js.org/cur/history.html#v1_0_0) **feature-u V1** has replaced the `app` object with a `fassets` object. In general, this is not a change that would break a plugin, because app/fassets is a positional parameter that is merely passed through the plugin. In other words the app/fassets is not directly interpreted by this plugin. However, **feature-redux** does have subtle indirect references to changed **feature-u V1** APIs, _such as Error message strings, etc_. Therefore, it is best to tidy up this detail. As a result, this plugin has now updated it's **feature-u** peerDependency to ">=1.0.0".  ## v0.1.3 - Establish Polyfill Strategy *(July 2, 2018)* [GitHub Content](https://github.com/KevinAst/feature-redux/tree/v0.1.3) • [GitHub Release](https://github.com/KevinAst/feature-redux/releases/tag/v0.1.3) • [Diff](https://github.com/KevinAst/feature-redux/compare/v0.1.2...v0.1.3) **NOTE**: This release is a **non-breaking change** _(i.e. no API was affected)_. - **Review**: A new policy is in affect where **polyfills are the responsibility of the client app**, when the target JavaScript engine is inadequate _(such as the IE browser)_. Please refer to [Potential Need for Polyfills](./README.md#potential-need-for-polyfills) for more information. As a result, all previous code patches related to es2015+ polyfill issues were removed, in favor of **polyfilling at the app-level**. - **Internal**: The most current babel version/configuration is now used to transpile the library's es5 distribution.  ## v0.1.2 - Auto Redux DevTools Integration *(March 29, 2018)* [GitHub Content](https://github.com/KevinAst/feature-redux/tree/v0.1.2) • [GitHub Release](https://github.com/KevinAst/feature-redux/releases/tag/v0.1.2) • [Diff](https://github.com/KevinAst/feature-redux/compare/v0.1.1...v0.1.2) **NOTE**: This release is a **non-breaking change** _(i.e. no API was affected)_. - **Enhanced**: Integration with Redux DevTools is automatically configured (when detected). - **Docs**: Removed action-u reference from example code, using a more conventional "defined constant" action type.  ## v0.1.1 - react-native android patch *(March 7, 2018)* [GitHub Content](https://github.com/KevinAst/feature-redux/tree/v0.1.1) • [GitHub Release](https://github.com/KevinAst/feature-redux/releases/tag/v0.1.1) • [Diff](https://github.com/KevinAst/feature-redux/compare/v0.1.0...v0.1.1?short_path=4ac32a7#diff-4ac32a78649ca5bdd8e0ba38b7006a1e) **NOTE**: This release is a **non-breaking change** _(i.e. no API was affected)_. - **Fixed**: A patch was applied in support of **react-native android**. When running react-native under android, receiving the following exception: ``` ERROR: undefined is not a function evaluating 'content[typeof Symbol === 'function' ? Symbol.iterator: '@@iterator']()' ``` This is a transpiler issue related to the es6 "for of" loop. It is believed to be limited to the **react-native android JS engine**. This may be a babel transpiler issue (possibly due to a stale babel version), or an issue with with react-native android's JS engine. The problem was temporarily avoided by employing old style es5 "for loop" constructs (till further research is conducted).  ## v0.1.0 - Initial Release *(March 6, 2018)* [GitHub Content](https://github.com/KevinAst/feature-redux/tree/v0.1.0) • [GitHub Release](https://github.com/KevinAst/feature-redux/releases/tag/v0.1.0) **This is where it all began ...**