npm - @metamask-previews/messenger - Versions diffs - 1.1.1-preview-45a82ea8e → 1.2.0-preview-d8ff44d - Mend

@metamask-previews/messenger 1.1.1-preview-45a82ea8e → 1.2.0-preview-d8ff44d

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
+## [1.2.0]
+### Added
+- Allow overriding action handler in subclass ([#8617](https://github.com/MetaMask/core/pull/8617))
+  - The `Messenger` class now has a protected `getAction` method which returns the action handler for a given action name.
+- Add `subscribeOnce` and `waitUntil` utility methods to `Messenger` ([#8575](https://github.com/MetaMask/core/pull/8575))
 ### Deprecated
 - Deprecate `generate-action-types` CLI tool and `messenger-generate-action-types` binary ([#8378](https://github.com/MetaMask/core/pull/8378))
@@ -88,7 +96,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Existing `RestrictedMessenger` instances should be replaced with a `Messenger` with the `parent` constructor parameter set to the global messenger. We can now use the same class everywhere, passing capabilities using `delegate`.
   - See this ADR for details: https://github.com/MetaMask/decisions/blob/main/decisions/core/0012-messenger-delegation.md
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/messenger@1.1.1...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/messenger@1.2.0...HEAD
+[1.2.0]: https://github.com/MetaMask/core/compare/@metamask/messenger@1.1.1...@metamask/messenger@1.2.0
 [1.1.1]: https://github.com/MetaMask/core/compare/@metamask/messenger@1.1.0...@metamask/messenger@1.1.1
 [1.1.0]: https://github.com/MetaMask/core/compare/@metamask/messenger@1.0.0...@metamask/messenger@1.1.0
 [1.0.0]: https://github.com/MetaMask/core/compare/@metamask/messenger@0.3.0...@metamask/messenger@1.0.0

package/dist/Messenger.cjs CHANGED Viewed

@@ -145,6 +145,20 @@ class Messenger {
             __classPrivateFieldGet(this, _Messenger_instances, "m", _Messenger_unregisterActionHandler).call(this, actionType);
         }
     }
+    /**
+     * Get the action handler for a given action type.
+     *
+     * This is a protected method to allow subclasses to override the way action
+     * handlers are retrieved, for example to implement custom delegation logic.
+     *
+     * @param actionType - The action type. This is a unique identifier for this
+     * action.
+     * @returns The action handler for the given action type, or undefined if no
+     * handler has been registered.
+     */
+    getAction(actionType) {
+        return __classPrivateFieldGet(this, _Messenger_actions, "f").get(actionType);
+    }
     /**
      * Call an action.
      *
@@ -159,7 +173,7 @@ class Messenger {
      * @returns The action return value.
      */
     call(actionType, ...params) {
-        const handler = __classPrivateFieldGet(this, _Messenger_actions, "f").get(actionType);
+        const handler = this.getAction(actionType);
         if (!handler) {
             throw new Error(__classPrivateFieldGet(this, _Messenger_instances, "m", _Messenger_isInCurrentNamespace).call(this, actionType)
                 ? `A handler for ${actionType} has not been registered`
@@ -242,6 +256,24 @@ class Messenger {
             }
         }
     }
+    subscribeOnce(eventType, handler, options) {
+        const { selector, condition } = options ?? {};
+        // Casting to unknown to handle both the code path where a selector is defined and where it is omitted.
+        const internalHandler = (...args) => {
+            if (condition &&
+                !condition(...args)) {
+                return;
+            }
+            this.unsubscribe(eventType, internalHandler);
+            handler(...args);
+        };
+        this.subscribe(eventType, internalHandler, selector);
+    }
+    waitUntil(eventType, options) {
+        return new Promise((resolve) => {
+            this.subscribeOnce(eventType, (...args) => resolve(args), options);
+        });
+    }
     /**
      * Unsubscribe from an event.
      *
@@ -335,7 +367,7 @@ class Messenger {
             const delegatedActionHandler = (...args) => {
                 // Cast to get more specific type, for this specific action
                 // The types get collapsed by `this.#actions`
-                const actionHandler = __classPrivateFieldGet(this, _Messenger_actions, "f").get(actionType);
+                const actionHandler = this.getAction(actionType);
                 if (!actionHandler) {
                     throw new Error(`A handler for ${actionType} has not been registered`);
                 }

package/dist/Messenger.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Messenger.cjs","sourceRoot":"","sources":["../src/Messenger.ts"],"names":[],"mappings":"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","sourcesContent":["export type ActionHandler<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = (\n ...args: ExtractActionParameters<Action, ActionType>\n) => ExtractActionResponse<Action, ActionType>;\n\nexport type ExtractActionParameters<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = Action extends {\n type: ActionType;\n handler: (...args: infer HandlerArgs) => unknown;\n}\n ? HandlerArgs\n : never;\n\nexport type ExtractActionResponse<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = Action extends {\n type: ActionType;\n handler: (...args: infer _) => infer HandlerReturnValue;\n}\n ? HandlerReturnValue\n : never;\n\nexport type ExtractEventHandler<\n Event extends EventConstraint,\n EventType = Event['type'],\n> = Event extends {\n type: EventType;\n payload: infer Payload;\n}\n ? Payload extends unknown[]\n ? (...payload: Payload) => void\n : never\n : never;\n\nexport type ExtractEventPayload<\n Event extends EventConstraint,\n EventType = Event['type'],\n> = Event extends {\n type: EventType;\n payload: infer Payload;\n}\n ? Payload extends unknown[]\n ? Payload\n : never\n : never;\n\nexport type GenericEventHandler = (...args: unknown[]) => void;\n\nexport type SelectorFunction<\n Event extends EventConstraint,\n EventType extends Event['type'],\n ReturnValue = unknown,\n> = (...args: ExtractEventPayload<Event, EventType>) => ReturnValue;\nexport type SelectorEventHandler<SelectorReturnValue = unknown> = (\n newValue: SelectorReturnValue,\n previousValue: SelectorReturnValue \| undefined,\n) => void;\n\nexport type ActionConstraint = {\n type: NamespacedName;\n handler: ((...args: never) => unknown) \| ((...args: never[]) => unknown);\n};\nexport type EventConstraint = {\n type: NamespacedName;\n payload: unknown[];\n};\n\n/*\n Extract action types from a Messenger type.\n \n @template Subject - The messenger type to extract from.\n /\nexport type MessengerActions<\n Subject extends Messenger<string, ActionConstraint, EventConstraint>,\n> =\n Subject extends Messenger<string, infer Action, EventConstraint>\n ? Action\n : never;\n\n/\n Extract event types from a Messenger type.\n \n @template Subject - The messenger type to extract from.\n /\nexport type MessengerEvents<\n Subject extends Messenger<string, ActionConstraint, EventConstraint>,\n> =\n Subject extends Messenger<string, ActionConstraint, infer Event>\n ? Event\n : never;\n\n/\n Messenger namespace checks can be disabled by using this as the `namespace` constructor\n * parameter, and using `MockAnyNamespace` as the Namespace type parameter.\n \n This is useful for mocking a variety of different actions/events in unit tests. Please do not\n * use this in production code.\n /\nexport const MOCK_ANY_NAMESPACE = 'MOCK_ANY_NAMESPACE';\n\n/\n A type representing any namespace.\n \n This is useful for mocking a variety of different actions/events in unit tests. Please do not\n * use this in production code.\n /\nexport type MockAnyNamespace = string;\n\n/\n Metadata for a single event subscription.\n \n @template Event - The event this subscription is for.\n /\ntype SubscriptionMetadata<Event extends EventConstraint> = {\n /\n Whether this subscription is for a delegated messenger. Delegation subscriptions are ignored\n * when clearing subscriptions.\n /\n delegation: boolean;\n /\n The optional selector function for this subscription.\n /\n selector?: SelectorFunction<Event, Event['type']>;\n};\n\n/\n A map of event handlers for a specific event.\n \n The key is the handler function, and the value contains additional subscription metadata.\n \n @template Event - The event these handlers are for.\n /\ntype EventSubscriptionMap<Event extends EventConstraint> = Map<\n GenericEventHandler \| SelectorEventHandler,\n SubscriptionMetadata<Event>\n>;\n\n/\n A namespaced string\n \n This type verifies that the string Name is prefixed by the string Name followed by a colon.\n \n @template Namespace - The namespace we're checking for.\n * @template Name - The full string, including the namespace.\n /\nexport type NamespacedBy<\n Namespace extends string,\n Name extends string,\n> = Name extends `${Namespace}:${string}` ? Name : never;\n\nexport type NotNamespacedBy<\n Namespace extends string,\n Name extends string,\n> = Name extends `${Namespace}:${string}` ? never : Name;\n\nexport type NamespacedName<Namespace extends string = string> =\n `${Namespace}:${string}`;\n\n/\n A messenger that actions and/or events can be delegated to.\n \n This is a minimal type interface to avoid complex incompatibilities resulting from generics over\n * invariant types.\n /\ntype DelegatedMessenger = Pick<\n // The type is broadened to all actions/events because some messenger methods are contravariant\n // over this type (`registerDelegatedActionHandler` and `publishDelegated` for example). If this\n // type is narrowed to just the delegated actions/events, the types for event payload and action\n // parameters would not be wide enough.\n Messenger<string, ActionConstraint, EventConstraint>,\n \| '_internalPublishDelegated'\n \| '_internalRegisterDelegatedActionHandler'\n \| '_internalRegisterDelegatedInitialEventPayload'\n \| '_internalUnregisterDelegatedActionHandler'\n \| 'captureException'\n>;\n\ntype StripNamespace<Namespaced extends NamespacedName> =\n Namespaced extends `${string}:${infer Name}` ? Name : never;\n\n/\n A message broker for \"actions\" and \"events\".\n \n The messenger allows registering functions as 'actions' that can be called elsewhere,\n * and it allows publishing and subscribing to events. Both actions and events are identified by\n * unique strings prefixed by a namespace (which is delimited by a colon, e.g.\n * `Namespace:actionName`).\n \n @template Action - A type union of all Action types.\n * @template Event - A type union of all Event types.\n * @template Namespace - The namespace for the messenger.\n /\nexport class Messenger<\n Namespace extends string,\n Action extends ActionConstraint = never,\n Event extends EventConstraint = never,\n Parent extends Messenger<\n string,\n ActionConstraint,\n EventConstraint,\n // Use `any` to avoid preventing a parent from having a parent. `any` is harmless in a type\n // constraint anyway, it's the one totally safe place to use it.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n any\n > = never,\n> {\n readonly #namespace: Namespace;\n\n /\n The parent messenger. All actions/events under this namespace are automatically delegated to\n * the parent messenger.\n /\n readonly #parent?: DelegatedMessenger;\n\n readonly #actions = new Map<Action['type'], Action['handler']>();\n\n readonly #events = new Map<Event['type'], EventSubscriptionMap<Event>>();\n\n /\n The set of messengers we've delegated events to and their event handlers, by event type.\n /\n readonly #subscriptionDelegationTargets = new Map<\n Event['type'],\n Map<DelegatedMessenger, ExtractEventHandler<Event, Event['type']>>\n >();\n\n /\n The set of messengers we've delegated actions to, by action type.\n /\n readonly #actionDelegationTargets = new Map<\n Action['type'],\n Set<DelegatedMessenger>\n >();\n\n /\n A map of functions for getting the initial event payload.\n \n Used only for events that represent state changes.\n /\n readonly #initialEventPayloadGetters = new Map<\n Event['type'],\n () => ExtractEventPayload<Event, Event['type']>\n >();\n\n /\n A cache of selector return values for their respective handlers.\n /\n readonly #eventPayloadCache = new Map<\n GenericEventHandler,\n unknown \| undefined\n >();\n\n /\n Reports an error to an error monitoring service.\n \n @param error - The error to report.\n /\n readonly captureException?: (error: Error) => void;\n\n /\n Construct a messenger.\n \n If a parent messenger is given, all actions and events under this messenger's namespace will\n * be delegated to the parent automatically.\n \n @param args - Constructor arguments\n * @param args.captureException - Reports an error to an error monitoring service.\n * @param args.namespace - The messenger namespace.\n * @param args.parent - The parent messenger.\n /\n constructor({\n captureException,\n namespace,\n parent,\n }: {\n captureException?: (error: Error) => void;\n namespace: Namespace;\n parent?: Action['type'] extends MessengerActions<Parent>['type']\n ? Event['type'] extends MessengerEvents<Parent>['type']\n ? Parent\n : never\n : never;\n }) {\n this.#namespace = namespace;\n this.#parent = parent;\n this.captureException = captureException ?? this.#parent?.captureException;\n }\n\n /\n Register an action handler.\n \n This will make the registered function available to call via the `call` method.\n \n The action being registered must be under the same namespace as the messenger.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @param handler - The action handler. This function gets called when the `call` method is\n * invoked with the given action type.\n * @throws Will throw when a handler has been registered for this action type already.\n * @template ActionType - A type union of Action type strings under this messenger's namespace.\n /\n registerActionHandler<\n ActionType extends Action['type'] & NamespacedName<Namespace>,\n >(actionType: ActionType, handler: ActionHandler<Action, ActionType>): void {\n if (!this.#isInCurrentNamespace(actionType)) {\n throw new Error(\n `Only allowed registering action handlers prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n this.#registerActionHandler(actionType, handler);\n if (this.#parent) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // action, but this is OK because it's validated in the constructor.\n this.delegate({ actions: [actionType], messenger: this.#parent });\n }\n }\n\n #registerActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n handler: ActionHandler<ActionConstraint, ActionType>,\n ): void {\n if (this.#actions.has(actionType)) {\n throw new Error(\n `A handler for ${actionType} has already been registered`,\n );\n }\n this.#actions.set(actionType, handler);\n }\n\n /\n Registers action handlers for a list of methods on a messenger client\n \n @param messengerClient - The object that is expected to make use of the messenger.\n * @param methodNames - The names of the methods on the messenger client to register as action\n * handlers.\n * @template MessengerClient - The type expected to make use of the messenger.\n * @template MethodNames - The type union of method names to register as action handlers.\n /\n registerMethodActionHandlers<\n MessengerClient extends { name: Namespace },\n MethodNames extends keyof MessengerClient & StripNamespace<Action['type']>,\n >(\n messengerClient: MessengerClient,\n methodNames: readonly MethodNames[],\n ): void {\n for (const methodName of methodNames) {\n const method = messengerClient[methodName];\n if (typeof method === 'function') {\n const actionType = `${messengerClient.name}:${methodName}` as const;\n this.registerActionHandler(actionType, method.bind(messengerClient));\n }\n }\n }\n\n /\n Unregister an action handler.\n \n This will prevent this action from being called.\n \n The action being unregistered must be under the same namespace as the messenger.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @template ActionType - A type union of Action type strings under this messenger's namespace.\n /\n unregisterActionHandler<\n ActionType extends Action['type'] & NamespacedName<Namespace>,\n >(actionType: ActionType): void {\n if (!this.#isInCurrentNamespace(actionType)) {\n throw new Error(\n `Only allowed unregistering action handlers prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n this.#unregisterActionHandler(actionType);\n }\n\n #unregisterActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n ): void {\n this.#actions.delete(actionType);\n }\n\n /\n Unregister all action handlers.\n \n This prevents all actions from being called.\n /\n clearActions(): void {\n for (const actionType of this.#actions.keys()) {\n this.#unregisterActionHandler(actionType);\n }\n }\n\n /\n Call an action.\n \n This function will call the action handler corresponding to the given action type, passing\n * along any parameters given.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @param params - The action parameters. These must match the type of the parameters of the\n * registered action handler.\n * @throws Will throw when no handler has been registered for the given type.\n * @template ActionType - A type union of Action type strings.\n * @returns The action return value.\n /\n call<ActionType extends Action['type']>(\n actionType: ActionType,\n ...params: ExtractActionParameters<Action, ActionType>\n ): ExtractActionResponse<Action, ActionType> {\n const handler = this.#actions.get(actionType) as ActionHandler<\n Action,\n ActionType\n >;\n if (!handler) {\n throw new Error(\n this.#isInCurrentNamespace(actionType)\n ? `A handler for ${actionType} has not been registered`\n : `A handler for ${actionType} has not been delegated to ${this.#namespace}`,\n );\n }\n return handler(...params);\n }\n\n /\n Register a function for getting the initial payload for an event.\n \n This is used for events that represent a state change, where the payload is the state.\n * Registering a function for getting the payload allows event selectors to have a point of\n * comparison the first time state changes.\n \n The event type must be under the same namespace as the messenger.\n \n @param args - The arguments to this function\n * @param args.eventType - The event type to register a payload for.\n * @param args.getPayload - A function for retrieving the event payload.\n * @template EventType - A type union of Event type strings under this messenger's namespace.\n /\n registerInitialEventPayload<\n EventType extends Event['type'] & NamespacedName<Namespace>,\n >({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n if (!this.#isInCurrentNamespace(eventType)) {\n throw new Error(\n `Only allowed registering initial payloads for events prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n if (\n this.#parent &&\n !this.#subscriptionDelegationTargets.get(eventType)?.has(this.#parent)\n ) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // event, but this is OK because it's validated in the constructor.\n this.delegate({ events: [eventType], messenger: this.#parent });\n }\n this.#registerInitialEventPayload({ eventType, getPayload });\n }\n\n #registerInitialEventPayload<EventType extends Event['type']>({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n this.#initialEventPayloadGetters.set(eventType, getPayload);\n const delegationTargets =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegationTargets) {\n return;\n }\n for (const messenger of delegationTargets.keys()) {\n messenger._internalRegisterDelegatedInitialEventPayload({\n eventType,\n getPayload,\n });\n }\n }\n\n /\n Publish an event.\n \n Publishes the given payload to all subscribers of the given event type.\n \n Note that this method should never throw directly. Any errors from\n * subscribers are captured and re-thrown in a timeout handler.\n \n The event being published must be under the same namespace as the messenger.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param payload - The event payload. The type of the parameters for each event handler must\n * match the type of this payload.\n * @template EventType - A type union of Event type strings under this messenger's namespace.\n /\n publish<EventType extends Event['type'] & NamespacedName<Namespace>>(\n eventType: EventType & NamespacedName<Namespace>,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n if (!this.#isInCurrentNamespace(eventType)) {\n throw new Error(\n `Only allowed publishing events prefixed by '${this.#namespace}:'`,\n );\n }\n if (\n this.#parent &&\n !this.#subscriptionDelegationTargets.get(eventType)?.has(this.#parent)\n ) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // event, but this is OK because it's validated in the constructor.\n this.delegate({ events: [eventType], messenger: this.#parent });\n }\n this.#publish(eventType, ...payload);\n }\n\n #publish<EventType extends Event['type']>(\n eventType: EventType,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n const subscribers = this.#events.get(eventType);\n\n if (subscribers) {\n for (const [handler, { selector }] of subscribers.entries()) {\n try {\n if (selector) {\n const previousValue = this.#eventPayloadCache.get(handler);\n const newValue = selector(...payload);\n\n if (newValue !== previousValue) {\n this.#eventPayloadCache.set(handler, newValue);\n handler(newValue, previousValue);\n }\n } else {\n (handler as GenericEventHandler)(...payload);\n }\n } catch (error) {\n // Capture error without interrupting the event publishing.\n if (this.captureException) {\n this.captureException(\n error instanceof Error ? error : new Error(String(error)),\n );\n } else {\n console.error(error);\n }\n }\n }\n }\n }\n\n /\n Subscribe to an event.\n \n Registers the given function as an event handler for the given event type.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event handler must\n * match the type of the payload for this event type.\n * @template EventType - A type union of Event type strings.\n /\n subscribe<EventType extends Event['type']>(\n eventType: EventType,\n handler: ExtractEventHandler<Event, EventType>,\n ): void;\n\n /\n Subscribe to an event, with a selector.\n \n Registers the given handler function as an event handler for the given\n * event type. When an event is published, its payload is first passed to the\n * selector. The event handler is only called if the selector's return value\n * differs from its last known return value.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event\n * handler must match the return type of the selector.\n * @param selector - The selector function used to select relevant data from\n * the event payload. The type of the parameters for this selector must match\n * the type of the payload for this event type.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n /\n subscribe<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler: SelectorEventHandler<SelectorReturnValue>,\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>,\n ): void;\n\n subscribe<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n selector?: SelectorFunction<Event, EventType, SelectorReturnValue>,\n ): void {\n // Widen type of event handler by dropping ReturnType parameter.\n //\n // We need to drop it here because it's used as the parameter to the event handler, and\n // functions in general are contravariant over the parameter type. This means the type is no\n // longer valid once it's added to a broader type union with other handlers (because as far\n // as TypeScript knows, we might call the handler with output from a different selector).\n //\n // This cast means the type system is not guaranteeing the handler is called with the matching\n // input selector return value. The parameter types do ensure they match when `subscribe` is\n // called, but past that point we need to make sure of that with manual review and tests\n // instead.\n const widenedHandler = handler as\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler;\n this.#subscribe(eventType, widenedHandler, { delegation: false, selector });\n\n if (selector) {\n const getPayload = this.#initialEventPayloadGetters.get(eventType);\n if (getPayload) {\n const initialValue = selector(...getPayload());\n this.#eventPayloadCache.set(widenedHandler, initialValue);\n }\n }\n }\n\n /\n Subscribe to an event.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event handler must\n * match the type of the payload for this event type.\n * @param metadata - Event metadata.\n * @template SubscribedEvent - The event being subscribed to.\n * @template SelectorReturnValue - The selector return value.\n /\n #subscribe<SubscribedEvent extends EventConstraint>(\n eventType: SubscribedEvent['type'],\n handler:\n \| ExtractEventHandler<SubscribedEvent, SubscribedEvent['type']>\n \| SelectorEventHandler,\n metadata: SubscriptionMetadata<SubscribedEvent>,\n ): void {\n let subscribers = this.#events.get(eventType);\n if (!subscribers) {\n subscribers = new Map();\n this.#events.set(eventType, subscribers);\n }\n subscribers.set(handler, metadata);\n }\n\n /\n Unsubscribe from an event.\n \n Unregisters the given function as an event handler for the given event.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler to unregister.\n * @throws Will throw when the given event handler is not registered for this event.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n /\n unsubscribe<EventType extends Event['type'], SelectorReturnValue = unknown>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n ): void {\n const subscribers = this.#events.get(eventType);\n\n // Widen type of event handler by dropping ReturnType parameter.\n //\n // We need to drop it here because it's used as the parameter to the event handler, and\n // functions in general are contravariant over the parameter type. This means the type is no\n // longer valid once it's added to a broader type union with other handlers (because as far\n // as TypeScript knows, we might call the handler with output from a different selector).\n //\n // This poses no risk in this case, since we never call the handler past this point.\n const widenedHandler = handler as\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler;\n if (!subscribers) {\n throw new Error(`Subscription not found for event: ${eventType}`);\n }\n const metadata = subscribers.get(widenedHandler);\n if (!metadata) {\n throw new Error(`Subscription not found for event: ${eventType}`);\n }\n if (metadata.selector) {\n this.#eventPayloadCache.delete(widenedHandler);\n }\n\n subscribers.delete(widenedHandler);\n }\n\n /\n Clear subscriptions for a specific event.\n \n This will remove all subscribed handlers for this event registered from this messenger. The\n * event may still have subscribers if it has been delegated to another messenger.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @template EventType - A type union of Event type strings.\n /\n clearEventSubscriptions<EventType extends Event['type']>(\n eventType: EventType,\n ): void {\n const subscriptions = this.#events.get(eventType);\n if (!subscriptions) {\n return;\n }\n\n for (const [handler, metadata] of subscriptions.entries()) {\n if (metadata.delegation) {\n continue;\n }\n subscriptions.delete(handler);\n }\n\n if (subscriptions.size === 0) {\n this.#events.delete(eventType);\n }\n }\n\n /\n Clear all subscriptions.\n \n This will remove all subscribed handlers for all events registered from this messenger. Events\n * may still have subscribers if they are delegated to another messenger.\n /\n clearSubscriptions(): void {\n for (const eventType of this.#events.keys()) {\n this.clearEventSubscriptions(eventType);\n }\n }\n\n /\n Delegate actions and/or events to another messenger.\n \n The messenger these actions/events are delegated to will be able to call these actions and\n * subscribe to these events.\n \n Note that the messenger these actions/events are delegated to must still have these\n * actions/events included in its type definition (as part of the Action and Event type\n * parameters). Actions and events are statically type checked, they cannot be delegated\n * dynamically at runtime.\n \n @param args - Arguments.\n * @param args.actions - The action types to delegate.\n * @param args.events - The event types to delegate.\n * @param args.messenger - The messenger to delegate to.\n * @template Delegatee - The messenger the actions/events are delegated to.\n * @template DelegatedActions - An array of delegated action types.\n * @template DelegatedEvents - An array of delegated event types.\n /\n delegate<\n Delegatee extends Messenger<string, ActionConstraint, EventConstraint>,\n DelegatedActions extends (MessengerActions<Delegatee> & Action)['type'][],\n DelegatedEvents extends (MessengerEvents<Delegatee> & Event)['type'][],\n >({\n actions,\n events,\n messenger,\n }: {\n actions?: DelegatedActions;\n events?: DelegatedEvents;\n messenger: Delegatee;\n }): void {\n for (const actionType of actions ?? []) {\n const delegatedActionHandler = (\n ...args: ExtractActionParameters<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n >\n ): ExtractActionResponse<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n > => {\n // Cast to get more specific type, for this specific action\n // The types get collapsed by `this.#actions`\n const actionHandler = this.#actions.get(actionType) as\n \| ActionHandler<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n >\n \| undefined;\n if (!actionHandler) {\n throw new Error(\n `A handler for ${actionType} has not been registered`,\n );\n }\n return actionHandler(...args);\n };\n let delegationTargets = this.#actionDelegationTargets.get(actionType);\n if (!delegationTargets) {\n delegationTargets = new Set<DelegatedMessenger>();\n this.#actionDelegationTargets.set(actionType, delegationTargets);\n }\n if (delegationTargets.has(messenger)) {\n throw new Error(\n `The action '${actionType}' has already been delegated to this messenger`,\n );\n }\n delegationTargets.add(messenger);\n\n messenger._internalRegisterDelegatedActionHandler(\n actionType,\n delegatedActionHandler,\n );\n }\n for (const eventType of events ?? []) {\n const untypedSubscriber = (\n ...payload: ExtractEventPayload<\n MessengerEvents<Delegatee> & Event,\n typeof eventType\n >\n ): void => {\n messenger._internalPublishDelegated(eventType, ...payload);\n };\n // Cast to get more specific subscriber type for this specific event.\n // The types get collapsed here to the type union of all delegated\n // events, rather than the single subscriber type corresponding to this\n // event.\n const subscriber = untypedSubscriber as ExtractEventHandler<\n MessengerEvents<Delegatee> & Event,\n typeof eventType\n >;\n let delegatedEventSubscriptions =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegatedEventSubscriptions) {\n delegatedEventSubscriptions = new Map();\n this.#subscriptionDelegationTargets.set(\n eventType,\n delegatedEventSubscriptions,\n );\n }\n if (delegatedEventSubscriptions.has(messenger)) {\n throw new Error(\n `The event '${eventType}' has already been delegated to this messenger`,\n );\n }\n delegatedEventSubscriptions.set(messenger, subscriber);\n const getPayload = this.#initialEventPayloadGetters.get(eventType);\n if (getPayload) {\n messenger._internalRegisterDelegatedInitialEventPayload({\n eventType,\n getPayload,\n });\n }\n\n this.#subscribe(eventType, subscriber, { delegation: true });\n }\n }\n\n /\n Revoke delegated actions and/or events from another messenger.\n \n The messenger these actions/events are delegated to will no longer be able to call these\n * actions or subscribe to these events.\n \n @param args - Arguments.\n * @param args.actions - The action types to revoke.\n * @param args.events - The event types to revoke.\n * @param args.messenger - The messenger these actions/events were delegated to.\n * @template Delegatee - The messenger the actions/events are being revoked from.\n * @template DelegatedActions - An array of delegated action types.\n * @template DelegatedEvents - An array of delegated event types.\n /\n revoke<\n Delegatee extends Messenger<string, ActionConstraint, EventConstraint>,\n DelegatedActions extends (MessengerActions<Delegatee> & Action)['type'][],\n DelegatedEvents extends (MessengerEvents<Delegatee> & Event)['type'][],\n >({\n actions,\n events,\n messenger,\n }: {\n actions?: DelegatedActions;\n events?: DelegatedEvents;\n messenger: Delegatee;\n }): void {\n if (messenger === this.#parent) {\n throw new Error('Cannot revoke from parent');\n }\n for (const actionType of actions ?? []) {\n const delegationTargets = this.#actionDelegationTargets.get(actionType);\n if (!delegationTargets?.has(messenger)) {\n // Nothing to revoke\n continue;\n }\n messenger._internalUnregisterDelegatedActionHandler(actionType);\n delegationTargets.delete(messenger);\n if (delegationTargets.size === 0) {\n this.#actionDelegationTargets.delete(actionType);\n }\n }\n for (const eventType of events ?? []) {\n const delegationTargets =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegationTargets) {\n // Nothing to revoke\n continue;\n }\n const delegatedSubscriber = delegationTargets.get(messenger);\n if (!delegatedSubscriber) {\n // Nothing to revoke\n continue;\n }\n this.unsubscribe(eventType, delegatedSubscriber);\n delegationTargets.delete(messenger);\n if (delegationTargets.size === 0) {\n this.#subscriptionDelegationTargets.delete(eventType);\n }\n }\n }\n\n /\n Register an action handler for an action delegated from another messenger.\n \n This will make the registered function available to call via the `call` method.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param actionType - The action type. This is a unique identifier for this action.\n * @param handler - The action handler. This function gets called when the `call` method is\n * invoked with the given action type.\n * @throws Will throw when a handler has been registered for this action type already.\n * @template ActionType - A type union of Action type strings.\n /\n _internalRegisterDelegatedActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n // Using wider `ActionConstraint` type here rather than `Action` because the `Action` type is\n // contravariant over the handler parameter type. Using `Action` would lead to a type error\n // here because the messenger we've delegated to supports _additional_ actions.\n handler: ActionHandler<ActionConstraint, ActionType>,\n ): void {\n this.#registerActionHandler(actionType, handler);\n }\n\n /\n Unregister an action handler for an action delegated from another messenger.\n \n This will prevent this action from being called.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param actionType - The action type. This is a unqiue identifier for this action.\n * @template ActionType - A type union of Action type strings.\n /\n _internalUnregisterDelegatedActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n ): void {\n this.#unregisterActionHandler(actionType);\n }\n\n /\n Register a function for getting the initial payload for an event that has been delegated from\n * another messenger.\n \n This is used for events that represent a state change, where the payload is the state.\n * Registering a function for getting the payload allows event selectors to have a point of\n * comparison the first time state changes.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param args - The arguments to this function\n * @param args.eventType - The event type to register a payload for.\n * @param args.getPayload - A function for retrieving the event payload.\n /\n _internalRegisterDelegatedInitialEventPayload<\n EventType extends Event['type'],\n >({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n this.#registerInitialEventPayload({ eventType, getPayload });\n }\n\n /\n Publish an event that was delegated from another messenger.\n \n Publishes the given payload to all subscribers of the given event type.\n \n Note that this method should never throw directly. Any errors from\n * subscribers are captured and re-thrown in a timeout handler.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param eventType - The event type. This is a unique identifier for this event.\n * @param payload - The event payload. The type of the parameters for each event handler must\n * match the type of this payload.\n * @template EventType - A type union of Event type strings.\n /\n _internalPublishDelegated<EventType extends Event['type']>(\n eventType: EventType,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n this.#publish(eventType, ...payload);\n }\n\n /\n Determine whether the given name is within the current namespace.\n \n If the current namespace is MOCK_ANY_NAMESPACE, this check always returns true.\n \n @param name - The name to check\n * @returns Whether the name is within the current namespace\n */\n #isInCurrentNamespace(name: string): name is NamespacedName<Namespace> {\n return (\n this.#namespace === MOCK_ANY_NAMESPACE \|\|\n name.startsWith(`${this.#namespace}:`)\n );\n }\n}\n"]}
1	+ {"version":3,"file":"Messenger.cjs","sourceRoot":"","sources":["../src/Messenger.ts"],"names":[],"mappings":"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","sourcesContent":["export type ActionHandler<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = (\n ...args: ExtractActionParameters<Action, ActionType>\n) => ExtractActionResponse<Action, ActionType>;\n\nexport type ExtractActionParameters<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = Action extends {\n type: ActionType;\n handler: (...args: infer HandlerArgs) => unknown;\n}\n ? HandlerArgs\n : never;\n\nexport type ExtractActionResponse<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = Action extends {\n type: ActionType;\n handler: (...args: infer _) => infer HandlerReturnValue;\n}\n ? HandlerReturnValue\n : never;\n\nexport type ExtractEventHandler<\n Event extends EventConstraint,\n EventType = Event['type'],\n> = Event extends {\n type: EventType;\n payload: infer Payload;\n}\n ? Payload extends unknown[]\n ? (...payload: Payload) => void\n : never\n : never;\n\nexport type ExtractEventPayload<\n Event extends EventConstraint,\n EventType = Event['type'],\n> = Event extends {\n type: EventType;\n payload: infer Payload;\n}\n ? Payload extends unknown[]\n ? Payload\n : never\n : never;\n\nexport type GenericEventHandler = (...args: unknown[]) => void;\n\nexport type SelectorFunction<\n Event extends EventConstraint,\n EventType extends Event['type'],\n ReturnValue = unknown,\n> = (...args: ExtractEventPayload<Event, EventType>) => ReturnValue;\nexport type SelectorEventHandler<SelectorReturnValue = unknown> = (\n newValue: SelectorReturnValue,\n previousValue: SelectorReturnValue \| undefined,\n) => void;\n\nexport type ActionConstraint = {\n type: NamespacedName;\n handler: ((...args: never) => unknown) \| ((...args: never[]) => unknown);\n};\nexport type EventConstraint = {\n type: NamespacedName;\n payload: unknown[];\n};\n\n/*\n Extract action types from a Messenger type.\n \n @template Subject - The messenger type to extract from.\n /\nexport type MessengerActions<\n Subject extends Messenger<string, ActionConstraint, EventConstraint>,\n> =\n Subject extends Messenger<string, infer Action, EventConstraint>\n ? Action\n : never;\n\n/\n Extract event types from a Messenger type.\n \n @template Subject - The messenger type to extract from.\n /\nexport type MessengerEvents<\n Subject extends Messenger<string, ActionConstraint, EventConstraint>,\n> =\n Subject extends Messenger<string, ActionConstraint, infer Event>\n ? Event\n : never;\n\n/\n Messenger namespace checks can be disabled by using this as the `namespace` constructor\n * parameter, and using `MockAnyNamespace` as the Namespace type parameter.\n \n This is useful for mocking a variety of different actions/events in unit tests. Please do not\n * use this in production code.\n /\nexport const MOCK_ANY_NAMESPACE = 'MOCK_ANY_NAMESPACE';\n\n/\n A type representing any namespace.\n \n This is useful for mocking a variety of different actions/events in unit tests. Please do not\n * use this in production code.\n /\nexport type MockAnyNamespace = string;\n\n/\n Metadata for a single event subscription.\n \n @template Event - The event this subscription is for.\n /\ntype SubscriptionMetadata<Event extends EventConstraint> = {\n /\n Whether this subscription is for a delegated messenger. Delegation subscriptions are ignored\n * when clearing subscriptions.\n /\n delegation: boolean;\n /\n The optional selector function for this subscription.\n /\n selector?: SelectorFunction<Event, Event['type']>;\n};\n\n/\n A map of event handlers for a specific event.\n \n The key is the handler function, and the value contains additional subscription metadata.\n \n @template Event - The event these handlers are for.\n /\ntype EventSubscriptionMap<Event extends EventConstraint> = Map<\n GenericEventHandler \| SelectorEventHandler,\n SubscriptionMetadata<Event>\n>;\n\n/\n A namespaced string\n \n This type verifies that the string Name is prefixed by the string Name followed by a colon.\n \n @template Namespace - The namespace we're checking for.\n * @template Name - The full string, including the namespace.\n /\nexport type NamespacedBy<\n Namespace extends string,\n Name extends string,\n> = Name extends `${Namespace}:${string}` ? Name : never;\n\nexport type NotNamespacedBy<\n Namespace extends string,\n Name extends string,\n> = Name extends `${Namespace}:${string}` ? never : Name;\n\nexport type NamespacedName<Namespace extends string = string> =\n `${Namespace}:${string}`;\n\n/\n A messenger that actions and/or events can be delegated to.\n \n This is a minimal type interface to avoid complex incompatibilities resulting from generics over\n * invariant types.\n /\ntype DelegatedMessenger = Pick<\n // The type is broadened to all actions/events because some messenger methods are contravariant\n // over this type (`registerDelegatedActionHandler` and `publishDelegated` for example). If this\n // type is narrowed to just the delegated actions/events, the types for event payload and action\n // parameters would not be wide enough.\n Messenger<string, ActionConstraint, EventConstraint>,\n \| '_internalPublishDelegated'\n \| '_internalRegisterDelegatedActionHandler'\n \| '_internalRegisterDelegatedInitialEventPayload'\n \| '_internalUnregisterDelegatedActionHandler'\n \| 'captureException'\n>;\n\ntype StripNamespace<Namespaced extends NamespacedName> =\n Namespaced extends `${string}:${infer Name}` ? Name : never;\n\n/\n A message broker for \"actions\" and \"events\".\n \n The messenger allows registering functions as 'actions' that can be called elsewhere,\n * and it allows publishing and subscribing to events. Both actions and events are identified by\n * unique strings prefixed by a namespace (which is delimited by a colon, e.g.\n * `Namespace:actionName`).\n \n @template Action - A type union of all Action types.\n * @template Event - A type union of all Event types.\n * @template Namespace - The namespace for the messenger.\n /\nexport class Messenger<\n Namespace extends string,\n Action extends ActionConstraint = never,\n Event extends EventConstraint = never,\n Parent extends Messenger<\n string,\n ActionConstraint,\n EventConstraint,\n // Use `any` to avoid preventing a parent from having a parent. `any` is harmless in a type\n // constraint anyway, it's the one totally safe place to use it.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n any\n > = never,\n> {\n readonly #namespace: Namespace;\n\n /\n The parent messenger. All actions/events under this namespace are automatically delegated to\n * the parent messenger.\n /\n readonly #parent?: DelegatedMessenger;\n\n readonly #actions = new Map<Action['type'], Action['handler']>();\n\n readonly #events = new Map<Event['type'], EventSubscriptionMap<Event>>();\n\n /\n The set of messengers we've delegated events to and their event handlers, by event type.\n /\n readonly #subscriptionDelegationTargets = new Map<\n Event['type'],\n Map<DelegatedMessenger, ExtractEventHandler<Event, Event['type']>>\n >();\n\n /\n The set of messengers we've delegated actions to, by action type.\n /\n readonly #actionDelegationTargets = new Map<\n Action['type'],\n Set<DelegatedMessenger>\n >();\n\n /\n A map of functions for getting the initial event payload.\n \n Used only for events that represent state changes.\n /\n readonly #initialEventPayloadGetters = new Map<\n Event['type'],\n () => ExtractEventPayload<Event, Event['type']>\n >();\n\n /\n A cache of selector return values for their respective handlers.\n /\n readonly #eventPayloadCache = new Map<\n GenericEventHandler,\n unknown \| undefined\n >();\n\n /\n Reports an error to an error monitoring service.\n \n @param error - The error to report.\n /\n readonly captureException?: (error: Error) => void;\n\n /\n Construct a messenger.\n \n If a parent messenger is given, all actions and events under this messenger's namespace will\n * be delegated to the parent automatically.\n \n @param args - Constructor arguments\n * @param args.captureException - Reports an error to an error monitoring service.\n * @param args.namespace - The messenger namespace.\n * @param args.parent - The parent messenger.\n /\n constructor({\n captureException,\n namespace,\n parent,\n }: {\n captureException?: (error: Error) => void;\n namespace: Namespace;\n parent?: Action['type'] extends MessengerActions<Parent>['type']\n ? Event['type'] extends MessengerEvents<Parent>['type']\n ? Parent\n : never\n : never;\n }) {\n this.#namespace = namespace;\n this.#parent = parent;\n this.captureException = captureException ?? this.#parent?.captureException;\n }\n\n /\n Register an action handler.\n \n This will make the registered function available to call via the `call` method.\n \n The action being registered must be under the same namespace as the messenger.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @param handler - The action handler. This function gets called when the `call` method is\n * invoked with the given action type.\n * @throws Will throw when a handler has been registered for this action type already.\n * @template ActionType - A type union of Action type strings under this messenger's namespace.\n /\n registerActionHandler<\n ActionType extends Action['type'] & NamespacedName<Namespace>,\n >(actionType: ActionType, handler: ActionHandler<Action, ActionType>): void {\n if (!this.#isInCurrentNamespace(actionType)) {\n throw new Error(\n `Only allowed registering action handlers prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n this.#registerActionHandler(actionType, handler);\n if (this.#parent) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // action, but this is OK because it's validated in the constructor.\n this.delegate({ actions: [actionType], messenger: this.#parent });\n }\n }\n\n #registerActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n handler: ActionHandler<ActionConstraint, ActionType>,\n ): void {\n if (this.#actions.has(actionType)) {\n throw new Error(\n `A handler for ${actionType} has already been registered`,\n );\n }\n this.#actions.set(actionType, handler);\n }\n\n /\n Registers action handlers for a list of methods on a messenger client\n \n @param messengerClient - The object that is expected to make use of the messenger.\n * @param methodNames - The names of the methods on the messenger client to register as action\n * handlers.\n * @template MessengerClient - The type expected to make use of the messenger.\n * @template MethodNames - The type union of method names to register as action handlers.\n /\n registerMethodActionHandlers<\n MessengerClient extends { name: Namespace },\n MethodNames extends keyof MessengerClient & StripNamespace<Action['type']>,\n >(\n messengerClient: MessengerClient,\n methodNames: readonly MethodNames[],\n ): void {\n for (const methodName of methodNames) {\n const method = messengerClient[methodName];\n if (typeof method === 'function') {\n const actionType = `${messengerClient.name}:${methodName}` as const;\n this.registerActionHandler(actionType, method.bind(messengerClient));\n }\n }\n }\n\n /\n Unregister an action handler.\n \n This will prevent this action from being called.\n \n The action being unregistered must be under the same namespace as the messenger.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @template ActionType - A type union of Action type strings under this messenger's namespace.\n /\n unregisterActionHandler<\n ActionType extends Action['type'] & NamespacedName<Namespace>,\n >(actionType: ActionType): void {\n if (!this.#isInCurrentNamespace(actionType)) {\n throw new Error(\n `Only allowed unregistering action handlers prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n this.#unregisterActionHandler(actionType);\n }\n\n #unregisterActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n ): void {\n this.#actions.delete(actionType);\n }\n\n /\n Unregister all action handlers.\n \n This prevents all actions from being called.\n /\n clearActions(): void {\n for (const actionType of this.#actions.keys()) {\n this.#unregisterActionHandler(actionType);\n }\n }\n\n /\n Get the action handler for a given action type.\n \n This is a protected method to allow subclasses to override the way action\n * handlers are retrieved, for example to implement custom delegation logic.\n \n @param actionType - The action type. This is a unique identifier for this\n * action.\n * @returns The action handler for the given action type, or undefined if no\n * handler has been registered.\n /\n protected getAction(\n actionType: Action['type'],\n ): ActionConstraint['handler'] \| undefined {\n return this.#actions.get(actionType);\n }\n\n /\n Call an action.\n \n This function will call the action handler corresponding to the given action type, passing\n * along any parameters given.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @param params - The action parameters. These must match the type of the parameters of the\n * registered action handler.\n * @throws Will throw when no handler has been registered for the given type.\n * @template ActionType - A type union of Action type strings.\n * @returns The action return value.\n /\n call<ActionType extends Action['type']>(\n actionType: ActionType,\n ...params: ExtractActionParameters<Action, ActionType>\n ): ExtractActionResponse<Action, ActionType> {\n const handler = this.getAction(actionType) as\n \| ActionHandler<Action, ActionType>\n \| undefined;\n\n if (!handler) {\n throw new Error(\n this.#isInCurrentNamespace(actionType)\n ? `A handler for ${actionType} has not been registered`\n : `A handler for ${actionType} has not been delegated to ${this.#namespace}`,\n );\n }\n\n return handler(...params);\n }\n\n /\n Register a function for getting the initial payload for an event.\n \n This is used for events that represent a state change, where the payload is the state.\n * Registering a function for getting the payload allows event selectors to have a point of\n * comparison the first time state changes.\n \n The event type must be under the same namespace as the messenger.\n \n @param args - The arguments to this function\n * @param args.eventType - The event type to register a payload for.\n * @param args.getPayload - A function for retrieving the event payload.\n * @template EventType - A type union of Event type strings under this messenger's namespace.\n /\n registerInitialEventPayload<\n EventType extends Event['type'] & NamespacedName<Namespace>,\n >({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n if (!this.#isInCurrentNamespace(eventType)) {\n throw new Error(\n `Only allowed registering initial payloads for events prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n if (\n this.#parent &&\n !this.#subscriptionDelegationTargets.get(eventType)?.has(this.#parent)\n ) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // event, but this is OK because it's validated in the constructor.\n this.delegate({ events: [eventType], messenger: this.#parent });\n }\n this.#registerInitialEventPayload({ eventType, getPayload });\n }\n\n #registerInitialEventPayload<EventType extends Event['type']>({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n this.#initialEventPayloadGetters.set(eventType, getPayload);\n const delegationTargets =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegationTargets) {\n return;\n }\n for (const messenger of delegationTargets.keys()) {\n messenger._internalRegisterDelegatedInitialEventPayload({\n eventType,\n getPayload,\n });\n }\n }\n\n /\n Publish an event.\n \n Publishes the given payload to all subscribers of the given event type.\n \n Note that this method should never throw directly. Any errors from\n * subscribers are captured and re-thrown in a timeout handler.\n \n The event being published must be under the same namespace as the messenger.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param payload - The event payload. The type of the parameters for each event handler must\n * match the type of this payload.\n * @template EventType - A type union of Event type strings under this messenger's namespace.\n /\n publish<EventType extends Event['type'] & NamespacedName<Namespace>>(\n eventType: EventType & NamespacedName<Namespace>,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n if (!this.#isInCurrentNamespace(eventType)) {\n throw new Error(\n `Only allowed publishing events prefixed by '${this.#namespace}:'`,\n );\n }\n if (\n this.#parent &&\n !this.#subscriptionDelegationTargets.get(eventType)?.has(this.#parent)\n ) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // event, but this is OK because it's validated in the constructor.\n this.delegate({ events: [eventType], messenger: this.#parent });\n }\n this.#publish(eventType, ...payload);\n }\n\n #publish<EventType extends Event['type']>(\n eventType: EventType,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n const subscribers = this.#events.get(eventType);\n\n if (subscribers) {\n for (const [handler, { selector }] of subscribers.entries()) {\n try {\n if (selector) {\n const previousValue = this.#eventPayloadCache.get(handler);\n const newValue = selector(...payload);\n\n if (newValue !== previousValue) {\n this.#eventPayloadCache.set(handler, newValue);\n handler(newValue, previousValue);\n }\n } else {\n (handler as GenericEventHandler)(...payload);\n }\n } catch (error) {\n // Capture error without interrupting the event publishing.\n if (this.captureException) {\n this.captureException(\n error instanceof Error ? error : new Error(String(error)),\n );\n } else {\n console.error(error);\n }\n }\n }\n }\n }\n\n /\n Subscribe to an event.\n \n Registers the given function as an event handler for the given event type.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event handler must\n * match the type of the payload for this event type.\n * @template EventType - A type union of Event type strings.\n /\n subscribe<EventType extends Event['type']>(\n eventType: EventType,\n handler: ExtractEventHandler<Event, EventType>,\n ): void;\n\n /\n Subscribe to an event, with a selector.\n \n Registers the given handler function as an event handler for the given\n * event type. When an event is published, its payload is first passed to the\n * selector. The event handler is only called if the selector's return value\n * differs from its last known return value.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event\n * handler must match the return type of the selector.\n * @param selector - The selector function used to select relevant data from\n * the event payload. The type of the parameters for this selector must match\n * the type of the payload for this event type.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n /\n subscribe<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler: SelectorEventHandler<SelectorReturnValue>,\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>,\n ): void;\n\n subscribe<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n selector?: SelectorFunction<Event, EventType, SelectorReturnValue>,\n ): void {\n // Widen type of event handler by dropping ReturnType parameter.\n //\n // We need to drop it here because it's used as the parameter to the event handler, and\n // functions in general are contravariant over the parameter type. This means the type is no\n // longer valid once it's added to a broader type union with other handlers (because as far\n // as TypeScript knows, we might call the handler with output from a different selector).\n //\n // This cast means the type system is not guaranteeing the handler is called with the matching\n // input selector return value. The parameter types do ensure they match when `subscribe` is\n // called, but past that point we need to make sure of that with manual review and tests\n // instead.\n const widenedHandler = handler as\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler;\n this.#subscribe(eventType, widenedHandler, { delegation: false, selector });\n\n if (selector) {\n const getPayload = this.#initialEventPayloadGetters.get(eventType);\n if (getPayload) {\n const initialValue = selector(...getPayload());\n this.#eventPayloadCache.set(widenedHandler, initialValue);\n }\n }\n }\n\n /\n Subscribe to an event.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event handler must\n * match the type of the payload for this event type.\n * @param metadata - Event metadata.\n * @template SubscribedEvent - The event being subscribed to.\n * @template SelectorReturnValue - The selector return value.\n /\n #subscribe<SubscribedEvent extends EventConstraint>(\n eventType: SubscribedEvent['type'],\n handler:\n \| ExtractEventHandler<SubscribedEvent, SubscribedEvent['type']>\n \| SelectorEventHandler,\n metadata: SubscriptionMetadata<SubscribedEvent>,\n ): void {\n let subscribers = this.#events.get(eventType);\n if (!subscribers) {\n subscribers = new Map();\n this.#events.set(eventType, subscribers);\n }\n subscribers.set(handler, metadata);\n }\n\n /\n Subscribe to an event, with a selector, invoking the handler exactly once.\n \n Registers the given handler function as an event handler for the given\n * event type. When an event is published, its payload is first passed to the\n * selector. The event handler is only called if the selector's return value\n * differs from its last known return value. Additionally if the optional condition\n * function is provided, it is checked whether it returns `true`.\n * The handler is invoked at most once, after which the subscription is removed.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event\n * handler must match the return type of the selector.\n * @param options - Options bag.\n * @param options.selector - The selector function used to select relevant data\n * from the event payload. The type of the parameters for this selector must\n * match the type of the payload for this event type.\n * @param options.condition - An optional predicate evaluated against the\n * selector's return value. The handler is only invoked when this returns `true`.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n * @example\n * ```typescript\n * messenger.subscribeOnce(\n * 'TransactionController:transactionConfirmed',\n * (hash) => { ... },\n * { selector: (tx) => tx.hash, condition: (hash) => hash === 'foo' },\n * );\n * ```\n /\n subscribeOnce<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler: SelectorEventHandler<SelectorReturnValue>,\n options: {\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?: (value: SelectorReturnValue) => boolean;\n },\n ): void;\n\n /\n Subscribe to an event, invoking the handler exactly once.\n \n Registers the given function as an event handler for the given event type\n * and automatically unsubscribes after the first invocation.\n \n If `options.condition` is provided, the handler is only invoked (and the\n * subscription only removed) when the condition returns `true`.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event\n * handler must match the type of the payload for this event type.\n * @param options - Options bag.\n * @param options.condition - A predicate evaluated against the event payload.\n * The handler is only invoked when this returns `true`.\n * @template EventType - A type union of Event type strings.\n * @example\n * ```typescript\n * messenger.subscribeOnce(\n * 'TransactionController:transactionConfirmed',\n * (tx) => { ... },\n * { condition: (tx) => tx.hash === 'foo' },\n * );\n * ```\n /\n subscribeOnce<EventType extends Event['type']>(\n eventType: EventType,\n handler: ExtractEventHandler<Event, EventType>,\n options?: {\n condition?: (\n ...payload: ExtractEventPayload<Event, EventType>\n ) => boolean;\n },\n ): void;\n\n subscribeOnce<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n options?: {\n selector?: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?:\n \| ((...payload: ExtractEventPayload<Event, EventType>) => boolean)\n \| ((value: SelectorReturnValue) => boolean);\n },\n ): void {\n const { selector, condition } = options ?? {};\n // Casting to unknown to handle both the code path where a selector is defined and where it is omitted.\n const internalHandler = (...args: unknown[]): void => {\n if (\n condition &&\n !(condition as (...args: unknown[]) => boolean)(...args)\n ) {\n return;\n }\n this.unsubscribe(eventType, internalHandler);\n (handler as (...args: unknown[]) => void)(...args);\n };\n\n this.subscribe(\n eventType,\n internalHandler,\n selector as SelectorFunction<Event, EventType, SelectorReturnValue>,\n );\n }\n\n /\n Return a promise that resolves the next time the selector's return value\n * changes and, if provided, the `options.condition` predicate returns `true`.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param options - Options bag.\n * @param options.selector - The selector function used to select relevant data\n * from the event payload.\n * @param options.condition - An optional predicate evaluated against the\n * selector's return value. The promise only resolves when this returns `true`.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n * @returns A promise that resolves with the selector's return value.\n * @example\n * ```typescript\n * const [hash] = await messenger.waitUntil(\n * 'TransactionController:transactionConfirmed',\n * { selector: (tx) => tx.hash, condition: (hash) => hash === 'foo' },\n * );\n * ```\n /\n waitUntil<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n options: {\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?: (value: SelectorReturnValue) => boolean;\n },\n ): Promise<[SelectorReturnValue, SelectorReturnValue \| undefined]>;\n\n /\n Return a promise that resolves the next time the given event is published.\n \n If `options.condition` is provided, the promise only resolves when the\n * condition returns `true`.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param options - Options bag.\n * @param options.condition - A predicate evaluated against the event payload.\n * The promise only resolves when this returns `true`.\n * @template EventType - A type union of Event type strings.\n * @returns A promise that resolves with the event payload.\n * @example\n * ```typescript\n * const [transactionMeta] = await messenger.waitUntil(\n * 'TransactionController:transactionConfirmed',\n * { condition: (tx) => tx.hash === 'foo' },\n * );\n * ```\n * @example\n * ```typescript\n * await messenger.waitUntil('KeyringController:unlock');\n * ```\n /\n waitUntil<EventType extends Event['type']>(\n eventType: EventType,\n options?: {\n condition?: (\n ...payload: ExtractEventPayload<Event, EventType>\n ) => boolean;\n },\n ): Promise<ExtractEventPayload<Event, EventType>>;\n\n waitUntil<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n options?: {\n selector?: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?:\n \| ((...payload: ExtractEventPayload<Event, EventType>) => boolean)\n \| ((value: SelectorReturnValue) => boolean);\n },\n ): Promise<SelectorReturnValue \| ExtractEventPayload<Event, EventType>[0]> {\n return new Promise((resolve) => {\n this.subscribeOnce(\n eventType,\n (...args) => resolve(args),\n options as {\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?: (value: SelectorReturnValue) => boolean;\n },\n );\n });\n }\n\n /\n Unsubscribe from an event.\n \n Unregisters the given function as an event handler for the given event.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler to unregister.\n * @throws Will throw when the given event handler is not registered for this event.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n /\n unsubscribe<EventType extends Event['type'], SelectorReturnValue = unknown>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n ): void {\n const subscribers = this.#events.get(eventType);\n\n // Widen type of event handler by dropping ReturnType parameter.\n //\n // We need to drop it here because it's used as the parameter to the event handler, and\n // functions in general are contravariant over the parameter type. This means the type is no\n // longer valid once it's added to a broader type union with other handlers (because as far\n // as TypeScript knows, we might call the handler with output from a different selector).\n //\n // This poses no risk in this case, since we never call the handler past this point.\n const widenedHandler = handler as\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler;\n if (!subscribers) {\n throw new Error(`Subscription not found for event: ${eventType}`);\n }\n const metadata = subscribers.get(widenedHandler);\n if (!metadata) {\n throw new Error(`Subscription not found for event: ${eventType}`);\n }\n if (metadata.selector) {\n this.#eventPayloadCache.delete(widenedHandler);\n }\n\n subscribers.delete(widenedHandler);\n }\n\n /\n Clear subscriptions for a specific event.\n \n This will remove all subscribed handlers for this event registered from this messenger. The\n * event may still have subscribers if it has been delegated to another messenger.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @template EventType - A type union of Event type strings.\n /\n clearEventSubscriptions<EventType extends Event['type']>(\n eventType: EventType,\n ): void {\n const subscriptions = this.#events.get(eventType);\n if (!subscriptions) {\n return;\n }\n\n for (const [handler, metadata] of subscriptions.entries()) {\n if (metadata.delegation) {\n continue;\n }\n subscriptions.delete(handler);\n }\n\n if (subscriptions.size === 0) {\n this.#events.delete(eventType);\n }\n }\n\n /\n Clear all subscriptions.\n \n This will remove all subscribed handlers for all events registered from this messenger. Events\n * may still have subscribers if they are delegated to another messenger.\n /\n clearSubscriptions(): void {\n for (const eventType of this.#events.keys()) {\n this.clearEventSubscriptions(eventType);\n }\n }\n\n /\n Delegate actions and/or events to another messenger.\n \n The messenger these actions/events are delegated to will be able to call these actions and\n * subscribe to these events.\n \n Note that the messenger these actions/events are delegated to must still have these\n * actions/events included in its type definition (as part of the Action and Event type\n * parameters). Actions and events are statically type checked, they cannot be delegated\n * dynamically at runtime.\n \n @param args - Arguments.\n * @param args.actions - The action types to delegate.\n * @param args.events - The event types to delegate.\n * @param args.messenger - The messenger to delegate to.\n * @template Delegatee - The messenger the actions/events are delegated to.\n * @template DelegatedActions - An array of delegated action types.\n * @template DelegatedEvents - An array of delegated event types.\n /\n delegate<\n Delegatee extends Messenger<string, ActionConstraint, EventConstraint>,\n DelegatedActions extends (MessengerActions<Delegatee> & Action)['type'][],\n DelegatedEvents extends (MessengerEvents<Delegatee> & Event)['type'][],\n >({\n actions,\n events,\n messenger,\n }: {\n actions?: DelegatedActions;\n events?: DelegatedEvents;\n messenger: Delegatee;\n }): void {\n for (const actionType of actions ?? []) {\n const delegatedActionHandler = (\n ...args: ExtractActionParameters<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n >\n ): ExtractActionResponse<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n > => {\n // Cast to get more specific type, for this specific action\n // The types get collapsed by `this.#actions`\n const actionHandler = this.getAction(actionType) as\n \| ActionHandler<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n >\n \| undefined;\n\n if (!actionHandler) {\n throw new Error(\n `A handler for ${actionType} has not been registered`,\n );\n }\n\n return actionHandler(...args);\n };\n let delegationTargets = this.#actionDelegationTargets.get(actionType);\n if (!delegationTargets) {\n delegationTargets = new Set<DelegatedMessenger>();\n this.#actionDelegationTargets.set(actionType, delegationTargets);\n }\n if (delegationTargets.has(messenger)) {\n throw new Error(\n `The action '${actionType}' has already been delegated to this messenger`,\n );\n }\n delegationTargets.add(messenger);\n\n messenger._internalRegisterDelegatedActionHandler(\n actionType,\n delegatedActionHandler,\n );\n }\n for (const eventType of events ?? []) {\n const untypedSubscriber = (\n ...payload: ExtractEventPayload<\n MessengerEvents<Delegatee> & Event,\n typeof eventType\n >\n ): void => {\n messenger._internalPublishDelegated(eventType, ...payload);\n };\n // Cast to get more specific subscriber type for this specific event.\n // The types get collapsed here to the type union of all delegated\n // events, rather than the single subscriber type corresponding to this\n // event.\n const subscriber = untypedSubscriber as ExtractEventHandler<\n MessengerEvents<Delegatee> & Event,\n typeof eventType\n >;\n let delegatedEventSubscriptions =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegatedEventSubscriptions) {\n delegatedEventSubscriptions = new Map();\n this.#subscriptionDelegationTargets.set(\n eventType,\n delegatedEventSubscriptions,\n );\n }\n if (delegatedEventSubscriptions.has(messenger)) {\n throw new Error(\n `The event '${eventType}' has already been delegated to this messenger`,\n );\n }\n delegatedEventSubscriptions.set(messenger, subscriber);\n const getPayload = this.#initialEventPayloadGetters.get(eventType);\n if (getPayload) {\n messenger._internalRegisterDelegatedInitialEventPayload({\n eventType,\n getPayload,\n });\n }\n\n this.#subscribe(eventType, subscriber, { delegation: true });\n }\n }\n\n /\n Revoke delegated actions and/or events from another messenger.\n \n The messenger these actions/events are delegated to will no longer be able to call these\n * actions or subscribe to these events.\n \n @param args - Arguments.\n * @param args.actions - The action types to revoke.\n * @param args.events - The event types to revoke.\n * @param args.messenger - The messenger these actions/events were delegated to.\n * @template Delegatee - The messenger the actions/events are being revoked from.\n * @template DelegatedActions - An array of delegated action types.\n * @template DelegatedEvents - An array of delegated event types.\n /\n revoke<\n Delegatee extends Messenger<string, ActionConstraint, EventConstraint>,\n DelegatedActions extends (MessengerActions<Delegatee> & Action)['type'][],\n DelegatedEvents extends (MessengerEvents<Delegatee> & Event)['type'][],\n >({\n actions,\n events,\n messenger,\n }: {\n actions?: DelegatedActions;\n events?: DelegatedEvents;\n messenger: Delegatee;\n }): void {\n if (messenger === this.#parent) {\n throw new Error('Cannot revoke from parent');\n }\n for (const actionType of actions ?? []) {\n const delegationTargets = this.#actionDelegationTargets.get(actionType);\n if (!delegationTargets?.has(messenger)) {\n // Nothing to revoke\n continue;\n }\n messenger._internalUnregisterDelegatedActionHandler(actionType);\n delegationTargets.delete(messenger);\n if (delegationTargets.size === 0) {\n this.#actionDelegationTargets.delete(actionType);\n }\n }\n for (const eventType of events ?? []) {\n const delegationTargets =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegationTargets) {\n // Nothing to revoke\n continue;\n }\n const delegatedSubscriber = delegationTargets.get(messenger);\n if (!delegatedSubscriber) {\n // Nothing to revoke\n continue;\n }\n this.unsubscribe(eventType, delegatedSubscriber);\n delegationTargets.delete(messenger);\n if (delegationTargets.size === 0) {\n this.#subscriptionDelegationTargets.delete(eventType);\n }\n }\n }\n\n /\n Register an action handler for an action delegated from another messenger.\n \n This will make the registered function available to call via the `call` method.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param actionType - The action type. This is a unique identifier for this action.\n * @param handler - The action handler. This function gets called when the `call` method is\n * invoked with the given action type.\n * @throws Will throw when a handler has been registered for this action type already.\n * @template ActionType - A type union of Action type strings.\n /\n _internalRegisterDelegatedActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n // Using wider `ActionConstraint` type here rather than `Action` because the `Action` type is\n // contravariant over the handler parameter type. Using `Action` would lead to a type error\n // here because the messenger we've delegated to supports _additional_ actions.\n handler: ActionHandler<ActionConstraint, ActionType>,\n ): void {\n this.#registerActionHandler(actionType, handler);\n }\n\n /\n Unregister an action handler for an action delegated from another messenger.\n \n This will prevent this action from being called.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param actionType - The action type. This is a unqiue identifier for this action.\n * @template ActionType - A type union of Action type strings.\n /\n _internalUnregisterDelegatedActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n ): void {\n this.#unregisterActionHandler(actionType);\n }\n\n /\n Register a function for getting the initial payload for an event that has been delegated from\n * another messenger.\n \n This is used for events that represent a state change, where the payload is the state.\n * Registering a function for getting the payload allows event selectors to have a point of\n * comparison the first time state changes.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param args - The arguments to this function\n * @param args.eventType - The event type to register a payload for.\n * @param args.getPayload - A function for retrieving the event payload.\n /\n _internalRegisterDelegatedInitialEventPayload<\n EventType extends Event['type'],\n >({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n this.#registerInitialEventPayload({ eventType, getPayload });\n }\n\n /\n Publish an event that was delegated from another messenger.\n \n Publishes the given payload to all subscribers of the given event type.\n \n Note that this method should never throw directly. Any errors from\n * subscribers are captured and re-thrown in a timeout handler.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param eventType - The event type. This is a unique identifier for this event.\n * @param payload - The event payload. The type of the parameters for each event handler must\n * match the type of this payload.\n * @template EventType - A type union of Event type strings.\n /\n _internalPublishDelegated<EventType extends Event['type']>(\n eventType: EventType,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n this.#publish(eventType, ...payload);\n }\n\n /\n Determine whether the given name is within the current namespace.\n \n If the current namespace is MOCK_ANY_NAMESPACE, this check always returns true.\n \n @param name - The name to check\n * @returns Whether the name is within the current namespace\n */\n #isInCurrentNamespace(name: string): name is NamespacedName<Namespace> {\n return (\n this.#namespace === MOCK_ANY_NAMESPACE \|\|\n name.startsWith(`${this.#namespace}:`)\n );\n }\n}\n"]}

package/dist/Messenger.d.cts CHANGED Viewed

@@ -144,6 +144,18 @@ export declare class Messenger<Namespace extends string, Action extends ActionCo
      * This prevents all actions from being called.
      */
     clearActions(): void;
+    /**
+     * Get the action handler for a given action type.
+     *
+     * This is a protected method to allow subclasses to override the way action
+     * handlers are retrieved, for example to implement custom delegation logic.
+     *
+     * @param actionType - The action type. This is a unique identifier for this
+     * action.
+     * @returns The action handler for the given action type, or undefined if no
+     * handler has been registered.
+     */
+    protected getAction(actionType: Action['type']): ActionConstraint['handler'] | undefined;
     /**
      * Call an action.
      *
@@ -221,6 +233,120 @@ export declare class Messenger<Namespace extends string, Action extends ActionCo
      * @template SelectorReturnValue - The selector return value.
      */
     subscribe<EventType extends Event['type'], SelectorReturnValue>(eventType: EventType, handler: SelectorEventHandler<SelectorReturnValue>, selector: SelectorFunction<Event, EventType, SelectorReturnValue>): void;
+    /**
+     * Subscribe to an event, with a selector, invoking the handler exactly once.
+     *
+     * Registers the given handler function as an event handler for the given
+     * event type. When an event is published, its payload is first passed to the
+     * selector. The event handler is only called if the selector's return value
+     * differs from its last known return value. Additionally if the optional condition
+     * function is provided, it is checked whether it returns `true`.
+     * The handler is invoked at most once, after which the subscription is removed.
+     *
+     * @param eventType - The event type. This is a unique identifier for this event.
+     * @param handler - The event handler. The type of the parameters for this event
+     * handler must match the return type of the selector.
+     * @param options - Options bag.
+     * @param options.selector - The selector function used to select relevant data
+     * from the event payload. The type of the parameters for this selector must
+     * match the type of the payload for this event type.
+     * @param options.condition - An optional predicate evaluated against the
+     * selector's return value. The handler is only invoked when this returns `true`.
+     * @template EventType - A type union of Event type strings.
+     * @template SelectorReturnValue - The selector return value.
+     * @example
+     * ```typescript
+     * messenger.subscribeOnce(
+     *   'TransactionController:transactionConfirmed',
+     *   (hash) => { ... },
+     *   { selector: (tx) => tx.hash, condition: (hash) => hash === 'foo' },
+     * );
+     * ```
+     */
+    subscribeOnce<EventType extends Event['type'], SelectorReturnValue>(eventType: EventType, handler: SelectorEventHandler<SelectorReturnValue>, options: {
+        selector: SelectorFunction<Event, EventType, SelectorReturnValue>;
+        condition?: (value: SelectorReturnValue) => boolean;
+    }): void;
+    /**
+     * Subscribe to an event, invoking the handler exactly once.
+     *
+     * Registers the given function as an event handler for the given event type
+     * and automatically unsubscribes after the first invocation.
+     *
+     * If `options.condition` is provided, the handler is only invoked (and the
+     * subscription only removed) when the condition returns `true`.
+     *
+     * @param eventType - The event type. This is a unique identifier for this event.
+     * @param handler - The event handler. The type of the parameters for this event
+     * handler must match the type of the payload for this event type.
+     * @param options - Options bag.
+     * @param options.condition - A predicate evaluated against the event payload.
+     * The handler is only invoked when this returns `true`.
+     * @template EventType - A type union of Event type strings.
+     * @example
+     * ```typescript
+     * messenger.subscribeOnce(
+     *   'TransactionController:transactionConfirmed',
+     *   (tx) => { ... },
+     *   { condition: (tx) => tx.hash === 'foo' },
+     * );
+     * ```
+     */
+    subscribeOnce<EventType extends Event['type']>(eventType: EventType, handler: ExtractEventHandler<Event, EventType>, options?: {
+        condition?: (...payload: ExtractEventPayload<Event, EventType>) => boolean;
+    }): void;
+    /**
+     * Return a promise that resolves the next time the selector's return value
+     * changes and, if provided, the `options.condition` predicate returns `true`.
+     *
+     * @param eventType - The event type. This is a unique identifier for this event.
+     * @param options - Options bag.
+     * @param options.selector - The selector function used to select relevant data
+     * from the event payload.
+     * @param options.condition - An optional predicate evaluated against the
+     * selector's return value. The promise only resolves when this returns `true`.
+     * @template EventType - A type union of Event type strings.
+     * @template SelectorReturnValue - The selector return value.
+     * @returns A promise that resolves with the selector's return value.
+     * @example
+     * ```typescript
+     * const [hash] = await messenger.waitUntil(
+     *   'TransactionController:transactionConfirmed',
+     *   { selector: (tx) => tx.hash, condition: (hash) => hash === 'foo' },
+     * );
+     * ```
+     */
+    waitUntil<EventType extends Event['type'], SelectorReturnValue>(eventType: EventType, options: {
+        selector: SelectorFunction<Event, EventType, SelectorReturnValue>;
+        condition?: (value: SelectorReturnValue) => boolean;
+    }): Promise<[SelectorReturnValue, SelectorReturnValue | undefined]>;
+    /**
+     * Return a promise that resolves the next time the given event is published.
+     *
+     * If `options.condition` is provided, the promise only resolves when the
+     * condition returns `true`.
+     *
+     * @param eventType - The event type. This is a unique identifier for this event.
+     * @param options - Options bag.
+     * @param options.condition - A predicate evaluated against the event payload.
+     * The promise only resolves when this returns `true`.
+     * @template EventType - A type union of Event type strings.
+     * @returns A promise that resolves with the event payload.
+     * @example
+     * ```typescript
+     * const [transactionMeta] = await messenger.waitUntil(
+     *   'TransactionController:transactionConfirmed',
+     *   { condition: (tx) => tx.hash === 'foo' },
+     * );
+     * ```
+     * @example
+     * ```typescript
+     * await messenger.waitUntil('KeyringController:unlock');
+     * ```
+     */
+    waitUntil<EventType extends Event['type']>(eventType: EventType, options?: {
+        condition?: (...payload: ExtractEventPayload<Event, EventType>) => boolean;
+    }): Promise<ExtractEventPayload<Event, EventType>>;
     /**
      * Unsubscribe from an event.
      *

package/dist/Messenger.d.cts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Messenger.d.cts","sourceRoot":"","sources":["../src/Messenger.ts"],"names":[],"mappings":"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~~IAe5C~~;;;;;;;;;;;;;OAaG;IACH,2BAA2B,CACzB,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,EAC3D,EACA,SAAS,EACT,UAAU,GACX,EAAE;QACD,SAAS,EAAE,SAAS,CAAC;QACrB,UAAU,EAAE,MAAM,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;KACzD,GAAG,IAAI;IAwCR;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,EACjE,SAAS,EAAE,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,EAChD,GAAG,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GAChD,IAAI;IAmDP;;;;;;;;;OASG;IACH,SAAS,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACvC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GAC7C,IAAI;IAEP;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAC5D,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,EAClD,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,mBAAmB,CAAC,GAChE,IAAI;IA2DP;;;;;;;;;;OAUG;IACH,WAAW,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,EACxE,SAAS,EAAE,SAAS,EACpB,OAAO,EACH,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GACrC,oBAAoB,CAAC,mBAAmB,CAAC,GAC5C,IAAI;IA4BP;;;;;;;;OAQG;IACH,uBAAuB,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACrD,SAAS,EAAE,SAAS,GACnB,IAAI;IAkBP;;;;;OAKG;IACH,kBAAkB,IAAI,IAAI;IAM1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CACN,SAAS,SAAS,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,EACtE,gBAAgB,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,EACzE,eAAe,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,EACtE,EACA,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE;QACD,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,SAAS,EAAE,SAAS,CAAC;KACtB,GAAG,IAAI;~~IAuFR~~;;;;;;;;;;;;;OAaG;IACH,MAAM,CACJ,SAAS,SAAS,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,EACtE,gBAAgB,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,EACzE,eAAe,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,EACtE,EACA,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE;QACD,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,SAAS,EAAE,SAAS,CAAC;KACtB,GAAG,IAAI;IAoCR;;;;;;;;;;;;;;;OAeG;IACH,uCAAuC,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,EACvE,UAAU,EAAE,UAAU,EAItB,OAAO,EAAE,aAAa,CAAC,gBAAgB,EAAE,UAAU,CAAC,GACnD,IAAI;IAIP;;;;;;;;;;;;OAYG;IACH,yCAAyC,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,EACzE,UAAU,EAAE,UAAU,GACrB,IAAI;IAIP;;;;;;;;;;;;;;;;OAgBG;IACH,6CAA6C,CAC3C,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAC/B,EACA,SAAS,EACT,UAAU,GACX,EAAE;QACD,SAAS,EAAE,SAAS,CAAC;QACrB,UAAU,EAAE,MAAM,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;KACzD,GAAG,IAAI;IAIR;;;;;;;;;;;;;;;;;OAiBG;IACH,yBAAyB,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACvD,SAAS,EAAE,SAAS,EACpB,GAAG,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GAChD,IAAI;CAkBR"}
1	+ {"version":3,"file":"Messenger.d.cts","sourceRoot":"","sources":["../src/Messenger.ts"],"names":[],"mappings":"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"}

package/dist/Messenger.d.mts CHANGED Viewed

@@ -144,6 +144,18 @@ export declare class Messenger<Namespace extends string, Action extends ActionCo
      * This prevents all actions from being called.
      */
     clearActions(): void;
+    /**
+     * Get the action handler for a given action type.
+     *
+     * This is a protected method to allow subclasses to override the way action
+     * handlers are retrieved, for example to implement custom delegation logic.
+     *
+     * @param actionType - The action type. This is a unique identifier for this
+     * action.
+     * @returns The action handler for the given action type, or undefined if no
+     * handler has been registered.
+     */
+    protected getAction(actionType: Action['type']): ActionConstraint['handler'] | undefined;
     /**
      * Call an action.
      *
@@ -221,6 +233,120 @@ export declare class Messenger<Namespace extends string, Action extends ActionCo
      * @template SelectorReturnValue - The selector return value.
      */
     subscribe<EventType extends Event['type'], SelectorReturnValue>(eventType: EventType, handler: SelectorEventHandler<SelectorReturnValue>, selector: SelectorFunction<Event, EventType, SelectorReturnValue>): void;
+    /**
+     * Subscribe to an event, with a selector, invoking the handler exactly once.
+     *
+     * Registers the given handler function as an event handler for the given
+     * event type. When an event is published, its payload is first passed to the
+     * selector. The event handler is only called if the selector's return value
+     * differs from its last known return value. Additionally if the optional condition
+     * function is provided, it is checked whether it returns `true`.
+     * The handler is invoked at most once, after which the subscription is removed.
+     *
+     * @param eventType - The event type. This is a unique identifier for this event.
+     * @param handler - The event handler. The type of the parameters for this event
+     * handler must match the return type of the selector.
+     * @param options - Options bag.
+     * @param options.selector - The selector function used to select relevant data
+     * from the event payload. The type of the parameters for this selector must
+     * match the type of the payload for this event type.
+     * @param options.condition - An optional predicate evaluated against the
+     * selector's return value. The handler is only invoked when this returns `true`.
+     * @template EventType - A type union of Event type strings.
+     * @template SelectorReturnValue - The selector return value.
+     * @example
+     * ```typescript
+     * messenger.subscribeOnce(
+     *   'TransactionController:transactionConfirmed',
+     *   (hash) => { ... },
+     *   { selector: (tx) => tx.hash, condition: (hash) => hash === 'foo' },
+     * );
+     * ```
+     */
+    subscribeOnce<EventType extends Event['type'], SelectorReturnValue>(eventType: EventType, handler: SelectorEventHandler<SelectorReturnValue>, options: {
+        selector: SelectorFunction<Event, EventType, SelectorReturnValue>;
+        condition?: (value: SelectorReturnValue) => boolean;
+    }): void;
+    /**
+     * Subscribe to an event, invoking the handler exactly once.
+     *
+     * Registers the given function as an event handler for the given event type
+     * and automatically unsubscribes after the first invocation.
+     *
+     * If `options.condition` is provided, the handler is only invoked (and the
+     * subscription only removed) when the condition returns `true`.
+     *
+     * @param eventType - The event type. This is a unique identifier for this event.
+     * @param handler - The event handler. The type of the parameters for this event
+     * handler must match the type of the payload for this event type.
+     * @param options - Options bag.
+     * @param options.condition - A predicate evaluated against the event payload.
+     * The handler is only invoked when this returns `true`.
+     * @template EventType - A type union of Event type strings.
+     * @example
+     * ```typescript
+     * messenger.subscribeOnce(
+     *   'TransactionController:transactionConfirmed',
+     *   (tx) => { ... },
+     *   { condition: (tx) => tx.hash === 'foo' },
+     * );
+     * ```
+     */
+    subscribeOnce<EventType extends Event['type']>(eventType: EventType, handler: ExtractEventHandler<Event, EventType>, options?: {
+        condition?: (...payload: ExtractEventPayload<Event, EventType>) => boolean;
+    }): void;
+    /**
+     * Return a promise that resolves the next time the selector's return value
+     * changes and, if provided, the `options.condition` predicate returns `true`.
+     *
+     * @param eventType - The event type. This is a unique identifier for this event.
+     * @param options - Options bag.
+     * @param options.selector - The selector function used to select relevant data
+     * from the event payload.
+     * @param options.condition - An optional predicate evaluated against the
+     * selector's return value. The promise only resolves when this returns `true`.
+     * @template EventType - A type union of Event type strings.
+     * @template SelectorReturnValue - The selector return value.
+     * @returns A promise that resolves with the selector's return value.
+     * @example
+     * ```typescript
+     * const [hash] = await messenger.waitUntil(
+     *   'TransactionController:transactionConfirmed',
+     *   { selector: (tx) => tx.hash, condition: (hash) => hash === 'foo' },
+     * );
+     * ```
+     */
+    waitUntil<EventType extends Event['type'], SelectorReturnValue>(eventType: EventType, options: {
+        selector: SelectorFunction<Event, EventType, SelectorReturnValue>;
+        condition?: (value: SelectorReturnValue) => boolean;
+    }): Promise<[SelectorReturnValue, SelectorReturnValue | undefined]>;
+    /**
+     * Return a promise that resolves the next time the given event is published.
+     *
+     * If `options.condition` is provided, the promise only resolves when the
+     * condition returns `true`.
+     *
+     * @param eventType - The event type. This is a unique identifier for this event.
+     * @param options - Options bag.
+     * @param options.condition - A predicate evaluated against the event payload.
+     * The promise only resolves when this returns `true`.
+     * @template EventType - A type union of Event type strings.
+     * @returns A promise that resolves with the event payload.
+     * @example
+     * ```typescript
+     * const [transactionMeta] = await messenger.waitUntil(
+     *   'TransactionController:transactionConfirmed',
+     *   { condition: (tx) => tx.hash === 'foo' },
+     * );
+     * ```
+     * @example
+     * ```typescript
+     * await messenger.waitUntil('KeyringController:unlock');
+     * ```
+     */
+    waitUntil<EventType extends Event['type']>(eventType: EventType, options?: {
+        condition?: (...payload: ExtractEventPayload<Event, EventType>) => boolean;
+    }): Promise<ExtractEventPayload<Event, EventType>>;
     /**
      * Unsubscribe from an event.
      *

package/dist/Messenger.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Messenger.d.mts","sourceRoot":"","sources":["../src/Messenger.ts"],"names":[],"mappings":"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~~IAe5C~~;;;;;;;;;;;;;OAaG;IACH,2BAA2B,CACzB,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,EAC3D,EACA,SAAS,EACT,UAAU,GACX,EAAE;QACD,SAAS,EAAE,SAAS,CAAC;QACrB,UAAU,EAAE,MAAM,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;KACzD,GAAG,IAAI;IAwCR;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,EACjE,SAAS,EAAE,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,EAChD,GAAG,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GAChD,IAAI;IAmDP;;;;;;;;;OASG;IACH,SAAS,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACvC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GAC7C,IAAI;IAEP;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAC5D,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,EAClD,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,mBAAmB,CAAC,GAChE,IAAI;IA2DP;;;;;;;;;;OAUG;IACH,WAAW,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,EACxE,SAAS,EAAE,SAAS,EACpB,OAAO,EACH,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GACrC,oBAAoB,CAAC,mBAAmB,CAAC,GAC5C,IAAI;IA4BP;;;;;;;;OAQG;IACH,uBAAuB,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACrD,SAAS,EAAE,SAAS,GACnB,IAAI;IAkBP;;;;;OAKG;IACH,kBAAkB,IAAI,IAAI;IAM1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CACN,SAAS,SAAS,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,EACtE,gBAAgB,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,EACzE,eAAe,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,EACtE,EACA,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE;QACD,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,SAAS,EAAE,SAAS,CAAC;KACtB,GAAG,IAAI;~~IAuFR~~;;;;;;;;;;;;;OAaG;IACH,MAAM,CACJ,SAAS,SAAS,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,EACtE,gBAAgB,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,EACzE,eAAe,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,EACtE,EACA,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE;QACD,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,SAAS,EAAE,SAAS,CAAC;KACtB,GAAG,IAAI;IAoCR;;;;;;;;;;;;;;;OAeG;IACH,uCAAuC,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,EACvE,UAAU,EAAE,UAAU,EAItB,OAAO,EAAE,aAAa,CAAC,gBAAgB,EAAE,UAAU,CAAC,GACnD,IAAI;IAIP;;;;;;;;;;;;OAYG;IACH,yCAAyC,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,EACzE,UAAU,EAAE,UAAU,GACrB,IAAI;IAIP;;;;;;;;;;;;;;;;OAgBG;IACH,6CAA6C,CAC3C,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAC/B,EACA,SAAS,EACT,UAAU,GACX,EAAE;QACD,SAAS,EAAE,SAAS,CAAC;QACrB,UAAU,EAAE,MAAM,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;KACzD,GAAG,IAAI;IAIR;;;;;;;;;;;;;;;;;OAiBG;IACH,yBAAyB,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACvD,SAAS,EAAE,SAAS,EACpB,GAAG,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GAChD,IAAI;CAkBR"}
1	+ {"version":3,"file":"Messenger.d.mts","sourceRoot":"","sources":["../src/Messenger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,CACvB,MAAM,SAAS,gBAAgB,EAC/B,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IACzB,CACF,GAAG,IAAI,EAAE,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,KACjD,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE/C,MAAM,MAAM,uBAAuB,CACjC,MAAM,SAAS,gBAAgB,EAC/B,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IACzB,MAAM,SAAS;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,WAAW,KAAK,OAAO,CAAC;CAClD,GACG,WAAW,GACX,KAAK,CAAC;AAEV,MAAM,MAAM,qBAAqB,CAC/B,MAAM,SAAS,gBAAgB,EAC/B,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IACzB,MAAM,SAAS;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,kBAAkB,CAAC;CACzD,GACG,kBAAkB,GAClB,KAAK,CAAC;AAEV,MAAM,MAAM,mBAAmB,CAC7B,KAAK,SAAS,eAAe,EAC7B,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,IACvB,KAAK,SAAS;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC;CACxB,GACG,OAAO,SAAS,OAAO,EAAE,GACvB,CAAC,GAAG,OAAO,EAAE,OAAO,KAAK,IAAI,GAC7B,KAAK,GACP,KAAK,CAAC;AAEV,MAAM,MAAM,mBAAmB,CAC7B,KAAK,SAAS,eAAe,EAC7B,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,IACvB,KAAK,SAAS;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC;CACxB,GACG,OAAO,SAAS,OAAO,EAAE,GACvB,OAAO,GACP,KAAK,GACP,KAAK,CAAC;AAEV,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAE/D,MAAM,MAAM,gBAAgB,CAC1B,KAAK,SAAS,eAAe,EAC7B,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAC/B,WAAW,GAAG,OAAO,IACnB,CAAC,GAAG,IAAI,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,WAAW,CAAC;AACpE,MAAM,MAAM,oBAAoB,CAAC,mBAAmB,GAAG,OAAO,IAAI,CAChE,QAAQ,EAAE,mBAAmB,EAC7B,aAAa,EAAE,mBAAmB,GAAG,SAAS,KAC3C,IAAI,CAAC;AAEV,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC;CAC1E,CAAC;AACF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAC1B,OAAO,SAAS,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,IAEpE,OAAO,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,MAAM,EAAE,eAAe,CAAC,GAC5D,MAAM,GACN,KAAK,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,eAAe,CACzB,OAAO,SAAS,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,IAEpE,OAAO,SAAS,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC,GAC5D,KAAK,GACL,KAAK,CAAC;AAEZ;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AA+BtC;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,CACtB,SAAS,SAAS,MAAM,EACxB,IAAI,SAAS,MAAM,IACjB,IAAI,SAAS,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC;AAEzD,MAAM,MAAM,eAAe,CACzB,SAAS,SAAS,MAAM,EACxB,IAAI,SAAS,MAAM,IACjB,IAAI,SAAS,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC;AAEzD,MAAM,MAAM,cAAc,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,IAC1D,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;AAqB3B,KAAK,cAAc,CAAC,UAAU,SAAS,cAAc,IACnD,UAAU,SAAS,GAAG,MAAM,IAAI,MAAM,IAAI,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS,CACpB,SAAS,SAAS,MAAM,EACxB,MAAM,SAAS,gBAAgB,GAAG,KAAK,EACvC,KAAK,SAAS,eAAe,GAAG,KAAK,EACrC,MAAM,SAAS,SAAS,CACtB,MAAM,EACN,gBAAgB,EAChB,eAAe,EAIf,GAAG,CACJ,GAAG,KAAK;;IAgDT;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEnD;;;;;;;;;;OAUG;gBACS,EACV,gBAAgB,EAChB,SAAS,EACT,MAAM,GACP,EAAE;QACD,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAC1C,SAAS,EAAE,SAAS,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAC5D,KAAK,CAAC,MAAM,CAAC,SAAS,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GACnD,MAAM,GACN,KAAK,GACP,KAAK,CAAC;KACX;IAMD;;;;;;;;;;;;OAYG;IACH,qBAAqB,CACnB,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,EAC7D,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI;IA4B3E;;;;;;;;OAQG;IACH,4BAA4B,CAC1B,eAAe,SAAS;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,EAC3C,WAAW,SAAS,MAAM,eAAe,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAE1E,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,SAAS,WAAW,EAAE,GAClC,IAAI;IAUP;;;;;;;;;OASG;IACH,uBAAuB,CACrB,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,EAC7D,UAAU,EAAE,UAAU,GAAG,IAAI;IAiB/B;;;;OAIG;IACH,YAAY,IAAI,IAAI;IAMpB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,SAAS,CACjB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,GACzB,gBAAgB,CAAC,SAAS,CAAC,GAAG,SAAS;IAI1C;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,EACpC,UAAU,EAAE,UAAU,EACtB,GAAG,MAAM,EAAE,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,GACrD,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC;IAgB5C;;;;;;;;;;;;;OAaG;IACH,2BAA2B,CACzB,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,EAC3D,EACA,SAAS,EACT,UAAU,GACX,EAAE;QACD,SAAS,EAAE,SAAS,CAAC;QACrB,UAAU,EAAE,MAAM,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;KACzD,GAAG,IAAI;IAwCR;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,EACjE,SAAS,EAAE,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,EAChD,GAAG,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GAChD,IAAI;IAmDP;;;;;;;;;OASG;IACH,SAAS,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACvC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GAC7C,IAAI;IAEP;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAC5D,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,EAClD,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,mBAAmB,CAAC,GAChE,IAAI;IA2DP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,aAAa,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAChE,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,EAClD,OAAO,EAAE;QACP,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;QAClE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC;KACrD,GACA,IAAI;IAEP;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,aAAa,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAC3C,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,EAC9C,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,CACV,GAAG,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,KAC9C,OAAO,CAAC;KACd,GACA,IAAI;IAkCP;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAC5D,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;QACP,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;QAClE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC;KACrD,GACA,OAAO,CAAC,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAElE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACvC,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,CACV,GAAG,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,KAC9C,OAAO,CAAC;KACd,GACA,OAAO,CAAC,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAuBjD;;;;;;;;;;OAUG;IACH,WAAW,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,EACxE,SAAS,EAAE,SAAS,EACpB,OAAO,EACH,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GACrC,oBAAoB,CAAC,mBAAmB,CAAC,GAC5C,IAAI;IA4BP;;;;;;;;OAQG;IACH,uBAAuB,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACrD,SAAS,EAAE,SAAS,GACnB,IAAI;IAkBP;;;;;OAKG;IACH,kBAAkB,IAAI,IAAI;IAM1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CACN,SAAS,SAAS,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,EACtE,gBAAgB,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,EACzE,eAAe,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,EACtE,EACA,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE;QACD,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,SAAS,EAAE,SAAS,CAAC;KACtB,GAAG,IAAI;IAyFR;;;;;;;;;;;;;OAaG;IACH,MAAM,CACJ,SAAS,SAAS,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,EACtE,gBAAgB,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,EACzE,eAAe,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,EACtE,EACA,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE;QACD,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,SAAS,EAAE,SAAS,CAAC;KACtB,GAAG,IAAI;IAoCR;;;;;;;;;;;;;;;OAeG;IACH,uCAAuC,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,EACvE,UAAU,EAAE,UAAU,EAItB,OAAO,EAAE,aAAa,CAAC,gBAAgB,EAAE,UAAU,CAAC,GACnD,IAAI;IAIP;;;;;;;;;;;;OAYG;IACH,yCAAyC,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,EACzE,UAAU,EAAE,UAAU,GACrB,IAAI;IAIP;;;;;;;;;;;;;;;;OAgBG;IACH,6CAA6C,CAC3C,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAC/B,EACA,SAAS,EACT,UAAU,GACX,EAAE;QACD,SAAS,EAAE,SAAS,CAAC;QACrB,UAAU,EAAE,MAAM,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;KACzD,GAAG,IAAI;IAIR;;;;;;;;;;;;;;;;;OAiBG;IACH,yBAAyB,CAAC,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EACvD,SAAS,EAAE,SAAS,EACpB,GAAG,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GAChD,IAAI;CAkBR"}

package/dist/Messenger.mjs CHANGED Viewed

@@ -142,6 +142,20 @@ export class Messenger {
             __classPrivateFieldGet(this, _Messenger_instances, "m", _Messenger_unregisterActionHandler).call(this, actionType);
         }
     }
+    /**
+     * Get the action handler for a given action type.
+     *
+     * This is a protected method to allow subclasses to override the way action
+     * handlers are retrieved, for example to implement custom delegation logic.
+     *
+     * @param actionType - The action type. This is a unique identifier for this
+     * action.
+     * @returns The action handler for the given action type, or undefined if no
+     * handler has been registered.
+     */
+    getAction(actionType) {
+        return __classPrivateFieldGet(this, _Messenger_actions, "f").get(actionType);
+    }
     /**
      * Call an action.
      *
@@ -156,7 +170,7 @@ export class Messenger {
      * @returns The action return value.
      */
     call(actionType, ...params) {
-        const handler = __classPrivateFieldGet(this, _Messenger_actions, "f").get(actionType);
+        const handler = this.getAction(actionType);
         if (!handler) {
             throw new Error(__classPrivateFieldGet(this, _Messenger_instances, "m", _Messenger_isInCurrentNamespace).call(this, actionType)
                 ? `A handler for ${actionType} has not been registered`
@@ -239,6 +253,24 @@ export class Messenger {
             }
         }
     }
+    subscribeOnce(eventType, handler, options) {
+        const { selector, condition } = options ?? {};
+        // Casting to unknown to handle both the code path where a selector is defined and where it is omitted.
+        const internalHandler = (...args) => {
+            if (condition &&
+                !condition(...args)) {
+                return;
+            }
+            this.unsubscribe(eventType, internalHandler);
+            handler(...args);
+        };
+        this.subscribe(eventType, internalHandler, selector);
+    }
+    waitUntil(eventType, options) {
+        return new Promise((resolve) => {
+            this.subscribeOnce(eventType, (...args) => resolve(args), options);
+        });
+    }
     /**
      * Unsubscribe from an event.
      *
@@ -332,7 +364,7 @@ export class Messenger {
             const delegatedActionHandler = (...args) => {
                 // Cast to get more specific type, for this specific action
                 // The types get collapsed by `this.#actions`
-                const actionHandler = __classPrivateFieldGet(this, _Messenger_actions, "f").get(actionType);
+                const actionHandler = this.getAction(actionType);
                 if (!actionHandler) {
                     throw new Error(`A handler for ${actionType} has not been registered`);
                 }

package/dist/Messenger.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Messenger.mjs","sourceRoot":"","sources":["../src/Messenger.ts"],"names":[],"mappings":"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","sourcesContent":["export type ActionHandler<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = (\n ...args: ExtractActionParameters<Action, ActionType>\n) => ExtractActionResponse<Action, ActionType>;\n\nexport type ExtractActionParameters<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = Action extends {\n type: ActionType;\n handler: (...args: infer HandlerArgs) => unknown;\n}\n ? HandlerArgs\n : never;\n\nexport type ExtractActionResponse<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = Action extends {\n type: ActionType;\n handler: (...args: infer _) => infer HandlerReturnValue;\n}\n ? HandlerReturnValue\n : never;\n\nexport type ExtractEventHandler<\n Event extends EventConstraint,\n EventType = Event['type'],\n> = Event extends {\n type: EventType;\n payload: infer Payload;\n}\n ? Payload extends unknown[]\n ? (...payload: Payload) => void\n : never\n : never;\n\nexport type ExtractEventPayload<\n Event extends EventConstraint,\n EventType = Event['type'],\n> = Event extends {\n type: EventType;\n payload: infer Payload;\n}\n ? Payload extends unknown[]\n ? Payload\n : never\n : never;\n\nexport type GenericEventHandler = (...args: unknown[]) => void;\n\nexport type SelectorFunction<\n Event extends EventConstraint,\n EventType extends Event['type'],\n ReturnValue = unknown,\n> = (...args: ExtractEventPayload<Event, EventType>) => ReturnValue;\nexport type SelectorEventHandler<SelectorReturnValue = unknown> = (\n newValue: SelectorReturnValue,\n previousValue: SelectorReturnValue \| undefined,\n) => void;\n\nexport type ActionConstraint = {\n type: NamespacedName;\n handler: ((...args: never) => unknown) \| ((...args: never[]) => unknown);\n};\nexport type EventConstraint = {\n type: NamespacedName;\n payload: unknown[];\n};\n\n/*\n Extract action types from a Messenger type.\n \n @template Subject - The messenger type to extract from.\n /\nexport type MessengerActions<\n Subject extends Messenger<string, ActionConstraint, EventConstraint>,\n> =\n Subject extends Messenger<string, infer Action, EventConstraint>\n ? Action\n : never;\n\n/\n Extract event types from a Messenger type.\n \n @template Subject - The messenger type to extract from.\n /\nexport type MessengerEvents<\n Subject extends Messenger<string, ActionConstraint, EventConstraint>,\n> =\n Subject extends Messenger<string, ActionConstraint, infer Event>\n ? Event\n : never;\n\n/\n Messenger namespace checks can be disabled by using this as the `namespace` constructor\n * parameter, and using `MockAnyNamespace` as the Namespace type parameter.\n \n This is useful for mocking a variety of different actions/events in unit tests. Please do not\n * use this in production code.\n /\nexport const MOCK_ANY_NAMESPACE = 'MOCK_ANY_NAMESPACE';\n\n/\n A type representing any namespace.\n \n This is useful for mocking a variety of different actions/events in unit tests. Please do not\n * use this in production code.\n /\nexport type MockAnyNamespace = string;\n\n/\n Metadata for a single event subscription.\n \n @template Event - The event this subscription is for.\n /\ntype SubscriptionMetadata<Event extends EventConstraint> = {\n /\n Whether this subscription is for a delegated messenger. Delegation subscriptions are ignored\n * when clearing subscriptions.\n /\n delegation: boolean;\n /\n The optional selector function for this subscription.\n /\n selector?: SelectorFunction<Event, Event['type']>;\n};\n\n/\n A map of event handlers for a specific event.\n \n The key is the handler function, and the value contains additional subscription metadata.\n \n @template Event - The event these handlers are for.\n /\ntype EventSubscriptionMap<Event extends EventConstraint> = Map<\n GenericEventHandler \| SelectorEventHandler,\n SubscriptionMetadata<Event>\n>;\n\n/\n A namespaced string\n \n This type verifies that the string Name is prefixed by the string Name followed by a colon.\n \n @template Namespace - The namespace we're checking for.\n * @template Name - The full string, including the namespace.\n /\nexport type NamespacedBy<\n Namespace extends string,\n Name extends string,\n> = Name extends `${Namespace}:${string}` ? Name : never;\n\nexport type NotNamespacedBy<\n Namespace extends string,\n Name extends string,\n> = Name extends `${Namespace}:${string}` ? never : Name;\n\nexport type NamespacedName<Namespace extends string = string> =\n `${Namespace}:${string}`;\n\n/\n A messenger that actions and/or events can be delegated to.\n \n This is a minimal type interface to avoid complex incompatibilities resulting from generics over\n * invariant types.\n /\ntype DelegatedMessenger = Pick<\n // The type is broadened to all actions/events because some messenger methods are contravariant\n // over this type (`registerDelegatedActionHandler` and `publishDelegated` for example). If this\n // type is narrowed to just the delegated actions/events, the types for event payload and action\n // parameters would not be wide enough.\n Messenger<string, ActionConstraint, EventConstraint>,\n \| '_internalPublishDelegated'\n \| '_internalRegisterDelegatedActionHandler'\n \| '_internalRegisterDelegatedInitialEventPayload'\n \| '_internalUnregisterDelegatedActionHandler'\n \| 'captureException'\n>;\n\ntype StripNamespace<Namespaced extends NamespacedName> =\n Namespaced extends `${string}:${infer Name}` ? Name : never;\n\n/\n A message broker for \"actions\" and \"events\".\n \n The messenger allows registering functions as 'actions' that can be called elsewhere,\n * and it allows publishing and subscribing to events. Both actions and events are identified by\n * unique strings prefixed by a namespace (which is delimited by a colon, e.g.\n * `Namespace:actionName`).\n \n @template Action - A type union of all Action types.\n * @template Event - A type union of all Event types.\n * @template Namespace - The namespace for the messenger.\n /\nexport class Messenger<\n Namespace extends string,\n Action extends ActionConstraint = never,\n Event extends EventConstraint = never,\n Parent extends Messenger<\n string,\n ActionConstraint,\n EventConstraint,\n // Use `any` to avoid preventing a parent from having a parent. `any` is harmless in a type\n // constraint anyway, it's the one totally safe place to use it.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n any\n > = never,\n> {\n readonly #namespace: Namespace;\n\n /\n The parent messenger. All actions/events under this namespace are automatically delegated to\n * the parent messenger.\n /\n readonly #parent?: DelegatedMessenger;\n\n readonly #actions = new Map<Action['type'], Action['handler']>();\n\n readonly #events = new Map<Event['type'], EventSubscriptionMap<Event>>();\n\n /\n The set of messengers we've delegated events to and their event handlers, by event type.\n /\n readonly #subscriptionDelegationTargets = new Map<\n Event['type'],\n Map<DelegatedMessenger, ExtractEventHandler<Event, Event['type']>>\n >();\n\n /\n The set of messengers we've delegated actions to, by action type.\n /\n readonly #actionDelegationTargets = new Map<\n Action['type'],\n Set<DelegatedMessenger>\n >();\n\n /\n A map of functions for getting the initial event payload.\n \n Used only for events that represent state changes.\n /\n readonly #initialEventPayloadGetters = new Map<\n Event['type'],\n () => ExtractEventPayload<Event, Event['type']>\n >();\n\n /\n A cache of selector return values for their respective handlers.\n /\n readonly #eventPayloadCache = new Map<\n GenericEventHandler,\n unknown \| undefined\n >();\n\n /\n Reports an error to an error monitoring service.\n \n @param error - The error to report.\n /\n readonly captureException?: (error: Error) => void;\n\n /\n Construct a messenger.\n \n If a parent messenger is given, all actions and events under this messenger's namespace will\n * be delegated to the parent automatically.\n \n @param args - Constructor arguments\n * @param args.captureException - Reports an error to an error monitoring service.\n * @param args.namespace - The messenger namespace.\n * @param args.parent - The parent messenger.\n /\n constructor({\n captureException,\n namespace,\n parent,\n }: {\n captureException?: (error: Error) => void;\n namespace: Namespace;\n parent?: Action['type'] extends MessengerActions<Parent>['type']\n ? Event['type'] extends MessengerEvents<Parent>['type']\n ? Parent\n : never\n : never;\n }) {\n this.#namespace = namespace;\n this.#parent = parent;\n this.captureException = captureException ?? this.#parent?.captureException;\n }\n\n /\n Register an action handler.\n \n This will make the registered function available to call via the `call` method.\n \n The action being registered must be under the same namespace as the messenger.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @param handler - The action handler. This function gets called when the `call` method is\n * invoked with the given action type.\n * @throws Will throw when a handler has been registered for this action type already.\n * @template ActionType - A type union of Action type strings under this messenger's namespace.\n /\n registerActionHandler<\n ActionType extends Action['type'] & NamespacedName<Namespace>,\n >(actionType: ActionType, handler: ActionHandler<Action, ActionType>): void {\n if (!this.#isInCurrentNamespace(actionType)) {\n throw new Error(\n `Only allowed registering action handlers prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n this.#registerActionHandler(actionType, handler);\n if (this.#parent) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // action, but this is OK because it's validated in the constructor.\n this.delegate({ actions: [actionType], messenger: this.#parent });\n }\n }\n\n #registerActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n handler: ActionHandler<ActionConstraint, ActionType>,\n ): void {\n if (this.#actions.has(actionType)) {\n throw new Error(\n `A handler for ${actionType} has already been registered`,\n );\n }\n this.#actions.set(actionType, handler);\n }\n\n /\n Registers action handlers for a list of methods on a messenger client\n \n @param messengerClient - The object that is expected to make use of the messenger.\n * @param methodNames - The names of the methods on the messenger client to register as action\n * handlers.\n * @template MessengerClient - The type expected to make use of the messenger.\n * @template MethodNames - The type union of method names to register as action handlers.\n /\n registerMethodActionHandlers<\n MessengerClient extends { name: Namespace },\n MethodNames extends keyof MessengerClient & StripNamespace<Action['type']>,\n >(\n messengerClient: MessengerClient,\n methodNames: readonly MethodNames[],\n ): void {\n for (const methodName of methodNames) {\n const method = messengerClient[methodName];\n if (typeof method === 'function') {\n const actionType = `${messengerClient.name}:${methodName}` as const;\n this.registerActionHandler(actionType, method.bind(messengerClient));\n }\n }\n }\n\n /\n Unregister an action handler.\n \n This will prevent this action from being called.\n \n The action being unregistered must be under the same namespace as the messenger.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @template ActionType - A type union of Action type strings under this messenger's namespace.\n /\n unregisterActionHandler<\n ActionType extends Action['type'] & NamespacedName<Namespace>,\n >(actionType: ActionType): void {\n if (!this.#isInCurrentNamespace(actionType)) {\n throw new Error(\n `Only allowed unregistering action handlers prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n this.#unregisterActionHandler(actionType);\n }\n\n #unregisterActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n ): void {\n this.#actions.delete(actionType);\n }\n\n /\n Unregister all action handlers.\n \n This prevents all actions from being called.\n /\n clearActions(): void {\n for (const actionType of this.#actions.keys()) {\n this.#unregisterActionHandler(actionType);\n }\n }\n\n /\n Call an action.\n \n This function will call the action handler corresponding to the given action type, passing\n * along any parameters given.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @param params - The action parameters. These must match the type of the parameters of the\n * registered action handler.\n * @throws Will throw when no handler has been registered for the given type.\n * @template ActionType - A type union of Action type strings.\n * @returns The action return value.\n /\n call<ActionType extends Action['type']>(\n actionType: ActionType,\n ...params: ExtractActionParameters<Action, ActionType>\n ): ExtractActionResponse<Action, ActionType> {\n const handler = this.#actions.get(actionType) as ActionHandler<\n Action,\n ActionType\n >;\n if (!handler) {\n throw new Error(\n this.#isInCurrentNamespace(actionType)\n ? `A handler for ${actionType} has not been registered`\n : `A handler for ${actionType} has not been delegated to ${this.#namespace}`,\n );\n }\n return handler(...params);\n }\n\n /\n Register a function for getting the initial payload for an event.\n \n This is used for events that represent a state change, where the payload is the state.\n * Registering a function for getting the payload allows event selectors to have a point of\n * comparison the first time state changes.\n \n The event type must be under the same namespace as the messenger.\n \n @param args - The arguments to this function\n * @param args.eventType - The event type to register a payload for.\n * @param args.getPayload - A function for retrieving the event payload.\n * @template EventType - A type union of Event type strings under this messenger's namespace.\n /\n registerInitialEventPayload<\n EventType extends Event['type'] & NamespacedName<Namespace>,\n >({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n if (!this.#isInCurrentNamespace(eventType)) {\n throw new Error(\n `Only allowed registering initial payloads for events prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n if (\n this.#parent &&\n !this.#subscriptionDelegationTargets.get(eventType)?.has(this.#parent)\n ) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // event, but this is OK because it's validated in the constructor.\n this.delegate({ events: [eventType], messenger: this.#parent });\n }\n this.#registerInitialEventPayload({ eventType, getPayload });\n }\n\n #registerInitialEventPayload<EventType extends Event['type']>({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n this.#initialEventPayloadGetters.set(eventType, getPayload);\n const delegationTargets =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegationTargets) {\n return;\n }\n for (const messenger of delegationTargets.keys()) {\n messenger._internalRegisterDelegatedInitialEventPayload({\n eventType,\n getPayload,\n });\n }\n }\n\n /\n Publish an event.\n \n Publishes the given payload to all subscribers of the given event type.\n \n Note that this method should never throw directly. Any errors from\n * subscribers are captured and re-thrown in a timeout handler.\n \n The event being published must be under the same namespace as the messenger.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param payload - The event payload. The type of the parameters for each event handler must\n * match the type of this payload.\n * @template EventType - A type union of Event type strings under this messenger's namespace.\n /\n publish<EventType extends Event['type'] & NamespacedName<Namespace>>(\n eventType: EventType & NamespacedName<Namespace>,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n if (!this.#isInCurrentNamespace(eventType)) {\n throw new Error(\n `Only allowed publishing events prefixed by '${this.#namespace}:'`,\n );\n }\n if (\n this.#parent &&\n !this.#subscriptionDelegationTargets.get(eventType)?.has(this.#parent)\n ) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // event, but this is OK because it's validated in the constructor.\n this.delegate({ events: [eventType], messenger: this.#parent });\n }\n this.#publish(eventType, ...payload);\n }\n\n #publish<EventType extends Event['type']>(\n eventType: EventType,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n const subscribers = this.#events.get(eventType);\n\n if (subscribers) {\n for (const [handler, { selector }] of subscribers.entries()) {\n try {\n if (selector) {\n const previousValue = this.#eventPayloadCache.get(handler);\n const newValue = selector(...payload);\n\n if (newValue !== previousValue) {\n this.#eventPayloadCache.set(handler, newValue);\n handler(newValue, previousValue);\n }\n } else {\n (handler as GenericEventHandler)(...payload);\n }\n } catch (error) {\n // Capture error without interrupting the event publishing.\n if (this.captureException) {\n this.captureException(\n error instanceof Error ? error : new Error(String(error)),\n );\n } else {\n console.error(error);\n }\n }\n }\n }\n }\n\n /\n Subscribe to an event.\n \n Registers the given function as an event handler for the given event type.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event handler must\n * match the type of the payload for this event type.\n * @template EventType - A type union of Event type strings.\n /\n subscribe<EventType extends Event['type']>(\n eventType: EventType,\n handler: ExtractEventHandler<Event, EventType>,\n ): void;\n\n /\n Subscribe to an event, with a selector.\n \n Registers the given handler function as an event handler for the given\n * event type. When an event is published, its payload is first passed to the\n * selector. The event handler is only called if the selector's return value\n * differs from its last known return value.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event\n * handler must match the return type of the selector.\n * @param selector - The selector function used to select relevant data from\n * the event payload. The type of the parameters for this selector must match\n * the type of the payload for this event type.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n /\n subscribe<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler: SelectorEventHandler<SelectorReturnValue>,\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>,\n ): void;\n\n subscribe<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n selector?: SelectorFunction<Event, EventType, SelectorReturnValue>,\n ): void {\n // Widen type of event handler by dropping ReturnType parameter.\n //\n // We need to drop it here because it's used as the parameter to the event handler, and\n // functions in general are contravariant over the parameter type. This means the type is no\n // longer valid once it's added to a broader type union with other handlers (because as far\n // as TypeScript knows, we might call the handler with output from a different selector).\n //\n // This cast means the type system is not guaranteeing the handler is called with the matching\n // input selector return value. The parameter types do ensure they match when `subscribe` is\n // called, but past that point we need to make sure of that with manual review and tests\n // instead.\n const widenedHandler = handler as\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler;\n this.#subscribe(eventType, widenedHandler, { delegation: false, selector });\n\n if (selector) {\n const getPayload = this.#initialEventPayloadGetters.get(eventType);\n if (getPayload) {\n const initialValue = selector(...getPayload());\n this.#eventPayloadCache.set(widenedHandler, initialValue);\n }\n }\n }\n\n /\n Subscribe to an event.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event handler must\n * match the type of the payload for this event type.\n * @param metadata - Event metadata.\n * @template SubscribedEvent - The event being subscribed to.\n * @template SelectorReturnValue - The selector return value.\n /\n #subscribe<SubscribedEvent extends EventConstraint>(\n eventType: SubscribedEvent['type'],\n handler:\n \| ExtractEventHandler<SubscribedEvent, SubscribedEvent['type']>\n \| SelectorEventHandler,\n metadata: SubscriptionMetadata<SubscribedEvent>,\n ): void {\n let subscribers = this.#events.get(eventType);\n if (!subscribers) {\n subscribers = new Map();\n this.#events.set(eventType, subscribers);\n }\n subscribers.set(handler, metadata);\n }\n\n /\n Unsubscribe from an event.\n \n Unregisters the given function as an event handler for the given event.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler to unregister.\n * @throws Will throw when the given event handler is not registered for this event.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n /\n unsubscribe<EventType extends Event['type'], SelectorReturnValue = unknown>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n ): void {\n const subscribers = this.#events.get(eventType);\n\n // Widen type of event handler by dropping ReturnType parameter.\n //\n // We need to drop it here because it's used as the parameter to the event handler, and\n // functions in general are contravariant over the parameter type. This means the type is no\n // longer valid once it's added to a broader type union with other handlers (because as far\n // as TypeScript knows, we might call the handler with output from a different selector).\n //\n // This poses no risk in this case, since we never call the handler past this point.\n const widenedHandler = handler as\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler;\n if (!subscribers) {\n throw new Error(`Subscription not found for event: ${eventType}`);\n }\n const metadata = subscribers.get(widenedHandler);\n if (!metadata) {\n throw new Error(`Subscription not found for event: ${eventType}`);\n }\n if (metadata.selector) {\n this.#eventPayloadCache.delete(widenedHandler);\n }\n\n subscribers.delete(widenedHandler);\n }\n\n /\n Clear subscriptions for a specific event.\n \n This will remove all subscribed handlers for this event registered from this messenger. The\n * event may still have subscribers if it has been delegated to another messenger.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @template EventType - A type union of Event type strings.\n /\n clearEventSubscriptions<EventType extends Event['type']>(\n eventType: EventType,\n ): void {\n const subscriptions = this.#events.get(eventType);\n if (!subscriptions) {\n return;\n }\n\n for (const [handler, metadata] of subscriptions.entries()) {\n if (metadata.delegation) {\n continue;\n }\n subscriptions.delete(handler);\n }\n\n if (subscriptions.size === 0) {\n this.#events.delete(eventType);\n }\n }\n\n /\n Clear all subscriptions.\n \n This will remove all subscribed handlers for all events registered from this messenger. Events\n * may still have subscribers if they are delegated to another messenger.\n /\n clearSubscriptions(): void {\n for (const eventType of this.#events.keys()) {\n this.clearEventSubscriptions(eventType);\n }\n }\n\n /\n Delegate actions and/or events to another messenger.\n \n The messenger these actions/events are delegated to will be able to call these actions and\n * subscribe to these events.\n \n Note that the messenger these actions/events are delegated to must still have these\n * actions/events included in its type definition (as part of the Action and Event type\n * parameters). Actions and events are statically type checked, they cannot be delegated\n * dynamically at runtime.\n \n @param args - Arguments.\n * @param args.actions - The action types to delegate.\n * @param args.events - The event types to delegate.\n * @param args.messenger - The messenger to delegate to.\n * @template Delegatee - The messenger the actions/events are delegated to.\n * @template DelegatedActions - An array of delegated action types.\n * @template DelegatedEvents - An array of delegated event types.\n /\n delegate<\n Delegatee extends Messenger<string, ActionConstraint, EventConstraint>,\n DelegatedActions extends (MessengerActions<Delegatee> & Action)['type'][],\n DelegatedEvents extends (MessengerEvents<Delegatee> & Event)['type'][],\n >({\n actions,\n events,\n messenger,\n }: {\n actions?: DelegatedActions;\n events?: DelegatedEvents;\n messenger: Delegatee;\n }): void {\n for (const actionType of actions ?? []) {\n const delegatedActionHandler = (\n ...args: ExtractActionParameters<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n >\n ): ExtractActionResponse<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n > => {\n // Cast to get more specific type, for this specific action\n // The types get collapsed by `this.#actions`\n const actionHandler = this.#actions.get(actionType) as\n \| ActionHandler<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n >\n \| undefined;\n if (!actionHandler) {\n throw new Error(\n `A handler for ${actionType} has not been registered`,\n );\n }\n return actionHandler(...args);\n };\n let delegationTargets = this.#actionDelegationTargets.get(actionType);\n if (!delegationTargets) {\n delegationTargets = new Set<DelegatedMessenger>();\n this.#actionDelegationTargets.set(actionType, delegationTargets);\n }\n if (delegationTargets.has(messenger)) {\n throw new Error(\n `The action '${actionType}' has already been delegated to this messenger`,\n );\n }\n delegationTargets.add(messenger);\n\n messenger._internalRegisterDelegatedActionHandler(\n actionType,\n delegatedActionHandler,\n );\n }\n for (const eventType of events ?? []) {\n const untypedSubscriber = (\n ...payload: ExtractEventPayload<\n MessengerEvents<Delegatee> & Event,\n typeof eventType\n >\n ): void => {\n messenger._internalPublishDelegated(eventType, ...payload);\n };\n // Cast to get more specific subscriber type for this specific event.\n // The types get collapsed here to the type union of all delegated\n // events, rather than the single subscriber type corresponding to this\n // event.\n const subscriber = untypedSubscriber as ExtractEventHandler<\n MessengerEvents<Delegatee> & Event,\n typeof eventType\n >;\n let delegatedEventSubscriptions =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegatedEventSubscriptions) {\n delegatedEventSubscriptions = new Map();\n this.#subscriptionDelegationTargets.set(\n eventType,\n delegatedEventSubscriptions,\n );\n }\n if (delegatedEventSubscriptions.has(messenger)) {\n throw new Error(\n `The event '${eventType}' has already been delegated to this messenger`,\n );\n }\n delegatedEventSubscriptions.set(messenger, subscriber);\n const getPayload = this.#initialEventPayloadGetters.get(eventType);\n if (getPayload) {\n messenger._internalRegisterDelegatedInitialEventPayload({\n eventType,\n getPayload,\n });\n }\n\n this.#subscribe(eventType, subscriber, { delegation: true });\n }\n }\n\n /\n Revoke delegated actions and/or events from another messenger.\n \n The messenger these actions/events are delegated to will no longer be able to call these\n * actions or subscribe to these events.\n \n @param args - Arguments.\n * @param args.actions - The action types to revoke.\n * @param args.events - The event types to revoke.\n * @param args.messenger - The messenger these actions/events were delegated to.\n * @template Delegatee - The messenger the actions/events are being revoked from.\n * @template DelegatedActions - An array of delegated action types.\n * @template DelegatedEvents - An array of delegated event types.\n /\n revoke<\n Delegatee extends Messenger<string, ActionConstraint, EventConstraint>,\n DelegatedActions extends (MessengerActions<Delegatee> & Action)['type'][],\n DelegatedEvents extends (MessengerEvents<Delegatee> & Event)['type'][],\n >({\n actions,\n events,\n messenger,\n }: {\n actions?: DelegatedActions;\n events?: DelegatedEvents;\n messenger: Delegatee;\n }): void {\n if (messenger === this.#parent) {\n throw new Error('Cannot revoke from parent');\n }\n for (const actionType of actions ?? []) {\n const delegationTargets = this.#actionDelegationTargets.get(actionType);\n if (!delegationTargets?.has(messenger)) {\n // Nothing to revoke\n continue;\n }\n messenger._internalUnregisterDelegatedActionHandler(actionType);\n delegationTargets.delete(messenger);\n if (delegationTargets.size === 0) {\n this.#actionDelegationTargets.delete(actionType);\n }\n }\n for (const eventType of events ?? []) {\n const delegationTargets =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegationTargets) {\n // Nothing to revoke\n continue;\n }\n const delegatedSubscriber = delegationTargets.get(messenger);\n if (!delegatedSubscriber) {\n // Nothing to revoke\n continue;\n }\n this.unsubscribe(eventType, delegatedSubscriber);\n delegationTargets.delete(messenger);\n if (delegationTargets.size === 0) {\n this.#subscriptionDelegationTargets.delete(eventType);\n }\n }\n }\n\n /\n Register an action handler for an action delegated from another messenger.\n \n This will make the registered function available to call via the `call` method.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param actionType - The action type. This is a unique identifier for this action.\n * @param handler - The action handler. This function gets called when the `call` method is\n * invoked with the given action type.\n * @throws Will throw when a handler has been registered for this action type already.\n * @template ActionType - A type union of Action type strings.\n /\n _internalRegisterDelegatedActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n // Using wider `ActionConstraint` type here rather than `Action` because the `Action` type is\n // contravariant over the handler parameter type. Using `Action` would lead to a type error\n // here because the messenger we've delegated to supports _additional_ actions.\n handler: ActionHandler<ActionConstraint, ActionType>,\n ): void {\n this.#registerActionHandler(actionType, handler);\n }\n\n /\n Unregister an action handler for an action delegated from another messenger.\n \n This will prevent this action from being called.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param actionType - The action type. This is a unqiue identifier for this action.\n * @template ActionType - A type union of Action type strings.\n /\n _internalUnregisterDelegatedActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n ): void {\n this.#unregisterActionHandler(actionType);\n }\n\n /\n Register a function for getting the initial payload for an event that has been delegated from\n * another messenger.\n \n This is used for events that represent a state change, where the payload is the state.\n * Registering a function for getting the payload allows event selectors to have a point of\n * comparison the first time state changes.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param args - The arguments to this function\n * @param args.eventType - The event type to register a payload for.\n * @param args.getPayload - A function for retrieving the event payload.\n /\n _internalRegisterDelegatedInitialEventPayload<\n EventType extends Event['type'],\n >({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n this.#registerInitialEventPayload({ eventType, getPayload });\n }\n\n /\n Publish an event that was delegated from another messenger.\n \n Publishes the given payload to all subscribers of the given event type.\n \n Note that this method should never throw directly. Any errors from\n * subscribers are captured and re-thrown in a timeout handler.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param eventType - The event type. This is a unique identifier for this event.\n * @param payload - The event payload. The type of the parameters for each event handler must\n * match the type of this payload.\n * @template EventType - A type union of Event type strings.\n /\n _internalPublishDelegated<EventType extends Event['type']>(\n eventType: EventType,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n this.#publish(eventType, ...payload);\n }\n\n /\n Determine whether the given name is within the current namespace.\n \n If the current namespace is MOCK_ANY_NAMESPACE, this check always returns true.\n \n @param name - The name to check\n * @returns Whether the name is within the current namespace\n */\n #isInCurrentNamespace(name: string): name is NamespacedName<Namespace> {\n return (\n this.#namespace === MOCK_ANY_NAMESPACE \|\|\n name.startsWith(`${this.#namespace}:`)\n );\n }\n}\n"]}
1	+ {"version":3,"file":"Messenger.mjs","sourceRoot":"","sources":["../src/Messenger.ts"],"names":[],"mappings":"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","sourcesContent":["export type ActionHandler<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = (\n ...args: ExtractActionParameters<Action, ActionType>\n) => ExtractActionResponse<Action, ActionType>;\n\nexport type ExtractActionParameters<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = Action extends {\n type: ActionType;\n handler: (...args: infer HandlerArgs) => unknown;\n}\n ? HandlerArgs\n : never;\n\nexport type ExtractActionResponse<\n Action extends ActionConstraint,\n ActionType = Action['type'],\n> = Action extends {\n type: ActionType;\n handler: (...args: infer _) => infer HandlerReturnValue;\n}\n ? HandlerReturnValue\n : never;\n\nexport type ExtractEventHandler<\n Event extends EventConstraint,\n EventType = Event['type'],\n> = Event extends {\n type: EventType;\n payload: infer Payload;\n}\n ? Payload extends unknown[]\n ? (...payload: Payload) => void\n : never\n : never;\n\nexport type ExtractEventPayload<\n Event extends EventConstraint,\n EventType = Event['type'],\n> = Event extends {\n type: EventType;\n payload: infer Payload;\n}\n ? Payload extends unknown[]\n ? Payload\n : never\n : never;\n\nexport type GenericEventHandler = (...args: unknown[]) => void;\n\nexport type SelectorFunction<\n Event extends EventConstraint,\n EventType extends Event['type'],\n ReturnValue = unknown,\n> = (...args: ExtractEventPayload<Event, EventType>) => ReturnValue;\nexport type SelectorEventHandler<SelectorReturnValue = unknown> = (\n newValue: SelectorReturnValue,\n previousValue: SelectorReturnValue \| undefined,\n) => void;\n\nexport type ActionConstraint = {\n type: NamespacedName;\n handler: ((...args: never) => unknown) \| ((...args: never[]) => unknown);\n};\nexport type EventConstraint = {\n type: NamespacedName;\n payload: unknown[];\n};\n\n/*\n Extract action types from a Messenger type.\n \n @template Subject - The messenger type to extract from.\n /\nexport type MessengerActions<\n Subject extends Messenger<string, ActionConstraint, EventConstraint>,\n> =\n Subject extends Messenger<string, infer Action, EventConstraint>\n ? Action\n : never;\n\n/\n Extract event types from a Messenger type.\n \n @template Subject - The messenger type to extract from.\n /\nexport type MessengerEvents<\n Subject extends Messenger<string, ActionConstraint, EventConstraint>,\n> =\n Subject extends Messenger<string, ActionConstraint, infer Event>\n ? Event\n : never;\n\n/\n Messenger namespace checks can be disabled by using this as the `namespace` constructor\n * parameter, and using `MockAnyNamespace` as the Namespace type parameter.\n \n This is useful for mocking a variety of different actions/events in unit tests. Please do not\n * use this in production code.\n /\nexport const MOCK_ANY_NAMESPACE = 'MOCK_ANY_NAMESPACE';\n\n/\n A type representing any namespace.\n \n This is useful for mocking a variety of different actions/events in unit tests. Please do not\n * use this in production code.\n /\nexport type MockAnyNamespace = string;\n\n/\n Metadata for a single event subscription.\n \n @template Event - The event this subscription is for.\n /\ntype SubscriptionMetadata<Event extends EventConstraint> = {\n /\n Whether this subscription is for a delegated messenger. Delegation subscriptions are ignored\n * when clearing subscriptions.\n /\n delegation: boolean;\n /\n The optional selector function for this subscription.\n /\n selector?: SelectorFunction<Event, Event['type']>;\n};\n\n/\n A map of event handlers for a specific event.\n \n The key is the handler function, and the value contains additional subscription metadata.\n \n @template Event - The event these handlers are for.\n /\ntype EventSubscriptionMap<Event extends EventConstraint> = Map<\n GenericEventHandler \| SelectorEventHandler,\n SubscriptionMetadata<Event>\n>;\n\n/\n A namespaced string\n \n This type verifies that the string Name is prefixed by the string Name followed by a colon.\n \n @template Namespace - The namespace we're checking for.\n * @template Name - The full string, including the namespace.\n /\nexport type NamespacedBy<\n Namespace extends string,\n Name extends string,\n> = Name extends `${Namespace}:${string}` ? Name : never;\n\nexport type NotNamespacedBy<\n Namespace extends string,\n Name extends string,\n> = Name extends `${Namespace}:${string}` ? never : Name;\n\nexport type NamespacedName<Namespace extends string = string> =\n `${Namespace}:${string}`;\n\n/\n A messenger that actions and/or events can be delegated to.\n \n This is a minimal type interface to avoid complex incompatibilities resulting from generics over\n * invariant types.\n /\ntype DelegatedMessenger = Pick<\n // The type is broadened to all actions/events because some messenger methods are contravariant\n // over this type (`registerDelegatedActionHandler` and `publishDelegated` for example). If this\n // type is narrowed to just the delegated actions/events, the types for event payload and action\n // parameters would not be wide enough.\n Messenger<string, ActionConstraint, EventConstraint>,\n \| '_internalPublishDelegated'\n \| '_internalRegisterDelegatedActionHandler'\n \| '_internalRegisterDelegatedInitialEventPayload'\n \| '_internalUnregisterDelegatedActionHandler'\n \| 'captureException'\n>;\n\ntype StripNamespace<Namespaced extends NamespacedName> =\n Namespaced extends `${string}:${infer Name}` ? Name : never;\n\n/\n A message broker for \"actions\" and \"events\".\n \n The messenger allows registering functions as 'actions' that can be called elsewhere,\n * and it allows publishing and subscribing to events. Both actions and events are identified by\n * unique strings prefixed by a namespace (which is delimited by a colon, e.g.\n * `Namespace:actionName`).\n \n @template Action - A type union of all Action types.\n * @template Event - A type union of all Event types.\n * @template Namespace - The namespace for the messenger.\n /\nexport class Messenger<\n Namespace extends string,\n Action extends ActionConstraint = never,\n Event extends EventConstraint = never,\n Parent extends Messenger<\n string,\n ActionConstraint,\n EventConstraint,\n // Use `any` to avoid preventing a parent from having a parent. `any` is harmless in a type\n // constraint anyway, it's the one totally safe place to use it.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n any\n > = never,\n> {\n readonly #namespace: Namespace;\n\n /\n The parent messenger. All actions/events under this namespace are automatically delegated to\n * the parent messenger.\n /\n readonly #parent?: DelegatedMessenger;\n\n readonly #actions = new Map<Action['type'], Action['handler']>();\n\n readonly #events = new Map<Event['type'], EventSubscriptionMap<Event>>();\n\n /\n The set of messengers we've delegated events to and their event handlers, by event type.\n /\n readonly #subscriptionDelegationTargets = new Map<\n Event['type'],\n Map<DelegatedMessenger, ExtractEventHandler<Event, Event['type']>>\n >();\n\n /\n The set of messengers we've delegated actions to, by action type.\n /\n readonly #actionDelegationTargets = new Map<\n Action['type'],\n Set<DelegatedMessenger>\n >();\n\n /\n A map of functions for getting the initial event payload.\n \n Used only for events that represent state changes.\n /\n readonly #initialEventPayloadGetters = new Map<\n Event['type'],\n () => ExtractEventPayload<Event, Event['type']>\n >();\n\n /\n A cache of selector return values for their respective handlers.\n /\n readonly #eventPayloadCache = new Map<\n GenericEventHandler,\n unknown \| undefined\n >();\n\n /\n Reports an error to an error monitoring service.\n \n @param error - The error to report.\n /\n readonly captureException?: (error: Error) => void;\n\n /\n Construct a messenger.\n \n If a parent messenger is given, all actions and events under this messenger's namespace will\n * be delegated to the parent automatically.\n \n @param args - Constructor arguments\n * @param args.captureException - Reports an error to an error monitoring service.\n * @param args.namespace - The messenger namespace.\n * @param args.parent - The parent messenger.\n /\n constructor({\n captureException,\n namespace,\n parent,\n }: {\n captureException?: (error: Error) => void;\n namespace: Namespace;\n parent?: Action['type'] extends MessengerActions<Parent>['type']\n ? Event['type'] extends MessengerEvents<Parent>['type']\n ? Parent\n : never\n : never;\n }) {\n this.#namespace = namespace;\n this.#parent = parent;\n this.captureException = captureException ?? this.#parent?.captureException;\n }\n\n /\n Register an action handler.\n \n This will make the registered function available to call via the `call` method.\n \n The action being registered must be under the same namespace as the messenger.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @param handler - The action handler. This function gets called when the `call` method is\n * invoked with the given action type.\n * @throws Will throw when a handler has been registered for this action type already.\n * @template ActionType - A type union of Action type strings under this messenger's namespace.\n /\n registerActionHandler<\n ActionType extends Action['type'] & NamespacedName<Namespace>,\n >(actionType: ActionType, handler: ActionHandler<Action, ActionType>): void {\n if (!this.#isInCurrentNamespace(actionType)) {\n throw new Error(\n `Only allowed registering action handlers prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n this.#registerActionHandler(actionType, handler);\n if (this.#parent) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // action, but this is OK because it's validated in the constructor.\n this.delegate({ actions: [actionType], messenger: this.#parent });\n }\n }\n\n #registerActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n handler: ActionHandler<ActionConstraint, ActionType>,\n ): void {\n if (this.#actions.has(actionType)) {\n throw new Error(\n `A handler for ${actionType} has already been registered`,\n );\n }\n this.#actions.set(actionType, handler);\n }\n\n /\n Registers action handlers for a list of methods on a messenger client\n \n @param messengerClient - The object that is expected to make use of the messenger.\n * @param methodNames - The names of the methods on the messenger client to register as action\n * handlers.\n * @template MessengerClient - The type expected to make use of the messenger.\n * @template MethodNames - The type union of method names to register as action handlers.\n /\n registerMethodActionHandlers<\n MessengerClient extends { name: Namespace },\n MethodNames extends keyof MessengerClient & StripNamespace<Action['type']>,\n >(\n messengerClient: MessengerClient,\n methodNames: readonly MethodNames[],\n ): void {\n for (const methodName of methodNames) {\n const method = messengerClient[methodName];\n if (typeof method === 'function') {\n const actionType = `${messengerClient.name}:${methodName}` as const;\n this.registerActionHandler(actionType, method.bind(messengerClient));\n }\n }\n }\n\n /\n Unregister an action handler.\n \n This will prevent this action from being called.\n \n The action being unregistered must be under the same namespace as the messenger.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @template ActionType - A type union of Action type strings under this messenger's namespace.\n /\n unregisterActionHandler<\n ActionType extends Action['type'] & NamespacedName<Namespace>,\n >(actionType: ActionType): void {\n if (!this.#isInCurrentNamespace(actionType)) {\n throw new Error(\n `Only allowed unregistering action handlers prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n this.#unregisterActionHandler(actionType);\n }\n\n #unregisterActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n ): void {\n this.#actions.delete(actionType);\n }\n\n /\n Unregister all action handlers.\n \n This prevents all actions from being called.\n /\n clearActions(): void {\n for (const actionType of this.#actions.keys()) {\n this.#unregisterActionHandler(actionType);\n }\n }\n\n /\n Get the action handler for a given action type.\n \n This is a protected method to allow subclasses to override the way action\n * handlers are retrieved, for example to implement custom delegation logic.\n \n @param actionType - The action type. This is a unique identifier for this\n * action.\n * @returns The action handler for the given action type, or undefined if no\n * handler has been registered.\n /\n protected getAction(\n actionType: Action['type'],\n ): ActionConstraint['handler'] \| undefined {\n return this.#actions.get(actionType);\n }\n\n /\n Call an action.\n \n This function will call the action handler corresponding to the given action type, passing\n * along any parameters given.\n \n @param actionType - The action type. This is a unique identifier for this action.\n * @param params - The action parameters. These must match the type of the parameters of the\n * registered action handler.\n * @throws Will throw when no handler has been registered for the given type.\n * @template ActionType - A type union of Action type strings.\n * @returns The action return value.\n /\n call<ActionType extends Action['type']>(\n actionType: ActionType,\n ...params: ExtractActionParameters<Action, ActionType>\n ): ExtractActionResponse<Action, ActionType> {\n const handler = this.getAction(actionType) as\n \| ActionHandler<Action, ActionType>\n \| undefined;\n\n if (!handler) {\n throw new Error(\n this.#isInCurrentNamespace(actionType)\n ? `A handler for ${actionType} has not been registered`\n : `A handler for ${actionType} has not been delegated to ${this.#namespace}`,\n );\n }\n\n return handler(...params);\n }\n\n /\n Register a function for getting the initial payload for an event.\n \n This is used for events that represent a state change, where the payload is the state.\n * Registering a function for getting the payload allows event selectors to have a point of\n * comparison the first time state changes.\n \n The event type must be under the same namespace as the messenger.\n \n @param args - The arguments to this function\n * @param args.eventType - The event type to register a payload for.\n * @param args.getPayload - A function for retrieving the event payload.\n * @template EventType - A type union of Event type strings under this messenger's namespace.\n /\n registerInitialEventPayload<\n EventType extends Event['type'] & NamespacedName<Namespace>,\n >({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n if (!this.#isInCurrentNamespace(eventType)) {\n throw new Error(\n `Only allowed registering initial payloads for events prefixed by '${\n this.#namespace\n }:'`,\n );\n }\n if (\n this.#parent &&\n !this.#subscriptionDelegationTargets.get(eventType)?.has(this.#parent)\n ) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // event, but this is OK because it's validated in the constructor.\n this.delegate({ events: [eventType], messenger: this.#parent });\n }\n this.#registerInitialEventPayload({ eventType, getPayload });\n }\n\n #registerInitialEventPayload<EventType extends Event['type']>({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n this.#initialEventPayloadGetters.set(eventType, getPayload);\n const delegationTargets =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegationTargets) {\n return;\n }\n for (const messenger of delegationTargets.keys()) {\n messenger._internalRegisterDelegatedInitialEventPayload({\n eventType,\n getPayload,\n });\n }\n }\n\n /\n Publish an event.\n \n Publishes the given payload to all subscribers of the given event type.\n \n Note that this method should never throw directly. Any errors from\n * subscribers are captured and re-thrown in a timeout handler.\n \n The event being published must be under the same namespace as the messenger.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param payload - The event payload. The type of the parameters for each event handler must\n * match the type of this payload.\n * @template EventType - A type union of Event type strings under this messenger's namespace.\n /\n publish<EventType extends Event['type'] & NamespacedName<Namespace>>(\n eventType: EventType & NamespacedName<Namespace>,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n if (!this.#isInCurrentNamespace(eventType)) {\n throw new Error(\n `Only allowed publishing events prefixed by '${this.#namespace}:'`,\n );\n }\n if (\n this.#parent &&\n !this.#subscriptionDelegationTargets.get(eventType)?.has(this.#parent)\n ) {\n // @ts-expect-error The parent type isn't constructed in a way that proves it supports this\n // event, but this is OK because it's validated in the constructor.\n this.delegate({ events: [eventType], messenger: this.#parent });\n }\n this.#publish(eventType, ...payload);\n }\n\n #publish<EventType extends Event['type']>(\n eventType: EventType,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n const subscribers = this.#events.get(eventType);\n\n if (subscribers) {\n for (const [handler, { selector }] of subscribers.entries()) {\n try {\n if (selector) {\n const previousValue = this.#eventPayloadCache.get(handler);\n const newValue = selector(...payload);\n\n if (newValue !== previousValue) {\n this.#eventPayloadCache.set(handler, newValue);\n handler(newValue, previousValue);\n }\n } else {\n (handler as GenericEventHandler)(...payload);\n }\n } catch (error) {\n // Capture error without interrupting the event publishing.\n if (this.captureException) {\n this.captureException(\n error instanceof Error ? error : new Error(String(error)),\n );\n } else {\n console.error(error);\n }\n }\n }\n }\n }\n\n /\n Subscribe to an event.\n \n Registers the given function as an event handler for the given event type.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event handler must\n * match the type of the payload for this event type.\n * @template EventType - A type union of Event type strings.\n /\n subscribe<EventType extends Event['type']>(\n eventType: EventType,\n handler: ExtractEventHandler<Event, EventType>,\n ): void;\n\n /\n Subscribe to an event, with a selector.\n \n Registers the given handler function as an event handler for the given\n * event type. When an event is published, its payload is first passed to the\n * selector. The event handler is only called if the selector's return value\n * differs from its last known return value.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event\n * handler must match the return type of the selector.\n * @param selector - The selector function used to select relevant data from\n * the event payload. The type of the parameters for this selector must match\n * the type of the payload for this event type.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n /\n subscribe<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler: SelectorEventHandler<SelectorReturnValue>,\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>,\n ): void;\n\n subscribe<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n selector?: SelectorFunction<Event, EventType, SelectorReturnValue>,\n ): void {\n // Widen type of event handler by dropping ReturnType parameter.\n //\n // We need to drop it here because it's used as the parameter to the event handler, and\n // functions in general are contravariant over the parameter type. This means the type is no\n // longer valid once it's added to a broader type union with other handlers (because as far\n // as TypeScript knows, we might call the handler with output from a different selector).\n //\n // This cast means the type system is not guaranteeing the handler is called with the matching\n // input selector return value. The parameter types do ensure they match when `subscribe` is\n // called, but past that point we need to make sure of that with manual review and tests\n // instead.\n const widenedHandler = handler as\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler;\n this.#subscribe(eventType, widenedHandler, { delegation: false, selector });\n\n if (selector) {\n const getPayload = this.#initialEventPayloadGetters.get(eventType);\n if (getPayload) {\n const initialValue = selector(...getPayload());\n this.#eventPayloadCache.set(widenedHandler, initialValue);\n }\n }\n }\n\n /\n Subscribe to an event.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event handler must\n * match the type of the payload for this event type.\n * @param metadata - Event metadata.\n * @template SubscribedEvent - The event being subscribed to.\n * @template SelectorReturnValue - The selector return value.\n /\n #subscribe<SubscribedEvent extends EventConstraint>(\n eventType: SubscribedEvent['type'],\n handler:\n \| ExtractEventHandler<SubscribedEvent, SubscribedEvent['type']>\n \| SelectorEventHandler,\n metadata: SubscriptionMetadata<SubscribedEvent>,\n ): void {\n let subscribers = this.#events.get(eventType);\n if (!subscribers) {\n subscribers = new Map();\n this.#events.set(eventType, subscribers);\n }\n subscribers.set(handler, metadata);\n }\n\n /\n Subscribe to an event, with a selector, invoking the handler exactly once.\n \n Registers the given handler function as an event handler for the given\n * event type. When an event is published, its payload is first passed to the\n * selector. The event handler is only called if the selector's return value\n * differs from its last known return value. Additionally if the optional condition\n * function is provided, it is checked whether it returns `true`.\n * The handler is invoked at most once, after which the subscription is removed.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event\n * handler must match the return type of the selector.\n * @param options - Options bag.\n * @param options.selector - The selector function used to select relevant data\n * from the event payload. The type of the parameters for this selector must\n * match the type of the payload for this event type.\n * @param options.condition - An optional predicate evaluated against the\n * selector's return value. The handler is only invoked when this returns `true`.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n * @example\n * ```typescript\n * messenger.subscribeOnce(\n * 'TransactionController:transactionConfirmed',\n * (hash) => { ... },\n * { selector: (tx) => tx.hash, condition: (hash) => hash === 'foo' },\n * );\n * ```\n /\n subscribeOnce<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler: SelectorEventHandler<SelectorReturnValue>,\n options: {\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?: (value: SelectorReturnValue) => boolean;\n },\n ): void;\n\n /\n Subscribe to an event, invoking the handler exactly once.\n \n Registers the given function as an event handler for the given event type\n * and automatically unsubscribes after the first invocation.\n \n If `options.condition` is provided, the handler is only invoked (and the\n * subscription only removed) when the condition returns `true`.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler. The type of the parameters for this event\n * handler must match the type of the payload for this event type.\n * @param options - Options bag.\n * @param options.condition - A predicate evaluated against the event payload.\n * The handler is only invoked when this returns `true`.\n * @template EventType - A type union of Event type strings.\n * @example\n * ```typescript\n * messenger.subscribeOnce(\n * 'TransactionController:transactionConfirmed',\n * (tx) => { ... },\n * { condition: (tx) => tx.hash === 'foo' },\n * );\n * ```\n /\n subscribeOnce<EventType extends Event['type']>(\n eventType: EventType,\n handler: ExtractEventHandler<Event, EventType>,\n options?: {\n condition?: (\n ...payload: ExtractEventPayload<Event, EventType>\n ) => boolean;\n },\n ): void;\n\n subscribeOnce<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n options?: {\n selector?: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?:\n \| ((...payload: ExtractEventPayload<Event, EventType>) => boolean)\n \| ((value: SelectorReturnValue) => boolean);\n },\n ): void {\n const { selector, condition } = options ?? {};\n // Casting to unknown to handle both the code path where a selector is defined and where it is omitted.\n const internalHandler = (...args: unknown[]): void => {\n if (\n condition &&\n !(condition as (...args: unknown[]) => boolean)(...args)\n ) {\n return;\n }\n this.unsubscribe(eventType, internalHandler);\n (handler as (...args: unknown[]) => void)(...args);\n };\n\n this.subscribe(\n eventType,\n internalHandler,\n selector as SelectorFunction<Event, EventType, SelectorReturnValue>,\n );\n }\n\n /\n Return a promise that resolves the next time the selector's return value\n * changes and, if provided, the `options.condition` predicate returns `true`.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param options - Options bag.\n * @param options.selector - The selector function used to select relevant data\n * from the event payload.\n * @param options.condition - An optional predicate evaluated against the\n * selector's return value. The promise only resolves when this returns `true`.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n * @returns A promise that resolves with the selector's return value.\n * @example\n * ```typescript\n * const [hash] = await messenger.waitUntil(\n * 'TransactionController:transactionConfirmed',\n * { selector: (tx) => tx.hash, condition: (hash) => hash === 'foo' },\n * );\n * ```\n /\n waitUntil<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n options: {\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?: (value: SelectorReturnValue) => boolean;\n },\n ): Promise<[SelectorReturnValue, SelectorReturnValue \| undefined]>;\n\n /\n Return a promise that resolves the next time the given event is published.\n \n If `options.condition` is provided, the promise only resolves when the\n * condition returns `true`.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param options - Options bag.\n * @param options.condition - A predicate evaluated against the event payload.\n * The promise only resolves when this returns `true`.\n * @template EventType - A type union of Event type strings.\n * @returns A promise that resolves with the event payload.\n * @example\n * ```typescript\n * const [transactionMeta] = await messenger.waitUntil(\n * 'TransactionController:transactionConfirmed',\n * { condition: (tx) => tx.hash === 'foo' },\n * );\n * ```\n * @example\n * ```typescript\n * await messenger.waitUntil('KeyringController:unlock');\n * ```\n /\n waitUntil<EventType extends Event['type']>(\n eventType: EventType,\n options?: {\n condition?: (\n ...payload: ExtractEventPayload<Event, EventType>\n ) => boolean;\n },\n ): Promise<ExtractEventPayload<Event, EventType>>;\n\n waitUntil<EventType extends Event['type'], SelectorReturnValue>(\n eventType: EventType,\n options?: {\n selector?: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?:\n \| ((...payload: ExtractEventPayload<Event, EventType>) => boolean)\n \| ((value: SelectorReturnValue) => boolean);\n },\n ): Promise<SelectorReturnValue \| ExtractEventPayload<Event, EventType>[0]> {\n return new Promise((resolve) => {\n this.subscribeOnce(\n eventType,\n (...args) => resolve(args),\n options as {\n selector: SelectorFunction<Event, EventType, SelectorReturnValue>;\n condition?: (value: SelectorReturnValue) => boolean;\n },\n );\n });\n }\n\n /\n Unsubscribe from an event.\n \n Unregisters the given function as an event handler for the given event.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @param handler - The event handler to unregister.\n * @throws Will throw when the given event handler is not registered for this event.\n * @template EventType - A type union of Event type strings.\n * @template SelectorReturnValue - The selector return value.\n /\n unsubscribe<EventType extends Event['type'], SelectorReturnValue = unknown>(\n eventType: EventType,\n handler:\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler<SelectorReturnValue>,\n ): void {\n const subscribers = this.#events.get(eventType);\n\n // Widen type of event handler by dropping ReturnType parameter.\n //\n // We need to drop it here because it's used as the parameter to the event handler, and\n // functions in general are contravariant over the parameter type. This means the type is no\n // longer valid once it's added to a broader type union with other handlers (because as far\n // as TypeScript knows, we might call the handler with output from a different selector).\n //\n // This poses no risk in this case, since we never call the handler past this point.\n const widenedHandler = handler as\n \| ExtractEventHandler<Event, EventType>\n \| SelectorEventHandler;\n if (!subscribers) {\n throw new Error(`Subscription not found for event: ${eventType}`);\n }\n const metadata = subscribers.get(widenedHandler);\n if (!metadata) {\n throw new Error(`Subscription not found for event: ${eventType}`);\n }\n if (metadata.selector) {\n this.#eventPayloadCache.delete(widenedHandler);\n }\n\n subscribers.delete(widenedHandler);\n }\n\n /\n Clear subscriptions for a specific event.\n \n This will remove all subscribed handlers for this event registered from this messenger. The\n * event may still have subscribers if it has been delegated to another messenger.\n \n @param eventType - The event type. This is a unique identifier for this event.\n * @template EventType - A type union of Event type strings.\n /\n clearEventSubscriptions<EventType extends Event['type']>(\n eventType: EventType,\n ): void {\n const subscriptions = this.#events.get(eventType);\n if (!subscriptions) {\n return;\n }\n\n for (const [handler, metadata] of subscriptions.entries()) {\n if (metadata.delegation) {\n continue;\n }\n subscriptions.delete(handler);\n }\n\n if (subscriptions.size === 0) {\n this.#events.delete(eventType);\n }\n }\n\n /\n Clear all subscriptions.\n \n This will remove all subscribed handlers for all events registered from this messenger. Events\n * may still have subscribers if they are delegated to another messenger.\n /\n clearSubscriptions(): void {\n for (const eventType of this.#events.keys()) {\n this.clearEventSubscriptions(eventType);\n }\n }\n\n /\n Delegate actions and/or events to another messenger.\n \n The messenger these actions/events are delegated to will be able to call these actions and\n * subscribe to these events.\n \n Note that the messenger these actions/events are delegated to must still have these\n * actions/events included in its type definition (as part of the Action and Event type\n * parameters). Actions and events are statically type checked, they cannot be delegated\n * dynamically at runtime.\n \n @param args - Arguments.\n * @param args.actions - The action types to delegate.\n * @param args.events - The event types to delegate.\n * @param args.messenger - The messenger to delegate to.\n * @template Delegatee - The messenger the actions/events are delegated to.\n * @template DelegatedActions - An array of delegated action types.\n * @template DelegatedEvents - An array of delegated event types.\n /\n delegate<\n Delegatee extends Messenger<string, ActionConstraint, EventConstraint>,\n DelegatedActions extends (MessengerActions<Delegatee> & Action)['type'][],\n DelegatedEvents extends (MessengerEvents<Delegatee> & Event)['type'][],\n >({\n actions,\n events,\n messenger,\n }: {\n actions?: DelegatedActions;\n events?: DelegatedEvents;\n messenger: Delegatee;\n }): void {\n for (const actionType of actions ?? []) {\n const delegatedActionHandler = (\n ...args: ExtractActionParameters<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n >\n ): ExtractActionResponse<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n > => {\n // Cast to get more specific type, for this specific action\n // The types get collapsed by `this.#actions`\n const actionHandler = this.getAction(actionType) as\n \| ActionHandler<\n MessengerActions<Delegatee> & Action,\n typeof actionType\n >\n \| undefined;\n\n if (!actionHandler) {\n throw new Error(\n `A handler for ${actionType} has not been registered`,\n );\n }\n\n return actionHandler(...args);\n };\n let delegationTargets = this.#actionDelegationTargets.get(actionType);\n if (!delegationTargets) {\n delegationTargets = new Set<DelegatedMessenger>();\n this.#actionDelegationTargets.set(actionType, delegationTargets);\n }\n if (delegationTargets.has(messenger)) {\n throw new Error(\n `The action '${actionType}' has already been delegated to this messenger`,\n );\n }\n delegationTargets.add(messenger);\n\n messenger._internalRegisterDelegatedActionHandler(\n actionType,\n delegatedActionHandler,\n );\n }\n for (const eventType of events ?? []) {\n const untypedSubscriber = (\n ...payload: ExtractEventPayload<\n MessengerEvents<Delegatee> & Event,\n typeof eventType\n >\n ): void => {\n messenger._internalPublishDelegated(eventType, ...payload);\n };\n // Cast to get more specific subscriber type for this specific event.\n // The types get collapsed here to the type union of all delegated\n // events, rather than the single subscriber type corresponding to this\n // event.\n const subscriber = untypedSubscriber as ExtractEventHandler<\n MessengerEvents<Delegatee> & Event,\n typeof eventType\n >;\n let delegatedEventSubscriptions =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegatedEventSubscriptions) {\n delegatedEventSubscriptions = new Map();\n this.#subscriptionDelegationTargets.set(\n eventType,\n delegatedEventSubscriptions,\n );\n }\n if (delegatedEventSubscriptions.has(messenger)) {\n throw new Error(\n `The event '${eventType}' has already been delegated to this messenger`,\n );\n }\n delegatedEventSubscriptions.set(messenger, subscriber);\n const getPayload = this.#initialEventPayloadGetters.get(eventType);\n if (getPayload) {\n messenger._internalRegisterDelegatedInitialEventPayload({\n eventType,\n getPayload,\n });\n }\n\n this.#subscribe(eventType, subscriber, { delegation: true });\n }\n }\n\n /\n Revoke delegated actions and/or events from another messenger.\n \n The messenger these actions/events are delegated to will no longer be able to call these\n * actions or subscribe to these events.\n \n @param args - Arguments.\n * @param args.actions - The action types to revoke.\n * @param args.events - The event types to revoke.\n * @param args.messenger - The messenger these actions/events were delegated to.\n * @template Delegatee - The messenger the actions/events are being revoked from.\n * @template DelegatedActions - An array of delegated action types.\n * @template DelegatedEvents - An array of delegated event types.\n /\n revoke<\n Delegatee extends Messenger<string, ActionConstraint, EventConstraint>,\n DelegatedActions extends (MessengerActions<Delegatee> & Action)['type'][],\n DelegatedEvents extends (MessengerEvents<Delegatee> & Event)['type'][],\n >({\n actions,\n events,\n messenger,\n }: {\n actions?: DelegatedActions;\n events?: DelegatedEvents;\n messenger: Delegatee;\n }): void {\n if (messenger === this.#parent) {\n throw new Error('Cannot revoke from parent');\n }\n for (const actionType of actions ?? []) {\n const delegationTargets = this.#actionDelegationTargets.get(actionType);\n if (!delegationTargets?.has(messenger)) {\n // Nothing to revoke\n continue;\n }\n messenger._internalUnregisterDelegatedActionHandler(actionType);\n delegationTargets.delete(messenger);\n if (delegationTargets.size === 0) {\n this.#actionDelegationTargets.delete(actionType);\n }\n }\n for (const eventType of events ?? []) {\n const delegationTargets =\n this.#subscriptionDelegationTargets.get(eventType);\n if (!delegationTargets) {\n // Nothing to revoke\n continue;\n }\n const delegatedSubscriber = delegationTargets.get(messenger);\n if (!delegatedSubscriber) {\n // Nothing to revoke\n continue;\n }\n this.unsubscribe(eventType, delegatedSubscriber);\n delegationTargets.delete(messenger);\n if (delegationTargets.size === 0) {\n this.#subscriptionDelegationTargets.delete(eventType);\n }\n }\n }\n\n /\n Register an action handler for an action delegated from another messenger.\n \n This will make the registered function available to call via the `call` method.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param actionType - The action type. This is a unique identifier for this action.\n * @param handler - The action handler. This function gets called when the `call` method is\n * invoked with the given action type.\n * @throws Will throw when a handler has been registered for this action type already.\n * @template ActionType - A type union of Action type strings.\n /\n _internalRegisterDelegatedActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n // Using wider `ActionConstraint` type here rather than `Action` because the `Action` type is\n // contravariant over the handler parameter type. Using `Action` would lead to a type error\n // here because the messenger we've delegated to supports _additional_ actions.\n handler: ActionHandler<ActionConstraint, ActionType>,\n ): void {\n this.#registerActionHandler(actionType, handler);\n }\n\n /\n Unregister an action handler for an action delegated from another messenger.\n \n This will prevent this action from being called.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param actionType - The action type. This is a unqiue identifier for this action.\n * @template ActionType - A type union of Action type strings.\n /\n _internalUnregisterDelegatedActionHandler<ActionType extends Action['type']>(\n actionType: ActionType,\n ): void {\n this.#unregisterActionHandler(actionType);\n }\n\n /\n Register a function for getting the initial payload for an event that has been delegated from\n * another messenger.\n \n This is used for events that represent a state change, where the payload is the state.\n * Registering a function for getting the payload allows event selectors to have a point of\n * comparison the first time state changes.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param args - The arguments to this function\n * @param args.eventType - The event type to register a payload for.\n * @param args.getPayload - A function for retrieving the event payload.\n /\n _internalRegisterDelegatedInitialEventPayload<\n EventType extends Event['type'],\n >({\n eventType,\n getPayload,\n }: {\n eventType: EventType;\n getPayload: () => ExtractEventPayload<Event, EventType>;\n }): void {\n this.#registerInitialEventPayload({ eventType, getPayload });\n }\n\n /\n Publish an event that was delegated from another messenger.\n \n Publishes the given payload to all subscribers of the given event type.\n \n Note that this method should never throw directly. Any errors from\n * subscribers are captured and re-thrown in a timeout handler.\n \n Note: This is an internal method. Never access this property from another module. This must be\n * exposed as a public property so that these methods can be called internally on other messenger\n * instances.\n \n @deprecated Internal use only. Use the `delegate` method for delegation.\n * @param eventType - The event type. This is a unique identifier for this event.\n * @param payload - The event payload. The type of the parameters for each event handler must\n * match the type of this payload.\n * @template EventType - A type union of Event type strings.\n /\n _internalPublishDelegated<EventType extends Event['type']>(\n eventType: EventType,\n ...payload: ExtractEventPayload<Event, EventType>\n ): void {\n this.#publish(eventType, ...payload);\n }\n\n /\n Determine whether the given name is within the current namespace.\n \n If the current namespace is MOCK_ANY_NAMESPACE, this check always returns true.\n \n @param name - The name to check\n * @returns Whether the name is within the current namespace\n */\n #isInCurrentNamespace(name: string): name is NamespacedName<Namespace> {\n return (\n this.#namespace === MOCK_ANY_NAMESPACE \|\|\n name.startsWith(`${this.#namespace}:`)\n );\n }\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/messenger",
-  "version": "1.1.1-preview-45a82ea8e",
+  "version": "1.2.0-preview-d8ff44d",
   "description": "A type-safe message bus library",
   "keywords": [
     "Ethereum",