Skip to content

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.

4.9 KB
Raw Blame
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();