import { Type, Static } from "@sinclair/typebox"; import { Link, Event, EventClass, RequestHandler, WebSocketClientConnector, WebSocketBaseConnector } from "./link"; import { Address, MessageRequest } from "./data"; import { User } from "./users"; export type SubscriptionChannelCategoriser = (event: T) => string | number; 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 */ 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]; } else { 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 * allChannels: false, channels: [] will unsubscribe the subscriber from being sent any events */ export class SubscriptionRequest { declare ["constructor"]: typeof SubscriptionRequest; static type = "request" as const; static src = ["control", "instance"] as const; static dst = "controller" as const; static plugin = "exp_commands" as const; static Response = SubscriptionResponse; static permission(user: User, 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 allChannels: boolean, public channels: Array = [], 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.Array(Type.Union([Type.String(), Type.Number()])), Type.Number(), ]) toJSON() { return [this.eventName, this.allChannels, this.channels, this.lastRequestTime]; } static fromJSON(json: Static): SubscriptionRequest { return new this(...json); } } /** * A class component to handle incoming subscription requests and offers a method to broadcast to subscribers * After creation, no other handler can be registered for SubscriptionRequest */ export class SubscriptionController { _events = new Map, channelCategoriser?: SubscriptionChannelCategoriser, subscriptions: 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 any client updates their subscription */ handle(Event: EventClass, channelCategoriser?: SubscriptionChannelCategoriser, subscriptionUpdate?: SubscriptionRequestHandler,): void; handle( Event: EventClass, channelCategoriser?: SubscriptionChannelCategoriser, 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, channelCategoriser: channelCategoriser, subscriptions: new Map(), }); } /** * Broadcast an event to all subscribers of that event, will be filtered by channels when relevant */ broadcast(event: Event): void; 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`); } const channel = eventData.channelCategoriser ? eventData.channelCategoriser(event) : null; for (let [link, subscription] of eventData.subscriptions) { if ((link.connector as WebSocketBaseConnector).closing) { eventData.subscriptions.delete(link); } else if ((subscription.all || (channel && subscription.channels.includes(channel)))) { link.send(event); } } } 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`); } const eventReplay = eventData.subscriptionUpdate ? await eventData.subscriptionUpdate(event, src, dst) : null; const link: Link = this.controller.wsServer.controlConnections.get(src.id); if (event.allChannels === false && event.channels.length === 0) { eventData.subscriptions.delete(link); return new SubscriptionResponse(eventReplay); } else { if (!eventData.subscriptions.has(link)) { link.connector.once("close", () => { eventData.subscriptions.delete(link); }) } eventData.subscriptions.set(link, { all: event.allChannels, channels: event.channels }); return new SubscriptionResponse(eventReplay); } } } /** * A class component to handle incoming subscription requests and offers a method to broadcast to subscribers * After creation, no other handler can be registered for SubscriptionRequest * An optional prehandler can be given to extract data from the event to be used by the subscribed handlers */ export class EventSubscriber { _callbacks = new Array>() _channelCallbacks = new Map>>() lastResponse: T | null = null; // Does not work with Event lastResponseTime = 0; control?: Link constructor( private event: EventClass, private prehandler?: (event: 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); } } async _handle(response: T) { this.lastResponse = response; this.lastResponseTime = Date.now(); if (this.prehandler) { for (let callback of this._callbacks) { callback(this.prehandler(response)); } } else { for (let callback of this._callbacks) { callback(response as any); // Default behaviour is to pass the event unchanged } } } connectControl(control: Link) { if (this.control === control) return Promise.resolve(); this.control = control; this.control.handle(this.event, this._handle.bind(this)); return this._updateSubscription(); } subscribe(handler: EventSubscriberCallback) { this._callbacks.push(handler); return this._updateSubscription(); } subscribeToChannel(channel: string | number, handler: EventSubscriberCallback) { if (!this._channelCallbacks.get(channel)) { this._channelCallbacks.set(channel, []); } this._channelCallbacks.get(channel)!.push(handler); return this._updateSubscription(); } unsubscribe(handler: EventSubscriberCallback) { let index = this._callbacks.lastIndexOf(handler); if (index === -1) { throw new Error("handler is not registered"); } this._callbacks.splice(index, 1); return this._updateSubscription(); } unsubscribeFromChannel(channel: string | number, handler: EventSubscriberCallback) { const channelCallbacks = this._channelCallbacks.get(channel); if (!channelCallbacks) { throw new Error("handler is not registered"); } let index = channelCallbacks.lastIndexOf(handler); if (index === -1) { throw new Error("handler is not registered"); } if (channelCallbacks.length === 1) { this._channelCallbacks.delete(channel); } else { channelCallbacks.splice(index, 1); } return this._updateSubscription(); } 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._channelCallbacks.keys()], this.lastResponseTime )); if (response.eventReplay) { this._handle(response.eventReplay as T); } } }