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

package/platform/services/Interop/modules/authorize.d.ts

@@ -0,0 +1,63 @@
+/***
+ * This file contains general logic for assessing authorization as part of FDC3 interop.
+ *
+ * For example, if App A broadcasts a context, but App A has authorization rules that only trust App B,
+ * App A's context should only make it to App B. This file provides the logic to process those authorization rules.
+ *
+ *
+ * * Authorization rules require that a specific contextType is provided in each rule. ContextType should be optional (KB: #35932)
+ * * Consider slimming down these functions. There is a lot of potential DRY violations here that could be reduced.
+ */
+import { InteropStore, SelectConnectAppList } from "../types";
+export declare const isInteropAuthorized: (appName: string, rules: SelectConnectAppList[]) => boolean;
+declare type FilterForClientAuthorizationProps = {
+    state: InteropStore;
+    originClientUuid: string;
+    destinationClientUuidList: string[];
+    contextType?: string;
+    intentType?: string;
+};
+/***
+ * When sending data (usually broadcasting context) from an origin client to a list of possible destination clients,
+ * the list of possible destinations need to be filtered based on possible authorization rules.
+ * This function takes metadata and a list of possible destination UUID's, and returns a filtered version of that list,
+ * where the unauthorized destinations have been removed.
+ * Note: This is only for clients, which have UUIDs. For apps generally, see the function `filterForAppAuthorization`.
+ *
+ * @param {Object} options
+ * @param {InteropStore} options.state The current InteropStore state collection (which contains authorization rules)
+ * @param {String[]} options.destinationClientUuidList The list of the UUID's of the possible destinations
+ * @param {String} options.originClientUuid The UUID of the origin client
+ * @param {String} [options.contextType] The type of context to be assessed for
+ * @param {String} [options.intentType] The type of intent to be assessed for
+ *
+ * @returns {String[]} The list of the UUID's of the *filtered* destinations
+ */
+export declare const filterForClientAuthorization: ({ state, destinationClientUuidList, originClientUuid, contextType, intentType, }: FilterForClientAuthorizationProps) => string[];
+declare type FilterForAppAuthorizationProps = {
+    state: InteropStore;
+    originClientUuid: string;
+    destinationAppIdList: string[];
+    contextType?: string;
+    intentType?: string;
+};
+/***
+ * When sending data (usually raising intents) from an origin client to a list of possible destination apps,
+ * the list of possible destinations need to be filtered based on possible authorization rules.
+ * This function takes metadata and a list of possible appId's, and returns a filtered version of that list,
+ * where the unauthorized destinations have been removed.
+ * Note: This is only for apps, which have appId's. For sending data to specific clients,
+ * see the function `filterForClientAuthorization`.
+ *
+ * @param {Object} options
+ * @param {InteropStore} options.state The current InteropStore state collection (which contains authorization rules)
+ * @param {String[]} options.destinationAppIdList The list of the appId's of the possible destinations
+ * @param {String} options.originClientUuid The UUID of the origin client
+ * @param {String} [options.contextType] The type of context to be assessed for
+ * @param {String} [options.intentType] The type of intent to be assessed for
+ *
+ * @returns {String[]} The list of the UUID's of the *filtered* destinations
+ */
+export declare const filterForAppAuthorization: ({ state, destinationAppIdList, originClientUuid, contextType, intentType, }: FilterForAppAuthorizationProps) => String[];
+export {};
+//# sourceMappingURL=authorize.d.ts.map

package/platform/services/Interop/modules/authorize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorize.d.ts","sourceRoot":"","sources":["../../../../../../src/platform/services/Interop/modules/authorize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAqB,MAAM,UAAU,CAAC;AAOjF,eAAO,MAAM,mBAAmB,YAAa,MAAM,SAAS,oBAAoB,EAAE,YACtC,CAAC;AAoG7C,aAAK,iCAAiC,GAAG;IACxC,KAAK,EAAE,YAAY,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,4BAA4B,qFAMtC,iCAAiC,aAkBnC,CAAC;AAEF,aAAK,8BAA8B,GAAG;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,gFAMnC,8BAA8B,KAAG,MAAM,EAqBzC,CAAC"}

package/platform/services/Interop/modules/authorize.js

@@ -0,0 +1,132 @@
+/***
+ * This file contains general logic for assessing authorization as part of FDC3 interop.
+ *
+ * For example, if App A broadcasts a context, but App A has authorization rules that only trust App B,
+ * App A's context should only make it to App B. This file provides the logic to process those authorization rules.
+ *
+ *
+ * * Authorization rules require that a specific contextType is provided in each rule. ContextType should be optional (KB: #35932)
+ * * Consider slimming down these functions. There is a lot of potential DRY violations here that could be reduced.
+ */
+export const isInteropAuthorized = (appName, rules) => rules.some((rule) => rule.name === appName);
+const isRulesetRelevant = (ruleSet, limitOptions) => {
+    // If this rule is restricted by contextType, make sure the limitOptions are about the right contextType
+    if (ruleSet.contextType && !(limitOptions.contextType && ruleSet.contextType === limitOptions.contextType)) {
+        return false;
+    }
+    // If this rule is restricted by intentType, make sure the limitOptions are about the right intentType
+    return !(ruleSet.intentType && !(limitOptions.intentType && ruleSet.intentType === limitOptions.intentType));
+};
+// Build the limit options object, based on what information was provided when this function was invoked
+// For example, if a context was being broadcast, only rules related to context limits are relevant, so context limiters
+// are all that will be checked.
+const generateLimitOptions = (contextType, intentType) => {
+    return Object.assign(Object.assign({}, (contextType ? { contextType } : {})), (intentType ? { intentType } : {}));
+};
+const runChecks = (selectConnect, limitOptions, authorizationCheckCallback, isDestinationCheck, defaultValue) => {
+    // Find the relevant selectConnect rules
+    for (const ruleSet of selectConnect) {
+        // If this rule isn't about the right context or intent, skip it
+        if (!isRulesetRelevant(ruleSet, limitOptions)) {
+            continue;
+        }
+        const { authorize, to, from } = ruleSet;
+        if (isDestinationCheck) {
+            if (from) {
+                return authorizationCheckCallback(from);
+            }
+        }
+        else {
+            if (to) {
+                return authorizationCheckCallback(to);
+            }
+        }
+        if (authorize) {
+            return authorizationCheckCallback(authorize);
+        }
+    }
+    return defaultValue;
+};
+const filterForAuthorization = ({ idList, contextType, intentType, selectConnect, getRules, getAppName, appName, authenticated, checkDestinationAuthentication, }) => {
+    let returnList = idList;
+    // Determine what limit options apply
+    const limitOptions = generateLimitOptions(contextType, intentType);
+    // Filter the list of destinations. Remove destinations that don't trust the originating app
+    returnList = returnList.filter((uuid) => runChecks(getRules(uuid), limitOptions, (rule) => isInteropAuthorized(appName, rule) && authenticated, true, true));
+    // Filter the list of destinations. Remove destinations that the originating app doesn't trust
+    returnList = runChecks(selectConnect, limitOptions, (rule) => returnList.filter((app) => isInteropAuthorized(getAppName(app), rule) && checkDestinationAuthentication(app)), false, returnList);
+    return returnList;
+};
+/***
+ * When sending data (usually broadcasting context) from an origin client to a list of possible destination clients,
+ * the list of possible destinations need to be filtered based on possible authorization rules.
+ * This function takes metadata and a list of possible destination UUID's, and returns a filtered version of that list,
+ * where the unauthorized destinations have been removed.
+ * Note: This is only for clients, which have UUIDs. For apps generally, see the function `filterForAppAuthorization`.
+ *
+ * @param {Object} options
+ * @param {InteropStore} options.state The current InteropStore state collection (which contains authorization rules)
+ * @param {String[]} options.destinationClientUuidList The list of the UUID's of the possible destinations
+ * @param {String} options.originClientUuid The UUID of the origin client
+ * @param {String} [options.contextType] The type of context to be assessed for
+ * @param {String} [options.intentType] The type of intent to be assessed for
+ *
+ * @returns {String[]} The list of the UUID's of the *filtered* destinations
+ */
+export const filterForClientAuthorization = ({ state, destinationClientUuidList, originClientUuid, contextType, intentType, }) => {
+    var _a, _b, _c, _d;
+    const { appName, authenticated } = state.resolver.clients[originClientUuid];
+    const selectConnect = (_d = (_c = (_b = (_a = state.resolver.clients[originClientUuid]) === null || _a === void 0 ? void 0 : _a.config) === null || _b === void 0 ? void 0 : _b.interop) === null || _c === void 0 ? void 0 : _c.selectConnect) !== null && _d !== void 0 ? _d : [];
+    const getRules = (uuid) => { var _a, _b, _c; return (_c = (_b = (_a = state.resolver.clients[uuid].config) === null || _a === void 0 ? void 0 : _a.interop) === null || _b === void 0 ? void 0 : _b.selectConnect) !== null && _c !== void 0 ? _c : []; };
+    const getAppName = (app) => state.resolver.clients[app].appName;
+    const checkDestinationAuthentication = (uuid) => state.resolver.clients[uuid].authenticated;
+    return filterForAuthorization({
+        appName,
+        idList: destinationClientUuidList,
+        contextType,
+        intentType,
+        selectConnect,
+        getRules,
+        getAppName,
+        authenticated,
+        checkDestinationAuthentication,
+    });
+};
+/***
+ * When sending data (usually raising intents) from an origin client to a list of possible destination apps,
+ * the list of possible destinations need to be filtered based on possible authorization rules.
+ * This function takes metadata and a list of possible appId's, and returns a filtered version of that list,
+ * where the unauthorized destinations have been removed.
+ * Note: This is only for apps, which have appId's. For sending data to specific clients,
+ * see the function `filterForClientAuthorization`.
+ *
+ * @param {Object} options
+ * @param {InteropStore} options.state The current InteropStore state collection (which contains authorization rules)
+ * @param {String[]} options.destinationAppIdList The list of the appId's of the possible destinations
+ * @param {String} options.originClientUuid The UUID of the origin client
+ * @param {String} [options.contextType] The type of context to be assessed for
+ * @param {String} [options.intentType] The type of intent to be assessed for
+ *
+ * @returns {String[]} The list of the UUID's of the *filtered* destinations
+ */
+export const filterForAppAuthorization = ({ state, destinationAppIdList, originClientUuid, contextType, intentType, }) => {
+    var _a, _b, _c;
+    const { appName, authenticated } = state.resolver.clients[originClientUuid];
+    const selectConnect = (_c = (_b = (_a = state.resolver.clients[originClientUuid].config) === null || _a === void 0 ? void 0 : _a.interop) === null || _b === void 0 ? void 0 : _b.selectConnect) !== null && _c !== void 0 ? _c : [];
+    const getRules = (uuid) => { var _a, _b, _c, _d; return (_d = (_c = (_b = (_a = state.resolver.apps.definitions[uuid]) === null || _a === void 0 ? void 0 : _a.manifest) === null || _b === void 0 ? void 0 : _b.interop) === null || _c === void 0 ? void 0 : _c.selectConnect) !== null && _d !== void 0 ? _d : []; };
+    const getAppName = (app) => state.resolver.apps.definitions[app].name;
+    // When the destination is an app, not a client, authentication isn't relevant
+    const checkDestinationAuthentication = () => true;
+    return filterForAuthorization({
+        appName,
+        idList: destinationAppIdList,
+        contextType,
+        intentType,
+        selectConnect,
+        getRules,
+        getAppName,
+        authenticated,
+        checkDestinationAuthentication,
+    });
+};
+//# sourceMappingURL=authorize.js.map

package/platform/services/Interop/modules/authorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorize.js","sourceRoot":"","sources":["../../../../../../src/platform/services/Interop/modules/authorize.ts"],"names":[],"mappings":"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"}

package/platform/services/Interop/modules/commonUtils.d.ts

@@ -0,0 +1,34 @@
+/***
+ *
+ * This file contains utility and helper functions shared by Interop modules.
+ *
+ */
+import { InteropClient } from "../types";
+export declare const showLinkerWindowAtMouseEffect: () => void;
+export declare const setComponentState: (params: {
+    field: string;
+    value: any;
+    windowName: string;
+}) => void;
+export declare const getComponentState: (params: {
+    field: string;
+    windowName: string;
+}) => Promise<any>;
+/**
+ * Returns a name that definitively and clearly identifies the app. Some apps may have random, non-descriptive
+ * appIds. Other times, multiple versions of an app will be registered with the same name but unique appIds.
+ *
+ * If the appId and name are the same then we return that single string. Otherwise we return a compound: `Chart(343GHS)`
+ */
+export declare const getFriendlyName: (params: {
+    title?: string;
+    appId: string;
+    name: string;
+}) => string;
+export declare const interopAssertion: (label: string, condition: boolean) => void;
+export declare const uuidsFromWindowName: ({ clients, windowName, }: {
+    clients: Record<string, InteropClient>;
+    windowName: string;
+}) => string[];
+export declare const notifyEndUser: (messageTitle: string, messageDetails: any, devModeOnly?: boolean) => Promise<void>;
+//# sourceMappingURL=commonUtils.d.ts.map

package/platform/services/Interop/modules/commonUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonUtils.d.ts","sourceRoot":"","sources":["../../../../../../src/platform/services/Interop/modules/commonUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,eAAO,MAAM,6BAA6B,QAAO,IAQhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,KAAG,IAQ7F,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAkB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,KAAG,QAAQ,GAAG,CA8BlG,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,WAAY;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,MAAM,CAAA;CAAE,KAAG,MAIzF,CAAC;AAGF,eAAO,MAAM,gBAAgB,UAAW,MAAM,aAAa,OAAO,SAIjE,CAAC;AAGF,eAAO,MAAM,mBAAmB;aAItB,OAAO,MAAM,EAAE,aAAa,CAAC;gBAC1B,MAAM;MACf,MAAM,EAGqB,CAAC;AAGhC,eAAO,MAAM,aAAa,iBAAwB,MAAM,kBAAkB,GAAG,gBAAe,OAAO,kBAOlG,CAAC"}

package/platform/services/Interop/modules/commonUtils.js

@@ -0,0 +1,80 @@
+/***
+ *
+ * This file contains utility and helper functions shared by Interop modules.
+ *
+ */
+import { RouterClient } from "../../../../clients/routerClient";
+import { Logger } from "../../../../clients/logger";
+import { NotificationClient, Notification } from "../../../../clients/notificationClient";
+export const showLinkerWindowAtMouseEffect = () => {
+    Logger.system.debug("showLinkerWindowAtMouseEffect");
+    const params = {
+        windowIdentifier: {
+            componentType: "LinkerWindow",
+        },
+    };
+    RouterClient.query(`Launcher.showWindowAtMouse`, params, (err, queryResponseMessage) => { });
+};
+export const setComponentState = (params) => {
+    const paramsPlusWI = Object.assign(Object.assign({}, params), { windowIdentifier: {
+            windowName: params.windowName,
+        } });
+    RouterClient.query(`WindowService-Request-setComponentState`, paramsPlusWI, () => { });
+};
+export const getComponentState = async (params) => {
+    const paramsPlusWI = Object.assign(Object.assign({}, params), { windowIdentifier: {
+            windowName: params.windowName,
+        } });
+    const { err, response } = await RouterClient.query(`WindowService-Request-getComponentState`, paramsPlusWI);
+    if (err === "Not found") {
+        /**
+         * getComponentState() returns an error of "Not found" when an app isn't in a workspace. This
+         * happens when it was launched without addToWorkspace flag. See windowClient.ts.
+         *
+         * The net result is the same as if there was no initial state.
+         */
+    }
+    else if (err === null || err === void 0 ? void 0 : err.includes("unidentified window")) {
+        /**
+         * getComponentState() returns an error of "unidentified window"" when a freestanding app isn't known by the window service.
+         *
+         * The net result is the same as if there was no initial state.
+         */
+        Logger.warn("getComponentState: getComponentState error (which is expected for freestanding apps without a window): ", err.toString(), paramsPlusWI);
+    }
+    else if (err) {
+        Logger.error("getComponentState: getComponentState error: ", err.toString(), paramsPlusWI);
+    }
+    return response === null || response === void 0 ? void 0 : response.data;
+};
+/**
+ * Returns a name that definitively and clearly identifies the app. Some apps may have random, non-descriptive
+ * appIds. Other times, multiple versions of an app will be registered with the same name but unique appIds.
+ *
+ * If the appId and name are the same then we return that single string. Otherwise we return a compound: `Chart(343GHS)`
+ */
+export const getFriendlyName = (params) => {
+    const { title, name, appId } = params;
+    const titleOrName = title !== null && title !== void 0 ? title : name;
+    return titleOrName ? `${titleOrName}(${appId})` : appId;
+};
+// Convenience function to log an error if interopAssertion isn't true.
+export const interopAssertion = (label, condition) => {
+    if (!condition) {
+        Logger.system.error(`${label} interopAssertion Failed`);
+    }
+};
+// Convenience function to returns uuids for a window name
+export const uuidsFromWindowName = ({ clients, windowName, }) => Object.values(clients)
+    .filter((client) => client.windowName === windowName)
+    .map((client) => client.uuid);
+// Convenience function to generate an end-user notification
+export const notifyEndUser = async (messageTitle, messageDetails, devModeOnly = false) => {
+    const notification = new Notification();
+    notification.source = "Finsemble";
+    notification.title = messageTitle;
+    notification.details = `${messageDetails} ${new Date().toString().split("GMT")[0]}`;
+    notification.devModeOnly = devModeOnly;
+    NotificationClient.notify(notification);
+};
+//# sourceMappingURL=commonUtils.js.map

package/platform/services/Interop/modules/commonUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonUtils.js","sourceRoot":"","sources":["../../../../../../src/platform/services/Interop/modules/commonUtils.ts"],"names":[],"mappings":"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"}

package/platform/services/Interop/modules/index.d.ts

@@ -0,0 +1,5 @@
+export * as authorize from "./authorize";
+export * as linker from "./linker";
+export * as resolver from "./resolver";
+export * as workspace from "./workspace";
+//# sourceMappingURL=index.d.ts.map

package/platform/services/Interop/modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/platform/services/Interop/modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC"}

package/platform/services/Interop/modules/index.js

@@ -0,0 +1,9 @@
+import * as authorize_1 from "./authorize";
+export { authorize_1 as authorize };
+import * as linker_1 from "./linker";
+export { linker_1 as linker };
+import * as resolver_1 from "./resolver";
+export { resolver_1 as resolver };
+import * as workspace_1 from "./workspace";
+export { workspace_1 as workspace };
+//# sourceMappingURL=index.js.map

package/platform/services/Interop/modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/platform/services/Interop/modules/index.ts"],"names":[],"mappings":"6BAA2B,aAAa;wBAA5B,SAAS;0BACG,UAAU;qBAAtB,MAAM;4BACQ,YAAY;uBAA1B,QAAQ;6BACO,aAAa;wBAA5B,SAAS"}

package/platform/services/Interop/modules/linker.d.ts

@@ -0,0 +1,70 @@
+import { ActionReducerMapBuilder } from "../../../../common/redux/createReducer";
+import { InteropStore, LinkerClient, LinkerChannel } from "../types";
+import { InteropJoinChannels, InteropLeaveChannels } from "../../../../clients/Interop/types";
+export declare type LinkerChannelConfig = {
+    name: string;
+    color: string;
+    border?: string;
+    label?: string;
+}[];
+export declare type InteropLinkChannels = {
+    type: "linker/linkChannels";
+    payload: {
+        channels: string[];
+    };
+    meta: {
+        windowName: string;
+    };
+};
+export declare type InteropUnlinkChannels = {
+    type: "linker/unlinkChannels";
+    payload: {
+        channels?: string[];
+    };
+    meta: {
+        windowName: string;
+    };
+};
+export declare type InteropLinkerSetActiveWindow = {
+    type: "linker/setActiveWindow";
+    payload: {
+        windowName: string;
+        showWindowAtMouse?: boolean;
+    };
+};
+declare type LinkerInitializeWindow = {
+    channels?: string[];
+    windowName: string;
+};
+export declare const actions: {
+    setActiveWindow: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropLinkerSetActiveWindow, string>;
+    initializeWindow: import("@reduxjs/toolkit").ActionCreatorWithPayload<LinkerInitializeWindow, string>;
+    linkChannels: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropLinkChannels, string>;
+    joinChannels: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropJoinChannels, string>;
+    leaveChannels: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropLeaveChannels, string>;
+    unlinkChannels: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropUnlinkChannels, string>;
+    setSystemChannels: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<string>;
+};
+declare const _default: {
+    getInitialState: () => {
+        clients: {
+            [windowName: string]: LinkerClient;
+        };
+        allChannels: LinkerChannel[];
+        connectIdToJoinedChannel: Record<string, string>;
+        activeWindowName?: string | undefined;
+    };
+    addReducerCases: (builder: ActionReducerMapBuilder<InteropStore>) => void;
+    actions: {
+        setActiveWindow: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropLinkerSetActiveWindow, string>;
+        initializeWindow: import("@reduxjs/toolkit").ActionCreatorWithPayload<LinkerInitializeWindow, string>;
+        linkChannels: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropLinkChannels, string>;
+        joinChannels: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropJoinChannels, string>;
+        leaveChannels: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropLeaveChannels, string>;
+        unlinkChannels: import("@reduxjs/toolkit").ActionCreatorWithPayload<InteropUnlinkChannels, string>;
+        setSystemChannels: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<string>;
+    };
+    initialize: (store: any) => void;
+};
+export default _default;
+//# sourceMappingURL=linker.d.ts.map

package/platform/services/Interop/modules/linker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linker.d.ts","sourceRoot":"","sources":["../../../../../../src/platform/services/Interop/modules/linker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAW,MAAM,wCAAwC,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAe,YAAY,EAAE,aAAa,EAA8B,MAAM,UAAU,CAAC;AAC9G,OAAO,EAAgB,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAY5G,oBAAY,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,EAAE,CAAC;AAEJ,oBAAY,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE;QACR,QAAQ,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,IAAI,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;KACnB,CAAC;CACF,CAAC;AAEF,oBAAY,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,IAAI,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;KACnB,CAAC;CACF,CAAC;AAEF,oBAAY,4BAA4B,GAAG;IAC1C,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;CACF,CAAC;AAEF,aAAK,sBAAsB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAsDF,eAAO,MAAM,OAAO;;;;;;;;CAQnB,CAAC;;;;;;;;;;;;;;;;;;;;;;AA0QF,wBAKE"}