diff --git a/src/app.ts b/src/app.ts index 935f54e4a0af76c050444ee6c1739b91323b803a..a0060928a01f8304df7d0be5682df4b9886e38b8 100644 --- a/src/app.ts +++ b/src/app.ts @@ -193,7 +193,7 @@ const server = new ApolloServer({ context, playground: { settings: { - "editor.theme": "dark", + "editor.theme": 'dark', "editor.cursorShape": 'line', "request.credentials": 'include' } diff --git a/src/graphql/models/authorization.ts b/src/graphql/models/authorization.ts index 2ee81593be8918759b179b846b249033acdc1dbf..c9072aaedced37ac66cdf8f9477d82eb9e0802b6 100644 --- a/src/graphql/models/authorization.ts +++ b/src/graphql/models/authorization.ts @@ -85,7 +85,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function getUid - * @summary Fonction qui renvoit l'identifiant de l'utilisateur + * @summary Fonction qui renvoie l'identifiant de l'utilisateur * @return {string} Renvoie l'uid de l'utilisateur du 'context' */ getUid(): string { @@ -95,7 +95,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function isConnectedOrOnplatal - * @summary Fonction qui renvoit si l'utilisateur est connecté ou on-platal + * @summary Fonction qui renvoie si l'utilisateur est connecté ou on-platal * @return {boolean} Renvoie true si l'utilisateur est connecté ou on-platal */ isConnectedOrOnplatal(): boolean { @@ -105,7 +105,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function isAuthenticated - * @summary Fonction qui renvoit si l'utilisateur est authentifié + * @summary Fonction qui renvoie si l'utilisateur est authentifié * @return {boolean} Renvoie true si l'utilisateur est authentifié */ isAuthenticated(): boolean { @@ -116,7 +116,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function isViewer - * @summary Fonction qui renvoit si l'utilisateur est viewer du groupe. + * @summary Fonction qui renvoie si l'utilisateur est viewer du groupe. * @arg {string} gid - Identifiant du groupe. * @return {Promise(boolean)} Renvoie true si l'utilisateur est viewer du groupe. * @async @@ -134,7 +134,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function groupsViewer - * @summary Fonction qui renvoit les groupes dont l'utilisateur est viewer. + * @summary Fonction qui renvoie les groupes dont l'utilisateur est viewer. * @return {Promise(GroupCollection)} Renvoie la collection de groupes dont l'utilisateur est viewer. * @async */ @@ -150,7 +150,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function isMember - * @summary Fonction qui renvoit si l'utilisateur est membre du groupe. + * @summary Fonction qui renvoie si l'utilisateur est membre du groupe. * @arg {string} gid - Identifiant du groupe. * @return {Promise(boolean)} Renvoie true si l'utilisateur est membre du groupe. * @async @@ -168,7 +168,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function isMemberOr - * @summary Fonction qui renvoit si l'utilisateur est membre d'au moins un de ces groupes. + * @summary Fonction qui renvoie si l'utilisateur est membre d'au moins un de ces groupes. * @arg {GroupSet} groups - Ensemble de groupes. * @return {Promise(boolean)} Renvoie true si l'utilisateur est membre d'un des groupes * @async @@ -191,7 +191,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function groupsMember - * @summary Fonction qui renvoit les groupes dont l'utilisateur est member. + * @summary Fonction qui renvoie les groupes dont l'utilisateur est member. * @return {Promise(GroupCollection)} Renvoie la collection de groupes dont l'utilisateur est member. * @async */ @@ -207,7 +207,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function isSpeaker - * @summary Fonction qui renvoit si l'utilisateur est speaker du groupe. + * @summary Fonction qui renvoie si l'utilisateur est speaker du groupe. * @arg {string} gid - Identifiant du groupe. * @return {Promise(boolean)} Renvoie true si l'utilisateur est speaker du groupe. * @async @@ -225,7 +225,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function groupsSpeaker - * @summary Fonction qui renvoit les groupes dont l'utilisateur est speaker. + * @summary Fonction qui renvoie les groupes dont l'utilisateur est speaker. * @return {Promise(GroupCollection)} Renvoie la collection de groupes dont l'utilisateur est speaker. * @async */ @@ -241,7 +241,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function isAdmin - * @summary Fonction qui renvoit si l'utilisateur est admin du groupe. + * @summary Fonction qui renvoie si l'utilisateur est admin du groupe. * @arg {string} gid - Identifiant du groupe. * @return {Promise(boolean)} Renvoie true si l'utilisateur est admin du groupe. * @async @@ -259,7 +259,7 @@ export class AuthorizationModel { /** * @memberof GraphQL.AuthorizationModel# * @function groupsAdmin - * @summary Fonction qui renvoit les groupes dont l'utilisateur est admin. + * @summary Fonction qui renvoie les groupes dont l'utilisateur est admin. * @return {Promise(GroupCollection)} Renvoie la collection de groupes dont l'utilisateur est admin. * @async */ diff --git a/src/graphql/models/userModel.ts b/src/graphql/models/userModel.ts index d31ceb270b5585803f309879b2537cb29f572e07..9d3c4ec2c81e1738654b1ccebd885356d16928a8 100644 --- a/src/graphql/models/userModel.ts +++ b/src/graphql/models/userModel.ts @@ -35,7 +35,7 @@ export class UserModel { /** * @memberof GraphQL.UserModel# * @function newUser - * @summary Fonction qui renvoit un utilisateur donné. + * @summary Fonction qui renvoie un utilisateur donné. * @arg {string} uid - Identifiant demandé. * @return {Promise(User)} Renvoie l'utilisateur dont l'identifiant est 'uid' * @async diff --git a/src/graphql/resolvers.ts b/src/graphql/resolvers.ts index 9fbeb23e1bae7ab8d358c6852031ba98154a73c7..c43610dd183bed7d33e77d5271e9c27a78806314 100644 --- a/src/graphql/resolvers.ts +++ b/src/graphql/resolvers.ts @@ -65,7 +65,7 @@ export const resolvers = { }, // @rights connectedOrOnplatal - simpleGroup: async function (obj, args, context: Context): Promise<SimpleGroup> { + simpleGroup: async function (root, args, context: Context): Promise<SimpleGroup> { if (context.models.auth.isConnectedOrOnplatal()) { return context.models.group.getSimpleGroup(args.gid); } @@ -73,7 +73,7 @@ export const resolvers = { }, // @rights connectedOrOnplatal - metaGroup: async function (obj, args, context: Context): Promise<MetaGroup> { + metaGroup: async function (root, args, context: Context): Promise<MetaGroup> { if (context.models.auth.isConnectedOrOnplatal()) { return context.models.group.getMetaGroup(args.gid); } diff --git a/src/ldap/export/group.ts b/src/ldap/export/group.ts index 4fed51f1dfe5d2231ba8ce52404d893e699f0604..9c90c506b571766de449ad004f6d3cbacf617a98 100644 --- a/src/ldap/export/group.ts +++ b/src/ldap/export/group.ts @@ -57,7 +57,7 @@ export class Group { /** * @memberof LDAP - * @summary Fonction qui renvoit toutes les infos relatives à un groupe particulier. + * @summary Fonction qui renvoie toutes les infos relatives à un groupe particulier. * @desc Cette fonction utilise {@link Tools.peek} avec l'interface {@link groupData}. Elle ne fait que consulter le groupe sans le changer, et en extrayant les uid des membres. * @arg {string} gid - Identifiant du groupe * @return {Promise(groupData)} Informations recueillies ; renvoie une liste de dictionnaire avec le profil complet du groupe au format {@link groupData}. diff --git a/src/ldap/export/user.ts b/src/ldap/export/user.ts index ae20fb644b5a73f6dac7b26efedb9dc908ef76ad..8a118af2a78e245ab18a4a866f419504f8999893 100644 --- a/src/ldap/export/user.ts +++ b/src/ldap/export/user.ts @@ -75,7 +75,7 @@ export class User { /** * @memberof LDAP - * @summary Fonction qui renvoit les infos de base relatives à un utilisateur particulier. + * @summary Fonction qui renvoie les infos de base relatives à un utilisateur particulier. * @desc Cette fonction utilise {@link Tools.peek} avec l'interface {@link userData}. * @arg {string} uid - Identifiant de l'utilisateur, supposé valide. * @return {Promise(userData)} Informations recueillies au format {@link userData}. diff --git a/src/ldap/internal/basics.ts b/src/ldap/internal/basics.ts index d7924ecdb56b6df2aaab4aca5d9c66ce1955d1f1..2070bb8b38092dcf1036d7c30d2f45f1eef4e670 100644 --- a/src/ldap/internal/basics.ts +++ b/src/ldap/internal/basics.ts @@ -67,7 +67,7 @@ export class Basics { * @memberof LDAP * @summary Fonction qui interroge le LDAP selon un protocole spécifié en argument et modifie une liste pour y insérer les valeurs trouvées. * @desc Cette fonction utilise ldapjs (voir [`Client API`](http://ldapjs.org/client.html) méthode search). Cette fonction fait une demande au LDAP - * qu'elle filtre selon un schéma prédéfini dans `filter` et à chaque résultat (event SearchEntry) le met dans une liste, et renvoit la liste à l'issue (event end). + * qu'elle filtre selon un schéma prédéfini dans `filter` et à chaque résultat (event SearchEntry) le met dans une liste, et renvoie la liste à l'issue (event end). * @arg {'gr'|'us'} domain - Emplacement de la requête (groupe ou utilisateur) * @arg {string[]} attributes - Attributs à renvoyer * @arg {string} id [null] - Identifiant facultatif pour une recherche triviale en o(1) @@ -97,9 +97,9 @@ export class Basics { console.log("Erreur lors de la recherche sur le LDAP."); resolve(false); } else { - // Dès que la recherche renvoit une entrée, on stocke les attributs qui nous intéresse + // Dès que la recherche renvoie une entrée, on stocke les attributs qui nous intéresse res.on('searchEntry', entry => handler(entry)); - // Si la recherche renvoie une erreur (client ou TCP seulement), on renvoit + // Si la recherche renvoie une erreur (client ou TCP seulement), on renvoie res.on('error', err2 => { console.log(err2); resolve(false); @@ -117,7 +117,7 @@ export class Basics { /** * @memberof LDAP - * @summary Fonction qui interroge le LDAP selon un protocole spécifié en argument et renvoit une liste de valeurs trouvées. + * @summary Fonction qui interroge le LDAP selon un protocole spécifié en argument et renvoie une liste de valeurs trouvées. * @desc Cette fonction utilise {@link LDAP.search} directement. * @arg {'gr'|'us'} domain - Emplacement de la requête (groupe ou utilisateur) * @arg {string} attribute - Attribut unique à renvoyer @@ -140,9 +140,9 @@ export class Basics { /** * @memberof LDAP - * @summary Fonction qui interroge le LDAP selon un protocole spécifié en argument et renvoit les valeurs trouvées. + * @summary Fonction qui interroge le LDAP selon un protocole spécifié en argument et renvoie les valeurs trouvées. * @desc Cette fonction utilise ldapjs (voir [`Client API`](http://ldapjs.org/client.html) méthode search). Cette fonction fait une demande au LDAP - * qu'elle filtre selon un schéma prédéfini dans `filter` et à chaque résultat (event SearchEntry) le met dans une liste, et renvoit la liste à l'issue (event end). + * qu'elle filtre selon un schéma prédéfini dans `filter` et à chaque résultat (event SearchEntry) le met dans une liste, et renvoie la liste à l'issue (event end). * @arg {'gr'|'us'} domain - Emplacement de la requête (groupe ou utilisateur) * @arg {string[]} attributes - Liste des attributs qui figureront dans le résultat final ; peut aussi être un seul élément * @arg {string} id [null] - Identifiant facultatif pour une recherche triviale en o(1) diff --git a/src/ldap/internal/tools.ts b/src/ldap/internal/tools.ts index bfb4567c5b18acb5816710d42b657274ca67f34f..302680f28c0b6d601e73c7c1402a50471eb43cf7 100644 --- a/src/ldap/internal/tools.ts +++ b/src/ldap/internal/tools.ts @@ -28,7 +28,7 @@ export class Tools { /** * @memberof LDAP - * @summary Fonction qui renvoit toutes les infos relatives à un groupe ou un utilisateur particulier. + * @summary Fonction qui renvoie toutes les infos relatives à un groupe ou un utilisateur particulier. * @desc Cette fonction utilise {@link LDAP.search} avec des attributs prédéfinis. Elle est naïve et n'opère pas de récursion. * Elle extrait déjà les ids à partir des DNs pour toutes les catégories précisées dans config * @param T - Format renvoyé (en pratique {@link userData} ou {@link groupData}) @@ -112,7 +112,7 @@ export class Tools { * @memberof LDAP * @summary Fonction qui retrouve les utilisateurs ou groupes respectivement correspondant à un groupe ou un utilisateur de la même catégorie. * @desc Cette fonction utilise {@link LDAP.search} et va directement à la feuille de l'utilisateur ou du groupe interrogé. - * Pour autant, elle est moins naïve qu'elle en a l'air. Elle ne gère ni la descente des admins ni la remontée des membres et renvoit une réponse naïve. + * Pour autant, elle est moins naïve qu'elle en a l'air. Elle ne gère ni la descente des admins ni la remontée des membres et renvoie une réponse naïve. * @param {string} id - Identifiant du groupe ou de l'individu à interroger (supposé valide) * @param {"user"|"group"} domain - Arbre à interroger * @param {"admins"|"speakers"|"members"|"followers"} category - Catégorie considérée @@ -422,7 +422,7 @@ export class Tools { * @param {string} attribute - Attribut à tester * @param {"gr"|"us"} domain - Domaine dans lequel l'attribut doit être unique * @param {changeValueCallback} changeValue - Fonction qui prend uniquement en argument l'id courant et - * le nombre d'itérations et qui renvoit la prochaine valeur de l'attribut + * le nombre d'itérations et qui renvoie la prochaine valeur de l'attribut * @param {number} n [0] - Nombre d'itérations (à initialiser à 0) * @return {Promise(string)} Valeur unique dans le domaine spécifié de l'attribut spécifié * @static @@ -434,7 +434,7 @@ export class Tools { if (domain == "group") var att=ldapConfig.group.gid; else var att=ldapConfig.user.uid; let matches = await Basics.searchSingle(domain, att, null, "("+attribute+"="+ldapEscape.filter("${txt}", { txt: value })+")") - // On renvoit la valeur si elle est bien unique + // On renvoie la valeur si elle est bien unique if (matches.length=0) return value; // Sinon, on tente de nouveau notre chance avec la valeur suivante else return Tools.ensureUnique(changeValue(value, n+1), attribute, domain, changeValue, n+1); diff --git a/src/utils/tools.ts b/src/utils/tools.ts index fe50a6ebefe818c47d31fe7ca84a1c2fdbec46b0..2a895066d9ee0032efc841edcf6dcd0d99cb0f0b 100644 --- a/src/utils/tools.ts +++ b/src/utils/tools.ts @@ -46,7 +46,7 @@ export class Tools { /** * @memberof GraphQL - * @summary Fonction qui renvoit l'union de deux ensembles + * @summary Fonction qui renvoie l'union de deux ensembles * @arg {GroupSet} A - Le premier ensemble. * @arg {GroupSet} B - Le deuxieme ensemble. * @return {Promise(GroupSet)} Renvoie un nouveau GroupSet contenant l'union de A et B. @@ -62,7 +62,7 @@ export class Tools { /** * @memberof GraphQL - * @summary Fonction qui renvoit tous les groupes simples dont le user est membre. + * @summary Fonction qui renvoie tous les groupes simples dont le user est membre. * @arg {userData} data - Données de l'utilisateur. * @return {Promise(GroupSet)} Renvoie un GroupSet contenant le nom des groupes simples. * @static @@ -78,7 +78,7 @@ export class Tools { /** * @memberof GraphQL - * @summary Fonction qui renvoit tous les groupes simples dont le user est speaker. + * @summary Fonction qui renvoie tous les groupes simples dont le user est speaker. * @arg {userData} data - Données de l'utilisateur. * @return {Promise(GroupSet)} Renvoie un GroupSet contenant le nom des groupes simples. * @static @@ -90,7 +90,7 @@ export class Tools { /** * @memberof GraphQL - * @summary Fonction qui renvoit tous les groupes simples dont le user est administrateur. + * @summary Fonction qui renvoie tous les groupes simples dont le user est administrateur. * @arg {userData} data - Données de l'utilisateur. * @return {Promise(GroupSet)} Renvoie un GroupSet contenant le nom des groupes simples. * @static @@ -106,7 +106,7 @@ export class Tools { /** * @memberof GraphQL - * @summary Fonction qui renvoit tous les méta-groupes dont ces groupes sont membres. + * @summary Fonction qui renvoie tous les méta-groupes dont ces groupes sont membres. * @arg {GroupSet} groups - Un ensemble de gid des groupes a considérer. * @return {Promise(GroupSet)} Renvoie un GroupSet contenant le nom des méta-groupes. * @static @@ -121,7 +121,7 @@ export class Tools { /** * @memberof GraphQL - * @summary Fonction qui renvoit tous les simple-groupes dont ces groupes sont membres. + * @summary Fonction qui renvoie tous les simple-groupes dont ces groupes sont membres. * @arg {GroupSet} groups - Un ensemble de gid des groupes a considérer. * @return {Promise(GroupSet)} Renvoie un GroupSet contenant le nom des simple-groupes. * @static @@ -136,7 +136,7 @@ export class Tools { /** * @memberof GraphQL - * @summary Fonction qui renvoit tous les groupes (simples ou méta) dont le user est membre. + * @summary Fonction qui renvoie tous les groupes (simples ou méta) dont le user est membre. * @arg {userData} data - Données de l'utilisateur. * @return {Promise(GroupCollection)} Renvoie une GroupCollection contenant le nom des groupes. * @static @@ -149,7 +149,7 @@ export class Tools { /** * @memberof GraphQL - * @summary Fonction qui renvoit tous les groupes (simples ou méta) dont le user est speaker. + * @summary Fonction qui renvoie tous les groupes (simples ou méta) dont le user est speaker. * @arg {userData} data - Données de l'utilisateur. * @return {Promise(GroupCollection)} Renvoie une GroupCollection contenant le nom des groupes. * @static @@ -162,7 +162,7 @@ export class Tools { /** * @memberof GraphQL - * @summary Fonction qui renvoit tous les groupes (simples ou méta) dont le user est administrateur. + * @summary Fonction qui renvoie tous les groupes (simples ou méta) dont le user est administrateur. * @arg {userData} data - Données de l'utilisateur. * @return {Promise(GroupCollection)} Renvoie une GroupCollection contenant le nom des groupes. * @static