[ADF-5158] ECM Version Directive (#5779)

* [ADF-5158] ECM Version Directive

* Update version-compatibility.directive.ts

* Update version-compatibility.directive.ts

* Change name from ecm to acs

* Fix unit tests

* Update docs for Version directive

* Fix unit tests

* Fix unit tests

* Linting

* Update apps-process-cloud.service.spec.ts

* Fix Ecm Service initialization

* Fix unit test

Co-authored-by: Eugenio Romano <eromano@users.noreply.github.com>

lib/core/core.module.ts

@@ -57,6 +57,8 @@ import { ExtensionsModule } from '@alfresco/adf-extensions';
 import { directionalityConfigFactory } from './services/directionality-config-factory';
 import { DirectionalityConfigService } from './services/directionality-config.service';
 import { SearchTextModule } from './search-text/search-text-input.module';
+import { versionCompatibilityFactory } from './services/version-compatibility-factory';
+import { VersionCompatibilityService } from './services/version-compatibility.service';
 
 @NgModule({
     imports: [
@@ -149,6 +151,12 @@ export class CoreModule {
                     useFactory: directionalityConfigFactory,
                     deps: [ DirectionalityConfigService ],
                     multi: true
+                },
+                {
+                    provide: APP_INITIALIZER,
+                    useFactory: versionCompatibilityFactory,
+                    deps: [ VersionCompatibilityService ],
+                    multi: true
                 }
             ]
         };

lib/core/directives/directive.module.ts

@@ -27,6 +27,7 @@ import { CheckAllowableOperationDirective } from './check-allowable-operation.di
 import { NodeRestoreDirective } from './node-restore.directive';
 import { UploadDirective } from './upload.directive';
 import { NodeDownloadDirective } from './node-download.directive';
+import { VersionCompatibilityDirective } from './version-compatibility.directive';
 
 @NgModule({
     imports: [
@@ -41,7 +42,8 @@ import { NodeDownloadDirective } from './node-download.directive';
         CheckAllowableOperationDirective,
         NodeRestoreDirective,
         NodeDownloadDirective,
-        UploadDirective
+        UploadDirective,
+        VersionCompatibilityDirective
     ],
     exports: [
         HighlightDirective,
@@ -51,7 +53,8 @@ import { NodeDownloadDirective } from './node-download.directive';
         CheckAllowableOperationDirective,
         NodeRestoreDirective,
         NodeDownloadDirective,
-        UploadDirective
+        UploadDirective,
+        VersionCompatibilityDirective
     ]
 })
 export class DirectiveModule {}

lib/core/directives/public-api.ts

@@ -23,5 +23,6 @@ export * from './check-allowable-operation.directive';
 export * from './node-restore.directive';
 export * from './node-download.directive';
 export * from './upload.directive';
+export * from './version-compatibility.directive';
 
 export * from './directive.module';

lib/core/directives/version-compatibility.directive.spec.ts

@@ -0,0 +1,95 @@
+/*!
+ * @license
+ * Copyright 2019 Alfresco Software, Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Component } from '@angular/core';
+import { By } from '@angular/platform-browser';
+import { TranslateModule } from '@ngx-translate/core';
+import { TestBed, ComponentFixture } from '@angular/core/testing';
+import { setupTestBed } from '../testing/setup-test-bed';
+import { CoreTestingModule } from '../testing/core.testing.module';
+import { VersionCompatibilityService } from '@alfresco/adf-core';
+
+@Component({
+    template: `
+        <div *adf-acs-version="'8'" class="hidden-content-1">
+            My hidden content 1
+        </div>
+        <div *adf-acs-version="'7.1'" class="hidden-content-2">
+            My hidden content 2
+        </div>
+        <div *adf-acs-version="'7.0.2'" class="hidden-content-3">
+            My hidden content 3
+        </div>
+        <div *adf-acs-version="'6.1.5'" class="visible-content-1">
+            My visible content 1
+        </div>
+        <div *adf-acs-version="'6.1'" class="visible-content-2">
+            My visible content 2
+        </div>
+        <div *adf-acs-version="'6'" class="visible-content-3">
+            My visible content 3
+        </div>
+        `
+})
+class TestComponent { }
+
+describe('VersionCompatibilityDirective', () => {
+    let fixture: ComponentFixture<TestComponent>;
+    let versionCompatibilityService: VersionCompatibilityService;
+
+    const acsResponceMock = {
+        display: '7.0.1',
+        major: '7',
+        minor: '0',
+        patch: '1'
+    };
+
+    setupTestBed({
+        imports: [
+            TranslateModule.forRoot(),
+            CoreTestingModule
+        ],
+        declarations: [TestComponent
+        ]
+    });
+
+    beforeEach(() => {
+        fixture = TestBed.createComponent(TestComponent);
+        versionCompatibilityService = TestBed.get(VersionCompatibilityService);
+        spyOn(versionCompatibilityService, 'getAcsVersion').and.returnValue(acsResponceMock);
+    });
+
+    it('should display component when the version is supported', () => {
+        fixture.detectChanges();
+        const element1 = fixture.debugElement.query(By.css('[class="visible-content-1"]'));
+        const element2 = fixture.debugElement.query(By.css('[class="visible-content-2"]'));
+        const element3 = fixture.debugElement.query(By.css('[class="visible-content-3"]'));
+        expect(element1).toBeDefined();
+        expect(element2).toBeDefined();
+        expect(element3).toBeDefined();
+    });
+
+    it('should hide component when the version is not supported', () => {
+        fixture.detectChanges();
+        const element1 = fixture.debugElement.query(By.css('[class="hidden-content-1"]'));
+        const element2 = fixture.debugElement.query(By.css('[class="hidden-content-2"]'));
+        const element3 = fixture.debugElement.query(By.css('[class="hidden-content-3"]'));
+        expect(element1).toBeNull();
+        expect(element2).toBeNull();
+        expect(element3).toBeNull();
+    });
+});

lib/core/directives/version-compatibility.directive.ts

@@ -0,0 +1,82 @@
+/*!
+ * @license
+ * Copyright 2019 Alfresco Software, Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Directive, Input, ViewContainerRef, TemplateRef } from '@angular/core';
+import { VersionCompatibilityService } from '../services/version-compatibility.service';
+import { VersionModel } from '../models/product-version.model';
+
+@Directive({
+    selector: '[adf-acs-version]'
+})
+export class VersionCompatibilityDirective {
+
+    /** Minimum version required for component to work correctly . */
+    @Input('adf-acs-version')
+    set version(requiredVersion: string) {
+        this.validateAcsVersion(requiredVersion);
+    }
+
+    constructor(
+        private templateRef: TemplateRef<any>,
+        private viewContainer: ViewContainerRef,
+        private versionCompatibilityService: VersionCompatibilityService
+    ) {
+    }
+
+    private validateAcsVersion(requiredVersion: string) {
+        if (requiredVersion && this.isVersionSupported(requiredVersion)) {
+            this.viewContainer.createEmbeddedView(this.templateRef);
+        } else {
+            this.viewContainer.clear();
+        }
+    }
+
+    private parseVersion(version: string): VersionModel {
+        const major = version.split('.')[0];
+        const minor = version.split('.')[1] || '0';
+        const patch = version.split('.')[2] || '0';
+
+        return {
+            major: major,
+            minor: minor,
+            patch: patch
+        } as VersionModel;
+    }
+
+    private isVersionSupported(requiredVersion: string): boolean {
+        const parsedRequiredVersion = this.parseVersion(requiredVersion);
+        const currentVersion = this.versionCompatibilityService.getAcsVersion();
+
+        let versionSupported = false;
+
+        if (currentVersion) {
+            if (+currentVersion.major > +parsedRequiredVersion.major) {
+                versionSupported = true;
+            } else if (currentVersion.major === parsedRequiredVersion.major &&
+                +currentVersion.minor > +parsedRequiredVersion.minor) {
+                versionSupported = true;
+            } else if (currentVersion.major === parsedRequiredVersion.major &&
+                currentVersion.minor === parsedRequiredVersion.minor &&
+                +currentVersion.patch >= +parsedRequiredVersion.patch) {
+                versionSupported = true;
+            }
+        }
+
+        return versionSupported;
+    }
+
+}

lib/core/search-text/search-text-input.component.spec.ts

@@ -24,7 +24,6 @@ import { Subject } from 'rxjs';
 import { TranslateModule } from '@ngx-translate/core';
 import { UserPreferencesService } from '../services/user-preferences.service';
 import { setupTestBed } from '../testing/setup-test-bed';
-import { CoreModule } from '../core.module';
 
 describe('SearchTextInputComponent', () => {
 
@@ -37,7 +36,6 @@ describe('SearchTextInputComponent', () => {
     setupTestBed({
         imports: [
             TranslateModule.forRoot(),
-            CoreModule.forRoot(),
             CoreTestingModule
         ]
     });
@@ -58,6 +56,7 @@ describe('SearchTextInputComponent', () => {
     describe('component rendering', () => {
 
         it('should display a search input field when specified', async(() => {
+            fixture.detectChanges();
             component.inputType = 'search';
             fixture.detectChanges();
             expect(element.querySelectorAll('input[type="search"]').length).toBe(1);
@@ -68,15 +67,17 @@ describe('SearchTextInputComponent', () => {
 
         beforeEach(() => {
             component.expandable = false;
-            fixture.detectChanges();
         });
 
         it('search button should be hide', () => {
+            fixture.detectChanges();
             const searchButton: any = element.querySelector('#adf-search-button');
             expect(searchButton).toBe(null);
         });
 
         it('should not have animation', () => {
+            userPreferencesService.setWithoutStore('textOrientation', 'rtl');
+            fixture.detectChanges();
             expect(component.subscriptAnimationState.value).toBe('no-animation');
         });
     });

lib/core/services/public-api.ts

@@ -61,4 +61,5 @@ export * from './ecm-user.service';
 export * from './identity-user.service';
 export * from './identity-group.service';
 export * from './identity-role.service';
+export * from './version-compatibility.service';
 export * from './auth-bearer.interceptor';

lib/core/services/version-compatibility-factory.ts

@@ -0,0 +1,22 @@
+/*!
+ * @license
+ * Copyright 2019 Alfresco Software, Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { VersionCompatibilityService } from './version-compatibility.service';
+
+export function versionCompatibilityFactory(
+    versionCompatibilityService: VersionCompatibilityService
+): Function { return () => versionCompatibilityService; }

lib/core/services/version-compatibility.service.spec.ts

@@ -0,0 +1,75 @@
+/*!
+ * @license
+ * Copyright 2019 Alfresco Software, Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { TestBed } from '@angular/core/testing';
+import { AppConfigService } from '../app-config/app-config.service';
+import { DiscoveryApiService } from './discovery-api.service';
+import { setupTestBed } from '../testing/setup-test-bed';
+import { CoreTestingModule } from '../testing/core.testing.module';
+import { AlfrescoApiServiceMock } from '../mock/alfresco-api.service.mock';
+import { VersionCompatibilityService } from './version-compatibility.service';
+import { of } from 'rxjs';
+import { TranslateModule } from '@ngx-translate/core';
+import { AuthenticationService } from './authentication.service';
+
+describe('VersionCompatibilityService', () => {
+    let versionCompatibilityService: VersionCompatibilityService;
+    let alfrescoApiService: AlfrescoApiServiceMock;
+    let discoveryApiService: DiscoveryApiService;
+    let authenticationService: AuthenticationService;
+
+    const acsResponceMock = {
+        version: {
+            display: '7.0.1',
+            major: '7',
+            minor: '0',
+            patch: '1'
+        }
+    };
+
+    setupTestBed({
+        imports: [
+            TranslateModule.forRoot(),
+            CoreTestingModule
+        ]
+    });
+
+    beforeEach(() => {
+        discoveryApiService = TestBed.get(DiscoveryApiService);
+        authenticationService = TestBed.get(AuthenticationService);
+        spyOn(discoveryApiService, 'getEcmProductInfo').and.returnValue(of(acsResponceMock));
+        spyOn(authenticationService, 'isEcmLoggedIn').and.returnValue(true);
+        versionCompatibilityService = TestBed.get(VersionCompatibilityService);
+        alfrescoApiService = new AlfrescoApiServiceMock(new AppConfigService(null), null);
+
+    });
+
+    it('should get ACS running version', (done) => {
+        versionCompatibilityService = new VersionCompatibilityService(
+            alfrescoApiService,
+            authenticationService,
+            discoveryApiService
+        );
+        alfrescoApiService.initialize();
+        setTimeout(() => {
+            const acsVersion = versionCompatibilityService.getAcsVersion();
+            expect(acsVersion).toBeDefined();
+            expect(acsVersion.display).toBe('7.0.1');
+            done();
+        }, 100);
+    });
+});

lib/core/services/version-compatibility.service.ts

@@ -0,0 +1,53 @@
+/*!
+ * @license
+ * Copyright 2019 Alfresco Software, Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Injectable } from '@angular/core';
+import { AlfrescoApiService } from './alfresco-api.service';
+import { filter } from 'rxjs/operators';
+import { DiscoveryApiService } from './discovery-api.service';
+import { VersionModel, EcmProductVersionModel } from '../models/product-version.model';
+import { AuthenticationService } from './authentication.service';
+
+@Injectable({
+    providedIn: 'root'
+})
+export class VersionCompatibilityService {
+    private acsVersion: VersionModel;
+
+    constructor(
+        private alfrescoApiService: AlfrescoApiService,
+        private authService: AuthenticationService,
+        private discoveryApiService: DiscoveryApiService
+    ) {
+        this.alfrescoApiService.alfrescoApiInitialized
+            .pipe(filter(status => status))
+            .subscribe(this.initCompatibilityVersion.bind(this));
+    }
+
+    private initCompatibilityVersion() {
+        if (this.authService.isEcmLoggedIn()) {
+            this.discoveryApiService.getEcmProductInfo().toPromise().then(
+                (acsInfo: EcmProductVersionModel) => {
+                    this.acsVersion = acsInfo.version;
+                });
+        }
+    }
+
+    public getAcsVersion(): VersionModel {
+        return this.acsVersion;
+    }
+}

lib/core/testing/core.testing.module.ts

@@ -32,6 +32,8 @@ import { CookieServiceMock } from '../mock/cookie.service.mock';
 import { HttpClientModule } from '@angular/common/http';
 import { directionalityConfigFactory } from '../services/directionality-config-factory';
 import { DirectionalityConfigService } from '../services/directionality-config.service';
+import { versionCompatibilityFactory } from '../services/version-compatibility-factory';
+import { VersionCompatibilityService } from '../services/version-compatibility.service';
 
 @NgModule({
     imports: [
@@ -52,6 +54,12 @@ import { DirectionalityConfigService } from '../services/directionality-config.s
             useFactory: directionalityConfigFactory,
             deps: [ DirectionalityConfigService ],
             multi: true
+        },
+        {
+            provide: APP_INITIALIZER,
+            useFactory: versionCompatibilityFactory,
+            deps: [ VersionCompatibilityService ],
+            multi: true
         }
     ],
     exports: [