feat(store): enable immutability checks by default (#2266)

Closes #2217

BREAKING CHANGE:

Immutability checks are enabled by default. 

BEFORE:

Immutability checks are opt-in.

AFTER:

If state or action is mutated then there will be a run time exception thrown.

Author: evgenyfedorenko

modules/store/schematics/ng-add/index.spec.ts

@@ -130,15 +130,4 @@ describe('Store ng-add Schematic', () => {
 
     expect(content).toMatch(/export interface AppState {/);
   });
-
-  it('should add runtime checks by default', () => {
-    const options = { ...defaultOptions, module: 'app.module.ts' };
-
-    const tree = schematicRunner.runSchematic('ng-add', options, appTree);
-    const content = tree.readContent(`${projectPath}/src/app/app.module.ts`);
-
-    expect(content).toMatch(/runtimeChecks: {/);
-    expect(content).toMatch(/strictStateImmutability: true,/);
-    expect(content).toMatch(/strictActionImmutability: true/);
-  });
 });

modules/store/schematics/ng-add/index.ts

@@ -8,7 +8,6 @@ import {
   branchAndMerge,
   chain,
   mergeWith,
-  template,
   url,
   noop,
   move,
@@ -59,18 +58,9 @@ function addImportToNgModule(options: RootStoreOptions): Rule {
     const storeModuleReducers = options.minimal ? `{}` : `reducers`;
 
     const storeModuleConfig = options.minimal
-      ? `{
-      runtimeChecks: {
-        strictStateImmutability: true,
-        strictActionImmutability: true
-      }
-    }`
+      ? `{}`
       : `{
-      metaReducers,
-      runtimeChecks: {
-        strictStateImmutability: true,
-        strictActionImmutability: true
-      }
+      metaReducers
     }`;
     const storeModuleSetup = `StoreModule.forRoot(${storeModuleReducers}, ${storeModuleConfig})`;
 

modules/store/spec/runtime_checks.spec.ts

@@ -7,57 +7,32 @@ import * as metaReducers from '../src/meta-reducers';
 
 describe('Runtime checks:', () => {
   describe('createActiveRuntimeChecks:', () => {
-    it('should disable all checks by default', () => {
+    it('should enable immutability checks by default', () => {
       expect(createActiveRuntimeChecks()).toEqual({
         strictStateSerializability: false,
         strictActionSerializability: false,
-        strictActionImmutability: false,
-        strictStateImmutability: false,
+        strictActionImmutability: true,
+        strictStateImmutability: true,
       });
     });
 
-    it('should log a warning in dev mode when no configuration is provided', () => {
-      const spy = spyOn(console, 'warn');
-
-      createActiveRuntimeChecks();
-
-      expect(spy).toHaveBeenCalled();
-    });
-
-    it('should not log a warning in dev mode when configuration is provided', () => {
-      const spy = spyOn(console, 'warn');
-
-      createActiveRuntimeChecks({});
-
-      expect(spy).not.toHaveBeenCalled();
-    });
-
-    it('should not log a warning when not dev mode when no configuration is provided', () => {
-      spyOn(ngCore, 'isDevMode').and.returnValue(false);
-      const spy = spyOn(console, 'warn');
-
-      createActiveRuntimeChecks();
-
-      expect(spy).not.toHaveBeenCalled();
-    });
-
     it('should allow the user to override the config', () => {
       expect(
         createActiveRuntimeChecks({
           strictStateSerializability: true,
           strictActionSerializability: true,
-          strictActionImmutability: true,
-          strictStateImmutability: true,
+          strictActionImmutability: false,
+          strictStateImmutability: false,
         })
       ).toEqual({
         strictStateSerializability: true,
         strictActionSerializability: true,
-        strictActionImmutability: true,
-        strictStateImmutability: true,
+        strictActionImmutability: false,
+        strictStateImmutability: false,
       });
     });
 
-    it('should disable runtime checks in production', () => {
+    it('should disable runtime checks in production by default', () => {
       spyOn(ngCore, 'isDevMode').and.returnValue(false);
 
       expect(createActiveRuntimeChecks()).toEqual({
@@ -67,6 +42,22 @@ describe('Runtime checks:', () => {
         strictStateImmutability: false,
       });
     });
+
+    it('should disable runtime checks in production even if opted in to enable', () => {
+      spyOn(ngCore, 'isDevMode').and.returnValue(false);
+
+      expect(
+        createActiveRuntimeChecks({
+          strictStateSerializability: true,
+          strictActionSerializability: true,
+        })
+      ).toEqual({
+        strictStateSerializability: false,
+        strictActionSerializability: false,
+        strictActionImmutability: false,
+        strictStateImmutability: false,
+      });
+    });
   });
 
   describe('USER_RUNTIME_CHECKS Token', () => {
@@ -114,7 +105,7 @@ describe('Runtime checks:', () => {
       expect(serializationCheckMetaReducerSpy).not.toHaveBeenCalled();
     });
 
-    it('should not create a meta reducer without config', () => {
+    it('should create immutability meta reducer without config', () => {
       const serializationCheckMetaReducerSpy = spyOn(
         metaReducers,
         'serializationCheckMetaReducer'
@@ -136,7 +127,7 @@ describe('Runtime checks:', () => {
 
       const _store = TestBed.get<Store<any>>(Store);
       expect(serializationCheckMetaReducerSpy).not.toHaveBeenCalled();
-      expect(immutabilityCheckMetaReducerSpy).not.toHaveBeenCalled();
+      expect(immutabilityCheckMetaReducerSpy).toHaveBeenCalled();
     });
   });
 

modules/store/src/runtime_checks.ts

@@ -15,16 +15,11 @@ export function createActiveRuntimeChecks(
   runtimeChecks?: Partial<RuntimeChecks>
 ): RuntimeChecks {
   if (isDevMode()) {
-    if (runtimeChecks === undefined) {
-      console.warn(
-        '@ngrx/store: runtime checks are currently opt-in but will be the default in the next major version with the possibility to opt-out, see https://ngrx.io/guide/migration/v8 for more information.'
-      );
-    }
     return {
       strictStateSerializability: false,
       strictActionSerializability: false,
-      strictStateImmutability: false,
-      strictActionImmutability: false,
+      strictStateImmutability: true,
+      strictActionImmutability: true,
       ...runtimeChecks,
     };
   }