Vmeda.Online/src/addons/messages/pages/settings/settings.ts

// (C) Copyright 2015 Moodle Pty 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, OnDestroy, OnInit, signal } from '@angular/core';
import {
    AddonMessagesProvider, AddonMessagesMessagePreferences,
    AddonMessagesMessagePreferencesNotification,
    AddonMessagesMessagePreferencesNotificationProcessor,
    AddonMessages,
} from '../../services/messages';
import { CoreUser } from '@features/user/services/user';
import { CoreConfig } from '@services/config';
import { CoreEvents } from '@singletons/events';
import { CoreSites } from '@services/sites';
import { CoreDomUtils } from '@services/utils/dom';
import { CoreConstants } from '@/core/constants';
import { AddonNotificationsPreferencesNotificationProcessorState } from '@addons/notifications/services/notifications';
import { CorePlatform } from '@services/platform';
import { CoreTextUtils } from '@services/utils/text';

/**
 * Page that displays the messages settings page.
 */
@Component({
    selector: 'page-addon-messages-settings',
    templateUrl: 'settings.html',
})
export class AddonMessagesSettingsPage implements OnInit, OnDestroy {

    protected updateTimeout?: number;

    preferences?: AddonMessagesMessagePreferences;
    preferencesLoaded = false;
    contactablePrivacy?: number | boolean;
    advancedContactable = false; // Whether the site supports "advanced" contactable privacy.
    allowSiteMessaging = false;
    onlyContactsValue = AddonMessagesProvider.MESSAGE_PRIVACY_ONLYCONTACTS;
    courseMemberValue = AddonMessagesProvider.MESSAGE_PRIVACY_COURSEMEMBER;
    siteValue = AddonMessagesProvider.MESSAGE_PRIVACY_SITE;
    groupMessagingEnabled = false;
    sendOnEnter = false;
    warningMessage = signal<string | undefined>(undefined);

    protected loggedInOffLegacyMode = false;
    protected previousContactableValue?: number | boolean;

    constructor() {

        const currentSite = CoreSites.getRequiredCurrentSite();
        this.advancedContactable = !!currentSite.isVersionGreaterEqualThan('3.6');
        this.allowSiteMessaging = !!currentSite.canUseAdvancedFeature('messagingallusers');
        this.groupMessagingEnabled = AddonMessages.isGroupMessagingEnabled();
        this.loggedInOffLegacyMode = !currentSite.isVersionGreaterEqualThan('4.0');

        this.asyncInit();
    }

    protected async asyncInit(): Promise<void> {
        this.sendOnEnter = !!(await CoreConfig.get(CoreConstants.SETTINGS_SEND_ON_ENTER, !CorePlatform.isMobile()));
    }

    /**
     * @inheritdoc
     */
    ngOnInit(): void {
        this.fetchPreferences();
    }

    /**
     * Fetches preference data.
     *
     * @returns Promise resolved when done.
     */
    protected async fetchPreferences(): Promise<void> {
        try {
            const preferences = await AddonMessages.getMessagePreferences();
            if (this.groupMessagingEnabled) {
                // Simplify the preferences.
                for (const component of preferences.components) {
                    // Only display get the notification preferences.
                    component.notifications = component.notifications.filter((notification) =>
                        notification.preferencekey == AddonMessagesProvider.NOTIFICATION_PREFERENCES_KEY);

                    if (this.loggedInOffLegacyMode) {
                        // Load enabled from loggedin / loggedoff values.
                        component.notifications.forEach((notification) => {
                            notification.processors.forEach(
                                (processor) => {
                                    processor.enabled = processor.loggedin.checked || processor.loggedoff.checked;
                                },
                            );
                        });
                    }
                }
            }

            this.preferences = preferences;
            this.contactablePrivacy = preferences.blocknoncontacts;
            this.previousContactableValue = this.contactablePrivacy;
            this.warningMessage.set(undefined);
        } catch (error) {
            if (error.errorcode === 'nopermissions') {
                this.warningMessage.set(CoreTextUtils.getErrorMessageFromError(error));

                return;
            }

            CoreDomUtils.showErrorModal(error);
        } finally {
            this.preferencesLoaded = true;
        }
    }

    /**
     * Update preferences. The purpose is to store the updated data, it won't be reflected in the view.
     */
    protected updatePreferences(): void {
        AddonMessages.invalidateMessagePreferences().finally(() => {
            this.fetchPreferences();
        });
    }

    /**
     * Update preferences after a certain time. The purpose is to store the updated data, it won't be reflected in the view.
     */
    protected updatePreferencesAfterDelay(): void {
        // Cancel pending updates.
        clearTimeout(this.updateTimeout);

        this.updateTimeout = window.setTimeout(() => {
            this.updateTimeout = undefined;
            this.updatePreferences();
        }, 5000);
    }

    /**
     * Save the contactable privacy setting..
     *
     * @param value The value to set.
     */
    async saveContactablePrivacy(value?: number | boolean): Promise<void> {
        if (this.contactablePrivacy == this.previousContactableValue) {
            // Value hasn't changed from previous, it probably means that we just fetched the value from the server.
            return;
        }

        const modal = await CoreDomUtils.showModalLoading('core.sending', true);

        if (!this.advancedContactable) {
            // Convert from boolean to number.
            value = value ? 1 : 0;
        }

        try {
            await CoreUser.updateUserPreference('message_blocknoncontacts', String(value));
            // Update the preferences since they were modified.
            this.updatePreferencesAfterDelay();
            this.previousContactableValue = this.contactablePrivacy;
        } catch (message) {
            // Show error and revert change.
            CoreDomUtils.showErrorModal(message);
            this.contactablePrivacy = this.previousContactableValue;
        } finally {
            modal.dismiss();
        }
    }

    /**
     * Change the value of a certain preference. Versions 3.6 onwards.
     *
     * @param notification Notification object.
     * @param processor Notification processor.
     */
    async changePreference(
        notification: AddonMessagesMessagePreferencesNotificationFormatted,
        processor: AddonMessagesMessagePreferencesNotificationProcessor,
    ): Promise<void> {
        // Update both states at the same time.
        let value = notification.processors
            .filter((processor) => processor.enabled)
            .map((processor) => processor.name)
            .join(',');

        if (value == '') {
            value = 'none';
        }

        notification.updating = true;

        const promises: Promise<void>[] = [];
        if (this.loggedInOffLegacyMode) {
            promises.push(CoreUser.updateUserPreference(notification.preferencekey + '_loggedin', value));
            promises.push(CoreUser.updateUserPreference(notification.preferencekey + '_loggedoff', value));
        }  else {
            promises.push(CoreUser.updateUserPreference(notification.preferencekey + '_enabled', value));
        }

        try {
            await Promise.all(promises);
            // Update the preferences since they were modified.
            this.updatePreferencesAfterDelay();
        } catch (error) {
            // Show error and revert change.
            CoreDomUtils.showErrorModal(error);
            processor.enabled = !processor.enabled;
        } finally {
            notification.updating = false;
        }
    }

    /**
     * Change the value of a certain preference. Only on version 3.5.
     *
     * @param notification Notification object.
     * @param processor Notification processor.
     * @param state State name, ['loggedin', 'loggedoff'].
     */
    async changePreferenceLegacy(
        notification: AddonMessagesMessagePreferencesNotificationFormatted,
        processor: AddonMessagesMessagePreferencesNotificationProcessor,
        state: 'loggedin' | 'loggedoff',
    ): Promise<void> {
        // Update only the specified state.
        const processorState: AddonNotificationsPreferencesNotificationProcessorState = processor[state];
        const preferenceName = notification.preferencekey + '_' + processorState.name;

        const value = notification.processors
            .filter((processor) => processor[state].checked)
            .map((processor) => processor.name)
            .join(',');

        notification['updating'+state] = true;
        try {
            await CoreUser.updateUserPreference(preferenceName, value);
            // Update the preferences since they were modified.
            this.updatePreferencesAfterDelay();
        } catch (error) {
            // Show error and revert change.
            CoreDomUtils.showErrorModal(error);
            processorState.checked = !processorState.checked;
        } finally {
            notification['updating'+state] = false;
        }
    }

    /**
     * Refresh the list of preferences.
     *
     * @param refresher Refresher.
     */
    refreshPreferences(refresher?: HTMLIonRefresherElement): void {
        AddonMessages.invalidateMessagePreferences().finally(() => {
            this.fetchPreferences().finally(() => {
                refresher?.complete();
            });
        });
    }

    /**
     * Send on Enter toggle has changed.
     */
    sendOnEnterChanged(): void {
        // Save the value.
        CoreConfig.set(CoreConstants.SETTINGS_SEND_ON_ENTER, this.sendOnEnter ? 1 : 0);

        // Notify the app.
        CoreEvents.trigger(
            CoreEvents.SEND_ON_ENTER_CHANGED,
            { sendOnEnter: !!this.sendOnEnter },
            CoreSites.getCurrentSiteId(),
        );
    }

    /**
     * @inheritdoc
     */
    ngOnDestroy(): void {
        // If there is a pending action to update preferences, execute it right now.
        if (this.updateTimeout) {
            clearTimeout(this.updateTimeout);
            this.updatePreferences();
        }
    }

}

/**
 * Message preferences notification with some caclulated data.
 */
type AddonMessagesMessagePreferencesNotificationFormatted = AddonMessagesMessagePreferencesNotification & {
    updating?: boolean; // Calculated in the app. Whether the notification is being updated.
    updatingloggedin?: boolean; // Calculated in the app. Whether the notification is being updated.
    updatingloggedoff?: boolean; // Calculated in the app. Whether the notification is being updated.
};