resource.component.ts

/* eslint-disable @typescript-eslint/member-ordering */
import { Component, Inject, Input, OnChanges, OnDestroy, OnInit, SimpleChange, ViewChild } from '@angular/core';
import { MatTabChangeEvent } from '@angular/material/tabs';
import { Title } from '@angular/platform-browser';
import {
    ActivatedRoute,
    NavigationEnd,
    NavigationError,
    NavigationStart,
    Router
} from '@angular/router';
import {
    ApiResponseError,
    Constants,
    CountQueryResponse,
    IHasPropertyWithPropertyDefinition,
    KnoraApiConnection,
    ReadArchiveFileValue,
    ReadAudioFileValue,
    ReadDocumentFileValue,
    ReadLinkValue,
    ReadMovingImageFileValue,
    ReadResource,
    ReadResourceSequence,
    ReadStillImageFileValue,
    ResourceClassAndPropertyDefinitions,
    ResourceClassDefinition,
    ResourceClassDefinitionWithPropertyDefinition,
    SystemPropertyDefinition
} from '@dasch-swiss/dsp-js';
import { Subscription } from 'rxjs';
import { DspApiConnectionToken } from 'src/app/main/declarations/dsp-api-tokens';
import { ErrorHandlerService } from 'src/app/main/services/error-handler.service';
import { NotificationService } from 'src/app/main/services/notification.service';
import { Session, SessionService } from 'src/app/main/services/session.service';
import { SplitSize } from '../results/results.component';
import { DspCompoundPosition, DspResource } from './dsp-resource';
import { PropertyInfoValues } from './properties/properties.component';
import { FileRepresentation, RepresentationConstants } from './representation/file-representation';
import { Region, StillImageComponent } from './representation/still-image/still-image.component';
import { IncomingService } from './services/incoming.service';
import { ResourceService } from './services/resource.service';
import { Events, UpdatedFileEventValue, ValueOperationEventService } from './services/value-operation-event.service';

@Component({
    selector: 'app-resource',
    templateUrl: './resource.component.html',
    styleUrls: ['./resource.component.scss'],
    providers: [ValueOperationEventService] // provide service on the component level so that each implementation of this component has its own instance.
})
export class ResourceComponent implements OnInit, OnChanges, OnDestroy {

    @ViewChild('stillImage') stillImageComponent: StillImageComponent;

    @Input() resourceIri: string;

    @Input() splitSizeChanged: SplitSize;

    projectCode: string;

    resourceUuid: string;
    // used to store the uuid of the value that is parsed from the url params
    valueUuid: string;

    // this will be the main resource
    resource: DspResource;

    // in case of incoming representations,
    // this will be the currently selected (part-of main) resource
    incomingResource: DspResource;

    // for the annotations e.g. regions in a still image representation
    annotationResources: DspResource[];

    selectedRegion: string;

    selectedTab = 0;

    selectedTabLabel: string;

    iiifUrl: string;

    resourceIsAnnotation: 'region' | 'sequence';

    // list of representations to be displayed
    // --> TODO: will be expanded with | MovingImageRepresentation[] | AudioRepresentation[] etc.
    representationsToDisplay: FileRepresentation[] = [];

    representationConstants = RepresentationConstants;

    // in case of compound object,
    // this will store the current page position information
    compoundPosition: DspCompoundPosition;

    showAllProps = false;

    loading = true;

    refresh: boolean;

    // permissions of logged-in user
    session: Session;
    adminPermissions = false;
    editPermissions = false;

    navigationSubscription: Subscription;

    valueOperationEventSubscriptions: Subscription[] = [];

    constructor(
        @Inject(DspApiConnectionToken) private _dspApiConnection: KnoraApiConnection,
        private _errorHandler: ErrorHandlerService,
        private _incomingService: IncomingService,
        private _notification: NotificationService,
        private _resourceService: ResourceService,
        private _route: ActivatedRoute,
        private _router: Router,
        private _session: SessionService,
        private _titleService: Title,
        private _valueOperationEventService: ValueOperationEventService
    ) {

        this._route.params.subscribe(params => {
            this.projectCode = params['project'];
            this.resourceUuid = params['resource'];
            this.valueUuid = params['value'];
            if (this.projectCode && this.resourceUuid) {
                this.resourceIri = this._resourceService.getResourceIri(this.projectCode, this.resourceUuid);
            }
            this.getResource(this.resourceIri);
        });

        this._router.events.subscribe((event) => {

            this._titleService.setTitle('Resource view');

            if (event instanceof NavigationStart) {
                // show loading indicator
                // console.log('NavigationStart', this.resourceIri);
            }

            if (event instanceof NavigationEnd) {
                // hide loading indicator
                this.refresh = true;
                // console.log('NavigationEnd', this.resourceIri);
                this.refresh = false;
            }

            if (event instanceof NavigationError) {
                // present error to user
                this._errorHandler.showMessage(event.error);

            }

        });

        this.valueOperationEventSubscriptions.push(this._valueOperationEventService.on(
            Events.FileValueUpdated, (newFileValue: UpdatedFileEventValue) => {
                if (newFileValue) {
                    this.getResource(this.resourceIri);
                }
            }));
    }

    ngOnInit() {

    }

    ngOnChanges(changes: { [propName: string]: SimpleChange }) {
        // do not reload the whole resource when the split size has changed
        if (this.splitSizeChanged) {
            return;
        }

        this.loading = true;
        // reset all resources
        this.resource = undefined;
        this.incomingResource = undefined;
        this.representationsToDisplay = [];
        this.compoundPosition = undefined;

        // get resource with all necessary information
        // incl. incoming resources and annotations
        if (this.resourceIri) {
            this.getResource(this.resourceIri);
        }
    }

    ngOnDestroy() {
        if (this.navigationSubscription !== undefined) {
            this.navigationSubscription.unsubscribe();
        }

        // unsubscribe from the ValueOperationEventService when component is destroyed
        if (this.valueOperationEventSubscriptions !== undefined) {
            this.valueOperationEventSubscriptions.forEach(sub => sub.unsubscribe());
        }
    }


    // ------------------------------------------------------------------------
    // ------------------------------------------------------------------------
    // general methods
    // ------------------------------------------------------------------------

    compoundNavigation(page: number) {
        this.selectedRegion = undefined;

        this.representationsToDisplay = [];

        // set current compound object position:
        // calculate offset and offset item position from current page and total pages info
        const offset = Math.ceil(page / 25) - 1;
        const position = Math.floor(page - (offset * 25) - 1);

        // get incoming still image representations, if the offset changed
        if (offset !== this.compoundPosition.offset) {
            this.compoundPosition.offset = offset;
            this.getIncomingStillImageRepresentations(offset);
        } else {
            // get incoming resource, if the offset is the same but page changed
            this.getIncomingResource(this.resource.incomingRepresentations[position].id);
        }

        this.compoundPosition.position = position;
        this.compoundPosition.page = page;

        this.representationsToDisplay = this.collectRepresentationsAndAnnotations(this.incomingResource);

    }

    // ------------------------------------------------------------------------
    // ------------------------------------------------------------------------
    // get and display resource
    // ------------------------------------------------------------------------

    /**
     * get a read resource sequence with ontology information and incoming resources.
     *
     * @param iri resourceIri
     */
    getResource(iri: string, incoming: boolean = false): void {
        if (!iri) {
            return;
        }

        this._dspApiConnection.v2.res.getResource(iri).subscribe(
            (response: ReadResource) => {
                const res = new DspResource(response);
                this.resource = res;

                // --> TODO: here we have to add also sequenceOf similar to regionOf (DEV-744)
                if (this.resource.res.outgoingReferences.length && this.resource.res.entityInfo.classes[Constants.Region] && this.resource.res.id === this.resourceIri) {
                    // the main resource (resourceIri) is a region;
                    // display the corresponding still-image resource instance
                    // find the iri of the parent resource; still-image in case of region, moving-image or audio in case of sequence
                    const annotationOfIri = (this.resource.res.properties[Constants.IsRegionOfValue] as ReadLinkValue[])[0].linkedResourceIri;

                    // get the parent resource to display
                    this.getResource(annotationOfIri);

                    // open annotation`s tab and highlight region
                    this.selectedTabLabel = 'annotations';
                    this.openRegion(iri);

                    this.selectedRegion = iri;
                    // define resource as annotation of type region
                    this.resourceIsAnnotation = (this.resource.res.entityInfo.classes[Constants.Region] ? 'region' : 'sequence');

                } else {

                    if (response.isDeleted) {
                        // deleted resource; no further infos needed
                        // --> TODO: as soon as we know how to display deleted/archived resources, we can handle it here.

                    } else {
                        // if there is no incomingResource and the resource has a still image property, assign the iiiUrl to be passed as an input to the still-image component
                        if (!this.incomingResource && this.resource.res.properties[Constants.HasStillImageFileValue]) {
                            this.iiifUrl = (this.resource.res.properties[Constants.HasStillImageFileValue][0] as ReadStillImageFileValue).fileUrl;
                        }

                        this.selectedTabLabel = this.resource.res.entityInfo?.classes[this.resource.res.type].label;

                        // get information about the logged-in user, if one is logged-in
                        if (this._session.getSession()) {
                            this.session = this._session.getSession();
                            // is the logged-in user project member?
                            // --> TODO: as soon as we know how to handle the permissions, set this value the correct way
                            this.editPermissions = true;
                            // is the logged-in user system admin or project admin?
                            this.adminPermissions = this.session.user.sysAdmin ? this.session.user.sysAdmin : this.session.user.projectAdmin.some(e => e === res.res.attachedToProject);
                        }

                        this.representationsToDisplay = this.collectRepresentationsAndAnnotations(this.resource);

                        if (!this.representationsToDisplay.length && !this.compoundPosition) {
                            // the resource could be a compound object
                            this._incomingService.getStillImageRepresentationsForCompoundResource(this.resource.res.id, 0, true).subscribe(
                                (countQuery: CountQueryResponse) => {

                                    if (countQuery.numberOfResults > 0) {
                                        this.compoundPosition = new DspCompoundPosition(countQuery.numberOfResults);
                                        this.compoundNavigation(1);
                                    } else {
                                        // not a compound object
                                        this.loading = false;
                                    }
                                },
                                (error: ApiResponseError) => {
                                    this.loading = false;
                                    this._errorHandler.showMessage(error);
                                }
                            );
                        } else {
                            this.requestIncomingResources(this.resource);
                        }

                        // gather resource property information
                        res.resProps = this.initProps(response);

                        // gather system property information
                        res.systemProps = this.resource.res.entityInfo.getPropertyDefinitionsByType(SystemPropertyDefinition);
                    }
                }
            },
            (error: ApiResponseError) => {
                this.resource = undefined;
                this.loading = false;
                this._errorHandler.showMessage(error);
            }
        );
    }

    getIncomingResource(iri: string) {
        this._dspApiConnection.v2.res.getResource(iri).subscribe(
            (response: ReadResource) => {
                const res = new DspResource(response);

                this.incomingResource = res;

                // if the resource is a still image, assign the iiiUrl to be passed as an input to the still-image component
                if (this.incomingResource.res.properties[Constants.HasStillImageFileValue]) {
                    this.iiifUrl = (this.incomingResource.res.properties[Constants.HasStillImageFileValue][0] as ReadStillImageFileValue).fileUrl;
                }

                res.resProps = this.initProps(response);
                res.systemProps = this.incomingResource.res.entityInfo.getPropertyDefinitionsByType(SystemPropertyDefinition);

                this.representationsToDisplay = this.collectRepresentationsAndAnnotations(this.incomingResource);

                if (this.representationsToDisplay.length && this.representationsToDisplay[0].fileValue && this.compoundPosition) {
                    this.getIncomingRegions(this.incomingResource, 0);
                }
            },
            (error: ApiResponseError) => {
                this._errorHandler.showMessage(error);
            }
        );
    }

    tabChanged(e: MatTabChangeEvent) {
        if (e.tab.textLabel === 'annotations') {
            this.stillImageComponent.renderRegions();
        } else {
            this.stillImageComponent.removeOverlays();
        }

        this.selectedTabLabel = e.tab.textLabel;
    }

    representationLoaded(e: boolean) {
        this.loading = !e;
    }

    /**
     * gather resource property information
     */
    protected initProps(resource: ReadResource): PropertyInfoValues[] {
        let props = resource.entityInfo.classes[resource.type].getResourcePropertiesList().map(
            (prop: IHasPropertyWithPropertyDefinition) => {
                let propInfoAndValues: PropertyInfoValues;

                switch (prop.propertyDefinition.objectType) {
                    case Constants.StillImageFileValue:
                        propInfoAndValues = {
                            propDef: prop.propertyDefinition,
                            guiDef: prop,
                            values: resource.getValuesAs(prop.propertyIndex, ReadStillImageFileValue)
                        };

                        const stillImageRepresentations = [new FileRepresentation(
                            resource.getValuesAs(Constants.HasStillImageFileValue, ReadStillImageFileValue)[0], [])
                        ];

                        this.representationsToDisplay = stillImageRepresentations;
                        // --> TODO: get regions here

                        break;

                    default:
                        // the object type is none from above
                        propInfoAndValues = {
                            propDef: prop.propertyDefinition,
                            guiDef: prop,
                            values: resource.getValues(prop.propertyIndex)
                        };
                }

                return propInfoAndValues;
            }
        );

        // sort properties by guiOrder
        props = props
            .filter(prop => prop.propDef.objectType !== Constants.GeomValue)
            .sort((a, b) => (a.guiDef.guiOrder > b.guiDef.guiOrder) ? 1 : -1);

        return props;
    }

    /**
     * creates a collection of [[StillImageRepresentation]] belonging to the given resource and assigns it to it.
     * each [[StillImageRepresentation]] represents an image including regions.
     *
     * @param resource The resource to get the images for.
     * @returns A collection of images for the given resource.
     */
    protected collectRepresentationsAndAnnotations(resource: DspResource): FileRepresentation[] {

        if (!resource) {
            return;
        }

        // general object for all kind of representations
        const representations: FileRepresentation[] = [];

        // --> TODO: use a switch here to go through the different representation types
        if (resource.res.properties[Constants.HasStillImageFileValue]) {
            // --> TODO: check if resources is a StillImageRepresentation using the ontology responder (support for subclass relations required)
            // resource has StillImageFileValues that are directly attached to it (properties)

            const fileValues: ReadStillImageFileValue[] = resource.res.properties[Constants.HasStillImageFileValue] as ReadStillImageFileValue[];

            for (const img of fileValues) {

                const regions: Region[] = [];

                const annotations: DspResource[] = [];

                for (const incomingRegion of resource.incomingAnnotations) {

                    const region = new Region(incomingRegion);
                    regions.push(region);

                    const annotation = new DspResource(incomingRegion);

                    // gather region property information
                    annotation.resProps = this.initProps(incomingRegion);

                    // gather system property information
                    annotation.systemProps = incomingRegion.entityInfo.getPropertyDefinitionsByType(SystemPropertyDefinition);

                    annotations.push(annotation);

                }

                const stillImage = new FileRepresentation(img, regions);

                representations.push(stillImage);

                this.annotationResources = annotations;

                // developer feature: this keeps the annotations tab open, if you add "/annotations" to the end of the URL
                // e.g. http://0.0.0.0:4200/resource/[project-shortcode]/[resource-iri]/annotations
                if (this.valueUuid === 'annotations' || this.selectedRegion === this.resourceIri) {
                    this.selectedTab = (this.incomingResource ? 2 : 1);
                    this.selectedTabLabel = 'annotations';
                }
            }

        } else if (resource.res.properties[Constants.HasDocumentFileValue]) {

            const fileValues: ReadDocumentFileValue[] = resource.res.properties[Constants.HasDocumentFileValue] as ReadDocumentFileValue[];
            for (const doc of fileValues) {

                const document = new FileRepresentation(doc);
                representations.push(document);
            }

        } else if (resource.res.properties[Constants.HasAudioFileValue]) {

            const fileValue: ReadAudioFileValue = resource.res.properties[Constants.HasAudioFileValue][0] as ReadAudioFileValue;
            const audio = new FileRepresentation(fileValue);
            representations.push(audio);

        } else if (resource.res.properties[Constants.HasMovingImageFileValue]) {

            const fileValue: ReadMovingImageFileValue = resource.res.properties[Constants.HasMovingImageFileValue][0] as ReadMovingImageFileValue;
            const video = new FileRepresentation(fileValue);
            representations.push(video);

        } else if (resource.res.properties[Constants.HasArchiveFileValue]) {

            const fileValue: ReadArchiveFileValue = resource.res.properties[Constants.HasArchiveFileValue][0] as ReadArchiveFileValue;
            const archive = new FileRepresentation(fileValue);
            representations.push(archive);

        }

        return representations;

    }

    /**
     * get StillImageRepresentations pointing to [[this.resource]].
     * This method may have to called several times with an increasing offsetChange in order to get all available StillImageRepresentations.
     *
     * @param offset the offset to be used (needed for paging). First request uses an offset of 0.
     * It takes the number of images returned as an argument.
     */
    protected getIncomingStillImageRepresentations(offset: number): void {
        // make sure that this.resource has been initialized correctly
        if (this.resource === undefined) {
            return;
        }

        if (offset < 0 || offset > this.compoundPosition.maxOffsets) {
            this._notification.openSnackBar(`Offset of ${offset} is invalid`);
            return;
        }

        // get all representations for compound resource of this offset sequence
        this._incomingService.getStillImageRepresentationsForCompoundResource(this.resource.res.id, offset).subscribe(
            (incomingImageRepresentations: ReadResourceSequence) => {

                if (incomingImageRepresentations.resources.length > 0) {

                    // set the incoming representations for the current offset only
                    this.resource.incomingRepresentations = incomingImageRepresentations.resources;
                    this.getIncomingResource(this.resource.incomingRepresentations[this.compoundPosition.position].id);

                } else {
                    this.loading = false;
                }
            },
            (error: ApiResponseError) => {
                this._errorHandler.showMessage(error);
            }
        );

    }

    /**
     * requests incoming resources for [[this.resource]].
     * Incoming resources are: regions, representations, and incoming links.
     */
    protected requestIncomingResources(resource: DspResource): void {

        // make sure that this resource has been initialized correctly
        if (resource === undefined) {
            return;
        }

        // request incoming regions --> TODO: add case to get incoming sequences in case of video and audio
        if (resource.res.properties[Constants.HasStillImageFileValue] ||
            resource.res.properties[Constants.HasDocumentFileValue] ||
            resource.res.properties[Constants.HasAudioFileValue] ||
            resource.res.properties[Constants.HasMovingImageFileValue] ||
            resource.res.properties[Constants.HasArchiveFileValue]) {
            // --> TODO: check if resources is a StillImageRepresentation using the ontology responder (support for subclass relations required)
            // the resource is a StillImageRepresentation, check if there are regions pointing to it

            this.getIncomingRegions(resource, 0);

        } else {
            // this resource is not a StillImageRepresentation
            // check if there are StillImageRepresentations pointing to this resource

            // this gets the first page of incoming StillImageRepresentations
            // more pages may be requested by [[this.viewer]].
            this.getIncomingStillImageRepresentations(this.compoundPosition.offset);
        }

        // check for incoming links for the current resource
        this.getIncomingLinks(0);

    }

    /**
     * gets the incoming regions for [[this.resource]].
     *
     * @param offset the offset to be used (needed for paging). First request uses an offset of 0.
     */
    protected getIncomingRegions(resource: DspResource, offset: number): void {
        this._incomingService.getIncomingRegions(resource.res.id, offset).subscribe(
            (regions: ReadResourceSequence) => {

                // append elements of regions.resources to resource.incoming
                Array.prototype.push.apply(resource.incomingAnnotations, regions.resources);

                // this.annotationResources.push(regions.resources)

                // prepare regions to be displayed
                // triggers ngOnChanges of StillImageComponent
                this.representationsToDisplay = this.collectRepresentationsAndAnnotations(resource);

            },
            (error: ApiResponseError) => {
                this._errorHandler.showMessage(error);
            }
        );
    }

    /**
     * get resources pointing to [[this.resource]] with properties other than knora-api:isPartOf and knora-api:isRegionOf.
     *
     * @param offset the offset to be used (needed for paging). First request uses an offset of 0.
     * It takes the number of images returned as an argument.
     */
    protected getIncomingLinks(offset: number): void {

        this._incomingService.getIncomingLinksForResource(this.resource.res.id, offset).subscribe(
            (incomingResources: ReadResourceSequence) => {

                // append elements incomingResources to this.resource.incomingLinks
                Array.prototype.push.apply(this.resource.res.incomingReferences, incomingResources.resources);
            },
            (error: ApiResponseError) => {
                this._errorHandler.showMessage(error);
            }
        );
    }

    openRegion(iri: string) {
        // open annotation tab
        this.selectedTab = (this.incomingResource ? 2 : 1);

        // activate the selected region
        this.selectedRegion = iri;

        // and scroll to region with this id
        const region = document.getElementById(iri);
        if (region) {
            region.scrollIntoView({
                behavior: 'smooth',
                block: 'center'
            });
        }

    }

    updateRegions(iri: string) {
        if (this.incomingResource) {
            this.incomingResource.incomingAnnotations = [];
        } else {
            this.resource.incomingAnnotations = [];
        }
        this.getIncomingRegions(this.incomingResource ? this.incomingResource : this.resource, 0);
        this.openRegion(iri);
    }

    updateRegion() {
        if (this.stillImageComponent !== undefined) {
            this.stillImageComponent.updateRegions();
        }
    }
}