import { Type, Static } from "@sinclair/typebox"; import { Link, Event, EventClass, RequestHandler, WebSocketClientConnector, WebSocketBaseConnector } from "./link"; import { Address, MessageRequest, IControllerUser } from "./data"; export type SubscriptionRequestHandler = RequestHandler | null>; export type EventSubscriberCallback = (value: T) => void; /** * Response received by the subscriber after a request * It can contain an eventReplay value if the event sender implements a subscription handler * This replay will be send to the handlers as if an update had just occurred */ export class SubscriptionResponse { constructor( public readonly eventReplay: Event | null = null, ) { if (eventReplay && !Link._eventsByClass.has(eventReplay.constructor)) { throw new Error(`Unregistered Event class ${eventReplay.constructor.name}`); } } static jsonSchema = Type.Union([ Type.Tuple([ Type.String(), Type.Unknown(), ]), Type.Null(), ]); toJSON() { if (this.eventReplay) { const entry = Link._eventsByClass.get(this.eventReplay.constructor)!; return [entry.name, this.eventReplay]; } return null; } static fromJSON(json: Static): SubscriptionResponse { if (json) { const entry = Link._eventsByName.get(json[0]); if (!entry) { throw new Error(`Unregistered Event class ${json[0]}`); } else { return new SubscriptionResponse(entry.eventFromJSON(json[1])); } } else { return new SubscriptionResponse(); } } } /** * A subscription request sent by a subscriber, this updates what events the subscriber will be sent * The permission for this request copies the permission from the event being subscribed to * subscribe: false will unsubscribe the subscriber from all notifications */ export class SubscriptionRequest { declare ["constructor"]: typeof SubscriptionRequest; static type = "request" as const; static src = ["control", "instance"] as const; static dst = "controller" as const; static Response = SubscriptionResponse; static permission(user: IControllerUser, message: MessageRequest) { if (typeof message.data === "object" && message.data !== null) { const data = message.data as Static; const entry = Link._eventsByName.get(data[0]); if (entry && entry.Event.permission) { if (typeof entry.Event.permission === "string") { user.checkPermission(entry.Event.permission); } else { entry.Event.permission(user, message); } } } } constructor( public eventName: string, public subscribe: boolean, public lastRequestTime: number = 0, ) { if (!Link._eventsByName.has(eventName)) { throw new Error(`Unregistered Event class ${eventName}`); } } static jsonSchema = Type.Tuple([ Type.String(), Type.Boolean(), Type.Number(), ]); toJSON() { return [this.eventName, this.subscribe, this.lastRequestTime]; } static fromJSON(json: Static): SubscriptionRequest { return new this(...json); } } type EventData = { subscriptionUpdate?: SubscriptionRequestHandler, subscriptions: Map void }>, }; /** * A class component to handle incoming subscription requests and offers a method to broadcast events to subscribers * After creation, no other handler can be registered for SubscriptionRequest on the controller */ export class SubscriptionController { _events = new Map(); constructor( private controller: any, // Controller | Link ) { this.controller.handle(SubscriptionRequest, this._handleRequest.bind(this)); } /** * Allow clients to subscribe to an event by telling the subscription controller to accept them * Has an optional subscription update handler which is called when a client subscribes * @param Event - Event class which is sent out as updates. * @param subscriptionUpdate - * Optional handler called when a client subscribes. */ handle(Event: EventClass, subscriptionUpdate?: SubscriptionRequestHandler) { const entry = Link._eventsByClass.get(Event); if (!entry) { throw new Error(`Unregistered Event class ${Event.name}`); } if (this._events.has(entry.name)) { throw new Error(`Event ${entry.name} is already registered`); } this._events.set(entry.name, { subscriptionUpdate: subscriptionUpdate, subscriptions: new Map(), }); } /** * Broadcast an event to all subscribers of that event * @param event - Event to broadcast. */ broadcast(event: Event) { const entry = Link._eventsByClass.get(event.constructor); if (!entry) { throw new Error(`Unregistered Event class ${event.constructor.name}`); } const eventData = this._events.get(entry.name); if (!eventData) { throw new Error(`Event ${entry.name} is not a registered as subscribable`); } for (let [link, subscription] of eventData.subscriptions) { if ((link.connector as WebSocketBaseConnector).closing) { eventData.subscriptions.delete(link); } else if (subscription.all) { link.send(event); } } } /** * Handle incoming event subscription requests * @param event - incomming event. * @param src - Source address of incomming request. * @param dst - destination address of incomming request. * @returns Response to subscription request. * @internal */ async _handleRequest(event: SubscriptionRequest, src: Address, dst: Address) { if (!Link._eventsByName.has(event.eventName)) { throw new Error(`Event ${event.eventName} is not a registered event`); } const eventData = this._events.get(event.eventName); if (!eventData) { throw new Error(`Event ${event.eventName} is not a registered as subscribable`); } let eventReplay: Event | null = null; const link: Link = this.controller.wsServer.controlConnections.get(src.id); if (event.subscribe === false) { let onceClose = eventData.subscriptions.get(link)?.onceClose; if (onceClose) { link.connector.off("close", onceClose); eventData.subscriptions.delete(link); } } else { if (eventData.subscriptionUpdate) { eventReplay = await eventData.subscriptionUpdate(event, src, dst); } let onceClose = eventData.subscriptions.get(link)?.onceClose; if (!onceClose) { onceClose = () => eventData.subscriptions.delete(link); link.connector.once("close", onceClose); } eventData.subscriptions.set( link, { all: event.subscribe, onceClose: onceClose }, ); } return new SubscriptionResponse(eventReplay); } } /** * A class component to allow subscribing and unsubscribing to/from an event * Multiple handlers can be subscribed at the same time */ export class EventSubscriber, V=T> { _callbacks = new Array>(); lastResponse: Event | null = null; lastResponseTime = -1; control?: Link; constructor( private event: EventClass, private prehandler?: (e: T) => V, control?: Link ) { const entry = Link._eventsByClass.get(this.event); if (!entry) { throw new Error(`Unregistered Event class ${this.event.name}`); } if (control) { this.connectControl(control); } } /** * Handle incoming events and distribute it to the correct callbacks * @param response - event from subscribed resource * @internal */ async _handle(response: Event) { this.lastResponse = response; this.lastResponseTime = Date.now(); const value = this.prehandler ? this.prehandler(response as T) : response as any; for (let callback of this._callbacks) { callback(value); } } /** * If a control link was not connected at creation, it can be connected * here (normally during onControllerConnectionEvent) * @param control - Control link to associate with. */ async connectControl(control: Link) { if (this.control === control) { return; } this.control = control; this.control.handle(this.event, this._handle.bind(this)); await this._updateSubscription(); } /** * Subscribe to receive all event notifications * @param handler - * callback invoked whenever the subscribed resource changes. */ async subscribe(handler: EventSubscriberCallback) { this._callbacks.push(handler); await this._updateSubscription(); } /** * Unsubscribe from receiving all event notifications, does not effect * the subscriptions of other handlers. * * @param handler - A callback previously passed to {@link subscribe} * * @throws {Error} * If your handler is not subscribed, does not accept anonymous * functions */ async unsubscribe(handler: EventSubscriberCallback) { let index = this._callbacks.lastIndexOf(handler); if (index === -1) { throw new Error("handler is not registered"); } this._callbacks.splice(index, 1); await this._updateSubscription(); } /** * Update the subscription with the controller based on current handler counts */ async _updateSubscription() { if (!this.control || !(this.control.connector as WebSocketClientConnector).connected) { return; } const entry = Link._eventsByClass.get(this.event)!; const response = await this.control.send(new SubscriptionRequest( entry.name, this._callbacks.length > 0, this.lastResponseTime )); if (response.eventReplay) { await this._handle(response.eventReplay as any); } } }