@therms/react-event-bus 1.0.1

package/README.md

@@ -0,0 +1,94 @@
+# @therms/react-event-bus
+
+An event-bus for use in React applications. This library provides a simple, type-safe way to handle cross-component communication using an event bus pattern.
+
+## Installation
+
+```bash
+npm install @therms/react-event-bus
+```
+
+## Usage
+
+### 1. Create an Event Notifier
+
+Create an instance of the event notifier. You can define the payload type for type safety.
+
+```typescript
+// events.ts
+import { makeEventNotifier } from '@therms/react-event-bus';
+
+// Define the payload type
+type UserLoggedInPayload = {
+  userId: string;
+  timestamp: number;
+};
+
+export const userLoginEvent = makeEventNotifier<UserLoggedInPayload>('USER_LOGIN');
+```
+
+### 2. Publish Events
+
+Trigger an event from anywhere in your application.
+
+```typescript
+import { userLoginEvent } from './events';
+
+userLoginEvent.notify({
+  userId: '12345',
+  timestamp: Date.now(),
+});
+```
+
+### 3. Subscribe to Events (React Hook)
+
+Use the `useEventListener` hook within your React components to listen for events. The hook automatically handles cleanup when the component unmounts.
+
+```tsx
+import React from 'react';
+import { userLoginEvent } from './events';
+
+const UserStatus = () => {
+  
+  userLoginEvent.useEventListener((payload) => {
+    console.log('User logged in:', payload.userId);
+  }, []); // Dependency array, similar to useEffect
+
+  return <div>Waiting for login...</div>;
+};
+```
+
+### 4. Subscribe to Events (Vanilla JS/TS)
+
+You can also subscribe outside of React components using the `listen` method.
+
+```typescript
+import { userLoginEvent } from './events';
+
+const unsubscribe = userLoginEvent.listen((payload) => {
+  console.log('Received event:', payload);
+});
+
+// Later, to stop listening:
+unsubscribe();
+```
+
+## API
+
+### `makeEventNotifier<Payload>(name: string)`
+
+Creates a new event notifier instance.
+
+*   `name`: A unique name for the event (mainly for debugging purposes).
+*   `Payload`: The type of data that will be passed with the event.
+
+Returns an object with the following methods:
+
+*   `notify(payload: Payload)`: Triggers the event with the given payload.
+*   `useEventListener(listener: (payload: Payload) => void, deps: any[])`: A React hook to subscribe to the event.
+*   `listen(listener: (payload: Payload) => void)`: Subscribes to the event. Returns an unsubscribe function.
+*   `name`: The name of the event.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export declare function makeEventNotifier<Payload>(name: string): {
+    /**
+     * Subscribe to events with a strong reference.
+     * The listener will remain active until manually unsubscribed.
+     */
+    listen: (listener: (param: Payload) => void) => () => void;
+    /**
+     * Subscribe to events with a weak reference tied to an owner object.
+     * The listener will be automatically removed when the owner is garbage collected.
+     * Use this to prevent memory leaks in class instances or services.
+     */
+    listenWeak: (owner: object, listener: (param: Payload) => void) => () => void;
+    name: string;
+    notify: (param: Payload) => void;
+    useEventListener: (listener: (param: Payload) => void, deps: ReadonlyArray<any>) => void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0IA,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM;IAEnD;;;OAGG;uBACgB,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAO3C;;;;OAIG;wBACiB,MAAM,YAAY,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;;oBAS9C,OAAO;iCAKX,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,QAC5B,aAAa,CAAC,GAAG,CAAC;EAG7B"}

package/dist/index.js

@@ -0,0 +1,121 @@
+import React, { useRef } from 'react';
+// Global state
+const listenersMap = new Map();
+// FinalizationRegistry for proactive cleanup when owner objects are GC'd
+const finalizationRegistry = new FinalizationRegistry(({ eventName, entry }) => {
+    const listeners = listenersMap.get(eventName);
+    if (listeners) {
+        listeners.delete(entry);
+        if (listeners.size === 0) {
+            listenersMap.delete(eventName);
+        }
+    }
+});
+function addListener(eventName, listener) {
+    let listeners = listenersMap.get(eventName);
+    if (!listeners) {
+        listeners = new Set();
+        listenersMap.set(eventName, listeners);
+    }
+    const entry = {
+        listener,
+        ownerRef: null, // Strong reference
+    };
+    listeners.add(entry);
+    return entry;
+}
+function addWeakListener(eventName, owner, listener) {
+    if (typeof owner !== 'object' || owner === null) {
+        throw new TypeError('Owner must be a non-null object');
+    }
+    let listeners = listenersMap.get(eventName);
+    if (!listeners) {
+        listeners = new Set();
+        listenersMap.set(eventName, listeners);
+    }
+    const entry = {
+        listener,
+        ownerRef: new WeakRef(owner),
+    };
+    listeners.add(entry);
+    finalizationRegistry.register(owner, { eventName, entry }, entry);
+    return entry;
+}
+function removeListenerEntry(eventName, entry) {
+    const listeners = listenersMap.get(eventName);
+    if (listeners) {
+        listeners.delete(entry);
+        if (entry.ownerRef !== null) {
+            finalizationRegistry.unregister(entry);
+        }
+        if (listeners.size === 0) {
+            listenersMap.delete(eventName);
+        }
+    }
+}
+function notify(eventName, ...params) {
+    const listeners = listenersMap.get(eventName);
+    if (!listeners)
+        return false;
+    const toRemove = [];
+    for (const entry of listeners) {
+        // Lazy cleanup: check if weak ref owner is still alive
+        if (entry.ownerRef !== null && entry.ownerRef.deref() === undefined) {
+            toRemove.push(entry);
+            continue;
+        }
+        entry.listener(...params);
+    }
+    // Remove dead weak refs
+    for (const entry of toRemove) {
+        listeners.delete(entry);
+    }
+    if (listeners.size === 0) {
+        listenersMap.delete(eventName);
+    }
+    return true;
+}
+function useEventNotifierListener(event, listener, deps) {
+    const local = useRef({ listener: listener });
+    local.current.listener = listener;
+    const callListener = React.useCallback((...params) => {
+        local.current.listener(...params);
+    }, []);
+    React.useEffect(() => {
+        const entry = addListener(event, callListener);
+        return () => {
+            removeListenerEntry(event, entry);
+        };
+    }, deps);
+}
+export function makeEventNotifier(name) {
+    return {
+        /**
+         * Subscribe to events with a strong reference.
+         * The listener will remain active until manually unsubscribed.
+         */
+        listen: (listener) => {
+            const entry = addListener(name, listener);
+            return () => {
+                removeListenerEntry(name, entry);
+            };
+        },
+        /**
+         * Subscribe to events with a weak reference tied to an owner object.
+         * The listener will be automatically removed when the owner is garbage collected.
+         * Use this to prevent memory leaks in class instances or services.
+         */
+        listenWeak: (owner, listener) => {
+            const entry = addWeakListener(name, owner, listener);
+            return () => {
+                removeListenerEntry(name, entry);
+            };
+        },
+        name: name,
+        notify: (param) => {
+            notify(name, param);
+        },
+        useEventListener: (listener, deps) => useEventNotifierListener(name, listener, deps),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js

@@ -0,0 +1,107 @@
+// @vitest-environment happy-dom
+import { describe, it, expect, vi } from 'vitest';
+import { renderHook } from '@testing-library/react';
+import { makeEventNotifier } from './index.js';
+describe('makeEventNotifier', () => {
+    it('should notify listeners when event is triggered', () => {
+        const eventName = 'test-event-1';
+        const notifier = makeEventNotifier(eventName);
+        const listener = vi.fn();
+        const cleanup = notifier.listen(listener);
+        notifier.notify('hello');
+        expect(listener).toHaveBeenCalledWith('hello');
+        expect(listener).toHaveBeenCalledTimes(1);
+        cleanup();
+    });
+    it('should allow unsubscribing', () => {
+        const eventName = 'test-event-2';
+        const notifier = makeEventNotifier(eventName);
+        const listener = vi.fn();
+        const cleanup = notifier.listen(listener);
+        cleanup();
+        notifier.notify('hello');
+        expect(listener).not.toHaveBeenCalled();
+    });
+    it('should handle multiple listeners', () => {
+        const eventName = 'test-event-3';
+        const notifier = makeEventNotifier(eventName);
+        const listenerOne = vi.fn();
+        const listenerTwo = vi.fn();
+        const cleanupOne = notifier.listen(listenerOne);
+        const cleanupTwo = notifier.listen(listenerTwo);
+        notifier.notify('hello');
+        expect(listenerOne).toHaveBeenCalledWith('hello');
+        expect(listenerTwo).toHaveBeenCalledWith('hello');
+        cleanupOne();
+        notifier.notify('world');
+        expect(listenerOne).toHaveBeenCalledTimes(1);
+        expect(listenerTwo).toHaveBeenCalledTimes(2);
+        expect(listenerTwo).toHaveBeenCalledWith('world');
+        cleanupTwo();
+    });
+    it('should work with useEventListener hook', () => {
+        const eventName = 'test-event-hook';
+        const notifier = makeEventNotifier(eventName);
+        const listener = vi.fn();
+        const { unmount } = renderHook(() => notifier.useEventListener(listener, []));
+        notifier.notify('from hook');
+        expect(listener).toHaveBeenCalledWith('from hook');
+        unmount();
+        notifier.notify('after unmount');
+        expect(listener).toHaveBeenCalledTimes(1);
+    });
+});
+describe('listenWeak', () => {
+    it('should notify weak listener when owner is alive', () => {
+        const notifier = makeEventNotifier('weak-test-1');
+        const listener = vi.fn();
+        const owner = { id: 'test-owner' };
+        notifier.listenWeak(owner, listener);
+        notifier.notify('hello');
+        expect(listener).toHaveBeenCalledWith('hello');
+    });
+    it('should allow manual unsubscribe of weak listener', () => {
+        const notifier = makeEventNotifier('weak-test-2');
+        const listener = vi.fn();
+        const owner = { id: 'test-owner' };
+        const unsubscribe = notifier.listenWeak(owner, listener);
+        unsubscribe();
+        notifier.notify('hello');
+        expect(listener).not.toHaveBeenCalled();
+    });
+    it('should throw if owner is not an object', () => {
+        const notifier = makeEventNotifier('weak-test-3');
+        const listener = vi.fn();
+        expect(() => {
+            // @ts-expect-error - testing runtime validation
+            notifier.listenWeak('not-an-object', listener);
+        }).toThrow(TypeError);
+        expect(() => {
+            // @ts-expect-error - testing runtime validation
+            notifier.listenWeak(null, listener);
+        }).toThrow(TypeError);
+    });
+    it('should support multiple weak listeners with same owner', () => {
+        const notifier = makeEventNotifier('weak-test-4');
+        const listener1 = vi.fn();
+        const listener2 = vi.fn();
+        const owner = { id: 'shared-owner' };
+        notifier.listenWeak(owner, listener1);
+        notifier.listenWeak(owner, listener2);
+        notifier.notify('hello');
+        expect(listener1).toHaveBeenCalledWith('hello');
+        expect(listener2).toHaveBeenCalledWith('hello');
+    });
+    it('should support mixed strong and weak listeners', () => {
+        const notifier = makeEventNotifier('weak-test-5');
+        const strongListener = vi.fn();
+        const weakListener = vi.fn();
+        const owner = { id: 'owner' };
+        notifier.listen(strongListener);
+        notifier.listenWeak(owner, weakListener);
+        notifier.notify('hello');
+        expect(strongListener).toHaveBeenCalledWith('hello');
+        expect(weakListener).toHaveBeenCalledWith('hello');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@therms/react-event-bus",
+  "version": "1.0.1",
+  "description": "An event-bus for use in React applications",
+  "keywords": [
+    "react",
+    "event-bus",
+    "event-hooks",
+    "react-notifier",
+    "react-native"
+  ],
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "homepage": "https://bitbucket.org/thermsio/react-event-bus#readme",
+  "bugs": {
+    "url": "https://bitbucket.org/thermsio/react-event-bus/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://bitbucket.org/thermsio/react-event-bus.git"
+  },
+  "license": "MIT",
+  "author": "coryrobinson42@gmail.com",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "tsc",
+    "prepublishOnly": "tsc"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.2.7",
+    "happy-dom": "^20.0.11",
+    "react": "^19.2.2",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.7",
+    "vitest": "^4.0.15"
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,143 @@
+// @vitest-environment happy-dom
+import {describe, it, expect, vi} from 'vitest'
+import {renderHook} from '@testing-library/react'
+import {makeEventNotifier} from './index.js'
+
+describe('makeEventNotifier', () => {
+  it('should notify listeners when event is triggered', () => {
+    const eventName = 'test-event-1'
+    const notifier = makeEventNotifier<string>(eventName)
+    const listener = vi.fn()
+
+    const cleanup = notifier.listen(listener)
+    
+    notifier.notify('hello')
+    
+    expect(listener).toHaveBeenCalledWith('hello')
+    expect(listener).toHaveBeenCalledTimes(1)
+    
+    cleanup()
+  })
+
+  it('should allow unsubscribing', () => {
+    const eventName = 'test-event-2'
+    const notifier = makeEventNotifier<string>(eventName)
+    const listener = vi.fn()
+
+    const cleanup = notifier.listen(listener)
+    cleanup()
+    
+    notifier.notify('hello')
+    
+    expect(listener).not.toHaveBeenCalled()
+  })
+
+  it('should handle multiple listeners', () => {
+    const eventName = 'test-event-3'
+    const notifier = makeEventNotifier<string>(eventName)
+    const listenerOne = vi.fn()
+    const listenerTwo = vi.fn()
+
+    const cleanupOne = notifier.listen(listenerOne)
+    const cleanupTwo = notifier.listen(listenerTwo)
+    
+    notifier.notify('hello')
+    
+    expect(listenerOne).toHaveBeenCalledWith('hello')
+    expect(listenerTwo).toHaveBeenCalledWith('hello')
+    
+    cleanupOne()
+    
+    notifier.notify('world')
+    
+    expect(listenerOne).toHaveBeenCalledTimes(1)
+    expect(listenerTwo).toHaveBeenCalledTimes(2)
+    expect(listenerTwo).toHaveBeenCalledWith('world')
+    
+    cleanupTwo()
+  })
+
+  it('should work with useEventListener hook', () => {
+    const eventName = 'test-event-hook'
+    const notifier = makeEventNotifier<string>(eventName)
+    const listener = vi.fn()
+
+    const {unmount} = renderHook(() => notifier.useEventListener(listener, []))
+
+    notifier.notify('from hook')
+    expect(listener).toHaveBeenCalledWith('from hook')
+
+    unmount()
+
+    notifier.notify('after unmount')
+    expect(listener).toHaveBeenCalledTimes(1)
+  })
+})
+
+describe('listenWeak', () => {
+  it('should notify weak listener when owner is alive', () => {
+    const notifier = makeEventNotifier<string>('weak-test-1')
+    const listener = vi.fn()
+    const owner = {id: 'test-owner'}
+
+    notifier.listenWeak(owner, listener)
+    notifier.notify('hello')
+
+    expect(listener).toHaveBeenCalledWith('hello')
+  })
+
+  it('should allow manual unsubscribe of weak listener', () => {
+    const notifier = makeEventNotifier<string>('weak-test-2')
+    const listener = vi.fn()
+    const owner = {id: 'test-owner'}
+
+    const unsubscribe = notifier.listenWeak(owner, listener)
+    unsubscribe()
+    notifier.notify('hello')
+
+    expect(listener).not.toHaveBeenCalled()
+  })
+
+  it('should throw if owner is not an object', () => {
+    const notifier = makeEventNotifier<string>('weak-test-3')
+    const listener = vi.fn()
+
+    expect(() => {
+      // @ts-expect-error - testing runtime validation
+      notifier.listenWeak('not-an-object', listener)
+    }).toThrow(TypeError)
+
+    expect(() => {
+      // @ts-expect-error - testing runtime validation
+      notifier.listenWeak(null, listener)
+    }).toThrow(TypeError)
+  })
+
+  it('should support multiple weak listeners with same owner', () => {
+    const notifier = makeEventNotifier<string>('weak-test-4')
+    const listener1 = vi.fn()
+    const listener2 = vi.fn()
+    const owner = {id: 'shared-owner'}
+
+    notifier.listenWeak(owner, listener1)
+    notifier.listenWeak(owner, listener2)
+    notifier.notify('hello')
+
+    expect(listener1).toHaveBeenCalledWith('hello')
+    expect(listener2).toHaveBeenCalledWith('hello')
+  })
+
+  it('should support mixed strong and weak listeners', () => {
+    const notifier = makeEventNotifier<string>('weak-test-5')
+    const strongListener = vi.fn()
+    const weakListener = vi.fn()
+    const owner = {id: 'owner'}
+
+    notifier.listen(strongListener)
+    notifier.listenWeak(owner, weakListener)
+    notifier.notify('hello')
+
+    expect(strongListener).toHaveBeenCalledWith('hello')
+    expect(weakListener).toHaveBeenCalledWith('hello')
+  })
+})

package/src/index.ts

@@ -0,0 +1,176 @@
+import React, {useRef} from 'react'
+
+/**
+ * A simplified version of https://github.com/primus/eventemitter3
+ *
+ * Supports both strong and weak references via listen() and listenWeak().
+ * Use listenWeak(owner, listener) to tie listener lifetime to an owner object,
+ * preventing memory leaks when the owner is garbage collected.
+ */
+
+// Types
+type ListenerFn = (...params: any[]) => void
+
+type ListenerEntry = {
+  listener: ListenerFn
+  ownerRef: WeakRef<object> | null // null = strong reference
+}
+
+// Global state
+const listenersMap: Map<string, Set<ListenerEntry>> = new Map()
+
+// FinalizationRegistry for proactive cleanup when owner objects are GC'd
+const finalizationRegistry = new FinalizationRegistry<{
+  eventName: string
+  entry: ListenerEntry
+}>(({eventName, entry}) => {
+  const listeners = listenersMap.get(eventName)
+  if (listeners) {
+    listeners.delete(entry)
+    if (listeners.size === 0) {
+      listenersMap.delete(eventName)
+    }
+  }
+})
+
+function addListener(eventName: string, listener: ListenerFn): ListenerEntry {
+  let listeners = listenersMap.get(eventName)
+  if (!listeners) {
+    listeners = new Set()
+    listenersMap.set(eventName, listeners)
+  }
+
+  const entry: ListenerEntry = {
+    listener,
+    ownerRef: null, // Strong reference
+  }
+
+  listeners.add(entry)
+  return entry
+}
+
+function addWeakListener(
+  eventName: string,
+  owner: object,
+  listener: ListenerFn,
+): ListenerEntry {
+  if (typeof owner !== 'object' || owner === null) {
+    throw new TypeError('Owner must be a non-null object')
+  }
+
+  let listeners = listenersMap.get(eventName)
+  if (!listeners) {
+    listeners = new Set()
+    listenersMap.set(eventName, listeners)
+  }
+
+  const entry: ListenerEntry = {
+    listener,
+    ownerRef: new WeakRef(owner),
+  }
+
+  listeners.add(entry)
+  finalizationRegistry.register(owner, {eventName, entry}, entry)
+
+  return entry
+}
+
+function removeListenerEntry(eventName: string, entry: ListenerEntry): void {
+  const listeners = listenersMap.get(eventName)
+  if (listeners) {
+    listeners.delete(entry)
+    if (entry.ownerRef !== null) {
+      finalizationRegistry.unregister(entry)
+    }
+    if (listeners.size === 0) {
+      listenersMap.delete(eventName)
+    }
+  }
+}
+
+function notify<T = any>(eventName: string, ...params: T[]): boolean {
+  const listeners = listenersMap.get(eventName)
+  if (!listeners) return false
+
+  const toRemove: ListenerEntry[] = []
+
+  for (const entry of listeners) {
+    // Lazy cleanup: check if weak ref owner is still alive
+    if (entry.ownerRef !== null && entry.ownerRef.deref() === undefined) {
+      toRemove.push(entry)
+      continue
+    }
+
+    entry.listener(...params)
+  }
+
+  // Remove dead weak refs
+  for (const entry of toRemove) {
+    listeners.delete(entry)
+  }
+
+  if (listeners.size === 0) {
+    listenersMap.delete(eventName)
+  }
+
+  return true
+}
+
+function useEventNotifierListener<T extends (...params: any) => void>(
+  event: string,
+  listener: T,
+  deps: ReadonlyArray<any>,
+) {
+  const local = useRef<{listener: T}>({listener: listener})
+  local.current.listener = listener
+
+  const callListener = React.useCallback((...params: Parameters<T>) => {
+    local.current.listener(...params)
+  }, [])
+
+  React.useEffect(() => {
+    const entry = addListener(event, callListener)
+    return () => {
+      removeListenerEntry(event, entry)
+    }
+  }, deps)
+}
+
+export function makeEventNotifier<Payload>(name: string) {
+  return {
+    /**
+     * Subscribe to events with a strong reference.
+     * The listener will remain active until manually unsubscribed.
+     */
+    listen: (listener: (param: Payload) => void) => {
+      const entry = addListener(name, listener)
+      return () => {
+        removeListenerEntry(name, entry)
+      }
+    },
+
+    /**
+     * Subscribe to events with a weak reference tied to an owner object.
+     * The listener will be automatically removed when the owner is garbage collected.
+     * Use this to prevent memory leaks in class instances or services.
+     */
+    listenWeak: (owner: object, listener: (param: Payload) => void) => {
+      const entry = addWeakListener(name, owner, listener)
+      return () => {
+        removeListenerEntry(name, entry)
+      }
+    },
+
+    name: name,
+
+    notify: (param: Payload) => {
+      notify(name, param)
+    },
+
+    useEventListener: (
+      listener: (param: Payload) => void,
+      deps: ReadonlyArray<any>,
+    ) => useEventNotifierListener(name, listener, deps),
+  }
+}
+