Package Exports

remitter
remitter/dist/remitter.js
remitter/dist/remitter.mjs

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (remitter) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

remitter

A tiny TypeScript friendly event emitter that supports easy re-emitting events.

Install

npm add remitter

Usage

import { Remitter } from "remitter";

interface EventConfig {
  event1: string;
  event2: void;
}

const remitter = new Remitter<EventConfig>();

const disposer = remitter.on("event1", value => {
  console.log("event1", value);
});

remitter.once("event1", value => {
  console.log("event1-once", value);
});

remitter.count("event1"); // 2

remitter.emit("event1", "hello"); // logs "event1 hello" and "event1-once hello"

remitter.emit("event1", "hello"); // logs "event1 hello"

remitter.emit("event2"); // nothing logs

disposer();
remitter.emit("event1", "world"); // nothing logs

remitter.clear("event2"); // remove all listeners for event2
remitter.count(); // 0

remitter.destroy(); // removes all listeners and dispose tapped events

Remit

You may tap into other events easily with remit. It is lazy-executed when listener count of the event name grows from 0 to 1. It is disposed when listener count of the event name drops from 1 to 0.

remitter.remit("event1", () => {
  const handler = e => {
    remitter.emit("event1", e.value + 1);
  };
  otherEvent.addListener(handler);
  return () => {
    otherEvent.removeListener(handler);
  };
});

The callback function can also be a pure function.

const tapToOtherEvent = remitter => {
  const handler = e => {
    remitter.emit("event1", e.value + 1);
  };
  otherEvent.addListener(handler);
  return () => {
    otherEvent.removeListener(handler);
  };
};

remitter.remit("event1", tapToOtherEvent);

Acknowledgment

Huge thanks to @recursivefunk for giving away the NPM package name remitter.