High performance self-hosted photo and video management solution.
TypeScript backup-toolfluttergoogle-photosgoogle-photos-alternativejavascriptmobile-appnestjsnodejsphoto-galleryphotosphotos-managementself-hostedsveltesveltekittypescriptvideos
type EventsBase = Record<string, unknown[]>;
type PromiseLike<T> = Promise<T> | T;
export type EventMap<E extends EventsBase> = { [K in keyof E]?: EventCallback<E, K> };
export type EventCallback<E extends EventsBase, T extends keyof E> = (...args: E[T]) => PromiseLike<unknown>;
export type EventItem<E extends EventsBase, T extends keyof E = keyof E> = {
id: number;
event: T;
callback: EventCallback<E, T>;
};
let count = 1;
const nextId = () => count++;
const noop = () => {};
export class BaseEventManager<Events extends EventsBase> {
#callbacks: EventItem<Events>[] = [];
#changeCount = $state(0); // make hasListeners reactive while keeping #callbacks plain JS
on(subscriptions: EventMap<Events>): () => void {
const cleanups = Object.entries(subscriptions).map(([event, callback]) =>
this.#onEvent(event as keyof Events, callback as EventCallback<Events, keyof Events>),
);
return () => {
for (const cleanup of cleanups) {
cleanup();
}
};
}
#onEvent<T extends keyof Events>(event: T, callback?: EventCallback<Events, T>) {
if (!callback) {
return noop;
}
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const item = { id: nextId(), event, callback } as EventItem<Events, any>;
this.#callbacks.push(item);
this.markChanged();
return () => {
this.#callbacks = this.#callbacks.filter((current) => current.id !== item.id);
this.markChanged();
};
}
private markChanged() {
this.#changeCount++;
}
emit<T extends keyof Events>(event: T, ...params: Events[T]) {
const listeners = this.getListeners(event);
for (const listener of listeners) {
void listener(...params);
}
}
hasListeners<T extends keyof Events>(event: T) {
// eslint-disable-next-line @typescript-eslint/no-unused-expressions
this.#changeCount;
return this.#callbacks.some((item) => item.event === event);
}
private getListeners<T extends keyof Events>(event: T) {
return this.#callbacks
.filter((item) => item.event === event)
.map((item) => item.callback as EventCallback<Events, T>);
}
}