@aneuhold/core-ts-db-lib 1.0.28 → 1.0.30

package/lib/documents/dashboard/Task.d.ts

@@ -3,7 +3,15 @@ import BaseDocumentWithType from '../BaseDocumentWithType';
 import RequiredUserId from '../../schemas/required-refs/RequiredUserId';
 import { DocumentValidator } from '../../schemas/validators/DocumentValidator';
 import { ParentRecurringTaskInfo, RecurrenceInfo } from '../../embedded-types/dashboard/task/RecurrenceInfo';
+import { DashboardTaskFilterSettings } from '../../embedded-types/dashboard/task/FilterSettings';
+import { DashboardTaskSortSettings } from '../../embedded-types/dashboard/task/SortSettings';
 export declare const validateDashboardTask: DocumentValidator<DashboardTask>;
+/**
+ * A utility type for a map of tasks.
+ */
+export type DashboardTaskMap = {
+    [taskId: string]: DashboardTask;
+};
 /**
  * When thinking about the logic of tasks, the following thoughts come to mind:
  *
@@ -82,12 +90,24 @@ export default class DashboardTask extends BaseDocumentWithType implements Requi
     /**
      * User-assigned tags for this task.
      */
-    tags: string[];
+    tags: {
+        [userId: string]: string[];
+    };
     /**
      * System-assigned category for this task. This should be used to determine
      * where this task should be displayed.
      */
     category: string;
+    /**
+     * The filter settings for subtasks of this task specifically, keyed on
+     * each user.
+     */
+    filterSettings: DashboardTaskFilterSettings;
+    /**
+     * The sort settings for subtasks of this task specifically, keyed on
+     * each user.
+     */
+    sortSettings: DashboardTaskSortSettings;
     constructor(ownerId: ObjectId);
 }
 //# sourceMappingURL=Task.d.ts.map

package/lib/documents/dashboard/Task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../../src/documents/dashboard/Task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,cAAc,MAAM,4CAA4C,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,cAAc,EAEf,MAAM,oDAAoD,CAAC;AAE5D,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,CAAC,aAAa,CAsBlE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,OAAO,aACnB,SAAQ,oBACR,YAAW,cAAc;IAEzB,MAAM,CAAC,OAAO,SAAU;IAExB,OAAO,SAAyB;IAEhC;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,QAAQ,EAAE,CAAM;IAE5B;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElD,KAAK,SAAM;IAEX,SAAS,UAAS;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC;IAExB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,OAAc;IAEzB;;OAEG;IACH,eAAe,OAAc;IAE7B,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,OAAO,CAAC,EAAE,IAAI,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAM;IAEpB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAa;gBAEjB,OAAO,EAAE,QAAQ;CAI9B"}
+{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../../src/documents/dashboard/Task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,cAAc,MAAM,4CAA4C,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,cAAc,EAEf,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AACjG,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAE7F,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,CAAC,aAAa,CAwBlE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAE,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAA;CAAE,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,OAAO,aACnB,SAAQ,oBACR,YAAW,cAAc;IAEzB,MAAM,CAAC,OAAO,SAAU;IAExB,OAAO,SAAyB;IAEhC;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,QAAQ,EAAE,CAAM;IAE5B;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElD,KAAK,SAAM;IAEX,SAAS,UAAS;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC;IAExB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,OAAc;IAEzB;;OAEG;IACH,eAAe,OAAc;IAE7B,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,OAAO,CAAC,EAAE,IAAI,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAM;IAE1C;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAa;IAE7B;;;OAGG;IACH,cAAc,EAAE,2BAA2B,CAAM;IAEjD;;;OAGG;IACH,YAAY,EAAE,yBAAyB,CAAM;gBAEjC,OAAO,EAAE,QAAQ;CAO9B"}

package/lib/documents/dashboard/Task.js

@@ -17,13 +17,15 @@ const validateDashboardTask = (task) => {
     validate.optionalString('description');
     validate.array('sharedWith', exampleTask.sharedWith);
     validate.optionalObject('recurrenceInfo');
-    validate.array('tags', exampleTask.tags);
+    validate.object('tags', {});
     validate.string('category', exampleTask.category);
     validate.object('createdDate', exampleTask.createdDate);
     validate.object('lastUpdatedDate', exampleTask.lastUpdatedDate);
     validate.optionalObject('startDate');
     validate.optionalObject('dueDate');
     validate.optionalObject('parentRecurringTaskInfo');
+    validate.object('filterSettings', {});
+    validate.object('sortSettings', {});
     (0, RecurrenceInfo_1.validateRecurrenceInfo)(task, errors);
     return { updatedDoc: task, errors };
 };
@@ -106,15 +108,28 @@ class DashboardTask extends BaseDocumentWithType_1.default {
     /**
      * User-assigned tags for this task.
      */
-    tags = [];
+    tags = {};
     /**
      * System-assigned category for this task. This should be used to determine
      * where this task should be displayed.
      */
     category = 'default';
+    /**
+     * The filter settings for subtasks of this task specifically, keyed on
+     * each user.
+     */
+    filterSettings = {};
+    /**
+     * The sort settings for subtasks of this task specifically, keyed on
+     * each user.
+     */
+    sortSettings = {};
     constructor(ownerId) {
         super();
         this.userId = ownerId;
+        this.tags = {
+            [ownerId.toString()]: []
+        };
     }
 }
 exports.default = DashboardTask;

package/lib/documents/dashboard/UserConfig.d.ts

@@ -2,6 +2,9 @@ import { ObjectId } from 'bson';
 import BaseDocumentWithType from '../BaseDocumentWithType';
 import RequiredUserId from '../../schemas/required-refs/RequiredUserId';
 import { DocumentValidator } from '../../schemas/validators/DocumentValidator';
+import { DashboardTagSettings } from '../../embedded-types/dashboard/userConfig/Tags';
+import { DashboardTaskListGlobalSortSettings } from '../../embedded-types/dashboard/task/SortSettings';
+import { DashboardTaskListGlobalFilterSettings } from '../../embedded-types/dashboard/task/FilterSettings';
 export declare const validateDashboardUserConfig: DocumentValidator<DashboardUserConfig>;
 export default class DashboardUserConfig extends BaseDocumentWithType implements RequiredUserId {
     static docType: string;
@@ -19,6 +22,12 @@ export default class DashboardUserConfig extends BaseDocumentWithType implements
      * Whether or not to enable dev mode for the user.
      */
     enableDevMode: boolean;
+    /**
+     * The user's tag settings for the dashboard.
+     */
+    tagSettings: DashboardTagSettings;
+    taskListSortSettings: DashboardTaskListGlobalSortSettings;
+    taskListFilterSettings: DashboardTaskListGlobalFilterSettings;
     constructor(ownerId: ObjectId);
 }
 //# sourceMappingURL=UserConfig.d.ts.map

package/lib/documents/dashboard/UserConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserConfig.d.ts","sourceRoot":"","sources":["../../../src/documents/dashboard/UserConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,cAAc,MAAM,4CAA4C,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAE/E,eAAO,MAAM,2BAA2B,EAAE,iBAAiB,CACzD,mBAAmB,CAUpB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,mBACnB,SAAQ,oBACR,YAAW,cAAc;IAEzB,MAAM,CAAC,OAAO,SAAgB;IAE9B,OAAO,SAA+B;IAEtC;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;;OAGG;IACH,aAAa,EAAE,QAAQ,EAAE,CAAM;IAE/B;;OAEG;IACH,aAAa,UAAS;gBAEV,OAAO,EAAE,QAAQ;CAI9B"}
+{"version":3,"file":"UserConfig.d.ts","sourceRoot":"","sources":["../../../src/documents/dashboard/UserConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,cAAc,MAAM,4CAA4C,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,EACL,mCAAmC,EAEpC,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,qCAAqC,EAEtC,MAAM,oDAAoD,CAAC;AAE5D,eAAO,MAAM,2BAA2B,EAAE,iBAAiB,CACzD,mBAAmB,CAapB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,mBACnB,SAAQ,oBACR,YAAW,cAAc;IAEzB,MAAM,CAAC,OAAO,SAAgB;IAE9B,OAAO,SAA+B;IAEtC;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;;OAGG;IACH,aAAa,EAAE,QAAQ,EAAE,CAAM;IAE/B;;OAEG;IACH,aAAa,UAAS;IAEtB;;OAEG;IACH,WAAW,EAAE,oBAAoB,CAAM;IAEvC,oBAAoB,EAAE,mCAAmC,CAAM;IAE/D,sBAAsB,EAAE,qCAAqC,CAAM;gBAEvD,OAAO,EAAE,QAAQ;CAI9B"}

package/lib/documents/dashboard/UserConfig.js

@@ -7,12 +7,17 @@ exports.validateDashboardUserConfig = void 0;
 const bson_1 = require("bson");
 const BaseDocumentWithType_1 = __importDefault(require("../BaseDocumentWithType"));
 const ValidateUtil_1 = __importDefault(require("../../schemas/validators/ValidateUtil"));
+const SortSettings_1 = require("../../embedded-types/dashboard/task/SortSettings");
+const FilterSettings_1 = require("../../embedded-types/dashboard/task/FilterSettings");
 const validateDashboardUserConfig = (config) => {
     const errors = [];
     const validate = new ValidateUtil_1.default(config, errors);
     const exampleConfig = new DashboardUserConfig(new bson_1.ObjectId());
     validate.boolean('enableDevMode', exampleConfig.enableDevMode);
     validate.array('collaborators', exampleConfig.collaborators);
+    validate.object('tagSettings', {});
+    (0, SortSettings_1.validateSortSettings)(validate, config);
+    (0, FilterSettings_1.validateFilterSettings)(validate, config);
     return { updatedDoc: config, errors };
 };
 exports.validateDashboardUserConfig = validateDashboardUserConfig;
@@ -32,6 +37,12 @@ class DashboardUserConfig extends BaseDocumentWithType_1.default {
      * Whether or not to enable dev mode for the user.
      */
     enableDevMode = false;
+    /**
+     * The user's tag settings for the dashboard.
+     */
+    tagSettings = {};
+    taskListSortSettings = {};
+    taskListFilterSettings = {};
     constructor(ownerId) {
         super();
         this.userId = ownerId;

package/lib/embedded-types/dashboard/task/FilterSettings.d.ts

@@ -0,0 +1,42 @@
+import DashboardUserConfig from '../../../documents/dashboard/UserConfig';
+import Validate from '../../../schemas/validators/ValidateUtil';
+export declare function getDefaultTaskListFilterSettings(userId: string): DashboardTaskListFilterSettings;
+export declare function validateFilterSettings(validate: Validate, config: DashboardUserConfig): void;
+/**
+ * Global task list filter settings. These are created for each user in the
+ * Dashboard config.
+ */
+export type DashboardTaskListGlobalFilterSettings = {
+    [category: string]: DashboardTaskListFilterSettings;
+};
+/**
+ * The filter settings for a particular task. Each user can have their
+ * own settings for a task.
+ */
+export type DashboardTaskFilterSettings = {
+    [userId: string]: DashboardTaskListFilterSettings;
+};
+/**
+ * The filter settings for a list of tasks for a particular user.
+ *
+ * Any new settings should be made optional so that they can be added
+ * without breaking existing users or tasks.
+ */
+export type DashboardTaskListFilterSettings = {
+    userId: string;
+    completed: StandardFilterSetting;
+    grandChildrenTasks: StandardFilterSetting;
+    startDate: {
+        showFutureTasks: boolean;
+    };
+    /**
+     * The default for tags, if not defined, is to show them.
+     */
+    tags: {
+        [tag: string]: StandardFilterSetting;
+    };
+};
+export type StandardFilterSetting = {
+    show: boolean;
+};
+//# sourceMappingURL=FilterSettings.d.ts.map

package/lib/embedded-types/dashboard/task/FilterSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterSettings.d.ts","sourceRoot":"","sources":["../../../../src/embedded-types/dashboard/task/FilterSettings.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,MAAM,yCAAyC,CAAC;AAC1E,OAAO,QAAQ,MAAM,0CAA0C,CAAC;AAEhE,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,GACb,+BAA+B,CAQjC;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,mBAAmB,QAmC5B;AAED;;;GAGG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,CAAC,QAAQ,EAAE,MAAM,GAAG,+BAA+B,CAAC;CACrD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,CAAC,MAAM,EAAE,MAAM,GAAG,+BAA+B,CAAC;CACnD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,qBAAqB,CAAC;IACjC,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,SAAS,EAAE;QACT,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF;;OAEG;IACH,IAAI,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAA;KAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,OAAO,CAAC;CACf,CAAC"}

package/lib/embedded-types/dashboard/task/FilterSettings.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFilterSettings = exports.getDefaultTaskListFilterSettings = void 0;
+function getDefaultTaskListFilterSettings(userId) {
+    return {
+        userId,
+        completed: { show: true },
+        grandChildrenTasks: { show: false },
+        startDate: { showFutureTasks: true },
+        tags: {}
+    };
+}
+exports.getDefaultTaskListFilterSettings = getDefaultTaskListFilterSettings;
+function validateFilterSettings(validate, config) {
+    validate.object('taskListFilterSettings', {});
+    const categories = Object.keys(config.taskListFilterSettings);
+    if (categories.length > 0) {
+        const defaultSettings = getDefaultTaskListFilterSettings(config.userId.toString());
+        categories.forEach((category) => {
+            validate.string(`taskListFilterSettings.${category}.userId`, defaultSettings.userId);
+            validate.object(`taskListFilterSettings.${category}.completed`, defaultSettings.completed);
+            validate.boolean(`taskListFilterSettings.${category}.completed.show`, defaultSettings.completed.show);
+            validate.object(`taskListFilterSettings.${category}.startDate`, defaultSettings.startDate);
+            validate.boolean(`taskListFilterSettings.${category}.startDate.showFutureTasks`, defaultSettings.startDate.showFutureTasks);
+            validate.object(`taskListFilterSettings.${category}.tags`, defaultSettings.tags);
+        });
+    }
+}
+exports.validateFilterSettings = validateFilterSettings;

package/lib/embedded-types/dashboard/task/SortSettings.d.ts

@@ -0,0 +1,54 @@
+import DashboardUserConfig from '../../../documents/dashboard/UserConfig';
+import Validate from '../../../schemas/validators/ValidateUtil';
+export declare function getDefaultTaskListSortSettings(userId: string): DashboardTaskListSortSettings;
+export declare function validateSortSettings(validate: Validate, config: DashboardUserConfig): void;
+export type DashboardTaskListGlobalSortSettings = {
+    [category: string]: DashboardTaskListSortSettings;
+};
+/**
+ * The sort settings for a particular task. Each user can have their
+ * own settings for a task.
+ */
+export type DashboardTaskSortSettings = {
+    [userId: string]: DashboardTaskListSortSettings;
+};
+/**
+ * The sort settings for a list of tasks for a particular user.
+ */
+export type DashboardTaskListSortSettings = {
+    userId: string;
+    sortList: Array<DashboardTaskSortSetting>;
+};
+/**
+ * The sortBy options for a task list.
+ */
+export declare enum DashboardTaskSortBy {
+    /**
+     * Tags are special because they depend on the user's global tag settings.
+     */
+    tags = "tags",
+    title = "title",
+    dueDate = "dueDate",
+    startDate = "startDate",
+    createdDate = "createdDate",
+    lastUpdatedDate = "lastUpdatedDate"
+}
+export type DashboardTaskSortSetting = {
+    sortBy: DashboardTaskSortBy;
+    sortDirection: DashboardTaskSortDirection;
+};
+/**
+ * The sort direction for a sorting setting. This is used as a multiplier
+ * for the sort function.
+ */
+export declare enum DashboardTaskSortDirection {
+    /**
+     * Higher as the numbers go down the list.
+     */
+    ascending = 1,
+    /**
+     * Lower as the numbers go down the list.
+     */
+    descending = -1
+}
+//# sourceMappingURL=SortSettings.d.ts.map

package/lib/embedded-types/dashboard/task/SortSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SortSettings.d.ts","sourceRoot":"","sources":["../../../../src/embedded-types/dashboard/task/SortSettings.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,MAAM,yCAAyC,CAAC;AAC1E,OAAO,QAAQ,MAAM,0CAA0C,CAAC;AAEhE,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GACb,6BAA6B,CAK/B;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,mBAAmB,QAmB5B;AAED,MAAM,MAAM,mCAAmC,GAAG;IAChD,CAAC,QAAQ,EAAE,MAAM,GAAG,6BAA6B,CAAC;CACnD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,CAAC,MAAM,EAAE,MAAM,GAAG,6BAA6B,CAAC;CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,oBAAY,mBAAmB;IAC7B;;OAEG;IACH,IAAI,SAAS;IACb,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,eAAe,oBAAoB;CACpC;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,aAAa,EAAE,0BAA0B,CAAC;CAC3C,CAAC;AAEF;;;GAGG;AACH,oBAAY,0BAA0B;IACpC;;OAEG;IACH,SAAS,IAAI;IACb;;OAEG;IACH,UAAU,KAAK;CAChB"}

package/lib/embedded-types/dashboard/task/SortSettings.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashboardTaskSortDirection = exports.DashboardTaskSortBy = exports.validateSortSettings = exports.getDefaultTaskListSortSettings = void 0;
+function getDefaultTaskListSortSettings(userId) {
+    return {
+        userId,
+        sortList: []
+    };
+}
+exports.getDefaultTaskListSortSettings = getDefaultTaskListSortSettings;
+function validateSortSettings(validate, config) {
+    validate.object('taskListSortSettings', {});
+    const categories = Object.keys(config.taskListSortSettings);
+    if (categories.length > 0) {
+        const defaultSettings = getDefaultTaskListSortSettings(config.userId.toString());
+        categories.forEach((category) => {
+            validate.string(`taskListSortSettings.${category}.userId`, defaultSettings.userId);
+            validate.array(`taskListSortSettings.${category}.sortList`, defaultSettings.sortList);
+        });
+    }
+}
+exports.validateSortSettings = validateSortSettings;
+/**
+ * The sortBy options for a task list.
+ */
+var DashboardTaskSortBy;
+(function (DashboardTaskSortBy) {
+    /**
+     * Tags are special because they depend on the user's global tag settings.
+     */
+    DashboardTaskSortBy["tags"] = "tags";
+    DashboardTaskSortBy["title"] = "title";
+    DashboardTaskSortBy["dueDate"] = "dueDate";
+    DashboardTaskSortBy["startDate"] = "startDate";
+    DashboardTaskSortBy["createdDate"] = "createdDate";
+    DashboardTaskSortBy["lastUpdatedDate"] = "lastUpdatedDate";
+})(DashboardTaskSortBy || (exports.DashboardTaskSortBy = DashboardTaskSortBy = {}));
+/**
+ * The sort direction for a sorting setting. This is used as a multiplier
+ * for the sort function.
+ */
+var DashboardTaskSortDirection;
+(function (DashboardTaskSortDirection) {
+    /**
+     * Higher as the numbers go down the list.
+     */
+    DashboardTaskSortDirection[DashboardTaskSortDirection["ascending"] = 1] = "ascending";
+    /**
+     * Lower as the numbers go down the list.
+     */
+    DashboardTaskSortDirection[DashboardTaskSortDirection["descending"] = -1] = "descending";
+})(DashboardTaskSortDirection || (exports.DashboardTaskSortDirection = DashboardTaskSortDirection = {}));

package/lib/embedded-types/dashboard/userConfig/Tags.d.ts

@@ -0,0 +1,11 @@
+export type DashboardTagSettings = {
+    [tag: string]: DashboardTagSetting;
+};
+export type DashboardTagSetting = {
+    /**
+     * Higher priority value means higher priority.
+     */
+    priority: number;
+    color?: string;
+};
+//# sourceMappingURL=Tags.d.ts.map

package/lib/embedded-types/dashboard/userConfig/Tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tags.d.ts","sourceRoot":"","sources":["../../../../src/embedded-types/dashboard/userConfig/Tags.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAAE,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/lib/embedded-types/dashboard/userConfig/Tags.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/index.d.ts

@@ -2,13 +2,15 @@ import BaseDocument from './documents/BaseDocument';
 import BaseDocumentWithType from './documents/BaseDocumentWithType';
 import ApiKey, { validateApiKey } from './documents/common/ApiKey';
 import User, { UserCTO, validateUser } from './documents/common/User';
-import DashboardTask, { validateDashboardTask } from './documents/dashboard/Task';
+import DashboardTask, { DashboardTaskMap, validateDashboardTask } from './documents/dashboard/Task';
 import DashboardUserConfig, { validateDashboardUserConfig } from './documents/dashboard/UserConfig';
+import { DashboardTaskListGlobalFilterSettings, DashboardTaskFilterSettings, DashboardTaskListFilterSettings, getDefaultTaskListFilterSettings } from './embedded-types/dashboard/task/FilterSettings';
 import { ParentRecurringTaskInfo, RecurrenceBasis, RecurrenceEffect, RecurrenceFrequency, RecurrenceFrequencyType, RecurrenceInfo } from './embedded-types/dashboard/task/RecurrenceInfo';
+import { DashboardTaskListGlobalSortSettings, DashboardTaskListSortSettings, DashboardTaskSortBy, DashboardTaskSortDirection, DashboardTaskSortSettings, DashboardTaskSortSetting, getDefaultTaskListSortSettings } from './embedded-types/dashboard/task/SortSettings';
 import RequiredUserId from './schemas/required-refs/RequiredUserId';
 import { DocumentValidator } from './schemas/validators/DocumentValidator';
 import DocumentService from './services/DocumentService';
-import DashboardTaskService from './services/dashboard/TaskService';
-export { User, validateUser, ApiKey, validateApiKey, DashboardUserConfig, validateDashboardUserConfig, DashboardTask, RecurrenceFrequencyType, RecurrenceBasis, RecurrenceEffect, validateDashboardTask, DashboardTaskService, BaseDocument, BaseDocumentWithType, RequiredUserId, DocumentService };
-export type { DocumentValidator, UserCTO, RecurrenceInfo, RecurrenceFrequency, ParentRecurringTaskInfo };
+import DashboardTaskService from './services/dashboard/Task/TaskService';
+export { User, validateUser, ApiKey, validateApiKey, DashboardUserConfig, validateDashboardUserConfig, DashboardTask, RecurrenceFrequencyType, RecurrenceBasis, RecurrenceEffect, DashboardTaskSortBy, DashboardTaskSortDirection, getDefaultTaskListFilterSettings, getDefaultTaskListSortSettings, validateDashboardTask, DashboardTaskService, BaseDocument, BaseDocumentWithType, RequiredUserId, DocumentService };
+export type { DocumentValidator, UserCTO, RecurrenceInfo, RecurrenceFrequency, ParentRecurringTaskInfo, DashboardTaskMap, DashboardTaskListGlobalFilterSettings, DashboardTaskFilterSettings, DashboardTaskListFilterSettings, DashboardTaskListGlobalSortSettings, DashboardTaskSortSettings, DashboardTaskListSortSettings, DashboardTaskSortSetting };
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,0BAA0B,CAAC;AACpD,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AACpE,OAAO,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,aAAa,EAAE,EACpB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,mBAAmB,EAAE,EAC1B,2BAA2B,EAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACf,MAAM,gDAAgD,CAAC;AACxD,OAAO,cAAc,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,eAAe,MAAM,4BAA4B,CAAC;AACzD,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AAGpE,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,2BAA2B,EAC3B,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,eAAe,EAChB,CAAC;AAGF,YAAY,EACV,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,0BAA0B,CAAC;AACpD,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AACpE,OAAO,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,aAAa,EAAE,EACpB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,mBAAmB,EAAE,EAC1B,2BAA2B,EAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,qCAAqC,EACrC,2BAA2B,EAC3B,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACf,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,mCAAmC,EACnC,6BAA6B,EAC7B,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC/B,MAAM,8CAA8C,CAAC;AACtD,OAAO,cAAc,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,eAAe,MAAM,4BAA4B,CAAC;AACzD,OAAO,oBAAoB,MAAM,uCAAuC,CAAC;AAGzE,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,2BAA2B,EAC3B,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,gCAAgC,EAChC,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,eAAe,EAChB,CAAC;AAGF,YAAY,EACV,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,qCAAqC,EACrC,2BAA2B,EAC3B,+BAA+B,EAC/B,mCAAmC,EACnC,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACzB,CAAC"}

package/lib/index.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocumentService = exports.RequiredUserId = exports.BaseDocumentWithType = exports.BaseDocument = exports.DashboardTaskService = exports.validateDashboardTask = exports.RecurrenceEffect = exports.RecurrenceBasis = exports.RecurrenceFrequencyType = exports.DashboardTask = exports.validateDashboardUserConfig = exports.DashboardUserConfig = exports.validateApiKey = exports.ApiKey = exports.validateUser = exports.User = void 0;
+exports.DocumentService = exports.RequiredUserId = exports.BaseDocumentWithType = exports.BaseDocument = exports.DashboardTaskService = exports.validateDashboardTask = exports.getDefaultTaskListSortSettings = exports.getDefaultTaskListFilterSettings = exports.DashboardTaskSortDirection = exports.DashboardTaskSortBy = exports.RecurrenceEffect = exports.RecurrenceBasis = exports.RecurrenceFrequencyType = exports.DashboardTask = exports.validateDashboardUserConfig = exports.DashboardUserConfig = exports.validateApiKey = exports.ApiKey = exports.validateUser = exports.User = void 0;
 const BaseDocument_1 = __importDefault(require("./documents/BaseDocument"));
 exports.BaseDocument = BaseDocument_1.default;
 const BaseDocumentWithType_1 = __importDefault(require("./documents/BaseDocumentWithType"));
@@ -43,13 +43,19 @@ Object.defineProperty(exports, "validateDashboardTask", { enumerable: true, get:
 const UserConfig_1 = __importStar(require("./documents/dashboard/UserConfig"));
 exports.DashboardUserConfig = UserConfig_1.default;
 Object.defineProperty(exports, "validateDashboardUserConfig", { enumerable: true, get: function () { return UserConfig_1.validateDashboardUserConfig; } });
+const FilterSettings_1 = require("./embedded-types/dashboard/task/FilterSettings");
+Object.defineProperty(exports, "getDefaultTaskListFilterSettings", { enumerable: true, get: function () { return FilterSettings_1.getDefaultTaskListFilterSettings; } });
 const RecurrenceInfo_1 = require("./embedded-types/dashboard/task/RecurrenceInfo");
 Object.defineProperty(exports, "RecurrenceBasis", { enumerable: true, get: function () { return RecurrenceInfo_1.RecurrenceBasis; } });
 Object.defineProperty(exports, "RecurrenceEffect", { enumerable: true, get: function () { return RecurrenceInfo_1.RecurrenceEffect; } });
 Object.defineProperty(exports, "RecurrenceFrequencyType", { enumerable: true, get: function () { return RecurrenceInfo_1.RecurrenceFrequencyType; } });
+const SortSettings_1 = require("./embedded-types/dashboard/task/SortSettings");
+Object.defineProperty(exports, "DashboardTaskSortBy", { enumerable: true, get: function () { return SortSettings_1.DashboardTaskSortBy; } });
+Object.defineProperty(exports, "DashboardTaskSortDirection", { enumerable: true, get: function () { return SortSettings_1.DashboardTaskSortDirection; } });
+Object.defineProperty(exports, "getDefaultTaskListSortSettings", { enumerable: true, get: function () { return SortSettings_1.getDefaultTaskListSortSettings; } });
 const RequiredUserId_1 = __importDefault(require("./schemas/required-refs/RequiredUserId"));
 exports.RequiredUserId = RequiredUserId_1.default;
 const DocumentService_1 = __importDefault(require("./services/DocumentService"));
 exports.DocumentService = DocumentService_1.default;
-const TaskService_1 = __importDefault(require("./services/dashboard/TaskService"));
+const TaskService_1 = __importDefault(require("./services/dashboard/Task/TaskService"));
 exports.DashboardTaskService = TaskService_1.default;

package/lib/services/DocumentService.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DocumentService.spec.d.ts.map

package/lib/services/DocumentService.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentService.spec.d.ts","sourceRoot":"","sources":["../../src/services/DocumentService.spec.ts"],"names":[],"mappings":""}

package/lib/services/DocumentService.spec.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const bson_1 = require("bson");
+const DocumentService_1 = __importDefault(require("./DocumentService"));
+describe('DocumentService', () => {
+    describe('deepCopy', () => {
+        it('should return a deep copy of the object', () => {
+            const obj = {
+                id: new bson_1.ObjectId(),
+                a: 1,
+                b: {
+                    c: 2
+                }
+            };
+            const result = DocumentService_1.default.deepCopy(obj);
+            expect(result).toEqual(obj);
+            expect(typeof result.id === 'object').toBeTruthy();
+            expect(result.id.toString()).toEqual(obj.id.toString());
+            expect(result).not.toBe(obj);
+            expect(result.b).toEqual(obj.b);
+            expect(result.b).not.toBe(obj.b);
+            // Change the original object and make sure the copy is not affected
+            obj.b.c = 3;
+            expect(result.b.c).toEqual(2);
+        });
+    });
+});

package/lib/services/dashboard/Task/TaskFilterService.d.ts

@@ -0,0 +1,21 @@
+import { DashboardTaskMap } from '../../../documents/dashboard/Task';
+import { DashboardTaskListFilterSettings } from '../../../embedded-types/dashboard/task/FilterSettings';
+/**
+ * A service responsible for filtering
+ */
+export default class DashboardTaskFilterService {
+    /**
+     * Filters the provided task ids based on the provided filter settings.
+     *
+     * This should filter first based on the most common cases, or faster-to-check
+     * cases, then the less common or more heavy cases later on to increase
+     * performance.
+     *
+     * @param taskMap the map of tasks to use for filtering. This is used so that
+     * the task map doesn't need to be generated multiple times.
+     * @param parentTaskId determines if the current list is for a parent task
+     * or not
+     */
+    static filter(taskMap: DashboardTaskMap, taskIds: string[], settings: DashboardTaskListFilterSettings, category: string, parentTaskId?: string): string[];
+}
+//# sourceMappingURL=TaskFilterService.d.ts.map

package/lib/services/dashboard/Task/TaskFilterService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskFilterService.d.ts","sourceRoot":"","sources":["../../../../src/services/dashboard/Task/TaskFilterService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,+BAA+B,EAAE,MAAM,uDAAuD,CAAC;AAExG;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,0BAA0B;IAC7C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,+BAA+B,EACzC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM;CA0DxB"}

package/lib/services/dashboard/Task/TaskFilterService.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * A service responsible for filtering
+ */
+class DashboardTaskFilterService {
+    /**
+     * Filters the provided task ids based on the provided filter settings.
+     *
+     * This should filter first based on the most common cases, or faster-to-check
+     * cases, then the less common or more heavy cases later on to increase
+     * performance.
+     *
+     * @param taskMap the map of tasks to use for filtering. This is used so that
+     * the task map doesn't need to be generated multiple times.
+     * @param parentTaskId determines if the current list is for a parent task
+     * or not
+     */
+    static filter(taskMap, taskIds, settings, category, parentTaskId) {
+        return taskIds.filter((taskId) => {
+            const task = taskMap[taskId];
+            // Category
+            if (!task || task.category !== category)
+                return false;
+            // Parent task
+            // (the current list is only children tasks)
+            if (parentTaskId) {
+                if (!settings.grandChildrenTasks.show &&
+                    task.parentTaskId &&
+                    task.parentTaskId.toString() !== parentTaskId) {
+                    return false;
+                }
+                // The list is all for a category, so filter out children tasks if needed.
+            }
+            else if (!settings.grandChildrenTasks.show &&
+                task.parentTaskId &&
+                taskMap[task.parentTaskId.toString()]) {
+                return false;
+            }
+            // Completed
+            if (!settings.completed.show && task.completed) {
+                return false;
+            }
+            // Start date
+            if (!settings.startDate.showFutureTasks &&
+                task.startDate &&
+                task.startDate > new Date()) {
+                return false;
+            }
+            // Tags
+            const tags = task.tags[settings.userId];
+            if (tags && tags.length > 0) {
+                const shouldHide = tags.some((tag) => {
+                    if (settings.tags[tag] && !settings.tags[tag].show) {
+                        return true;
+                    }
+                    return false;
+                });
+                if (shouldHide) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+}
+exports.default = DashboardTaskFilterService;

package/lib/services/dashboard/Task/TaskRecurrenceService.d.ts

@@ -0,0 +1,21 @@
+import { RecurrenceFrequency } from '../../../embedded-types/dashboard/task/RecurrenceInfo';
+import DashboardTask from '../../../documents/dashboard/Task';
+export default class DashboardTaskRecurrenceService {
+    /**
+     * Gets the next frequency date from the provided basis date. Returns null
+     * if the provided frequency is in an invalid state.
+     */
+    static getNextFrequencyDate(basisDate: Date, frequency: RecurrenceFrequency): Date | null;
+    /**
+     * Moves the start and due date forward by one frequency.
+     *
+     * This does not take into account the recurrence effect. That should be
+     * handled on the frontend.
+     *
+     * Makes no changes if the state of the task is invalid for recurrence or
+     * there isn't recurrence info.
+     */
+    static updateDatesForRecurrence(task: DashboardTask): void;
+    private static getDiffForDateUpdate;
+}
+//# sourceMappingURL=TaskRecurrenceService.d.ts.map

package/lib/services/dashboard/Task/TaskRecurrenceService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskRecurrenceService.d.ts","sourceRoot":"","sources":["../../../../src/services/dashboard/Task/TaskRecurrenceService.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EAEpB,MAAM,uDAAuD,CAAC;AAC/D,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAE9D,MAAM,CAAC,OAAO,OAAO,8BAA8B;IACjD;;;OAGG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,mBAAmB;IAsE3E;;;;;;;;OAQG;IACH,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IA+D1D,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAapC"}