Api v3 groups chat clear flags

.gitignore

@@ -1,6 +1,7 @@
 .DS_Store
 website/public/gen
 website/public/common
+website/public/apidoc
 node_modules
 *.swp
 .idea*

.nvmrc

@@ -1 +1 @@
-0.10.40
+4.2

.travis.yml

@@ -1,8 +1,8 @@
 language: node_js
 node_js:
-  - '0.10'
+  - '4.2'
 before_install:
-  - "npm install -g npm@2"
+  - "npm install -g npm@3"
   - "npm install -g gulp"
   - "sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10"
   - "echo 'deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen' | sudo tee /etc/apt/sources.list.d/mongodb.list"

Gruntfile.js

@@ -131,7 +131,7 @@ module.exports = function(grunt) {
   grunt.registerTask('build:test', ['test:prepare:translations', 'build:dev']);
 
   grunt.registerTask('test:prepare:translations', function() {
-    var i18n  = require('./website/src/libs/i18n'),
+    var i18n  = require('./website/src/libs/api-v3/i18n'),
         fs    = require('fs');
     fs.writeFileSync('test/spec/mocks/translations.js',
       "if(!window.env) window.env = {};\n" +

Procfile

@@ -1 +1 @@
-web: node ./website/src/server.js
+web: node ./website/src/index.js

common/locales/en/api-v3.json

@@ -0,0 +1,69 @@
+{
+  "missingAuthHeaders": "Missing authentication headers.",
+  "missingUsernameEmail": "Missing username or email.",
+  "missingEmail": "Missing email.",
+  "missingUsername": "Missing username.",
+  "missingPassword": "Missing password.",
+  "notAnEmail": "Invalid email address.",
+  "emailTaken": "Email already taken.",
+  "usernameTaken": "Username already taken.",
+  "passwordConfirmationMatch": "Password confirmation doesn't match password.",
+  "invalidLoginCredentials": "Incorrect username / email and / or password.",
+  "invalidCredentials": "User not found with given auth credentials.",
+  "accountSuspended": "Account has been suspended, please contact [email protected] with your UUID \"<%= userId %>\" for assistance.",
+  "onlyFbSupported": "Only Facebook supported currently.",
+  "cantDetachFb": "Account lacks another authentication method, can't detach Facebook.",
+  "onlySocialAttachLocal": "Local auth can only be added to a social account.",
+  "invalidReqParams": "Invalid request parameters.",
+  "memberIdRequired": "\"member\" must be a valid UUID.",
+  "taskIdRequired": "\"taskId\" must be a valid UUID.",
+  "taskNotFound": "Task not found.",
+  "invalidTaskType": "Task type must be one of \"habit\", \"daily\", \"todo\", \"reward\".",
+  "cantDeleteChallengeTasks": "A task belonging to a challenge can't be deleted.",
+  "checklistOnlyDailyTodo": "Checklists are supported only on dailies and todos",
+  "checklistItemNotFound": "No checklist item was found with given id.",
+  "itemIdRequired": "\"itemId\" must be a valid UUID.",
+  "tagNotFound": "No tag item was found with given id.",
+  "tagIdRequired": "\"tagId\" must be a valid UUID corresponding to a tag belonging to the user.",
+  "positionRequired": "\"position\" is required and must be a number.",
+  "cantMoveCompletedTodo": "Can't move a completed todo.",
+  "directionUpDown": "\"direction\" is required and must be 'up' or 'down'",
+  "alreadyTagged": "The task is already tagged with given tag.",
+  "groupIdRequired": "\"groupId\" must be a valid UUID",
+  "groupNotFound": "Group not found.",
+  "groupTypesRequired": "You must supply a valid \"type\" query string.",
+  "questLeaderCannotLeaveGroup": "You cannot leave your party when you have started a quest. Abort the quest first.",
+  "cannotLeaveWhileActiveQuest": "You cannot leave party during an active quest. Please leave the quest first.",
+  "onlyLeaderCanRemoveMember": "Only group leader can remove a member!",
+  "memberCannotRemoveYourself": "You cannot remove yourself!",
+  "groupMemberNotFound": "User not found among group's members",
+  "challengeMemberNotFound": "User not found among challenge's members",
+  "mustBeGroupMember": "Must be member of the group.",
+  "keepOrRemoveAll": "req.query.keep must be either \"keep-all\" or \"remove-all\"",
+  "keepOrRemove": "req.query.keep must be either \"keep\" or \"remove\"",
+  "canOnlyInviteEmailUuid": "Can only invite using uuids or emails.",
+  "inviteMissingEmail": "Missing email address in invite.",
+  "onlyGroupLeaderChal": "Only the group leader can create challenges",
+  "pubChalsMinPrize": "Prize must be at least 1 Gem for public challenges.",
+  "cantAfford": "You can't afford this prize. Purchase more gems or lower the prize amount.",
+  "challengeIdRequired": "\"challengeId\" must be a valid UUID.",
+  "winnerIdRequired": "\"winnerId\" must be a valid UUID.",
+  "challengeNotFound": "Challenge not found.",
+  "onlyLeaderDeleteChal": "Only the challenge leader can delete it.",
+  "winnerNotFound": "Winner with id \"<%= userId %>\" not found or not part of the challenge.",
+  "noCompletedTodosChallenge": "\"includeComepletedTodos\" is not supported when fetching a challenge tasks.",
+  "userTasksNoChallengeId": "When \"tasksOwner\" is \"user\" \"challengeId\" can't be passed.",
+  "onlyChalLeaderEditTasks": "Tasks belonging to a challenge can only be edited by the leader.",
+  "userAlreadyInChallenge": "User is already participating in this challenge.",
+  "invalidTasksOwner": "\"tasksOwner\" must be \"user\" or \"challenge\".",
+  "partyMustbePrivate": "Parties must be private",
+  "userAlreadyInGroup": "User already in that group.",
+  "userAlreadyInvitedToGroup": "User already invited to that group.",
+  "userAlreadyPendingInvitation": "User already pending invitation.",
+  "userAlreadyInAParty": "User already in a party.",
+  "userWithIDNotFound": "User with id \"<%= userId %>\" not found.",
+  "uuidsMustBeAnArray": "UUIDs invites must be a an Array.",
+  "emailsMustBeAnArray": "Email invites must be a an Array.",
+  "canOnlyInviteMaxInvites": "You can only invite \"<%= maxInvites %>\" at a time",
+  "cantOnlyUnlinkChalTask": "Only challenges tasks can be unlinked."
+}

common/script/api-v3/cron.js

@@ -0,0 +1,264 @@
+import moment from 'moment';
+import _ from 'lodash';
+import scoreTask from './scoreTask';
+import { preenUserHistory } from './preening';
+import common from '../../';
+import {
+  shouldDo,
+} from '../cron';
+
+let clearBuffs = {
+  str: 0,
+  int: 0,
+  per: 0,
+  con: 0,
+  stealth: 0,
+  streaks: false,
+};
+
+// At end of day, add value to all incomplete Daily & Todo tasks (further incentive)
+// For incomplete Dailys, deduct experience
+// Make sure to run this function once in a while as server will not take care of overnight calculations.
+// And you have to run it every time client connects.
+export default function cron (options = {}) {
+  let {user, tasksByType, analytics, now, daysMissed} = options;
+
+  user.auth.timestamps.loggedin = now;
+  user.lastCron = now;
+  // Reset the lastDrop count to zero
+  if (user.items.lastDrop.count > 0) user.items.lastDrop.count = 0;
+
+  // "Perfect Day" achievement for perfect-days
+  let perfect = true;
+
+  // end-of-month perks for subscribers
+  let plan = user.purchased.plan;
+  if (user.isSubscribed()) {
+    if (moment(plan.dateUpdated).format('MMYYYY') !== moment().format('MMYYYY')) {
+      plan.gemsBought = 0; // reset gem-cap
+      plan.dateUpdated = now;
+      // For every month, inc their "consecutive months" counter. Give perks based on consecutive blocks
+      // If they already got perks for those blocks (eg, 6mo subscription, subscription gifts, etc) - then dec the offset until it hits 0
+      // TODO use month diff instead of ++ / --?
+      _.defaults(plan.consecutive, {count: 0, offset: 0, trinkets: 0, gemCapExtra: 0}); // FIXME see https://github.com/HabitRPG/habitrpg/issues/4317
+      plan.consecutive.count++;
+      if (plan.consecutive.offset > 0) {
+        plan.consecutive.offset--;
+      } else if (plan.consecutive.count % 3 === 0) { // every 3 months
+        plan.consecutive.trinkets++;
+        plan.consecutive.gemCapExtra += 5;
+        if (plan.consecutive.gemCapExtra > 25) plan.consecutive.gemCapExtra = 25; // cap it at 50 (hard 25 limit + extra 25)
+      }
+    }
+
+    // If user cancelled subscription, we give them until 30day's end until it terminates
+    if (plan.dateTerminated && moment(plan.dateTerminated).isBefore(new Date())) {
+      _.merge(plan, {
+        planId: null,
+        customerId: null,
+        paymentMethod: null,
+      });
+
+      _.merge(plan.consecutive, {
+        count: 0,
+        offset: 0,
+        gemCapExtra: 0,
+      });
+
+      user.markModified('purchased.plan');
+    }
+  }
+
+  // User is resting at the inn.
+  // On cron, buffs are cleared and all dailies are reset without performing damage
+  if (user.preferences.sleep === true) {
+    user.stats.buffs = _.cloneDeep(clearBuffs);
+
+    tasksByType.dailys.forEach((daily) => {
+      let completed = daily.completed;
+      let thatDay = moment(now).subtract({days: 1});
+
+      if (shouldDo(thatDay.toDate(), daily, user.preferences) || completed) {
+        daily.checklist.forEach(box => box.completed = false);
+      }
+      daily.completed = false;
+    });
+
+    return;
+  }
+
+  let multiDaysCountAsOneDay = true;
+  // If the user does not log in for two or more days, cron (mostly) acts as if it were only one day.
+  // When site-wide difficulty settings are introduced, this can be a user preference option.
+
+  // Tally each task
+  let todoTally = 0;
+
+  tasksByType.todos.forEach(task => { // make uncompleted todos redder
+    scoreTask({
+      task,
+      user,
+      direction: 'down',
+      cron: true,
+      times: multiDaysCountAsOneDay ? 1 : daysMissed,
+      // TODO pass req for analytics?
+    });
+
+    todoTally += task.value;
+  });
+
+  let dailyChecked = 0; // how many dailies were checked?
+  let dailyDueUnchecked = 0; // how many dailies were cun-hecked?
+  if (!user.party.quest.progress.down) user.party.quest.progress.down = 0;
+
+  tasksByType.dailys.forEach((task) => {
+    let completed = task.completed;
+    // Deduct points for missed Daily tasks
+    let EvadeTask = 0;
+    let scheduleMisses = daysMissed;
+
+    if (completed) {
+      dailyChecked += 1;
+    } else {
+      // dailys repeat, so need to calculate how many they've missed according to their own schedule
+      scheduleMisses = 0;
+
+      for (let i = 0; i < daysMissed; i++) {
+        let thatDay = moment(now).subtract({days: i + 1});
+
+        if (shouldDo(thatDay.toDate(), task, user.preferences)) {
+          scheduleMisses++;
+          if (user.stats.buffs.stealth) {
+            user.stats.buffs.stealth--;
+            EvadeTask++;
+          }
+          if (multiDaysCountAsOneDay) break;
+        }
+      }
+
+      if (scheduleMisses > EvadeTask) {
+        perfect = false;
+
+        if (task.checklist && task.checklist.length > 0) { // Partially completed checklists dock fewer mana points
+          let fractionChecked = _.reduce(task.checklist, (m, i) => m + (i.completed ? 1 : 0), 0) / task.checklist.length;
+          dailyDueUnchecked += 1 - fractionChecked;
+          dailyChecked += fractionChecked;
+        } else {
+          dailyDueUnchecked += 1;
+        }
+
+        let delta = scoreTask({
+          user,
+          task,
+          direction: 'down',
+          times: multiDaysCountAsOneDay ? 1 : scheduleMisses - EvadeTask,
+          cron: true,
+        });
+
+        // Apply damage from a boss, less damage for Trivial priority (difficulty)
+        user.party.quest.progress.down += delta * (task.priority < 1 ? task.priority : 1);
+        // NB: Medium and Hard priorities do not increase damage from boss. This was by accident
+        // initially, and when we realised, we could not fix it because users are used to
+        // their Medium and Hard Dailies doing an Easy amount of damage from boss.
+        // Easy is task.priority = 1. Anything < 1 will be Trivial (0.1) or any future
+        // setting between Trivial and Easy.
+      }
+    }
+
+    task.history.push({
+      date: Number(new Date()),
+      value: task.value,
+    });
+    task.completed = false;
+
+    if (completed || scheduleMisses > 0) {
+      task.checklist.forEach(i => i.completed = true); // FIXME this should not happen for grey tasks unless they are completed
+    }
+  });
+
+  tasksByType.habits.forEach((task) => { // slowly reset 'onlies' value to 0
+    if (task.up === false || task.down === false) {
+      task.value = Math.abs(task.value) < 0.1 ? 0 : task.value = task.value / 2;
+    }
+  });
+
+  // Finished tallying
+  user.history.todos.push({date: now, value: todoTally});
+
+  // tally experience
+  let expTally = user.stats.exp;
+  let lvl = 0; // iterator
+  while (lvl < user.stats.lvl - 1) {
+    lvl++;
+    expTally += common.tnl(lvl);
+  }
+  user.history.exp.push({date: now, value: expTally});
+
+  // preen user history so that it doesn't become a performance problem
+  // also for subscribed users but differentyly
+  // premium subscribers can keep their full history.
+  preenUserHistory(user, tasksByType, user.preferences.timezoneOffset);
+
+  if (perfect) {
+    user.achievements.perfect++;
+    let lvlDiv2 = Math.ceil(common.capByLevel(user.stats.lvl) / 2);
+    user.stats.buffs = {
+      str: lvlDiv2,
+      int: lvlDiv2,
+      per: lvlDiv2,
+      con: lvlDiv2,
+      stealth: 0,
+      streaks: false,
+    };
+  } else {
+    user.stats.buffs = _.cloneDeep(clearBuffs);
+  }
+
+  // Add 10 MP, or 10% of max MP if that'd be more. Perform this after Perfect Day for maximum benefit
+  // Adjust for fraction of dailies completed
+  user.stats.mp += _.max([10, 0.1 * user._statsComputed.maxMP]) * dailyChecked / (dailyDueUnchecked + dailyChecked);
+  if (user.stats.mp > user._statsComputed.maxMP) user.stats.mp = user._statsComputed.maxMP;
+
+  if (dailyDueUnchecked === 0 && dailyChecked === 0) dailyChecked = 1;
+  user.stats.mp += _.max([10, 0.1 * user._statsComputed.maxMP]) * dailyChecked / (dailyDueUnchecked + dailyChecked);
+  if (user.stats.mp > user._statsComputed.maxMP) {
+    user.stats.mp = user._statsComputed.maxMP;
+  }
+
+  // After all is said and done, progress up user's effect on quest, return those values & reset the user's
+  let progress = user.party.quest.progress;
+  let _progress = _.cloneDeep(progress);
+  _.merge(progress, {down: 0, up: 0});
+  progress.collect = _.transform(progress.collect, (m, v, k) => m[k] = 0);
+
+  // Clean PMs - keep 200 for subscribers and 50 for free users
+  // TODO tests
+  let maxPMs = user.isSubscribed() ? 200 : 50; // TODO 200 limit for contributors too
+  let numberOfPMs = Object.keys(user.inbox.messages).length;
+  if (Object.keys(user.inbox.messages).length > maxPMs) {
+    _(user.inbox.messages)
+      .sortBy('timestamp')
+      .takeRight(numberOfPMs - maxPMs)
+      .each(pm => {
+        user.inbox.messages[pm.id] = undefined;
+      }).value();
+
+    user.markModified('inbox.messages');
+  }
+
+  // Analytics
+  user.flags.cronCount++;
+  analytics.track('Cron', {
+    category: 'behavior',
+    gaLabel: 'Cron Count',
+    gaValue: user.flags.cronCount,
+    uuid: user._id,
+    user, // TODO is it really necessary passing the whole user object?
+    resting: user.preferences.sleep,
+    cronCount: user.flags.cronCount,
+    progressUp: _.min([_progress.up, 900]),
+    progressDown: _progress.down,
+  });
+
+  return _progress;
+}