@alwatr/signal 9.11.2 → 9.13.0

package/src/core/signal-base.ts

@@ -135,6 +135,8 @@ export abstract class SignalBase<T> {
     }
   }
 
+  private pendingRejects__ = new Set<(reason?: any) => void>();
+
   /**
    * Returns a Promise that resolves with the next value dispatched by the signal.
    * This provides an elegant way to wait for a single, future event using `async/await`.
@@ -151,12 +153,19 @@ export abstract class SignalBase<T> {
   public untilNext(): Promise<T> {
     this.logger_.logMethod?.('untilNext');
     this.checkDestroyed_();
-    return new Promise((resolve) => {
-      this.subscribe(resolve, {
-        once: true,
-        priority: true, // Resolve the promise before other listeners are called.
-        receivePrevious: false, // We only want the *next* value, not the current one.
-      });
+    return new Promise((resolve, reject) => {
+      this.pendingRejects__.add(reject);
+      this.subscribe(
+        (value) => {
+          this.pendingRejects__.delete(reject);
+          resolve(value);
+        },
+        {
+          once: true,
+          priority: true, // Resolve the promise before other listeners are called.
+          receivePrevious: false, // We only want the *next* value, not the current one.
+        },
+      );
     });
   }
 
@@ -173,7 +182,15 @@ export abstract class SignalBase<T> {
       this.logger_.incident?.('destroy_', 'double_destroy_attempt');
       return;
     }
-    this.isDestroyed__ = true;
+    this.isDestroyed__ = true; // Mark the signal as destroyed.
+    // Reject all pending promises.
+    if (this.pendingRejects__.size) {
+      const error = new Error('signal_destroyed');
+      for (const reject of this.pendingRejects__) {
+        reject(error);
+      }
+      this.pendingRejects__.clear(); // Clear all pending rejects.
+    }
     this.priorityObservers_.clear(); // Clear all priority observers.
     this.observers_.clear(); // Clear all normal observers.
     this.config_.onDestroy?.(); // Call the optional onDestroy callback.

package/src/creators/channel.ts

@@ -0,0 +1,44 @@
+import {ChannelSignal} from '../core/channel-signal.js';
+
+import type {ChannelSignalConfig} from '../core/channel-signal.js';
+
+/**
+ * Creates a stateless multi-channel signal that acts as a typed message bus.
+ *
+ * `ChannelSignal` is ideal when you need a single signal to carry multiple
+ * distinct message types — each identified by a `name` — rather than creating
+ * a separate `EventSignal` for every event.
+ *
+ * The generic parameter `TMap` is a record that maps every valid message name
+ * to its payload type, giving you full type safety at both dispatch and subscribe sites.
+ *
+ * @template TMap A record mapping message names to their payload types.
+ *
+ * @param config The configuration for the channel signal.
+ * @returns A new instance of `ChannelSignal`.
+ *
+ * @example
+ * ```ts
+ * interface AppMessages {
+ *   'open-drawer': {panel: string};
+ *   'close-drawer': void;
+ *   'show-toast': {message: string; type: 'info' | 'error'};
+ * }
+ *
+ * const appChannel = createChannelSignal<AppMessages>({name: 'app-channel'});
+ *
+ * // Subscribe to a specific message
+ * appChannel.on('show-toast', (payload) => {
+ *   toast.show(payload!.message, payload!.type);
+ * });
+ *
+ * // Dispatch a message
+ * appChannel.dispatch('show-toast', {message: 'Saved!', type: 'info'});
+ * appChannel.dispatch('close-drawer');
+ * ```
+ */
+export function createChannelSignal<TMap extends Record<string, unknown>>(
+  config: ChannelSignalConfig,
+): ChannelSignal<TMap> {
+  return new ChannelSignal<TMap>(config);
+}

package/src/main.ts

@@ -5,6 +5,7 @@ export * from './core/computed-signal.js';
 export * from './core/effect-signal.js';
 export * from './core/persistent-state-signal.js';
 export * from './core/session-state-signal.js';
+export * from './core/channel-signal.js';
 
 export * from './creators/event.js';
 export * from './creators/state.js';
@@ -12,6 +13,7 @@ export * from './creators/computed.js';
 export * from './creators/effect.js';
 export * from './creators/persistent-state.js';
 export * from './creators/session-state.js';
+export * from './creators/channel.js';
 
 export * from './operators/debounce.js';
 export * from './operators/filter.js';