TaskView is a self-hosted project and task management platform focused on clarity, ownership, and control. TaskView is built for teams that want a transparent, self-hosted alternative to SaaS task managers.
TypeScript graphviewkanban-boardnodejsproductivityproject-managementself-hostedtasktask-managementtask-managertodoapp
import { EventEmitter } from 'node:events';
import { FileEvents, type FileEventPayload } from '../tv-modules/files/types';
import type { RecurrenceRulesSchemaTypeForSelect, SprintsSchemaTypeForSelect, TasksSchemaTypeForSelect } from 'taskview-db-schemas';
import type { TimeEntryWithUser } from '../tv-modules/time-tracking/types';
import type { InviteEmailLocale } from '../tv-modules/collaboration/collaboration.server.types';
import { $logger } from '../modules/logget';
export interface AppEvents {
'task.created': { task: TasksSchemaTypeForSelect; initiatorId: number };
'task.updated': { task: TasksSchemaTypeForSelect; changes: Record<string, unknown>; initiatorId: number };
'task.assigneesChanged': { taskId: number; userIds: number[]; initiatorId: number };
'task.tagsChanged': { taskId: number; tagId: number; added: boolean; initiatorId: number };
'task.deleted': { taskId: number; goalId: number; initiatorId: number };
// A task (with the subtasks in taskIds) moved to another project; the copy mode emits task.created instead
'task.moved': { task: TasksSchemaTypeForSelect; taskIds: number[]; fromGoalId: number; toGoalId: number; initiatorId: number };
'collaboration.userAdded': { goalId: number; email: string; initiatorId: number; locale: InviteEmailLocale };
'collaboration.userRemoved': { goalId: number; collaborationUserId: number; initiatorId: number };
'collaboration.rolesChanged': { goalId: number; collaborationUserId: number; initiatorId: number };
'time-entry.started': { entry: TimeEntryWithUser; taskId: number; userId: number; goalId: number };
'time-entry.stopped': { entry: TimeEntryWithUser; taskId: number; userId: number; goalId: number; durationSeconds: number };
'time-entry.created': { entry: TimeEntryWithUser; initiatorId: number };
'time-entry.updated': { entry: TimeEntryWithUser; changes: Record<string, unknown>; initiatorId: number };
'time-entry.deleted': { entryId: number; taskId: number; goalId: number; userId: number; initiatorId: number };
'sprint.created': { sprint: SprintsSchemaTypeForSelect; initiatorId: number };
'sprint.updated': { sprint: SprintsSchemaTypeForSelect; changes: Record<string, unknown>; initiatorId: number };
'sprint.activated': { sprintId: number; goalId: number; initiatorId: number | null };
'sprint.reviewStarted': { sprintId: number; goalId: number; initiatorId: number };
'sprint.completed': { sprintId: number; goalId: number; initiatorId: number };
'sprint.paused': { sprintId: number; goalId: number; initiatorId: number };
'sprint.resumed': { sprintId: number; goalId: number; initiatorId: number };
'sprint.deleted': { sprintId: number; goalId: number; initiatorId: number };
'task.assignedToSprint': {
taskId: number;
sprintId: number | null;
prevSprintId: number | null;
goalId: number;
initiatorId: number;
};
'recurrence.created': { rule: RecurrenceRulesSchemaTypeForSelect; initiatorId: number };
'recurrence.updated': { rule: RecurrenceRulesSchemaTypeForSelect; changes: Record<string, unknown>; initiatorId: number };
'recurrence.paused': { ruleId: number; goalId: number; initiatorId: number };
'recurrence.resumed': { ruleId: number; goalId: number; initiatorId: number };
'recurrence.ended': { ruleId: number; goalId: number; initiatorId: number };
'recurrence.deleted': { ruleId: number; goalId: number; initiatorId: number };
'recurrence.instanceSkipped': { ruleId: number; goalId: number; date: string; initiatorId: number };
'kanban.statusDeleted': { statusId: number; goalId: number; initiatorId: number };
'tag.deleted': { tagId: number; goalId: number; initiatorId: number };
'list.deleted': { listId: number; goalId: number; initiatorId: number };
'files.changed': { goalId: number; taskIds: number[]; initiatorId: number };
[FileEvents.Uploaded]: FileEventPayload;
[FileEvents.Renamed]: FileEventPayload;
[FileEvents.Deleted]: FileEventPayload;
[FileEvents.Attached]: FileEventPayload;
[FileEvents.Detached]: FileEventPayload;
}
type EventName = keyof AppEvents;
type EventHandler<T extends EventName> = (data: AppEvents[T]) => void | Promise<void>;
class AppEventBus {
private emitter = new EventEmitter();
on<T extends EventName>(event: T, handler: EventHandler<T>) {
this.emitter.on(event, (data: AppEvents[T]) => {
try {
const result = handler(data);
if (result instanceof Promise) {
result.catch((err) => {
$logger.error(err, `EventBus handler error [${event}]`);
});
}
} catch (err) {
$logger.error(err, `EventBus handler error [${event}]`);
}
});
}
emit<T extends EventName>(event: T, data: AppEvents[T]) {
this.emitter.emit(event, data);
}
}
export const eventBus = new AppEventBus();