alfresco-ng2-components/lib/core/src/lib/services/renditions.service.ts

/*!
 * @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 { RenditionEntry, RenditionPaging, RenditionsApi, ContentApi } from '@alfresco/js-api';
import { Observable, from, interval, empty } from 'rxjs';
import { AlfrescoApiService } from './alfresco-api.service';
import { concatMap, switchMap, takeWhile, map } from 'rxjs/operators';

@Injectable({
    providedIn: 'root'
})
export class RenditionsService {

    private _renditionsApi: RenditionsApi;
    get renditionsApi(): RenditionsApi {
        this._renditionsApi = this._renditionsApi ?? new RenditionsApi(this.apiService.getInstance());
        return this._renditionsApi;
    }

    private _contentApi: ContentApi;
    get contentApi(): ContentApi {
        this._contentApi = this._contentApi ?? new ContentApi(this.apiService.getInstance());
        return this._contentApi;
    }

    constructor(private apiService: AlfrescoApiService) {
    }

    /**
     * Gets the first available rendition found for a node.
     *
     * @param nodeId ID of the target node
     * @returns Information object for the rendition
     */
    getAvailableRenditionForNode(nodeId: string): Observable<RenditionEntry> {
        return from(this.renditionsApi.listRenditions(nodeId)).pipe(
            map((availableRenditions: RenditionPaging) => {
                const renditionsAvailable: RenditionEntry[] = availableRenditions.list.entries.filter(
                    (rendition) => (rendition.entry.id === 'pdf' || rendition.entry.id === 'imgpreview'));
                const existingRendition = renditionsAvailable.find((rend) => rend.entry.status === 'CREATED');
                return existingRendition ? existingRendition : renditionsAvailable[0];
            }));
    }

    /**
     * Generates a rendition for a node using the first available encoding.
     *
     * @param nodeId ID of the target node
     * @returns Null response to indicate completion
     */
    generateRenditionForNode(nodeId: string): Observable<any> {
        return this.getAvailableRenditionForNode(nodeId).pipe(
            map((rendition: RenditionEntry) => {
                if (rendition.entry.status !== 'CREATED') {
                    return from(this.renditionsApi.createRendition(nodeId, { id: rendition.entry.id }));
                } else {
                    return empty();
                }
            })
        );
    }

    /**
     * Checks if the specified rendition is available for a node.
     *
     * @param nodeId ID of the target node
     * @param encoding Name of the rendition encoding
     * @returns True if the rendition is available, false otherwise
     */
    isRenditionAvailable(nodeId: string, encoding: string): Observable<boolean> {
        return new Observable((observer) => {
            this.getRendition(nodeId, encoding).subscribe(
                (res) => {
                    let isAvailable = true;
                    if (res.entry.status.toString() === 'NOT_CREATED') {
                        isAvailable = false;
                    }
                    observer.next(isAvailable);
                    observer.complete();
                },
                () => {
                    observer.next(false);
                    observer.complete();
                }
            );
        });
    }

    /**
     * Checks if the node can be converted using the specified rendition.
     *
     * @param nodeId ID of the target node
     * @param encoding Name of the rendition encoding
     * @returns True if the node can be converted, false otherwise
     */
    isConversionPossible(nodeId: string, encoding: string): Observable<boolean> {
        return new Observable((observer) => {
            this.getRendition(nodeId, encoding).subscribe(
                () => {
                    observer.next(true);
                    observer.complete();
                },
                () => {
                    observer.next(false);
                    observer.complete();
                }
            );
        });
    }

    /**
     * Gets a URL linking to the specified rendition of a node.
     *
     * @param nodeId ID of the target node
     * @param encoding Name of the rendition encoding
     * @returns URL string
     */
    getRenditionUrl(nodeId: string, encoding: string): string {
        return this.contentApi.getRenditionUrl(nodeId, encoding);
    }

    /**
     * Gets information about a rendition of a node.
     *
     * @param nodeId ID of the target node
     * @param encoding Name of the rendition encoding
     * @returns Information object about the rendition
     */
    getRendition(nodeId: string, encoding: string): Observable<RenditionEntry> {
        return from(this.renditionsApi.getRendition(nodeId, encoding));
    }

    /**
     * Gets a list of all renditions for a node.
     *
     * @param nodeId ID of the target node
     * @returns Paged list of rendition details
     */
    getRenditionsListByNodeId(nodeId: string): Observable<RenditionPaging> {
        return from(this.renditionsApi.listRenditions(nodeId));
    }

    /**
     * Creates a rendition for a node.
     *
     * @param nodeId ID of the target node
     * @param encoding Name of the rendition encoding
     * @returns Null response to indicate completion
     */
    createRendition(nodeId: string, encoding: string): Observable<any> {
        return from(this.renditionsApi.createRendition(nodeId, { id: encoding }));
    }

    /**
     * Repeatedly attempts to create a rendition, through to success or failure.
     *
     * @param nodeId ID of the target node
     * @param encoding Name of the rendition encoding
     * @param pollingInterval Time interval (in milliseconds) between checks for completion
     * @param retries Number of attempts to make before declaring failure
     * @returns True if the rendition was created, false otherwise
     */
    convert(nodeId: string, encoding: string, pollingInterval: number = 1000, retries: number = 5) {
        return this.createRendition(nodeId, encoding)
            .pipe(
                concatMap(() => this.pollRendition(nodeId, encoding, pollingInterval, retries))
            );
    }

    private pollRendition(nodeId: string, encoding: string, intervalSize: number = 1000, retries: number = 5) {
        let attempts = 0;
        return interval(intervalSize)
            .pipe(
                switchMap(() => this.getRendition(nodeId, encoding)),
                takeWhile((renditionEntry: RenditionEntry) => {
                    attempts += 1;
                    if (attempts > retries) {
                        return false;
                    }
                    return (renditionEntry.entry.status.toString() !== 'CREATED');
                })
            );
    }
}