vikunja-frontend/src/models/task.ts

325 lines
8.6 KiB
TypeScript
Raw Normal View History

2022-07-21 00:42:36 +02:00
import type { Priority } from '@/models/constants/priorities'
import AbstractModel from '@/models/abstractModel'
import UserModel, { type IUser } from '@/models/user'
import LabelModel, { type ILabel } from '@/models/label'
import AttachmentModel, {type IAttachment} from '@/models/attachment'
import SubscriptionModel, { type ISubscription } from '@/models/subscription'
import type { IList } from '@/models/list'
2022-07-21 19:16:13 +02:00
import type {IRepeats} from '@/types/IRepeats'
import {parseDateOrNull} from '@/helpers/parseDateOrNull'
2022-07-21 00:42:36 +02:00
import type { IBucket } from './bucket'
2020-12-08 15:43:51 +01:00
const SUPPORTS_TRIGGERED_NOTIFICATION = 'Notification' in window && 'showTrigger' in Notification.prototype
export const TASK_DEFAULT_COLOR = '#1973ff'
2022-06-23 03:22:21 +02:00
export const TASK_REPEAT_MODES = {
'REPEAT_MODE_DEFAULT': 0,
'REPEAT_MODE_MONTH': 1,
'REPEAT_MODE_FROM_CURRENT_DATE': 2,
} as const
export type TaskRepeatMode = typeof TASK_REPEAT_MODES[keyof typeof TASK_REPEAT_MODES]
export interface ITask extends AbstractModel {
2022-06-23 03:22:21 +02:00
id: number
title: string
description: string
done: boolean
doneAt: Date | null
2022-07-20 21:15:35 +02:00
priority: Priority
2022-07-21 00:42:36 +02:00
labels: ILabel[]
assignees: IUser[]
2022-06-23 03:22:21 +02:00
dueDate: Date | null
startDate: Date | null
endDate: Date | null
2022-07-21 19:16:13 +02:00
repeatAfter: number | IRepeats
2022-06-23 03:22:21 +02:00
repeatFromCurrentDate: boolean
repeatMode: TaskRepeatMode
reminderDates: Date[]
2022-07-21 00:42:36 +02:00
parentTaskId: ITask['id']
2022-06-23 03:22:21 +02:00
hexColor: string
percentDone: number
2022-07-21 00:42:36 +02:00
relatedTasks: { [relationKind: string]: ITask } // FIXME: use relationKinds
attachments: IAttachment[]
2022-06-23 03:22:21 +02:00
identifier: string
index: number
isFavorite: boolean
2022-07-21 00:42:36 +02:00
subscription: ISubscription
2022-06-23 03:22:21 +02:00
position: number
kanbanPosition: number
2022-07-21 00:42:36 +02:00
createdBy: IUser
created: Date
updated: Date
listId: IList['id'] // Meta, only used when creating a new task
bucketId: IBucket['id']
}
export default class TaskModel extends AbstractModel implements ITask {
id: number
title: string
declare description: string
declare done: boolean
doneAt: Date | null
declare priority: Priority
labels: ILabel[]
assignees: IUser[]
dueDate: Date | null
startDate: Date | null
endDate: Date | null
2022-07-21 19:16:13 +02:00
declare repeatAfter: number | IRepeats
2022-07-21 00:42:36 +02:00
declare repeatFromCurrentDate: boolean
declare repeatMode: TaskRepeatMode
reminderDates: Date[]
declare parentTaskId: ITask['id']
declare hexColor: string
declare percentDone: number
declare relatedTasks: { [relationKind: string]: ITask } // FIXME: use relationKinds
attachments: IAttachment[]
declare identifier: string
declare index: number
declare isFavorite: boolean
declare subscription: ISubscription
declare position: number
declare kanbanPosition: number
createdBy: IUser
2022-06-23 03:22:21 +02:00
created: Date
updated: Date
2022-07-21 00:42:36 +02:00
listId: IList['id'] // Meta, only used when creating a new task
2022-07-21 19:16:13 +02:00
declare bucketId: IBucket['id']
2022-06-23 03:22:21 +02:00
2022-07-21 00:42:36 +02:00
constructor(data: Partial<ITask>) {
super(data)
2019-11-24 14:16:24 +01:00
this.id = Number(this.id)
this.title = this.title?.trim()
this.doneAt = parseDateOrNull(this.doneAt)
this.labels = this.labels
.map(l => new LabelModel(l))
.sort((f, s) => f.title > s.title ? 1 : -1)
// Parse the assignees into user models
this.assignees = this.assignees.map(a => {
return new UserModel(a)
})
this.dueDate = parseDateOrNull(this.dueDate)
this.startDate = parseDateOrNull(this.startDate)
this.endDate = parseDateOrNull(this.endDate)
// Parse the repeat after into something usable
this.parseRepeatAfter()
this.reminderDates = this.reminderDates.map(d => new Date(d))
// Cancel all scheduled notifications for this task to be sure to only have available notifications
this.cancelScheduledNotifications().then(() => {
// Every time we see a reminder, we schedule a notification for it
this.reminderDates.forEach(d => this.scheduleNotification(d))
})
if (this.hexColor !== '' && this.hexColor.substring(0, 1) !== '#') {
2019-04-30 22:18:06 +02:00
this.hexColor = '#' + this.hexColor
}
// Make all subtasks to task models
Object.keys(this.relatedTasks).forEach(relationKind => {
this.relatedTasks[relationKind] = this.relatedTasks[relationKind].map(t => {
return new TaskModel(t)
})
})
2019-11-24 14:16:24 +01:00
// Make all attachments to attachment models
this.attachments = this.attachments.map(a => new AttachmentModel(a))
2020-05-16 13:14:57 +02:00
// Set the task identifier to empty if the list does not have one
if (this.identifier === `-${this.index}`) {
2020-05-16 13:14:57 +02:00
this.identifier = ''
}
if (typeof this.subscription !== 'undefined' && this.subscription !== null) {
this.subscription = new SubscriptionModel(this.subscription)
}
this.createdBy = new UserModel(this.createdBy)
this.created = new Date(this.created)
this.updated = new Date(this.updated)
this.listId = Number(this.listId)
}
defaults() {
return {
id: 0,
title: '',
description: '',
done: false,
2020-11-28 15:52:15 +01:00
doneAt: null,
priority: 0,
labels: [],
assignees: [],
dueDate: 0,
startDate: 0,
endDate: 0,
repeatAfter: 0,
repeatFromCurrentDate: false,
2022-06-23 03:22:21 +02:00
repeatMode: TASK_REPEAT_MODES.REPEAT_MODE_DEFAULT,
reminderDates: [],
parentTaskId: 0,
2019-04-30 22:18:06 +02:00
hexColor: '',
2019-10-19 18:27:31 +02:00
percentDone: 0,
relatedTasks: {},
2019-11-24 14:16:24 +01:00
attachments: [],
2020-05-16 13:14:57 +02:00
identifier: '',
index: 0,
isFavorite: false,
subscription: null,
position: 0,
kanbanPosition: 0,
2019-04-30 22:18:06 +02:00
createdBy: UserModel,
created: null,
updated: null,
listId: 0, // Meta, only used when creating a new task
2022-07-21 19:16:13 +02:00
bucketId: 0,
}
}
getTextIdentifier() {
if (this.identifier === '') {
return `#${this.index}`
}
return this.identifier
}
getHexColor() {
if (this.hexColor === '' || this.hexColor === '#') {
return TASK_DEFAULT_COLOR
}
return this.hexColor
}
/////////////////
// Helper functions
///////////////
/**
* Parses the "repeat after x seconds" from the task into a usable js object inside the task.
* This function should only be called from the constructor.
*/
parseRepeatAfter() {
2022-06-23 03:22:21 +02:00
const repeatAfterHours = (this.repeatAfter as number / 60) / 60
this.repeatAfter = {type: 'hours', amount: repeatAfterHours}
// if its dividable by 24, its something with days, otherwise hours
if (repeatAfterHours % 24 === 0) {
2022-02-15 13:07:34 +01:00
const repeatAfterDays = repeatAfterHours / 24
if (repeatAfterDays % 7 === 0) {
this.repeatAfter.type = 'weeks'
this.repeatAfter.amount = repeatAfterDays / 7
} else if (repeatAfterDays % 30 === 0) {
this.repeatAfter.type = 'months'
this.repeatAfter.amount = repeatAfterDays / 30
} else if (repeatAfterDays % 365 === 0) {
this.repeatAfter.type = 'years'
this.repeatAfter.amount = repeatAfterDays / 365
} else {
this.repeatAfter.type = 'days'
this.repeatAfter.amount = repeatAfterDays
}
}
}
2019-04-30 22:18:06 +02:00
async cancelScheduledNotifications() {
if (!SUPPORTS_TRIGGERED_NOTIFICATION) {
console.debug('This browser does not support triggered notifications')
return
}
if (typeof navigator.serviceWorker === 'undefined') {
console.debug('Service Worker not available')
return
}
const registration = await navigator.serviceWorker.getRegistration()
if (typeof registration === 'undefined') {
return
}
// Get all scheduled notifications for this task and cancel them
const scheduledNotifications = await registration.getNotifications({
tag: `vikunja-task-${this.id}`,
includeTriggered: true,
})
console.debug('Already scheduled notifications:', scheduledNotifications)
scheduledNotifications.forEach(n => n.close())
}
async scheduleNotification(date) {
if (typeof navigator.serviceWorker === 'undefined') {
console.debug('Service Worker not available')
return
}
if (date < new Date()) {
console.debug('Date is in the past, not scheduling a notification. Date is ', date)
return
}
if (!SUPPORTS_TRIGGERED_NOTIFICATION) {
console.debug('This browser does not support triggered notifications')
return
}
const {state} = await navigator.permissions.request({name: 'notifications'})
if (state !== 'granted') {
console.debug('Notification permission not granted, not showing notifications')
return
}
const registration = await navigator.serviceWorker.getRegistration()
if (typeof registration === 'undefined') {
console.error('No service worker registration available')
return
}
// Register the actual notification
try {
registration.showNotification('Vikunja Reminder', {
tag: `vikunja-task-${this.id}`, // Group notifications by task id so we're only showing one notification per task
body: this.title,
// eslint-disable-next-line no-undef
showTrigger: new TimestampTrigger(date),
badge: '/images/icons/badge-monochrome.png',
icon: '/images/icons/android-chrome-512x512.png',
data: {taskId: this.id},
actions: [
{
action: 'show-task',
title: 'Show task',
},
],
})
console.debug('Notification scheduled for ' + date)
} catch (e) {
throw new Error('Error scheduling notification', e)
}
}
}