alfresco-ng2-components/lib/content-services/src/lib/version-manager/version-manager.component.ts

/*!
 * @license
 * Copyright © 2005-2025 Hyland Software, Inc. and its affiliates. All rights reserved.
 *
 * 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, EventEmitter, Input, OnInit, Output, ViewChild, ViewEncapsulation } from '@angular/core';
import { Node } from '@alfresco/js-api';
import { VersionListComponent } from './version-list.component';
import { animate, state, style, transition, trigger } from '@angular/animations';
import { ContentService } from '../common/services/content.service';
import { NodesApiService } from '../common/services/nodes-api.service';
import { FileUploadErrorEvent } from '../common/events/file.event';
import { CommonModule } from '@angular/common';
import { VersionComparisonComponent } from './version-comparison.component';
import { VersionUploadComponent } from './version-upload.component';
import { MatButtonModule } from '@angular/material/button';
import { TranslateModule } from '@ngx-translate/core';

@Component({
    selector: 'adf-version-manager',
    standalone: true,
    imports: [CommonModule, VersionComparisonComponent, VersionUploadComponent, MatButtonModule, TranslateModule, VersionListComponent],
    templateUrl: './version-manager.component.html',
    styleUrls: ['./version-manager.component.scss'],
    animations: [
        trigger('uploadToggle', [
            state('open', style({ height: '175px', opacity: 1, visibility: 'visible' })),
            state('close', style({ height: '0%', opacity: 0, visibility: 'hidden' })),
            transition('open => close', [style({ visibility: 'hidden' }), animate('0.4s cubic-bezier(0.25, 0.8, 0.25, 1)')]),
            transition('close => open', [style({ visibility: 'visible' }), animate('0.4s cubic-bezier(0.25, 0.8, 0.25, 1)')])
        ])
    ],
    encapsulation: ViewEncapsulation.None
})
export class VersionManagerComponent implements OnInit {
    /** Target node to manage version history. */
    @Input({ required: true })
    node: Node;

    /** New file for updating current version. */
    @Input()
    newFileVersion: File;

    /** Toggles showing/hiding of comments. */
    @Input()
    showComments = true;

    /** Toggles showing/hiding the version comparison component. */
    @Input()
    showVersionComparison = false;

    /** Enable/disable downloading a version of the current node. */
    @Input()
    allowDownload = true;

    /** Toggles showing/hiding of version actions. */
    @Input()
    showActions = true;

    /** Enable/disable viewing versions of the current node. */
    @Input()
    allowViewVersions = true;

    /** Enable/disable deletion of version */
    @Input()
    allowVersionDelete = true;

    /** Emitted when a file is uploaded successfully. */
    @Output()
    uploadSuccess = new EventEmitter<Node>();

    /** Emitted when an error occurs during upload. */
    @Output()
    uploadError = new EventEmitter<FileUploadErrorEvent>();

    /** Emitted when an cancelling during upload. */
    @Output()
    uploadCancel = new EventEmitter<boolean>();

    /** Emitted when viewing a version. */
    @Output()
    viewVersion = new EventEmitter<string>();

    @ViewChild('versionList', { static: true })
    versionListComponent: VersionListComponent;

    uploadState: string = 'close';

    constructor(private contentService: ContentService, private nodesApiService: NodesApiService) {}

    ngOnInit() {
        if (this.newFileVersion) {
            this.toggleNewVersion();
        }
    }

    refresh(node: Node) {
        this.nodesApiService.nodeUpdated.next(node);
        this.versionListComponent.loadVersionHistory();
        this.uploadSuccess.emit(node);
        this.uploadState = 'close';
    }

    onUploadSuccess(event: any) {
        this.showVersionComparison = false;
        this.newFileVersion = null;
        this.nodesApiService.nodeUpdated.next(event.value.entry);
        this.versionListComponent.loadVersionHistory();
        this.uploadSuccess.emit(event.value.entry);
        this.uploadState = 'close';
    }

    onUploadError(event: FileUploadErrorEvent) {
        this.uploadError.emit(event);
    }

    onUploadCancel() {
        this.uploadState = 'close';
        this.showVersionComparison = false;
        this.newFileVersion = null;
        this.uploadCancel.emit(true);
    }

    onViewVersion(versionId: string) {
        this.viewVersion.emit(versionId);
    }

    toggleNewVersion() {
        this.uploadState = this.uploadState === 'open' ? 'close' : 'open';
    }

    canUpdate(): boolean {
        return this.contentService.hasAllowableOperations(this.node, 'update');
    }
}