Deprecate (de)serializeState / (de)serializeAction

Related to #278.

Author: zalmoxisus

docs/API/Arguments.md

@@ -11,7 +11,7 @@ Use `window.__REDUX_DEVTOOLS_EXTENSION__([config])` or `window.__REDUX_DEVTOOLS_
   - **pauseActionType** (*string*) - if specified, whenever clicking on `Pause recording` button and there are actions in the history log, will add this action type. If not specified, will commit when paused. Default is `@@PAUSED`.
   - **shouldStartLocked** (*boolean*) - if specified as `true`, it will not allow any non-monitor actions to be dispatched till clicking on `Unlock changes` button. Default is `false`.
   - **shouldHotReload** *boolean* - if set to `false`, will not recompute the states on hot reloading (or on replacing the reducers). Default to `true`.
-  - **deserializeState(state): transformedState** / **deserializeAction(action): transformedAction** (*function*) - optional transformation of state / action deserialized from debug session (useful if state is not plain object. Example: immutable-js state). *These are legacy parameters. Use `serialize` instead!*
+  - **deserializeState(state): transformedState** / **deserializeAction(action): transformedAction** (*function*) - optional transformation of state / action deserialized from debug session (useful if state is not plain object. Example: immutable-js state). ***Deprecated**. Use `serialize` instead!*
       Example of usage:
 
       ```js

src/app/api/importState.js

@@ -2,6 +2,10 @@ import mapValues from 'lodash/mapValues';
 import jsan from 'jsan';
 import seralizeImmutable from 'remotedev-serialize/immutable/serialize';
 
+function deprecate(param) {
+  console.warn(`\`${param}\` parameter for Redux DevTools Extension is deprecated. Use \`serialize\` parameter instead: https://github.com/zalmoxisus/redux-devtools-extension/releases/tag/v2.12.1`); // eslint-disable-line
+}
+
 export default function importState(state, { deserializeState, deserializeAction, serialize }) {
   if (!state) return undefined;
   let parse = jsan.parse;
@@ -20,6 +24,7 @@ export default function importState(state, { deserializeState, deserializeAction
     nextLiftedState = parse(nextLiftedState.payload);
   }
   if (deserializeState) {
+    deprecate('deserializeState');
     if (typeof nextLiftedState.computedStates !== 'undefined') {
       nextLiftedState.computedStates = nextLiftedState.computedStates.map(computedState => ({
         ...computedState,
@@ -34,6 +39,7 @@ export default function importState(state, { deserializeState, deserializeAction
     }
   }
   if (deserializeAction) {
+    deprecate('deserializeAction');
     nextLiftedState.actionsById = mapValues(nextLiftedState.actionsById, liftedAction => ({
       ...liftedAction,
       action: deserializeAction(liftedAction.action)

src/app/api/index.js

@@ -39,6 +39,8 @@ export function getSeralizeParameter(config, param) {
 
   const value = config[param];
   if (typeof value === 'undefined') return undefined;
+  console.warn(`\`${param}\` parameter for Redux DevTools Extension is deprecated. Use \`serialize\` parameter instead: https://github.com/zalmoxisus/redux-devtools-extension/releases/tag/v2.12.1`); // eslint-disable-line
+
   if (typeof serializeState === 'boolean') return { options: value };
   if (typeof serializeState === 'function') return { replacer: value };
   return value;