@finsemble/finsemble-ui 7.2.1 → 8.0.0-beta.1

package/common/events/PrivateEventManager.js

@@ -0,0 +1,286 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _EventManager_unsubscribeWindowClosings;
+import { RouterClient } from "../../clients/routerClient";
+import { Logger } from "../../clients/logger";
+import PublicEventManager from "./PublicEventManager";
+import FinsembleEvent from "./PrivateFinsembleEvent";
+import { sleep } from "../util";
+import { LAUNCHER_SERVICE } from "../../common/constants";
+/**
+ * This private Event Manager distributes events to remove event handlers (using the router).
+ * It is used within the windowService and workspaceService. Clients use the PublicEventManager
+ * in order to register and unregister handlers.
+ *
+ * The primary use is for FinsembleWindow events. FinsembleWindow is derived from PublicEventManager.
+ *
+ * The windowService will create multiple PrivateEventManagers, generally one per live window. Each
+ * PrivateEventManager maintains its own private store of remote event handlers. Note that event handlers
+ * may exist across multiple windows. For instance, a window called "Bobby" may want to know when another
+ * window called "Gary" closes. When Bobby registers an event handler ("tell me when Gary closes") then
+ * Gary's PrivateEventManager will gain a handler, which is associated with Bobby.
+ *
+ * In the above scenario, if Bobby (client) closes then Gary's PrivateEventManager will remove all references
+ * to remote event handlers. But, if Gary closes then Bobby's references will become orphans - never triggered,
+ * which is probably fine for most application logic.
+ *
+ * For more information on the distrubted event architecture - see https://miro.com/app/board/o9J_kwhN9zo=/
+ *
+ * Note, this class can also be used as a *local* event manager with the functions.
+ */
+class EventManager extends PublicEventManager {
+    /**
+     *Creates an instance of EventManager.
+     * @param {*} params
+     * @memberof EventManager
+     */
+    constructor(params) {
+        super(params);
+        /**
+         * Listens for [graceful] window closings and then removes event listeners associated with the closed window
+         */
+        _EventManager_unsubscribeWindowClosings.set(this, void 0);
+        this.eventList = [];
+        this.eventInternalHandlerMap = {};
+        this.remoteListenerEventMap = {};
+        this.windowToGuidsMap = {};
+        this.waitList = {};
+        this.unsubscribes = [];
+        // listen for remote events registering
+        this.unsubscribes.push(RouterClient.addListener(`Finsemble.RegisterInterruptibleEvent.${this.name}`, (err, response) => {
+            this.registerRemoteEventHandler(response.data.event, response.data.listenerGuid, response.data.windowName);
+        }));
+        //listen for remote events unregistering
+        this.unsubscribes.push(RouterClient.addListener(`Finsemble.UnregisterInterruptibleEvent.${this.name}`, (err, response) => {
+            this.unregisterRemoteEventHandler(response.data.event, response.data.listenerGuid, response.data.windowName);
+        }));
+        /**
+         * Listen on Finsemble's global window closed pubsub. When a window is closed all local listeners are removed.
+         */
+        __classPrivateFieldSet(this, _EventManager_unsubscribeWindowClosings, RouterClient.addListener(LAUNCHER_SERVICE.WINDOW_CLOSED, (err, response) => {
+            if (err) {
+                Logger.system.error(`PrivateEventManager: Error listening for ${LAUNCHER_SERVICE.WINDOW_CLOSED}: ${err}`);
+            }
+            else {
+                const { name } = response.data;
+                this.removeWindow(name);
+            }
+        }), "f");
+    }
+    /**
+     * Removes all listeners associated with a window [that has closed]
+     */
+    removeWindow(listeningWindow) {
+        var _a;
+        ((_a = this.windowToGuidsMap[listeningWindow]) !== null && _a !== void 0 ? _a : []).forEach((listenerGuid) => {
+            this.removeGuid(listenerGuid);
+        });
+        delete this.windowToGuidsMap[listeningWindow];
+    }
+    /**
+     * Removes all listeners for a specific remote guid
+     */
+    removeGuid(listenerGuid) {
+        const events = Object.keys(this.remoteListenerEventMap);
+        events.forEach((event) => {
+            this.remoteListenerEventMap[event] = this.remoteListenerEventMap[event].filter((oldGuid) => oldGuid !== listenerGuid);
+        });
+    }
+    /**
+     * Adds an individual remote listener (listenerGuid+event) to this event manager
+     */
+    registerRemoteEventHandler(event, listenerGuid, listenerWindow) {
+        var _a;
+        if (!this.remoteListenerEventMap[event])
+            this.remoteListenerEventMap[event] = [];
+        this.remoteListenerEventMap[event].push(listenerGuid);
+        this.windowToGuidsMap[listenerWindow] = [listenerGuid].concat((_a = this.windowToGuidsMap[listenerWindow]) !== null && _a !== void 0 ? _a : []);
+    }
+    /**
+     * Removes an individual remote listener (listenerGuid+event) from this event manager
+     */
+    unregisterRemoteEventHandler(event, listenerGuid, listenerWindow) {
+        var _a;
+        if (this.remoteListenerEventMap[event]) {
+            // Remove the remote listener
+            this.remoteListenerEventMap[event] = this.remoteListenerEventMap[event].filter((g) => g !== listenerGuid);
+            // Remove from the window map. Delete the window map if there are no more listeners.
+            this.windowToGuidsMap[listenerWindow] = ((_a = this.windowToGuidsMap[listenerWindow]) !== null && _a !== void 0 ? _a : []).filter((g) => g !== listenerGuid);
+            if (this.windowToGuidsMap[listenerWindow].length === 0)
+                delete this.windowToGuidsMap[listenerWindow];
+        }
+        else if (this.windowToGuidsMap[listenerWindow]) {
+            // if window is still open
+            // Straggling unregister requests may trickle in after a window is closed, but if the window is still open then something has probably gone wrong.
+            Logger.system.warn(`PrivateEventManager.unregisterListener() attempt to remove unregistered event "${event}" for window ${listenerWindow}`);
+        }
+    }
+    /**
+     * We must wait for a remote transit if delayed
+     *
+     * @memberof EventManager
+     */
+    awaitRemoteDelayer(eventGuid, listenerGuid) {
+        const awaitRemoteDelayerPromiseResolver = (resolve, reject) => {
+            const listener = (err, response) => {
+                RouterClient.removeListener(`Finsemble.Listener.Done.${eventGuid}.${listenerGuid}`, listener);
+                if (response.data.canceled === true) {
+                    reject("canceled");
+                }
+                else {
+                    resolve(response.data.data);
+                }
+            };
+            this.waitList[eventGuid] = listener;
+            RouterClient.addListener(`Finsemble.Listener.Done.${eventGuid}.${listenerGuid}`, listener);
+        };
+        return new Promise(awaitRemoteDelayerPromiseResolver);
+    }
+    /**
+     * Sends a message to a remote listener (PublicEventManager) which will then emit a local Finsemble event.
+     *
+     * Called by this.trigger().
+     */
+    async queryRemoteListener(event, listenerGuid, data, options) {
+        // This needs to get added first, otherwise the event can be done before the listener is created; only do this for delayable events.
+        const eventGuid = `${this.name}_private_${Date.now()}_${Math.random()}`;
+        const eventData = {
+            event,
+            guid: eventGuid,
+            data,
+        };
+        const delayListener = this.awaitRemoteDelayer(eventGuid, listenerGuid);
+        // 1 second to respond to initial query - if this doesn't happen, the window that has the listener is likely crashed or uncleanly closed
+        // We send the query without a timeout because there's a race condition. This interrupt may be delivered just as the
+        // app is shutting down, in which case there will be no responder available to process this event.
+        const { err, response } = await Promise.race([
+            RouterClient.query(`Finsemble.Interrupt.${listenerGuid}`, eventData, { timeout: 0, logWhenNoResponder: false }, () => { }),
+            sleep(options.initialQueryTimeout, true),
+        ]).catch(() => {
+            // sleep throws an exception
+            RouterClient.removeListener(`Finsemble.Listener.Done.${eventGuid}.${listenerGuid}`, this.waitList[eventGuid]);
+            throw "eventHandler failed initial response";
+        });
+        if (err || !response.data)
+            return;
+        let needToRemoveListener = true;
+        if (response.data.delayed === true) {
+            try {
+                needToRemoveListener = false;
+                // must respond within timeout seconds
+                return await Promise.race([delayListener, sleep(options.timeout, true)]);
+            }
+            catch (e) {
+                // sleep throws an exception
+                if (e !== "timeout expired") {
+                    throw "event was canceled";
+                }
+                else {
+                    needToRemoveListener = true;
+                }
+            }
+        }
+        if (needToRemoveListener) {
+            RouterClient.removeListener(`Finsemble.Listener.Done.${eventGuid}.${listenerGuid}`, this.waitList[eventGuid]);
+        }
+        if (response.data.canceled === true) {
+            throw "event was canceled";
+        }
+        return response.data.data;
+    }
+    /**
+     * Forwards an event to all remote listeners and then waits for them to respond.
+     * They may optionally interrupt the event by sending a "cancel" which results in FinsembleEvent throwing
+     * an exception. Any individual exception will cause this function to also throw an exception, thus
+     * interrupting the event (which occurs upstream, e.g. preventing a window from closing).
+     */
+    async trigger(event, data = null, options = { initialQueryTimeout: 1000, timeout: 10000 }) {
+        Logger.verbose(`Triggering ${event} for ${this.name}`, data);
+        const listenerList = [];
+        // If a tree falls in the forest and nobody is listening, does it matter?
+        if (this.remoteListenerEventMap[event]) {
+            // send a query all remote listeners
+            for (let listenerGuid of this.remoteListenerEventMap[event]) {
+                listenerList.push(this.queryRemoteListener(event, listenerGuid, data, options));
+            }
+        }
+        // Send the event to each registered handler
+        const handlers = this.handlers.filter((entry) => entry.event === event);
+        handlers.forEach((entry) => {
+            const finsembleEvent = new FinsembleEvent({
+                source: this.name,
+                sourceType: this.sourceType,
+                handler: entry.handler,
+                event,
+                data,
+                guid: entry.listenerGuid,
+            });
+            listenerList.push(finsembleEvent.complete);
+        });
+        try {
+            return await Promise.all(listenerList);
+        }
+        catch (err) {
+            if (err === "eventHandler failed initial response") {
+                console.debug(`No response for interupt on event ${event}. Window is probably already closed.`);
+            }
+            else {
+                throw "event was canceled";
+            }
+        }
+    }
+    /**
+     * Adds a *local* event listener.
+     */
+    addEventListener(event, handler) {
+        Logger.system.debug("PrivateEventManager.addEventListener:", event);
+        const listenerGuid = `${this.name}_public_${Date.now()}_${Math.random()}`;
+        this.handlers.push({
+            event,
+            handler,
+            listenerGuid,
+        });
+        return () => {
+            this.removeEventListener(event, handler);
+        };
+    }
+    /**
+     * Removes a *local* event listener.
+     */
+    removeEventListener(event, handler) {
+        Logger.system.debug("PrivateEventManager.removeEventListener:", event);
+        // Find the first entry that matches - noting that there could be multiple entries for the same handler
+        // and this legacy interface provides no disambiguation via listenerGuid
+        const index = this.handlers.findIndex((entry) => entry.event === event && entry.handler === handler);
+        if (index == -1) {
+            Logger.system.warn(`PrivateEventManager.removeEventListener() attempt to remove unregistered event "${event}"`);
+            return;
+        }
+        this.handlers.splice(index, 1);
+    }
+    /**
+     * Removes all router listeners and subscriptions. This is called when the windowService terminates this
+     * PrivateEventManager (e.g. because the window has closed).
+     */
+    cleanup() {
+        if (__classPrivateFieldGet(this, _EventManager_unsubscribeWindowClosings, "f"))
+            __classPrivateFieldGet(this, _EventManager_unsubscribeWindowClosings, "f").call(this);
+        // Close the router listeners that were opened in the constructor
+        this.unsubscribes.forEach((unsubscribe) => {
+            unsubscribe();
+        });
+        this.unsubscribes = [];
+    }
+}
+_EventManager_unsubscribeWindowClosings = new WeakMap();
+export default EventManager;
+//# sourceMappingURL=PrivateEventManager.js.map

package/common/events/PrivateEventManager.js.map

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

package/common/events/PrivateFinsembleEvent.d.ts

@@ -0,0 +1,30 @@
+declare class PrivateFinsembleEvent {
+    private event;
+    private source;
+    private sourceType;
+    private handler;
+    private allowDelay;
+    private delayed;
+    private allowCancel;
+    private canceled;
+    private completed;
+    private guid;
+    data: any;
+    complete: Promise<void>;
+    private eventComplete;
+    private eventCanceled;
+    constructor(params: {
+        event: string;
+        source: string;
+        sourceType: string;
+        data: any;
+        guid: string;
+        handler: Function;
+    });
+    private internalHandler;
+    cancel(): void;
+    wait(): void;
+    done(data?: any): void;
+}
+export default PrivateFinsembleEvent;
+//# sourceMappingURL=PrivateFinsembleEvent.d.ts.map

package/common/events/PrivateFinsembleEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrivateFinsembleEvent.d.ts","sourceRoot":"","sources":["../../../../src/common/events/PrivateFinsembleEvent.ts"],"names":[],"mappings":"AAEA,cAAM,qBAAqB;IAC1B,OAAO,CAAC,KAAK,CAAS;IAEtB,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,OAAO,CAAW;IAE1B,OAAO,CAAC,UAAU,CAAkB;IAEpC,OAAO,CAAC,OAAO,CAAkB;IAEjC,OAAO,CAAC,WAAW,CAAkB;IAErC,OAAO,CAAC,QAAQ,CAAkB;IAElC,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO,CAAC,IAAI,CAAS;IAEd,IAAI,EAAE,GAAG,CAAC;IAEV,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,OAAO,CAAC,aAAa,CAAuB;IAE5C,OAAO,CAAC,aAAa,CAAuB;gBAEhC,MAAM,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,QAAQ,CAAC;KAClB;YA2Ba,eAAe;IAO7B,MAAM,IAAI,IAAI;IAOd,IAAI,IAAI,IAAI;IAQZ,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAYtB;AAED,eAAe,qBAAqB,CAAC"}

package/common/events/PrivateFinsembleEvent.js

@@ -0,0 +1,65 @@
+import * as Constants from "../constants";
+class PrivateFinsembleEvent {
+    constructor(params) {
+        this.allowDelay = false;
+        this.delayed = false;
+        this.allowCancel = false;
+        this.canceled = false;
+        this.completed = false;
+        this.event = params.event;
+        this.source = params.source;
+        this.sourceType = params.sourceType;
+        this.data = params.data;
+        this.guid = params.guid;
+        if (Constants[this.sourceType.toUpperCase()] &&
+            Constants[this.sourceType.toUpperCase()].DELAYABLE_EVENTS.includes(this.event)) {
+            this.allowDelay = true;
+        }
+        if (Constants[this.sourceType.toUpperCase()] &&
+            Constants[this.sourceType.toUpperCase()].CANCELABLE_EVENTS.includes(this.event)) {
+            this.allowCancel = true;
+        }
+        this.handler = params.handler;
+        this.complete = new Promise((resolve, reject) => {
+            this.eventCanceled = reject;
+            this.eventComplete = resolve;
+        });
+        this.internalHandler();
+    }
+    async internalHandler() {
+        if (this.handler)
+            await this.handler(this);
+        if (!(this.delayed || this.canceled || this.completed)) {
+            this.done();
+        }
+    }
+    cancel() {
+        if (this.allowCancel) {
+            this.canceled = true;
+            this.done();
+        }
+    }
+    wait() {
+        if (this.allowDelay) {
+            this.delayed = true;
+        }
+        else {
+            this.done();
+        }
+    }
+    done(data) {
+        this.completed = true;
+        if (this.canceled) {
+            if (!!this.eventCanceled) {
+                this.eventCanceled();
+            }
+        }
+        else {
+            if (!!this.eventComplete) {
+                this.eventComplete(data);
+            }
+        }
+    }
+}
+export default PrivateFinsembleEvent;
+//# sourceMappingURL=PrivateFinsembleEvent.js.map

package/common/events/PrivateFinsembleEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrivateFinsembleEvent.js","sourceRoot":"","sources":["../../../../src/common/events/PrivateFinsembleEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAE1C,MAAM,qBAAqB;IA6B1B,YAAY,MAOX;QA3BO,eAAU,GAAY,KAAK,CAAC;QAE5B,YAAO,GAAY,KAAK,CAAC;QAEzB,gBAAW,GAAY,KAAK,CAAC;QAE7B,aAAQ,GAAY,KAAK,CAAC;QAE1B,cAAS,GAAY,KAAK,CAAC;QAoBlC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAExB,IACC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAC7E;YACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;SACvB;QACD,IACC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAC9E;YACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;SACxB;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC/C,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;YAC5B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,eAAe;QAC5B,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE;YACvD,IAAI,CAAC,IAAI,EAAE,CAAC;SACZ;IACF,CAAC;IAED,MAAM;QACL,IAAI,IAAI,CAAC,WAAW,EAAE;YACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,IAAI,EAAE,CAAC;SACZ;IACF,CAAC;IAED,IAAI;QACH,IAAI,IAAI,CAAC,UAAU,EAAE;YACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;SACpB;aAAM;YACN,IAAI,CAAC,IAAI,EAAE,CAAC;SACZ;IACF,CAAC;IAED,IAAI,CAAC,IAAU;QACd,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC,QAAQ,EAAE;YAClB,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE;gBACzB,IAAI,CAAC,aAAa,EAAE,CAAC;aACrB;SACD;aAAM;YACN,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE;gBACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;aACzB;SACD;IACF,CAAC;CACD;AAED,eAAe,qBAAqB,CAAC"}

package/common/events/PublicEventManager.d.ts

@@ -0,0 +1,59 @@
+export declare type Unsubscriber = () => void;
+declare class EventManager {
+    eventList: string[];
+    cleanedUp: boolean;
+    name: string;
+    thisWindowName: string;
+    sourceType: string;
+    openResponders: string[];
+    handlers: {
+        event: string;
+        handler: Function;
+        listenerGuid: string;
+    }[];
+    constructor(params: {
+        name: string;
+        sourceType?: string;
+    });
+    /**
+     * @private
+     * @param event
+     * @param handler
+     */
+    addListener(event: string, handler: Function): Unsubscriber;
+    /**
+     * @private
+     * @param event
+     * @param handler
+     */
+    removeListener(event: string, handler: Function): void;
+    /**
+     * Duplicate entries with the same handler are okay but will result in the function being called twice.
+     * @param {string} event
+     * @param {Function} handler
+     * @memberof EventManager
+     */
+    addEventListener(event: string, handler: Function): Unsubscriber;
+    /**
+     * Removes an event listener added by addEventListener
+     *
+     * @deprecated Please use the Unsubscriber returned from addEventListener() instead.
+     *
+     * @param {string} event An event that was used with addEventListener to add a listener
+     * @param {FinsembleEventHandler} handler The handler that was used with addEventListener for the event
+     * @param {boolean} logWarning [true] If set to false then no warning will be logged if the handler isn't
+     * found. This is generally a bad idea, so don't use it unless absolutely forced to. Currently "title-changed"
+     * has an impossible problem.
+     */
+    removeEventListener(event: string, handler: Function, logWarning?: boolean): void;
+    /**
+     * @private
+     * cleanup is called as part of the "unload" event. The browser provides very little time
+     * to perform cleanup before terminating an app, so we must send a single message and hope
+     * that it gets through. This should at some point be moved to a single, server-side cleanup
+     * facility.
+     */
+    cleanup(): void;
+}
+export default EventManager;
+//# sourceMappingURL=PublicEventManager.d.ts.map

package/common/events/PublicEventManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicEventManager.d.ts","sourceRoot":"","sources":["../../../../src/common/events/PublicEventManager.ts"],"names":[],"mappings":"AAIA,oBAAY,YAAY,GAAG,MAAM,IAAI,CAAC;AACtC,cAAM,YAAY;IACjB,SAAS,EAAE,MAAM,EAAE,CAAM;IAGzB,SAAS,EAAE,OAAO,CAAS;IAE3B,IAAI,EAAE,MAAM,CAAC;IAEb,cAAc,EAAE,MAAM,CAAC;IAEvB,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc,EAAE,MAAM,EAAE,CAAM;IAE9B,QAAQ,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,QAAQ,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACrB,EAAE,CAAM;gBAEG,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAUzD;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,YAAY;IAI3D;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAItD;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,YAAY;IAyChE;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,GAAE,OAAc,GAAG,IAAI;IA4BvF;;;;;;OAMG;IACH,OAAO,IAAI,IAAI;CAQf;AAED,eAAe,YAAY,CAAC"}

package/common/events/PublicEventManager.js

@@ -0,0 +1,124 @@
+import { RouterClient } from "../../clients/routerClient";
+import { Logger } from "../../clients/logger";
+import FinsembleEvent from "./FinsembleEvent";
+class EventManager {
+    constructor(params) {
+        var _a;
+        this.eventList = [];
+        // This flag is flipped to true when cleanup() is called to prevent spurious errors
+        this.cleanedUp = false;
+        this.openResponders = [];
+        this.handlers = [];
+        this.name = params.name;
+        this.thisWindowName = window.name;
+        this.sourceType = (_a = params.sourceType) !== null && _a !== void 0 ? _a : "undefined";
+        // Note: "beforeunload" is not 100% reliable if a window crashes or is killed by the operating system
+        window.addEventListener("beforeunload", () => {
+            this.cleanup();
+        });
+    }
+    /**
+     * @private
+     * @param event
+     * @param handler
+     */
+    addListener(event, handler) {
+        return this.addEventListener(event, handler);
+    }
+    /**
+     * @private
+     * @param event
+     * @param handler
+     */
+    removeListener(event, handler) {
+        return this.removeEventListener(event, handler);
+    }
+    /**
+     * Duplicate entries with the same handler are okay but will result in the function being called twice.
+     * @param {string} event
+     * @param {Function} handler
+     * @memberof EventManager
+     */
+    addEventListener(event, handler) {
+        Logger.system.debug("PublicEventmanager.addEventListener:", event);
+        const listenerGuid = `${this.name}_public_${Date.now()}_${Math.random()}`;
+        this.handlers.push({
+            event,
+            handler,
+            listenerGuid,
+        });
+        // Registers an event handler with the private event manager
+        RouterClient.transmit(`Finsemble.RegisterInterruptibleEvent.${this.name}`, {
+            event,
+            listenerGuid,
+            windowName: this.thisWindowName,
+        });
+        const responderName = `Finsemble.Interrupt.${listenerGuid}`;
+        // Add a responder for when an event is triggered by the private event manager
+        RouterClient.addResponder(responderName, (err, queryMessage) => {
+            new FinsembleEvent({
+                source: this.name,
+                sourceType: this.sourceType,
+                listenerGuid,
+                handler,
+                event,
+            }, queryMessage);
+        });
+        this.openResponders.push(responderName);
+        // Return an automatic unsubscriber
+        return () => {
+            this.removeEventListener(event, handler);
+        };
+    }
+    /**
+     * Removes an event listener added by addEventListener
+     *
+     * @deprecated Please use the Unsubscriber returned from addEventListener() instead.
+     *
+     * @param {string} event An event that was used with addEventListener to add a listener
+     * @param {FinsembleEventHandler} handler The handler that was used with addEventListener for the event
+     * @param {boolean} logWarning [true] If set to false then no warning will be logged if the handler isn't
+     * found. This is generally a bad idea, so don't use it unless absolutely forced to. Currently "title-changed"
+     * has an impossible problem.
+     */
+    removeEventListener(event, handler, logWarning = true) {
+        Logger.system.debug("PublicEventManager.removeEventListener:", event);
+        // If cleanup() was already called then all handlers have already been removed
+        // This prevents spurious warnings from any stray cleanup code
+        if (this.cleanedUp)
+            return;
+        // Find the first entry that matches - noting that there could be multiple entries for the same handler
+        // and this legacy interface provides no disambiguation via listenerGuid
+        const index = this.handlers.findIndex((entry) => entry.event === event && entry.handler === handler);
+        if (index === -1) {
+            if (logWarning)
+                Logger.system.warn(`PublicEventManager.removeEventListener() attempt to remove unregistered event "${event}"`);
+            return;
+        }
+        const { listenerGuid } = this.handlers[index];
+        RouterClient.transmit(`Finsemble.UnregisterInterruptibleEvent.${this.name}`, {
+            event,
+            listenerGuid,
+            windowName: this.thisWindowName,
+        });
+        RouterClient.removeResponder(`Finsemble.Interrupt.${listenerGuid}`);
+        this.handlers.splice(index, 1);
+    }
+    /**
+     * @private
+     * cleanup is called as part of the "unload" event. The browser provides very little time
+     * to perform cleanup before terminating an app, so we must send a single message and hope
+     * that it gets through. This should at some point be moved to a single, server-side cleanup
+     * facility.
+     */
+    cleanup() {
+        this.cleanedUp = true;
+        this.handlers = [];
+        // Close all the responders that we opened (one for each event that were listened on).
+        this.openResponders.forEach((responderName) => {
+            RouterClient.removeResponder(responderName);
+        });
+    }
+}
+export default EventManager;
+//# sourceMappingURL=PublicEventManager.js.map

package/common/events/PublicEventManager.js.map

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

package/common/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./Globals";
+export * as REST from "./REST";
+export * as Desktop from "./Desktop";
+//# sourceMappingURL=index.d.ts.map

package/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}

package/common/index.js

@@ -0,0 +1,6 @@
+export * from "./Globals";
+import * as REST_1 from "./REST";
+export { REST_1 as REST };
+import * as Desktop_1 from "./Desktop";
+export { Desktop_1 as Desktop };
+//# sourceMappingURL=index.js.map

package/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;wBACJ,QAAQ;mBAAlB,IAAI;2BACS,WAAW;sBAAxB,OAAO"}

package/common/redux/actionIdMapper.d.ts

@@ -0,0 +1,33 @@
+/**
+ * This module can be used to map an "action id" back to a promise resolution. It is useful when a query/response
+ * mechanism needs to know when a dispatch action has completed.
+ */
+import { ActionId, ActionResult } from "./types";
+export declare let actionPromiseMap: Record<string, Function>;
+export declare let actionResultMap: Record<string, ActionResult>;
+/**
+ * Create an action Identifier with unique id and type
+ *
+ * @param {string} type the type of the action (e.g. InteropRaiseIntent["type"])
+ * @returns {ActionId}
+ */
+export declare const actionIdentifier: (type: string) => ActionId;
+/**
+ * Returns promise for an action result -- dovetails with setActionResult()
+ *
+ * NOTE: the use case justifies supporting only one client per actionId; if multiple clients were needed then need an array of promises
+ *
+ * @param {ActionId} actionId the action id that was input to the action dispatch()
+ * @returns {Promise<ActionResult>}
+ */
+export declare const actionResult: (actionId: ActionId) => Promise<ActionResult>;
+/**
+ * Sets action result and resolves any pending promise waiting on the result -- dovetails with actionResult()
+ *
+ * NOTE: the use case justifies supporting only one client per actionId; if multiple clients were needed then need an array of promises
+ *
+ * @param {ActionId} actionId identifies the result being set
+ * @param {ActionResult} aResult the result being set; actionId.type must match aResult.type (if used property it will)
+ */
+export declare const setActionResult: (actionId: ActionId, aResult: ActionResult) => void;
+//# sourceMappingURL=actionIdMapper.d.ts.map