@dungarees/event-broker 0.11.4

package/event-emitter.d.ts

@@ -0,0 +1,2 @@
+import type { EventBrokerBackend } from './type.ts';
+export declare const createEventEmitterBackend: () => EventBrokerBackend;

package/event-emitter.js

@@ -0,0 +1,12 @@
+import { EventEmitter } from 'node:events';
+export const createEventEmitterBackend = () => {
+    const target = new EventEmitter();
+    return {
+        dispatch: (event, args) => {
+            target.emit(event, args);
+        },
+        on: (event, handler) => {
+            target.addListener(event, handler);
+        },
+    };
+};

package/event-emitter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/event-emitter.test.js

@@ -0,0 +1,30 @@
+import { createEventEmitterBackend } from './event-emitter.js';
+import { expect, test } from 'vitest';
+test('the backend hands a dispatched payload to a handler registered for that event', () => {
+    const backend = createEventEmitterBackend();
+    const received = [];
+    backend.on('some-event', (args) => {
+        received.push(args);
+    });
+    backend.dispatch('some-event', { a: 1 });
+    expect(received).toEqual([{ a: 1 }]);
+});
+test('the backend keeps one event from reaching another event handler', () => {
+    const backend = createEventEmitterBackend();
+    const received = [];
+    backend.on('some-event', (args) => {
+        received.push(args);
+    });
+    backend.dispatch('other-event', { a: 1 });
+    expect(received).toEqual([]);
+});
+test('the backend delivers to a handler as many times as the event is dispatched', () => {
+    const backend = createEventEmitterBackend();
+    const received = [];
+    backend.on('some-event', (args) => {
+        received.push(args);
+    });
+    backend.dispatch('some-event', 1);
+    backend.dispatch('some-event', 2);
+    expect(received).toEqual([1, 2]);
+});

package/fake.d.ts

@@ -0,0 +1,11 @@
+import type { EventBrokerBackend } from './type.ts';
+type Subscription = [string, (args: never) => void];
+type DispatchedEvent = [string, unknown];
+export type FakeEventBrokerBackend = {
+    backend: EventBrokerBackend;
+    subscriptions: Subscription[];
+    dispatchedEvents: DispatchedEvent[];
+    invokeHandlers: (event: string, args: unknown) => void;
+};
+export declare const createFakeEventBrokerBackend: () => FakeEventBrokerBackend;
+export {};

package/fake.js

@@ -0,0 +1,28 @@
+// Records rather than delivers, so a test can assert what its subject dispatched without standing
+// up a listener, and can drive the registered handlers itself when it wants the other direction.
+export const createFakeEventBrokerBackend = () => {
+    const subscriptions = [];
+    const dispatchedEvents = [];
+    return {
+        backend: {
+            on: (event, handler) => {
+                subscriptions.push([event, handler]);
+            },
+            dispatch: (event, args) => {
+                dispatchedEvents.push([event, args]);
+            },
+        },
+        subscriptions,
+        dispatchedEvents,
+        invokeHandlers: (event, args) => {
+            subscriptions
+                .filter(([subscribedEvent]) => subscribedEvent === event)
+                // The handler's parameter is `never` on the untyped side of the boundary, so calling it
+                // means handing over a value the backend cannot describe; the typed broker above is what
+                // guarantees the payload matches the event.
+                .forEach(([_, handler]) => {
+                handler(args);
+            });
+        },
+    };
+};

package/fake.test.d.ts

@@ -0,0 +1 @@
+export {};

package/fake.test.js

@@ -0,0 +1,69 @@
+import { createFakeEventBrokerBackend } from './fake.js';
+import { createBroker } from './service.js';
+import { expect, test } from 'vitest';
+test('the fake backend records what a broker dispatched through it', () => {
+    const { backend, dispatchedEvents } = createFakeEventBrokerBackend();
+    const broker = createBroker(backend);
+    broker.dispatch('counted', 7);
+    expect(dispatchedEvents).toEqual([['counted', 7]]);
+});
+test('the fake backend records dispatches in the order they happened', () => {
+    const { backend, dispatchedEvents } = createFakeEventBrokerBackend();
+    const broker = createBroker(backend);
+    broker.dispatch('counted', 1);
+    broker.dispatch('counted', 2);
+    expect(dispatchedEvents).toEqual([
+        ['counted', 1],
+        ['counted', 2],
+    ]);
+});
+test('the fake backend does not deliver a dispatch to handlers on its own', () => {
+    const { backend } = createFakeEventBrokerBackend();
+    const broker = createBroker(backend);
+    const received = [];
+    broker.on('counted', (args) => {
+        received.push(args);
+    });
+    broker.dispatch('counted', 7);
+    expect(received).toEqual([]);
+});
+test('invokeHandlers drives the handlers registered for that event', () => {
+    const { backend, invokeHandlers } = createFakeEventBrokerBackend();
+    const broker = createBroker(backend);
+    const received = [];
+    broker.on('counted', (args) => {
+        received.push(args);
+    });
+    invokeHandlers('counted', 7);
+    expect(received).toEqual([7]);
+});
+test('invokeHandlers leaves handlers for other events alone', () => {
+    const { backend, invokeHandlers } = createFakeEventBrokerBackend();
+    const broker = createBroker(backend);
+    const received = [];
+    broker.on('counted', (args) => {
+        received.push(args);
+    });
+    invokeHandlers('other-event', 7);
+    expect(received).toEqual([]);
+});
+test('invokeHandlers drives every handler registered for the event', () => {
+    const { backend, invokeHandlers } = createFakeEventBrokerBackend();
+    const broker = createBroker(backend);
+    const received = [];
+    broker.on('counted', (args) => {
+        received.push(args);
+    });
+    broker.on('counted', (args) => {
+        received.push(args * 2);
+    });
+    invokeHandlers('counted', 7);
+    expect(received).toEqual([7, 14]);
+});
+test('the fake backend records what a broker subscribed to', () => {
+    const { backend, subscriptions } = createFakeEventBrokerBackend();
+    const broker = createBroker(backend);
+    const handler = () => undefined;
+    broker.on('counted', handler);
+    expect(subscriptions).toEqual([['counted', handler]]);
+});

package/package.json

@@ -0,0 +1,455 @@
+{
+  "name": "@dungarees/event-broker",
+  "engines": {
+    "node": ">=25.0.0"
+  },
+  "scripts": {
+    "type-check": "tsc --noEmit"
+  },
+  "type": "module",
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.2"
+  },
+  "author": "info@productkind.com",
+  "license": "MIT",
+  "version": "0.11.4",
+  "exports": {
+    "./event-emitter.test.ts": {
+      "import": "./event-emitter.test.js",
+      "types": "./event-emitter.test.d.ts"
+    },
+    "./event-emitter.ts": {
+      "import": "./event-emitter.js",
+      "types": "./event-emitter.d.ts"
+    },
+    "./fake.test.ts": {
+      "import": "./fake.test.js",
+      "types": "./fake.test.d.ts"
+    },
+    "./fake.ts": {
+      "import": "./fake.js",
+      "types": "./fake.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.d.js",
+      "types": "./node_modules/typescript/lib/lib.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.decorators.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.decorators.d.js",
+      "types": "./node_modules/typescript/lib/lib.decorators.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.decorators.legacy.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.decorators.legacy.d.js",
+      "types": "./node_modules/typescript/lib/lib.decorators.legacy.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.dom.asynciterable.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.dom.asynciterable.d.js",
+      "types": "./node_modules/typescript/lib/lib.dom.asynciterable.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.dom.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.dom.d.js",
+      "types": "./node_modules/typescript/lib/lib.dom.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.dom.iterable.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.dom.iterable.d.js",
+      "types": "./node_modules/typescript/lib/lib.dom.iterable.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.collection.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.collection.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.collection.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.core.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.core.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.core.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.generator.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.generator.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.generator.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.iterable.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.iterable.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.iterable.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.promise.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.promise.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.promise.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.proxy.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.proxy.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.proxy.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.reflect.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.reflect.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.reflect.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.symbol.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.symbol.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.symbol.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2016.array.include.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2016.array.include.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2016.array.include.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2016.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2016.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2016.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2016.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2016.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2016.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2016.intl.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2016.intl.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2016.intl.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2017.arraybuffer.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2017.arraybuffer.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2017.arraybuffer.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2017.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2017.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2017.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2017.date.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2017.date.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2017.date.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2017.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2017.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2017.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2017.intl.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2017.intl.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2017.intl.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2017.object.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2017.object.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2017.object.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2017.sharedmemory.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2017.sharedmemory.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2017.sharedmemory.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2017.string.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2017.string.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2017.string.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2017.typedarrays.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2017.typedarrays.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2017.typedarrays.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2018.asyncgenerator.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2018.asyncgenerator.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2018.asyncgenerator.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2018.asynciterable.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2018.asynciterable.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2018.asynciterable.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2018.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2018.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2018.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2018.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2018.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2018.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2018.intl.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2018.intl.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2018.intl.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2018.promise.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2018.promise.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2018.promise.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2018.regexp.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2018.regexp.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2018.regexp.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2019.array.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2019.array.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2019.array.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2019.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2019.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2019.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2019.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2019.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2019.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2019.intl.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2019.intl.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2019.intl.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2019.object.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2019.object.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2019.object.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2019.string.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2019.string.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2019.string.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2019.symbol.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2019.symbol.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2019.symbol.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.bigint.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.bigint.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.bigint.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.date.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.date.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.date.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.intl.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.intl.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.intl.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.number.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.number.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.number.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.promise.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.promise.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.promise.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.sharedmemory.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.sharedmemory.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.sharedmemory.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.string.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.string.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.string.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2021.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2021.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2021.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2021.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2021.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2021.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2021.intl.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2021.intl.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2021.intl.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2021.promise.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2021.promise.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2021.promise.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2021.string.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2021.string.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2021.string.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2021.weakref.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2021.weakref.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2021.weakref.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2022.array.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2022.array.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2022.array.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2022.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2022.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2022.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2022.error.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2022.error.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2022.error.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2022.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2022.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2022.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2022.intl.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2022.intl.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2022.intl.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2022.object.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2022.object.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2022.object.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2022.regexp.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2022.regexp.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2022.regexp.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2022.string.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2022.string.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2022.string.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2023.array.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2023.array.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2023.array.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2023.collection.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2023.collection.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2023.collection.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2023.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2023.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2023.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2023.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2023.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2023.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2023.intl.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2023.intl.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2023.intl.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2024.arraybuffer.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2024.arraybuffer.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2024.arraybuffer.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2024.collection.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2024.collection.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2024.collection.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2024.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2024.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2024.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2024.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2024.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2024.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2024.object.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2024.object.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2024.object.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2024.promise.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2024.promise.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2024.promise.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2024.regexp.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2024.regexp.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2024.regexp.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2024.sharedmemory.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2024.sharedmemory.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2024.sharedmemory.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es2024.string.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es2024.string.d.js",
+      "types": "./node_modules/typescript/lib/lib.es2024.string.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es5.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es5.d.js",
+      "types": "./node_modules/typescript/lib/lib.es5.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.es6.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.es6.d.js",
+      "types": "./node_modules/typescript/lib/lib.es6.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.array.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.array.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.array.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.collection.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.collection.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.collection.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.decorators.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.decorators.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.decorators.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.disposable.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.disposable.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.disposable.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.error.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.error.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.error.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.float16.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.float16.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.float16.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.full.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.full.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.full.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.intl.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.intl.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.intl.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.iterator.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.iterator.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.iterator.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.promise.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.promise.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.promise.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.esnext.sharedmemory.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.esnext.sharedmemory.d.js",
+      "types": "./node_modules/typescript/lib/lib.esnext.sharedmemory.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.scripthost.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.scripthost.d.js",
+      "types": "./node_modules/typescript/lib/lib.scripthost.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.webworker.asynciterable.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.webworker.asynciterable.d.js",
+      "types": "./node_modules/typescript/lib/lib.webworker.asynciterable.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.webworker.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.webworker.d.js",
+      "types": "./node_modules/typescript/lib/lib.webworker.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.webworker.importscripts.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.webworker.importscripts.d.js",
+      "types": "./node_modules/typescript/lib/lib.webworker.importscripts.d.d.ts"
+    },
+    "./node_modules/typescript/lib/lib.webworker.iterable.d.ts": {
+      "import": "./node_modules/typescript/lib/lib.webworker.iterable.d.js",
+      "types": "./node_modules/typescript/lib/lib.webworker.iterable.d.d.ts"
+    },
+    "./node_modules/typescript/lib/tsserverlibrary.d.ts": {
+      "import": "./node_modules/typescript/lib/tsserverlibrary.d.js",
+      "types": "./node_modules/typescript/lib/tsserverlibrary.d.d.ts"
+    },
+    "./node_modules/typescript/lib/typescript.d.ts": {
+      "import": "./node_modules/typescript/lib/typescript.d.js",
+      "types": "./node_modules/typescript/lib/typescript.d.d.ts"
+    },
+    "./service.test.ts": {
+      "import": "./service.test.js",
+      "types": "./service.test.d.ts"
+    },
+    "./service.ts": {
+      "import": "./service.js",
+      "types": "./service.d.ts"
+    },
+    "./type.ts": {
+      "import": "./type.js",
+      "types": "./type.d.ts"
+    }
+  }
+}

package/service.d.ts

@@ -0,0 +1,2 @@
+import type { EventBroker, EventBrokerBackend } from './type.ts';
+export declare const createBroker: <PAYLOADS extends Record<string, unknown>>(brokerBackend: EventBrokerBackend) => EventBroker<PAYLOADS>;

package/service.js

@@ -0,0 +1,8 @@
+export const createBroker = (brokerBackend) => ({
+    dispatch: (event, args) => {
+        brokerBackend.dispatch(event, args);
+    },
+    on: (event, handler) => {
+        brokerBackend.on(event, handler);
+    },
+});

package/service.test.d.ts

@@ -0,0 +1 @@
+export {};

package/service.test.js

@@ -0,0 +1,72 @@
+import { createEventEmitterBackend } from './event-emitter.js';
+import { createBroker } from './service.js';
+import { expect, expectTypeOf, test } from 'vitest';
+test('a handler receives the payload dispatched for its event', () => {
+    const broker = createBroker(createEventEmitterBackend());
+    const received = [];
+    broker.on('greeted', (args) => {
+        received.push(args);
+    });
+    broker.dispatch('greeted', { name: 'Ada' });
+    expect(received).toEqual([{ name: 'Ada' }]);
+});
+test('a handler is left alone when a different event is dispatched', () => {
+    const broker = createBroker(createEventEmitterBackend());
+    const received = [];
+    broker.on('counted', (args) => {
+        received.push(args);
+    });
+    broker.dispatch('greeted', { name: 'Ada' });
+    expect(received).toEqual([]);
+});
+test('every handler registered for an event receives it', () => {
+    const broker = createBroker(createEventEmitterBackend());
+    const first = [];
+    const second = [];
+    broker.on('counted', (args) => {
+        first.push(args);
+    });
+    broker.on('counted', (args) => {
+        second.push(args);
+    });
+    broker.dispatch('counted', 7);
+    expect([first, second]).toEqual([[7], [7]]);
+});
+test('a handler receives each dispatch in turn', () => {
+    const broker = createBroker(createEventEmitterBackend());
+    const received = [];
+    broker.on('counted', (args) => {
+        received.push(args);
+    });
+    broker.dispatch('counted', 1);
+    broker.dispatch('counted', 2);
+    expect(received).toEqual([1, 2]);
+});
+test('dispatching an event nobody listens for is not an error', () => {
+    const broker = createBroker(createEventEmitterBackend());
+    expect(() => broker.dispatch('counted', 7)).not.toThrow();
+});
+test('the handler payload is typed from the event it is registered for', () => {
+    const broker = createBroker(createEventEmitterBackend());
+    broker.on('greeted', (args) => {
+        expectTypeOf(args).toEqualTypeOf();
+    });
+    broker.on('counted', (args) => {
+        expectTypeOf(args).toEqualTypeOf();
+    });
+});
+test('dispatch rejects a payload that belongs to a different event', () => {
+    const broker = createBroker(createEventEmitterBackend());
+    // @ts-expect-error the 'greeted' payload is an object, so a number is never valid for it
+    broker.dispatch('greeted', 7);
+});
+test('dispatch rejects an event the payload map does not declare', () => {
+    const broker = createBroker(createEventEmitterBackend());
+    // @ts-expect-error 'shouted' is not one of the declared events
+    broker.dispatch('shouted', { name: 'Ada' });
+});
+test('on rejects an event the payload map does not declare', () => {
+    const broker = createBroker(createEventEmitterBackend());
+    // @ts-expect-error 'shouted' is not one of the declared events
+    broker.on('shouted', () => undefined);
+});

package/type.d.ts

@@ -0,0 +1,8 @@
+export type EventBrokerBackend = {
+    on: <PAYLOAD>(event: string, handler: (args: PAYLOAD) => void) => void;
+    dispatch: <PAYLOAD>(event: string, args: PAYLOAD) => void;
+};
+export type EventBroker<PAYLOADS extends Record<string, unknown>> = {
+    on: <TYPE extends keyof PAYLOADS & string>(event: TYPE, handler: (args: PAYLOADS[TYPE]) => void) => void;
+    dispatch: <TYPE extends keyof PAYLOADS & string>(event: TYPE, args: PAYLOADS[TYPE]) => void;
+};

package/type.js

@@ -0,0 +1 @@
+export {};