feat: Add legal requirements (#1306)

server/api/hooks/query-methods/models/Config.js

@@ -0,0 +1,15 @@
+/*!
+ * Copyright (c) 2024 PLANKA Software GmbH
+ * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
+ */
+
+/* Query methods */
+
+const getOneMain = () => Config.findOne(Config.MAIN_ID);
+
+const updateOneMain = (values) => Config.updateOne(Config.MAIN_ID).set({ ...values });
+
+module.exports = {
+  getOneMain,
+  updateOneMain,
+};

server/api/hooks/query-methods/models/IdentityProviderUser.js

@@ -3,6 +3,8 @@
  * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
  */
 
+/* Query methods */
+
 const createOne = (values) => IdentityProviderUser.create({ ...values }).fetch();
 
 const getOneByIssuerAndSub = (issuer, sub) =>

server/api/hooks/query-methods/models/Session.js

@@ -3,6 +3,8 @@
  * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
  */
 
+/* Query methods */
+
 const createOne = (values) => Session.create({ ...values }).fetch();
 
 const getOneUndeletedByAccessToken = (accessToken) =>
@@ -11,6 +13,14 @@ const getOneUndeletedByAccessToken = (accessToken) =>
     deletedAt: null,
   });
 
+const getOneUndeletedByPendingToken = (pendingToken) =>
+  Session.findOne({
+    pendingToken,
+    deletedAt: null,
+  });
+
+const updateOne = (criteria, values) => Session.updateOne(criteria).set({ ...values });
+
 // eslint-disable-next-line no-underscore-dangle
 const delete_ = (criteria) => Session.destroy(criteria).fetch();
 
@@ -25,6 +35,8 @@ const deleteOneById = (id) =>
 module.exports = {
   createOne,
   getOneUndeletedByAccessToken,
+  getOneUndeletedByPendingToken,
+  updateOne,
   deleteOneById,
   delete: delete_,
 };

server/api/hooks/terms/index.js

@@ -0,0 +1,87 @@
+/*!
+ * Copyright (c) 2024 PLANKA Software GmbH
+ * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
+ */
+
+/**
+ * terms hook
+ *
+ * @description :: A hook definition. Extends Sails by adding shadow routes, implicit actions,
+ *                 and/or initialization logic.
+ * @docs        :: https://sailsjs.com/docs/concepts/extending-sails/hooks
+ */
+
+const fsPromises = require('fs').promises;
+const crypto = require('crypto');
+
+const Types = {
+  GENERAL: 'general',
+  EXTENDED: 'extended',
+};
+
+const LANGUAGES = ['de-DE', 'en-US'];
+const DEFAULT_LANGUAGE = 'en-US';
+
+const hashContent = (content) => crypto.createHash('sha256').update(content).digest('hex');
+
+module.exports = function defineTermsHook(sails) {
+  let signatureByType;
+  let signaturesSet;
+
+  return {
+    Types,
+    LANGUAGES,
+
+    /**
+     * Runs when this Sails app loads/lifts.
+     */
+
+    async initialize() {
+      sails.log.info('Initializing custom hook (`terms`)');
+
+      signatureByType = {
+        [Types.GENERAL]: hashContent(await this.getContent(Types.GENERAL)),
+        [Types.EXTENDED]: hashContent(await this.getContent(Types.EXTENDED)),
+      };
+
+      signaturesSet = new Set(Object.values(signatureByType));
+    },
+
+    async getPayload(type, language = DEFAULT_LANGUAGE) {
+      if (!Object.values(Types).includes(type)) {
+        throw new Error(`Unknown type: ${type}`);
+      }
+
+      if (!LANGUAGES.includes(language)) {
+        language = DEFAULT_LANGUAGE; // eslint-disable-line no-param-reassign
+      }
+
+      return {
+        type,
+        language,
+        content: await this.getContent(type, language),
+        signature: this.getSignatureByType(type),
+      };
+    },
+
+    getTypeByUserRole(userRole) {
+      return userRole === User.Roles.ADMIN ? Types.EXTENDED : Types.GENERAL;
+    },
+
+    getContent(type, language = DEFAULT_LANGUAGE) {
+      return fsPromises.readFile(`${sails.config.appPath}/terms/${language}/${type}.md`, 'utf8');
+    },
+
+    getSignatureByType(type) {
+      return signatureByType[type];
+    },
+
+    getSignatureByUserRole(userRole) {
+      return signatureByType[this.getTypeByUserRole(userRole)];
+    },
+
+    hasSignature(signature) {
+      return signaturesSet.has(signature);
+    },
+  };
+};