event-publisher

EventPublisher

A strongly typed protected event creator/publisher/signaler for use with TypeScript and JavaScript.

Purpose

• Provides an API that separates event listening/subscribing from dispatching/publishing.
• Simplifies adding events to any object.

Example

import { Event, EventPublisher } from '../src/EventPublisher';

export class MyObservable<T> {

	readonly start:Event<void>;
	readonly update:Event<T>;
	readonly complete:Event<void>;

	private readonly _dispatcher:{
		start:EventPublisher<void>,
		update:EventPublisher<T>,
		complete:EventPublisher<void>
	};

	constructor()
	{
		const start = new EventPublisher<void>();
		const update = new EventPublisher<T>();
		const complete = new EventPublisher<void>();
		this._dispatcher = { start, update, complete };
		this.start = start.event;
		this.update = update.event;
		this.complete = complete.event;
	}
}

API

Event

type Listener<T> = (value: T) => void;
type Unsubscribe = () => void;

interface Event<T>
{
	/**
	 * Adds a listener and return an unsubscribe function.
	 * @param listener
	 */
	(listener: Listener<T>): Unsubscribe;

    /**
     * Add an entry to the end of the registry.
     * @param value
     */

    add(value: T): number;
    /**
     * Remove an entry.
     * @param id
     */

    remove(id: number): boolean;
    /**
     * Adds an entry to the registry if it doesn't exist.
     * @param value
     */

    register(value: T): number;
    /**
     * Clears all entries.
     */
    clear(): void;
}

EventPublisher

interface IEventPublisher<T>
{
	publish(payload: T): void;
	publishReverse(payload: T): void;

	readonly event: Readonly<Event<T>>;
}