app/services/rights/abilityBuilder.ts

import * as yaml from 'yaml-import'
import * as _ from 'lodash-es'
import type { MongoAbility } from '@casl/ability/dist/types/Ability'
import RoleUtils from '~/services/rights/roleUtils'
import type { AbilitiesType, AccessProfile } from '~/types/interfaces'
import type { ABILITIES } from '~/types/enum/enums'
import type OrganizationProfile from '~/models/Organization/OrganizationProfile'

interface ConditionParameters {
  action: string
  subject: string
}

interface Condition {
  function: string
  parameters?: Array<string | ConditionParameters>
  expectedResult?: boolean
}

/**
 * Classe permettant de mener des opérations sur les habilités
 */
class AbilityBuilder {
  private readonly ability: MongoAbility = {} as MongoAbility
  private readonly accessProfile: AccessProfile
  private readonly organizationProfile: OrganizationProfile

  private readonly configFile = './config/abilities/config.yaml'

  private abilities: Array<AbilitiesType> = []

  /**
   * @constructor
   */
  constructor(
    ability: MongoAbility,
    accessProfile: AccessProfile,
    organizationProfile: OrganizationProfile,
  ) {
    this.ability = ability
    this.accessProfile = accessProfile
    this.organizationProfile = organizationProfile
  }

  /**
   * Construit et renvoie l'ensemble des habilités de l'utilisateur, qu'elles soient issues de ses roles
   * ou de la configuration
   *
   * @return {Array<AbilitiesType>}
   */
  buildAbilities(): Array<AbilitiesType> {
    // Build from roles
    this.abilities = this.buildAbilitiesFromRoles()
    this.ability.update(this.abilities)

    // Build from config
    this.abilities = this.abilities.concat(this.buildAbilitiesFromConfig())
    this.ability.update(this.abilities)

    return this.abilities
  }

  /**
   * Adaptation et transformations des roles symfony en abilities Casl
   */
  buildAbilitiesFromRoles() {
    return RoleUtils.rolesToAbilities(this.accessProfile.roles)
  }

  /**
   * Charge les habilités depuis les fichiers de configuration
   */
  buildAbilitiesFromConfig() {
    const abilitiesByConfig: Array<AbilitiesType> = []

    const doc = yaml.read(this.configFile)
    const fromConfig = doc.abilities

    _.each(
      fromConfig,
      (
        ability: { action: ABILITIES; conditions: Array<Condition> },
        subject: string,
      ) => {
        // eslint-disable-next-line prefer-const
        let { action, conditions } = ability

        if (!Array.isArray(conditions)) {
          // Special: la denormalization ne produit pas une array s'il n'y a qu'un seul élément
          conditions = [conditions]
        }

        const hasAbility = this.hasConfigAbility(
          conditions as Array<Condition>,
          subject,
        )

        abilitiesByConfig.push({ action, subject, inverted: !hasAbility })
      },
    )

    return abilitiesByConfig
  }

  /**
   * Parcourt les services définis dans la configuration, et établit si oui ou non l'habilité est autorisée
   *
   * @return {boolean}
   * @param conditions  Les conditions à l'obtention de l'habileté, telles que définies dans les fichiers de config
   * @param subject  For debugging purpose only
   */
  hasConfigAbility(conditions: Array<Condition>, subject: string = '') {
    return conditions.every((condition) =>
      this.execAndValidateCondition(condition, subject),
    )
  }

  // noinspection JSUnusedGlobalSymbols
  /**
   * Correspondances entre les noms des fonctions définies dans les conditions des fichiers de configuration et
   * les méthodes correspondantes
   *
   * TODO: voir pourquoi on a besoin d'accepter un param null pour le hasProfile?
   */
  handlerMap: Record<
    string,
    (parameters: Array<ConditionParameters | string>) => boolean
  > = {
    accessHasAllRoleAbilities: (
      parameters: Array<ConditionParameters | string>,
    ) => this.hasAllRoleAbilities(parameters),
    accessHasAnyRoleAbility: (
      parameters: Array<ConditionParameters | string>,
    ) => this.hasAnyRoleAbility(parameters),
    accessHasAnyProfile: (parameters: Array<ConditionParameters | string>) =>
      parameters === null || this.hasAnyProfile(parameters),
    organizationHasAllModules: (
      parameters: Array<ConditionParameters | string>,
    ) => this.hasAllModules(parameters),
    organizationHasAnyModule: (
      parameters: Array<ConditionParameters | string>,
    ) => this.hasAnyModule(parameters),
    accessIsAdminAccount: (_) => this.accessProfile.isAdminAccount,
    organizationIsSchool: (_) => this.organizationProfile.isSchool,
    organizationIsArtist: (_) => this.organizationProfile.isArtist,
    organizationIsManagerProduct: (_) =>
      this.organizationProfile.isManagerProduct,
    organizationHasChildren: (_) => this.organizationProfile.hasChildren,
    organizationIsAssociation: (_) => this.organizationProfile.isAssociation,
    organizationIsShowAdherentList: (_) =>
      this.organizationProfile.isShowAdherentList,
    organizationIsCmf: (_) => this.organizationProfile.isCmf,
    organizationHasWebsite: (_) => this.organizationProfile.getWebsite,
  }

  /**
   * Exécute la fonction associée à la condition, et compare le résultat obtenu au résultat attendu (true par défaut)
   *
   * @param condition  Un condition à la possession d'une habilité, telle que définie dans les fichiers de config
   * @param subject  For debugging purpose only
   * @private
   */
  protected execAndValidateCondition(
    condition: Condition,
    // eslint-disable-next-line @typescript-eslint/no-unused-vars
    subject: string = '',
  ) {
    const expectedResult: boolean = condition.expectedResult ?? true
    const parameters = condition.parameters ?? []

    if (!(condition.function in this.handlerMap)) {
      throw new Error('unknown condition function : ' + condition.function)
    }
    const actualResult = this.handlerMap[condition.function](parameters ?? null)

    return actualResult === expectedResult
  }

  /**
   * Est-ce que l'utilisateur possède l'habilité en paramètre
   *
   * @return {boolean}
   * @param ability
   */
  hasRoleAbility(ability: ConditionParameters | string): boolean {
    if (!Object.prototype.hasOwnProperty.call(ability, 'action')) {
      throw new Error(
        'hasRoleAbility except a ConditionParameters object, not a string',
      )
    }
    ability = ability as ConditionParameters
    return this.ability.can(ability.action, ability.subject)
  }

  /**
   * Est-ce que l'utilisateur possède toutes les habilités passées en paramètre
   *
   * @param {Array<AbilitiesType>} abilities Habilités à tester
   * @return {boolean}
   */
  hasAllRoleAbilities(abilities: Array<ConditionParameters | string>): boolean {
    return abilities.every((ability) => this.hasRoleAbility(ability))
  }

  /**
   * Est-ce que l'utilisateur possède au moins l'une des habilités passées en paramètre
   *
   * @param {Array<AbilitiesType>} abilities Habilités à tester
   * @return {boolean}
   */
  hasAnyRoleAbility(abilities: Array<ConditionParameters | string>): boolean {
    return abilities.some((ability) => this.hasRoleAbility(ability))
  }

  /**
   * Teste si l'utilisateur possède le profil donné
   *
   * @param {string} profile Profil à tester
   * @return {boolean}
   */
  hasProfile(profile: ConditionParameters | string): boolean {
    if (Object.prototype.hasOwnProperty.call(profile, 'subject')) {
      profile = (profile as ConditionParameters).subject
    }

    return (
      {
        admin: this.accessProfile.isAdmin,
        administratifManager: this.accessProfile.isAdministratifManager,
        pedagogicManager: this.accessProfile.isPedagogicManager,
        financialManager: this.accessProfile.isFinancialManager,
        caMember: this.accessProfile.isCaMember,
        student: this.accessProfile.isStudent,
        teacher: this.accessProfile.isTeacher,
        member: this.accessProfile.isMember,
        other: this.accessProfile.isOther,
        guardian: this.accessProfile.isGuardian,
        payor: this.accessProfile.isPayer,
      }[profile as string] ?? false
    )
  }

  /**
   * Retourne vrai si l'utilisateur connecté possède l'un des profils passés en paramètre
   *
   * @param {Array<string>} profiles Profils à tester
   * @return {boolean}
   */
  hasAnyProfile(profiles: Array<ConditionParameters | string>): boolean {
    return profiles.some((p) => this.hasProfile(p))
  }

  /**
   * Retourne vrai si l'utilisateur connecté possède tous les profils passés en paramètre
   *
   * @param {Array<string>} profiles Profils à tester
   * @return {boolean}
   */
  hasAllProfiles(profiles: Array<ConditionParameters | string>): boolean {
    return profiles.every((p) => this.hasProfile(p))
  }

  /**
   * Est-ce que l'utilisateur possède le rôle donné ?
   *
   * @return {boolean}
   * @param role
   */
  hasRole(role: string): boolean {
    return this.accessProfile.hasRole(role)
  }

  /**
   * L'utilisateur possède-t-il au moins l'un des rôles donnés
   *
   * @return {boolean}
   * @param roles
   */
  hasAnyRole(roles: Array<string>): boolean {
    return roles.some((r) => this.hasRole(r))
  }

  /**
   * L'utilisateur possède-t-il tous les rôles donnés
   *
   * @return {boolean}
   * @param roles
   */
  hasAllRoles(roles: Array<string>): boolean {
    return roles.every((r) => this.hasRole(r))
  }

  /**
   * Est-ce que l'organisation possède le module donné
   *
   * @return {boolean}
   * @param module
   */
  hasModule(module: ConditionParameters | string): boolean {
    if (Object.prototype.hasOwnProperty.call(module, 'subject')) {
      module = (module as ConditionParameters).subject
    }

    return this.organizationProfile.hasModule(module)
  }

  /**
   * Est-ce que l'organisation possède au moins un des modules donnés
   *
   * @param modules
   * @return {boolean}
   */
  hasAnyModule(modules: Array<ConditionParameters | string>): boolean {
    return modules.some((r) => this.hasModule(r))
  }

  /**
   * Est-ce que l'organisation possède-t-il tous les modules donnés
   *
   * @param modules
   * @return {boolean}
   */
  hasAllModules(modules: Array<ConditionParameters | string>): boolean {
    return modules.every((r) => this.hasModule(r))
  }
}

export default AbilityBuilder