@finsemble/finsemble-ui 7.3.2 → 8.0.0-alpha-1

package/clients/Startup/FSBLFreestanding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FSBLFreestanding.d.ts","sourceRoot":"","sources":["../../../../src/clients/Startup/FSBLFreestanding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAuB,MAAM,kBAAkB,CAAC;AAOpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;GAGG;AAEH,qBAAa,gBAAgB;;gBAGhB,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,qBAAqB,CAAA;KAAE;IAIrD;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW;IA0EnC;;OAEG;YACW,yBAAyB;IAiBvC;;OAEG;IACG,OAAO;CAKb"}

package/clients/Startup/FSBLFreestanding.js

@@ -0,0 +1,127 @@
+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 _FSBLFreestanding_fdc3;
+import { RouterController } from "../routerClient";
+import { Startup } from "../Startup/Startup";
+import { getRouterConfig } from "./RouterConfig";
+import { LoggerClient as Logger } from "../logger";
+import { authSignature } from "../../platform/services/Interop/AuthSignVerify";
+import uuidv4 from "uuid-random";
+/**
+ * Starts Finsemble for "freestanding" apps (those that are not running under Electron). This is used
+ * by the finsemble-javascript-adapter.
+ */
+export class FSBLFreestanding {
+    constructor({ fdc3 }) {
+        _FSBLFreestanding_fdc3.set(this, void 0);
+        __classPrivateFieldSet(this, _FSBLFreestanding_fdc3, fdc3, "f");
+    }
+    /**
+     * Freestanding apps must call startApp() to start the FSBL and fdc3 client code.
+     *
+     * Startup configurations and data can be passed in the params. If not provided, defaults will be used
+     * according to the typedocs for StartupData.
+     */
+    async startApp(params) {
+        var _a, _b, _c, _d;
+        // Window name must be unique within Finsemble, so uuid is always added even if passed in params.
+        // This also prevents a freestanding app from spoofing another window by taking its name.
+        const windowName = `${(_c = (_a = params === null || params === void 0 ? void 0 : params.windowName) !== null && _a !== void 0 ? _a : (_b = document === null || document === void 0 ? void 0 : document.location) === null || _b === void 0 ? void 0 : _b.href) !== null && _c !== void 0 ? _c : "freestandingApp"}-${uuidv4()}`;
+        // If no appName is provided then use the windowName. The app will be treated anonymously.
+        const appName = (_d = params === null || params === void 0 ? void 0 : params.appName) !== null && _d !== void 0 ? _d : windowName;
+        let authenticationToken;
+        // If JSON Web Token is passed in then use it in place of the digital signing key. The use case is for the JWT to be created on a server to avoid having to include the private key into the app.
+        // Note that Finsemble will use JWT's iot field to internally set the token's timestamp -- the Finsemble TTL for a token is 30 seconds.
+        // JWT optional expiration time is not used to avoid confusion with the static auth timestamp, plus JWT expiration times are typically in minutes, where Finsemble needs to enforce a short TTL.
+        if (params === null || params === void 0 ? void 0 : params.jwt) {
+            authenticationToken = {
+                signatureStringType: "static-jwt",
+                signatureString: params === null || params === void 0 ? void 0 : params.jwt,
+                meta: {
+                    name: appName,
+                },
+            };
+            //else if digital signing key provided, then creates the static AuthenticationToken that is necessary to instantiate interop.
+        }
+        else if (params === null || params === void 0 ? void 0 : params.digitalSigningKey) {
+            authenticationToken = await this.staticAuthenticationToken(params === null || params === void 0 ? void 0 : params.digitalSigningKey, appName);
+        }
+        else {
+            // If a digital signing key hasn't been provided then the default is used with type set to "unauthenticated".
+            authenticationToken = {
+                signatureStringType: "unauthenticated",
+                signatureString: "",
+                meta: {
+                    name: appName,
+                    appId: appName, // authentication is based on the appId
+                },
+            };
+        }
+        /**
+         * Finsemble's router client requires a windowName but otherwise it will start with defaults unless routerAddress
+         * has been set, in which case that will be set as the serverAddress for IAC (FinsembleTransport).
+         */
+        const routerAddress = params === null || params === void 0 ? void 0 : params.routerAddress;
+        const definitiveRouterConfig = getRouterConfig(routerAddress
+            ? {
+                windowName,
+                transportSettings: {
+                    FinsembleTransport: {
+                        serverAddress: routerAddress,
+                    },
+                },
+            }
+            : {
+                windowName,
+            });
+        const definitiveStartupData = {
+            windowName,
+            webContentsName: windowName,
+            authenticationToken,
+        };
+        const startup = Startup.getInstance();
+        startup.setStartupData(definitiveStartupData);
+        await RouterController.start(definitiveRouterConfig);
+        startup.setReady();
+        Logger.start();
+        // In freestanding apps, we always immediately connect to the interop service.
+        __classPrivateFieldGet(this, _FSBLFreestanding_fdc3, "f").start();
+    }
+    /**
+     * Builds and returns a static authentication token.
+     */
+    async staticAuthenticationToken(digitalSigningKey, name) {
+        // a timestamp is in the signed data, which will be used for TTL check
+        const timestamp = Date.now();
+        const signatureData = { timestamp };
+        const { signature } = await authSignature(digitalSigningKey, signatureData);
+        return {
+            signatureStringType: "static",
+            timestamp,
+            signatureString: signature,
+            meta: {
+                name,
+                appId: name,
+            },
+        };
+    }
+    /**
+     * Stops the app.
+     */
+    async stopApp() {
+        __classPrivateFieldGet(this, _FSBLFreestanding_fdc3, "f").stop();
+        Logger.unregisterClient();
+        RouterController.stop();
+    }
+}
+_FSBLFreestanding_fdc3 = new WeakMap();
+//# sourceMappingURL=FSBLFreestanding.js.map

package/clients/Startup/FSBLFreestanding.js.map

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

package/clients/Startup/FSBLService.d.ts

@@ -0,0 +1,8 @@
+export declare class FSBLService {
+    /**
+     * Starts Finsemble for internal service and service manager windows
+     */
+    startApp(): Promise<void>;
+    stopApp(): Promise<void>;
+}
+//# sourceMappingURL=FSBLService.d.ts.map

package/clients/Startup/FSBLService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FSBLService.d.ts","sourceRoot":"","sources":["../../../../src/clients/Startup/FSBLService.ts"],"names":[],"mappings":"AAWA,qBAAa,WAAW;IACvB;;OAEG;IACG,QAAQ;IAwCR,OAAO;CAGb"}

package/clients/Startup/FSBLService.js

@@ -0,0 +1,56 @@
+/**
+ * Finsemble entry point for services and the service manager.
+ */
+import { RouterClient, RouterController } from "../routerClient";
+import { getRouterConfig, getSystemStartupData, getManifestFromStartupData } from "./RouterConfig";
+import { System } from "../../common/system";
+import { Startup } from "./Startup";
+import { Globals } from "../../common/Globals";
+import { FinsembleDesktopAgent } from "../Interop/FinsembleDesktopAgent";
+import uuidv4 from "uuid-random";
+export class FSBLService {
+    /**
+     * Starts Finsemble for internal service and service manager windows
+     */
+    async startApp() {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const systemStartupData = await getSystemStartupData();
+        const finWindow = System.Window.getCurrent();
+        const appName = (_c = (_a = finWindow.name) !== null && _a !== void 0 ? _a : (_b = document === null || document === void 0 ? void 0 : document.location) === null || _b === void 0 ? void 0 : _b.href) !== null && _c !== void 0 ? _c : "Unknown App";
+        const windowName = (_f = (_d = finWindow.name) !== null && _d !== void 0 ? _d : (_e = document === null || document === void 0 ? void 0 : document.location) === null || _e === void 0 ? void 0 : _e.href) !== null && _f !== void 0 ? _f : `Unknown window-${uuidv4()}`;
+        const webContentsName = (_g = finWindow.webContentsName) !== null && _g !== void 0 ? _g : windowName;
+        /**
+         * The system manifest is provided in the startup data. At early stages, this is available
+         * at the root level. In later stages, a more complete manifest is available in customData.
+         */
+        const systemManifest = (_h = getManifestFromStartupData(systemStartupData)) !== null && _h !== void 0 ? _h : {};
+        const routerConfig = getRouterConfig({
+            windowName,
+            systemManifest,
+        });
+        await RouterController.start(routerConfig);
+        const startup = Startup.getInstance();
+        startup.setStartupData({
+            windowName,
+            webContentsName,
+            authenticationToken: {
+                signatureString: "",
+                signatureStringType: "unauthenticated",
+                meta: {
+                    name: appName,
+                },
+            },
+        });
+        // Made fdc3 available to services. This is temporary until services become invisible, singleton apps.
+        Globals.fdc3 = new FinsembleDesktopAgent({
+            routerClient: RouterClient,
+            startup,
+        });
+        startup.setReady();
+        // search for Logger.start() and client initialize calls in services and move them here
+    }
+    async stopApp() {
+        RouterController.stop();
+    }
+}
+//# sourceMappingURL=FSBLService.js.map

package/clients/Startup/FSBLService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FSBLService.js","sourceRoot":"","sources":["../../../../src/clients/Startup/FSBLService.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,OAAO,WAAW;IACvB;;OAEG;IACH,KAAK,CAAC,QAAQ;;QACb,MAAM,iBAAiB,GAAG,MAAM,oBAAoB,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAA,MAAA,SAAS,CAAC,IAAI,mCAAI,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,QAAQ,0CAAE,IAAI,mCAAI,aAAa,CAAC;QAC5E,MAAM,UAAU,GAAG,MAAA,MAAA,SAAS,CAAC,IAAI,mCAAI,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,QAAQ,0CAAE,IAAI,mCAAI,kBAAkB,MAAM,EAAE,EAAE,CAAC;QAC9F,MAAM,eAAe,GAAG,MAAA,SAAS,CAAC,eAAe,mCAAI,UAAU,CAAC;QAEhE;;;WAGG;QACH,MAAM,cAAc,GAAG,MAAA,0BAA0B,CAAC,iBAAiB,CAAC,mCAAI,EAAE,CAAC;QAC3E,MAAM,YAAY,GAAG,eAAe,CAAC;YACpC,UAAU;YACV,cAAc;SACd,CAAC,CAAC;QACH,MAAM,gBAAgB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACtC,OAAO,CAAC,cAAc,CAAC;YACtB,UAAU;YACV,eAAe;YACf,mBAAmB,EAAE;gBACpB,eAAe,EAAE,EAAE;gBACnB,mBAAmB,EAAE,iBAAiB;gBACtC,IAAI,EAAE;oBACL,IAAI,EAAE,OAAO;iBACb;aACD;SACD,CAAC,CAAC;QAEH,sGAAsG;QACtG,OAAO,CAAC,IAAI,GAAG,IAAI,qBAAqB,CAAC;YACxC,YAAY,EAAE,YAAY;YAC1B,OAAO;SACP,CAAC,CAAC;QAEH,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,uFAAuF;IACxF,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,gBAAgB,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACD"}

package/clients/Startup/RouterConfig.d.ts

@@ -0,0 +1,37 @@
+/**
+ * This module is responsible for deriving the RouterConfig. Freestanding apps can pass their
+ * RouterConfig into FSBL.startApp(). When not passed in, the RouterConfig should default to the IAC
+ * for freestanding apps.
+ *
+ * When runnning in FEA, the router config is obtained from the system manifest.
+ */
+import { RouterConfig, RouterTransportSettings } from "../../clients/routerClient";
+import { SystemStartupData } from "./types";
+import { Manifest } from "../../types";
+/**
+ * Returns the recommended transport given the configurations in the system manifest. The transport depends
+ * on whether this window is running in the same domain as the router service (by checking the finsemble.moduleRoot entry in
+ * the system manifest).
+ */
+export declare const getRecommendedTransport: (systemManifest: any) => any;
+declare type GetRouterConfigParams = {
+    windowName: string;
+    systemManifest?: any;
+    transportSettings?: RouterTransportSettings;
+};
+/**
+ * Retrieves a router configuration given a windowName, optional transportSettings and optional systemManifest.
+ * If a systemManifest is provided (e.g. FSBLDesktop) then the router config from the manifest will be used
+ * otherwise it will default to using IAC (FinsembleTransport). The default IAC port of 127.0.0.1:3376 will
+ * be used unless transportSettings is passed in to override it.
+ */
+export declare const getRouterConfig: ({ windowName, systemManifest, transportSettings, }: GetRouterConfigParams) => RouterConfig;
+/** Converts System.Window.getCurrent().getOptions() into a simple async call */
+export declare const getSystemStartupData: () => Promise<SystemStartupData>;
+/**
+ * Returns a system manifest that has been run through the config resolver to replace
+ * variables with absolute paths (e.g. $applicationRoot, $moduleRoot)
+ */
+export declare const getManifestFromStartupData: (systemStartupData: SystemStartupData) => Manifest;
+export {};
+//# sourceMappingURL=RouterConfig.d.ts.map

package/clients/Startup/RouterConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterConfig.d.ts","sourceRoot":"","sources":["../../../../src/clients/Startup/RouterConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAInF,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAyCvC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,mBAAoB,GAAG,QAK1D,CAAC;AAkCF,aAAK,qBAAqB,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,uDAIzB,qBAAqB,KAAG,YAY1B,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,kCAK9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,0BAA0B,sBAAuB,iBAAiB,KAAG,QAYjF,CAAC"}

package/clients/Startup/RouterConfig.js

@@ -0,0 +1,108 @@
+import { Logger } from "../logger";
+import { System } from "../../common/system";
+import { ConfigUtilInstance as ConfigUtil } from "../../common/configUtil";
+const FreestandingRouterConfig = {
+    sameDomainTransport: "FinsembleTransport",
+    crossDomainTransport: "FinsembleTransport",
+    transportSettings: {
+        FinsembleTransport: {
+            serverAddress: "ws://127.0.0.1:3376",
+        },
+    },
+    transportName: "FinsembleTransport",
+};
+/**
+ * Determines if the current window is in the same domain as the provided documentRoot.
+ * The documentRoot is typically from the "finsemble.moduleRoot" entry of the system manifest
+ * which is expanded into an absolute domain by FEA (see Manifest.ts in electron-adapter package).
+ */
+const isCrossDomain = (documentRoot) => {
+    if (!documentRoot) {
+        Logger.system.error("No documentRoot provided to RouterConfig.isCrossDomain(). Check the moduleRoot entry of the manifest.");
+        return true;
+    }
+    const parser = document.createElement("a");
+    parser.href = documentRoot;
+    const isSameHost = window.location.hostname === parser.hostname;
+    const isSameProtocol = window.location.protocol === parser.protocol;
+    const wport = window.location.port !== undefined ? window.location.port : 80;
+    const pport = parser.port !== undefined ? parser.port : 80;
+    const isSamePort = wport === pport;
+    const sameDomain = isSameHost && isSamePort && isSameProtocol;
+    Logger.system.debug(`Transport crossDomain=${isCrossDomain} (${isSameHost}:${isSameProtocol}:${isSamePort})`);
+    return !sameDomain;
+};
+/**
+ * Returns the recommended transport given the configurations in the system manifest. The transport depends
+ * on whether this window is running in the same domain as the router service (by checking the finsemble.moduleRoot entry in
+ * the system manifest).
+ */
+export const getRecommendedTransport = (systemManifest) => {
+    const { moduleRoot, router } = systemManifest === null || systemManifest === void 0 ? void 0 : systemManifest.finsemble;
+    const { sameDomainTransport = "SharedWorker", crossDomainTransport = "IPCBus" } = router !== null && router !== void 0 ? router : {};
+    return isCrossDomain(moduleRoot) ? crossDomainTransport : sameDomainTransport;
+};
+/**
+ * Converts a manifest into a RouterConfig object which can be used to start the router.
+ */
+const routerConfigFromManifest = (systemManifest, windowName) => {
+    var _a, _b, _c;
+    Logger.system.info("WINDOW LIFECYCLE:STARTUP:RouterClient:routerConfigFromManifest");
+    // If manifest is a string, then there was an error getting the manifest because in a separate application
+    if (!systemManifest || typeof systemManifest === "string") {
+        Logger.system.error("WINDOW LIFECYCLE:STARTUP:RouterClient:routerConfigFromManifest failed -- fatal error. No manifest found.", systemManifest);
+        return Object.assign(Object.assign({}, FreestandingRouterConfig), { windowName });
+    }
+    else {
+        const finConfig = systemManifest.finsemble;
+        // Config for transportSettings is preferred. finsemble.IAC is deprecated but might still be floating around in production.
+        const transportSettings = (_c = (_b = (_a = finConfig === null || finConfig === void 0 ? void 0 : finConfig.router) === null || _a === void 0 ? void 0 : _a.transportSettings) !== null && _b !== void 0 ? _b : finConfig === null || finConfig === void 0 ? void 0 : finConfig.IAC) !== null && _c !== void 0 ? _c : {};
+        const routerConfig = {
+            windowName,
+            routerDomainRoot: finConfig.moduleRoot,
+            transportName: getRecommendedTransport(systemManifest),
+            transportSettings,
+        };
+        return routerConfig;
+    }
+};
+/**
+ * Retrieves a router configuration given a windowName, optional transportSettings and optional systemManifest.
+ * If a systemManifest is provided (e.g. FSBLDesktop) then the router config from the manifest will be used
+ * otherwise it will default to using IAC (FinsembleTransport). The default IAC port of 127.0.0.1:3376 will
+ * be used unless transportSettings is passed in to override it.
+ */
+export const getRouterConfig = ({ windowName, systemManifest, transportSettings, }) => {
+    if (systemManifest) {
+        // FEA
+        return routerConfigFromManifest(systemManifest, windowName);
+    }
+    else {
+        // Freestanding
+        return Object.assign(Object.assign({}, FreestandingRouterConfig), { windowName, transportSettings: transportSettings !== null && transportSettings !== void 0 ? transportSettings : {} });
+    }
+};
+/** Converts System.Window.getCurrent().getOptions() into a simple async call */
+export const getSystemStartupData = async () => new Promise((resolve) => {
+    System.Window.getCurrent().getOptions((options) => {
+        resolve(options);
+    });
+});
+/**
+ * Returns a system manifest that has been run through the config resolver to replace
+ * variables with absolute paths (e.g. $applicationRoot, $moduleRoot)
+ */
+export const getManifestFromStartupData = (systemStartupData) => {
+    /**
+     * systemStartupData.manifest contains the startup manifest, before the imports are processed.
+     * At early boot stages this is all that is available. Once the entire manifest has been processed
+     * for imports it becomes available in systtemStartupData.customData.manifest. For the purposes
+     * of system startup it really doesn't matter which we use because all the important entries are
+     * in the system manifest.
+     */
+    let systemManifest = systemStartupData === null || systemStartupData === void 0 ? void 0 : systemStartupData.manifest;
+    if (systemManifest === null || systemManifest === void 0 ? void 0 : systemManifest.finsemble)
+        ConfigUtil.resolveManifestMacros(systemManifest, systemManifest.finsemble);
+    return systemManifest;
+};
+//# sourceMappingURL=RouterConfig.js.map

package/clients/Startup/RouterConfig.js.map

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

package/clients/Startup/SDDListeners.d.ts

@@ -0,0 +1,12 @@
+import { Manifest } from "../../types";
+export declare type CSS = {
+    [key: string]: string;
+};
+/**
+ * Starts up listeners for SDD's dynamic updates.
+ *
+ * @param {*} systemManifest System manifest (e.g. obtained from System.getOptions() )
+ * @param {string} componentType The type of component (e.g. from components.json). All components have theme.css injected except the SDD itself.
+ */
+export declare const start: (systemManifest: Manifest, componentType: string) => void;
+//# sourceMappingURL=SDDListeners.d.ts.map

package/clients/Startup/SDDListeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SDDListeners.d.ts","sourceRoot":"","sources":["../../../../src/clients/Startup/SDDListeners.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,oBAAY,GAAG,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAkF5C;;;;;GAKG;AACH,eAAO,MAAM,KAAK,mBAAoB,QAAQ,iBAAiB,MAAM,SAMpE,CAAC"}

package/clients/Startup/SDDListeners.js

@@ -0,0 +1,98 @@
+import { System } from "../../common/system";
+import { Logger } from "../logger";
+import { RouterClient } from "../routerClient";
+import { ConfigClient } from "../configClient";
+import uuidv4 from "uuid-random";
+// Ensures that a path, such as documentRoot, ends with a trailing slash
+const ensureEndSlash = (path) => {
+    if (path.substr(-1) === "/")
+        return path;
+    return `${path}/`;
+};
+/**
+ * Inserts a child element into a parent element ensuring that the child becomes the
+ * first element in the parent.
+ */
+const insertAsFirstElement = (parent, child) => {
+    if (parent.firstChild) {
+        parent.insertBefore(child, parent.firstChild);
+    }
+    else {
+        parent.appendChild(child);
+    }
+};
+/**
+ * Starts up the listener for theme updates from the Smart Desktop Designer (SDD). This page's local CSS variables
+ * will be updated with values from received messages.
+ */
+const startSDDThemeUpdates = (systemManifest) => {
+    var _a;
+    /**
+     * Ian: IIRC the theme is imported into the tsx at build time and bundled into the component.
+     * I think we can just move it into the html of each component so it remains a stylesheet link.
+     * Terry: Since SDD doesn't use theme.css then the config probably can be eliminated
+     */
+    const documentRoot = (_a = systemManifest === null || systemManifest === void 0 ? void 0 : systemManifest.finsemble) === null || _a === void 0 ? void 0 : _a.documentRoot;
+    if (documentRoot) {
+        const cacheBuster = uuidv4();
+        const themeCssUrl = `${ensureEndSlash(documentRoot)}assets/css/theme.css?${cacheBuster}`;
+        const themeLink = document.createElement("link");
+        themeLink.setAttribute("rel", "stylesheet");
+        themeLink.setAttribute("type", "text/css");
+        themeLink.setAttribute("href", themeCssUrl);
+        /**
+         * Append theme.css' <link> at the top of the *body*. It's important to put this link
+         * in the body and not the head because "style-loader" (webpack) will inject <style>
+         * tags into the <head> which could override theme.css. There is no control over the
+         * order of operations, so by putting theme.css into the <body> we guarantee that it is
+         * always processed after any injected styles.
+         */
+        insertAsFirstElement(document.body, themeLink);
+        RouterClient.addListener("Finsemble-ui-change.themeUpdate", (error, data) => {
+            const css = data === null || data === void 0 ? void 0 : data.data;
+            if (css) {
+                for (const [key, value] of Object.entries(css)) {
+                    document.documentElement.style.setProperty(key, String(value));
+                }
+            }
+            else {
+                Logger.system.error("FSBL.entry.ts: Expected CSS for Finsemble-ui-change.themeUpdate but got error", error);
+            }
+        });
+    }
+    else {
+        Logger.system.error("Could not find manifest entry: finsemble.documentRoot");
+    }
+};
+/**
+ * Receives a notice from SDD that the taskbar icon has been updated. The updated location
+ * is retrieved from config and then set for the current window.
+ */
+const startSDDTaskbarUpdates = () => {
+    RouterClient.addListener("Finsemble-ui-change.taskbarIconUpdate", () => {
+        Logger.system.log("Finsemble-ui-change: dynamic taskbar icon change -- resetting component icon");
+        ConfigClient.getValue({ field: "startup_app" }, (err, value) => {
+            if (err) {
+                Logger.system.error(`error updating taskbar icon: ${err}`);
+            }
+            else {
+                const { applicationIcon } = value;
+                System.Window.getCurrent().setTaskbarIcon({ iconURL: applicationIcon });
+            }
+        });
+    });
+};
+/**
+ * Starts up listeners for SDD's dynamic updates.
+ *
+ * @param {*} systemManifest System manifest (e.g. obtained from System.getOptions() )
+ * @param {string} componentType The type of component (e.g. from components.json). All components have theme.css injected except the SDD itself.
+ */
+export const start = (systemManifest, componentType) => {
+    // Every component should listen for theme updates except for the SDD itself
+    if (componentType !== "smartDesktopDesigner") {
+        startSDDThemeUpdates(systemManifest);
+        startSDDTaskbarUpdates();
+    }
+};
+//# sourceMappingURL=SDDListeners.js.map

package/clients/Startup/SDDListeners.js.map

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

package/clients/Startup/Startup.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Startup provides Startup
+ */
+import { CompleteStartupData } from "./types";
+/**
+ * Provides functionality related to startup of client side APIs. This runs as a singleton
+ * and should always be accessed through the static method Startup.getInstance(). Never
+ * construct a Startup class using new.
+ */
+export declare class Startup {
+    static instance: Startup | null;
+    isReady: boolean;
+    onReadyListeners: (() => void)[];
+    /**
+     * Contains the StartupData. Default is an anonymous app.
+     */
+    currentStartupData: CompleteStartupData;
+    /**
+     * Use this method to gain access to the Startup singleton. Never construct
+     * a Startup class using new.
+     * @returns Singleton instance of Startup
+     */
+    static getInstance(): Startup;
+    /**
+     * Returns the startup data that was set for this app. This data is generally
+     * set in FSBL (FSBLDesktop, FSBLFreestanding, etc) and then it is cached here to
+     * enable synchronous retrieval.
+     *
+     * Calls to System.updateOptions() or fin.Window.getCurrent().updateOptions() or finsembleWindow.updateOptions()
+     * will not update this startup data!
+     *
+     */
+    getStartupData(): CompleteStartupData;
+    /**
+     * Sets the startup data. This is typically done by FSBL (FSBLDesktop or FSBLFreestanding)
+     * but is also called by System.Window.getCurrent().updateOptions.
+     */
+    setStartupData(newStartupData: CompleteStartupData): void;
+    /**
+     * Will trigger the listener when Finsemble's startup routine is ready. At this point it is safe
+     * to use any Finsemble APIs. This guarantees:
+     * a) startup data is available
+     * b) router is ready to receive messages
+     * c) Client APIs have been initialized
+     *
+     * Either pass in a callback function or await on the returned promise
+     *
+     * @param {() => void} [listener] Optional callback (or use await)
+     */
+    onReady(listener?: () => void): Promise<void>;
+    /**
+     * This is called by "friend" modules (FSBLDesktop, FSBLService, FSBLFreestanding) when they are ready
+     * for the client side API to start. This will trigger the Startup.onReady() event for any app that is
+     * listening for that event.
+     * @private
+     */
+    setReady(): void;
+}
+//# sourceMappingURL=Startup.d.ts.map

package/clients/Startup/Startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Startup.d.ts","sourceRoot":"","sources":["../../../../src/clients/Startup/Startup.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAQ9C;;;;GAIG;AACH,qBAAa,OAAO;IACnB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAQ;IAEvC,OAAO,EAAE,OAAO,CAAS;IAEzB,gBAAgB,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAM;IAEtC;;OAEG;IACH,kBAAkB,EAAE,mBAAmB,CAIrC;IAEF;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;IAO7B;;;;;;;;OAQG;IACH,cAAc,IAAI,mBAAmB;IAIrC;;;OAGG;IACH,cAAc,CAAC,cAAc,EAAE,mBAAmB,GAAG,IAAI;IAIzD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7C;;;;;OAKG;IACH,QAAQ,IAAI,IAAI;CAWhB"}