cbsnexora/src/app/web-app.component.ts

/**
 * Copyright since 2025 Mifos Initiative
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */

/* eslint-disable @angular-eslint/prefer-inject */
/** Angular Imports */
import { Component, OnInit, HostListener, HostBinding, OnDestroy } from '@angular/core';
import { Router, NavigationEnd, ActivatedRoute } from '@angular/router';
import { Title } from '@angular/platform-browser';
import { MatSnackBar } from '@angular/material/snack-bar';
import { MatDialog } from '@angular/material/dialog';

/** rxjs Imports */
import { merge, Subscription, Subject } from 'rxjs';
import { filter, map, mergeMap, takeUntil, take } from 'rxjs/operators';

/** Translation Imports */
import { TranslateService } from '@ngx-translate/core';

/** Environment Configuration */
import { environment } from '../environments/environment';

/** Custom Services */
import { Logger } from './core/logger/logger.service';
import { ThemeStorageService } from './shared/theme-picker/theme-storage.service';
import { AlertService } from './core/alert/alert.service';
import { AuthenticationService } from './core/authentication/authentication.service';
import { SettingsService } from './settings/settings.service';
import { DocumentationLinksService } from 'app/shared/services/documentation-links.service';
import { IdleTimeoutService } from './home/timeout-dialog/idle-timeout.service';
import { SessionTimeoutDialogComponent } from './home/timeout-dialog/session-timeout-dialog.component';
import { ErrorDialogComponent } from './shared/error-dialog/error-dialog.component';

/** Custom Items */
import { Alert } from './core/alert/alert.model';
import { Dates } from './core/utils/dates';
import { animate, style, transition, trigger } from '@angular/animations';
import { I18nService } from './core/i18n/i18n.service';
import { ThemingService } from './shared/theme-toggle/theming.service';
import { KeyboardShortcutService } from './core/services/keyboard-shortcut.service';
import { ShortcutSuggestionService } from './core/services/shortcut-suggestion.service';

/** Initialize Logger */
const log = new Logger('MifosX');

import { registerLocaleData } from '@angular/common';
import localeCS from '@angular/common/locales/cs';
import localeEN from '@angular/common/locales/en';
import localeES from '@angular/common/locales/es';
import localeDE from '@angular/common/locales/de';
import localeFR from '@angular/common/locales/fr';
import localeIT from '@angular/common/locales/it';
import localeKO from '@angular/common/locales/ko';
import localeLT from '@angular/common/locales/lt';
import localeLV from '@angular/common/locales/lv';
import localeNE from '@angular/common/locales/ne';
import localePT from '@angular/common/locales/pt';
import localeSW from '@angular/common/locales/sw';
import { STANDALONE_SHARED_IMPORTS } from 'app/standalone-shared.module';
registerLocaleData(localeCS);
registerLocaleData(localeEN);
registerLocaleData(localeES);
registerLocaleData(localeDE);
registerLocaleData(localeFR);
registerLocaleData(localeIT);
registerLocaleData(localeKO);
registerLocaleData(localeLT);
registerLocaleData(localeLV);
registerLocaleData(localeNE);
registerLocaleData(localePT);
registerLocaleData(localeSW);

/**
 * Main web app component.
 */
@Component({
  selector: 'mifosx-web-app',
  templateUrl: './web-app.component.html',
  styleUrls: ['./web-app.component.scss'],
  animations: [
    trigger('opacityScale', [
      transition(':enter', [
        style({ opacity: 0, transform: 'scale(.95)' }),
        animate('100ms ease-out', style({ opacity: 1, transform: 'scale(1)' }))
      ]),
      transition(':leave', [
        style({ opacity: 1, transform: 'scale(1)' }),
        animate('75ms ease-in', style({ opacity: 0, transform: 'scale(.95)' }))
      ])
    ])
  ],

  // eslint-disable-next-line @angular-eslint/prefer-standalone
  standalone: false
})
export class WebAppComponent implements OnInit, OnDestroy {
  i18nService: I18nService;

  private authSubscription: Subscription;
  private destroy$ = new Subject<void>();

  /**
   * @param {Router} router Router for navigation.
   * @param {ActivatedRoute} activatedRoute Activated Route.
   * @param {Title} titleService Title Service.
   * @param {TranslateService} translateService Translate Service.
   * @param {ThemeStorageService} themeStorageService Theme Storage Service.
   * @param {MatSnackBar} snackBar Material Snackbar for notifications.
   * @param {AlertService} alertService Alert Service.
   * @param {SettingsService} settingsService Settings Service.
   * @param {AuthenticationService} authenticationService Authentication service.
   * @param {Dates} dateUtils Dates service.
   * @param {IdleTimeoutService} idle Idle timeout service.
   * @param {MatDialog} dialog Dialog component.
   */
  constructor(
    private router: Router,
    private activatedRoute: ActivatedRoute,
    private titleService: Title,
    private translateService: TranslateService,
    private themeStorageService: ThemeStorageService,
    public snackBar: MatSnackBar,
    private alertService: AlertService,
    private settingsService: SettingsService,
    private authenticationService: AuthenticationService,
    private themingService: ThemingService,
    private dateUtils: Dates,
    private idle: IdleTimeoutService,
    private dialog: MatDialog,
    private documentationLinks: DocumentationLinksService,
    private keyboardShortcutService: KeyboardShortcutService,
    private shortcutSuggestionService: ShortcutSuggestionService
  ) {}

  @HostBinding('class') public cssClass: string;

  /**
   * Initial Setup:
   *
   * 1) Logger
   *
   * 2) Language and Translations
   *
   * 3) Page Title
   *
   * 4) Alerts
   */

  ngOnInit() {
    this.themingService.theme.subscribe((value: string) => {
      this.cssClass = value;
    });
    this.themingService.setInitialDarkMode();
    this.themingService.setDarkMode(!!this.settingsService.themeDarkEnabled);

    // Setup logger
    if (environment.production) {
      Logger.enableProductionMode();
    }
    log.debug('init');

    // Setup translations
    this.translateService.addLangs(environment.supportedLanguages.split(','));
    if (this.settingsService.language) {
      this.translateService.use(this.settingsService.languageCode);
    } else {
      this.translateService.use(environment.defaultLanguage);
    }

    this.i18nService = new I18nService(this.translateService);

    // Change page title on navigation or language change, based on route data
    const onNavigationEnd = this.router.events.pipe(filter((event) => event instanceof NavigationEnd));
    merge(this.translateService.onLangChange, onNavigationEnd)
      .pipe(
        map(() => {
          let route = this.activatedRoute;
          while (route.firstChild) {
            route = route.firstChild;
          }
          return route;
        }),
        filter((route) => route.outlet === 'primary'),
        mergeMap((route) => route.data),
        takeUntil(this.destroy$)
      )
      .subscribe((event) => {
        if (!event['title']) {
          this.i18nService
            .translate('APP_NAME')
            .pipe(take(1))
            .subscribe((t: any) => this.titleService.setTitle(t));
          return;
        }
        const raw = event['title'];
        const textKey = `labels.text.${raw}`;
        const menuKey = `labels.menus.${raw}`;
        this.i18nService
          .translate(textKey)
          .pipe(take(1))
          .subscribe((textResult: any) => {
            if (textResult !== textKey) {
              this.titleService.setTitle(textResult);
            } else {
              this.i18nService
                .translate(menuKey)
                .pipe(take(1))
                .subscribe((menuResult: any) => {
                  this.titleService.setTitle(menuResult !== menuKey ? menuResult : raw);
                });
            }
          });
      });

    // Stores top 100 user activites as local storage object.
    let activities: string[] = [];
    if (localStorage.getItem('mifosXLocation')) {
      const activitiesArray: string[] = JSON.parse(localStorage.getItem('mifosXLocation'));
      const length = activitiesArray.length;
      activities = length > 100 ? activitiesArray.slice(length - 100) : activitiesArray;
    }
    // Store route URLs array in local storage on navigation end.
    onNavigationEnd.pipe(takeUntil(this.destroy$)).subscribe(() => {
      activities.push(this.router.url);
      localStorage.setItem('mifosXLocation', JSON.stringify(activities));
    });

    // Setup alerts
    this.alertService.alertEvent.subscribe((alertEvent: Alert) => {
      if (alertEvent.severity === 'error') {
        // Errors go to a centred modal instead of the corner snack bar: they need to be read and
        // acknowledged, and a toast that self-dismisses after 2s was being missed entirely.
        this.dialog.open(ErrorDialogComponent, {
          data: { title: alertEvent.type, message: alertEvent.message },
          autoFocus: true,
          restoreFocus: true
        });
        return;
      }
      this.snackBar.open(`${alertEvent.message}`, 'Close', {
        duration: 2000,
        horizontalPosition: 'right',
        verticalPosition: 'top'
      });
    });

    // initialize language and date format if they are null.
    if (!localStorage.getItem('mifosXLanguage')) {
      this.settingsService.setDefaultLanguage();
    }
    // Set default max date picker as Today
    this.settingsService.setBusinessDate(this.dateUtils.formatDate(new Date(), SettingsService.businessDateFormat));
    // Set the server list from the env var FINERACT_API_URLS, but avoid overwriting "Add new server" user choice
    if (!this.settingsService.servers) {
      this.settingsService.setServers(environment.baseApiUrls.split(','));
    }
    // Set the Tenant Identifier(s) list from the env var
    if (!localStorage.getItem('mifosXTenantIdentifier')) {
      this.settingsService.setTenantIdentifier(environment.fineractPlatformTenantId || 'default');
    }
    this.settingsService.setTenantIdentifiers(environment.fineractPlatformTenantIds.split(','));

    // Subscribe to session timeout If IdleTimeout is higher than 0 (zero)
    if (environment.session.timeout.idleTimeout > 0) {
      this.authSubscription = this.authenticationService.isAuthenticated$.subscribe((loggedIn) => {
        if (loggedIn) {
          this.idle.start();
          this.keyboardShortcutService.initShortcuts();
          this.shortcutSuggestionService.init();
        } else {
          this.idle.stop();
        }
      });

      this.idle.$onSessionTimeout.subscribe(() => {
        const warningCountdown = (environment.session.timeout as any).warningCountdown || 60;
        const dialogRef = this.dialog.open(SessionTimeoutDialogComponent, {
          disableClose: true,
          data: { countdownSeconds: warningCountdown }
        });

        dialogRef.afterClosed().subscribe((result) => {
          if (result === 'keep-alive') {
            this.idle.start();
          } else {
            this.alertService.alert({
              type: 'Session timeout',
              message: this.translateService.instant('labels.text.Session timed out')
            });
            this.logout();
          }
        });
      });
    }
  }

  ngOnDestroy() {
    this.destroy$.next();
    this.destroy$.complete();
    if (this.authSubscription) {
      this.authSubscription.unsubscribe();
    }
  }

  logout() {
    this.authenticationService.logout().subscribe(() => this.router.navigate(['/login'], { replaceUrl: true }));
  }

  help() {
    this.documentationLinks.open('userManual');
  }
}