@vived/host 4.2.0 → 4.4.0

package/dist/esm/Apps/UCs/Mounters/MounterUC.js

@@ -4,32 +4,85 @@ import { HostHandlerEntity } from "../../../Handler/Entities/HostHandler";
 import { GetAppFromAPIUC } from "../../../VivedAPI/UCs/GetAppFromAPIUC";
 import { AppEntity, AppState } from "../../Entities/AppEntity";
 import { formAppIDWithVersion } from "../formAppIDWithVersion";
+/**
+ * Abstract base class for app mounting use cases.
+ *
+ * The MounterUC is responsible for loading, initializing, and managing app
+ * lifecycle. It handles script loading, version management, and communication
+ * setup between the host and app.
+ *
+ * @extends AppObjectUC from @vived/core
+ */
 export class MounterUC extends AppObjectUC {
+    /**
+     * Retrieves the MounterUC component from an app object.
+     *
+     * @param appObject - The app object to get the component from
+     * @returns The MounterUC component or undefined if not found
+     */
     static get(appObject) {
         return appObject.getComponent(MounterUC.type);
     }
+    /**
+     * Retrieves the MounterUC component by app object ID.
+     *
+     * @param id - The ID of the app object
+     * @param appObjects - The app object repository
+     * @returns The MounterUC component or undefined if not found
+     */
     static getById(id, appObjects) {
         const ao = appObjects.get(id);
         return ao?.getComponent(MounterUC.type);
     }
 }
 MounterUC.type = "MounterUC";
+/**
+ * Factory function to create a new MounterUC instance.
+ *
+ * @param appObject - The app object to attach the mounter to
+ * @returns A new MounterUC instance
+ */
 export function makeMounterUC(appObject) {
     return new MounterUCImp(appObject);
 }
+/**
+ * Concrete implementation of the MounterUC abstract class.
+ *
+ * This implementation provides the standard mounting behavior for loading
+ * and initializing apps, handling script loading, and managing app lifecycle.
+ */
 class MounterUCImp extends MounterUC {
+    /**
+     * Gets the use case for retrieving apps from the API.
+     */
     get getAppFromAPI() {
         return this.getCachedSingleton(GetAppFromAPIUC.type);
     }
+    /**
+     * Gets the app entity representing the app being mounted.
+     */
     get app() {
         return this.getCachedLocalComponent(AppEntity.type);
     }
+    /**
+     * Gets the host handler entity for receiving messages from apps.
+     */
     get hostHandler() {
         return this.getCachedLocalComponent(HostHandlerEntity.type);
     }
+    /**
+     * Gets the host dispatcher entity for sending messages to apps.
+     */
     get hostDispatcher() {
         return this.getCachedLocalComponent(HostDispatchEntity.type);
     }
+    /**
+     * Helper method to find a specific version of the app.
+     *
+     * @param major - Major version number
+     * @param minor - Minor version number
+     * @returns The Version object or undefined if not found
+     */
     getAppVersion(major, minor) {
         if (!this.app) {
             return;
@@ -43,6 +96,11 @@ class MounterUCImp extends MounterUC {
         }
         return appVersion;
     }
+    /**
+     * Mounts the latest available version of the app.
+     *
+     * @returns A promise that resolves when the app is mounted
+     */
     mountLatestVersion() {
         if (!this.app) {
             this.error("Missing Components");
@@ -55,6 +113,12 @@ class MounterUCImp extends MounterUC {
         }
         return this.mount(version.major, version.minor);
     }
+    /**
+     * Parses app entrypoints into scripts and styles.
+     *
+     * @param endpoints - Array of endpoint URLs
+     * @returns Object with separate arrays for scripts and styles
+     */
     parseEndpoints(endpoints) {
         const scripts = [];
         const styles = [];
@@ -74,6 +138,17 @@ class MounterUCImp extends MounterUC {
             styles
         };
     }
+    /**
+     * Waits for an app to report it's ready.
+     *
+     * This method handles special cases for apps that don't properly
+     * report their ready state, as well as the normal case where
+     * apps transition to the READY state.
+     *
+     * @param app - The app entity
+     * @param appVersion - The app version
+     * @returns A promise that resolves when the app is ready
+     */
     waitForAppIsReady(app, appVersion) {
         // Edge cases here
         if (app.id === "app4e48fbaa815a4857821bf7569b003751" &&
@@ -118,9 +193,23 @@ class MounterUCImp extends MounterUC {
             app.addChangeObserver(appObserver);
         });
     }
+    /**
+     * Creates a new MounterUCImp instance.
+     *
+     * @param appObject - The app object to attach to
+     */
     constructor(appObject) {
         super(appObject, MounterUC.type);
+        /**
+         * Tracks script elements added to the document to enable cleanup.
+         */
         this.scriptElements = [];
+        /**
+         * Unmounts the app, removing it from the runtime environment.
+         *
+         * This removes script elements, cleans up global references,
+         * and resets app state.
+         */
         this.unmount = () => {
             if (!this.app)
                 return;
@@ -138,6 +227,17 @@ class MounterUCImp extends MounterUC {
             this.app.mountedVersion = undefined;
             this.app.state = AppState.INIT;
         };
+        /**
+         * Mounts a specific version of the app.
+         *
+         * This method fetches the app from the API, loads scripts,
+         * establishes communication with the app, and waits for the
+         * app to be ready.
+         *
+         * @param majorVersion - The major version number
+         * @param minorVersion - The minor version number
+         * @returns A promise that resolves when the app is mounted
+         */
         this.mount = (majorVersion, minorVersion) => {
             const fetchApp = this.getAppFromAPI;
             if (!fetchApp) {
@@ -197,6 +297,13 @@ class MounterUCImp extends MounterUC {
                 });
             });
         };
+        /**
+         * Loads app scripts and retrieves the app interface.
+         *
+         * @param scripts - Array of script URLs to load
+         * @param version - The app version
+         * @returns A promise that resolves with the app interface
+         */
         this.loadScripts = (scripts, version) => {
             const app = this.app;
             if (!app) {
@@ -229,6 +336,13 @@ class MounterUCImp extends MounterUC {
                 });
             });
         };
+        /**
+         * Loads a script into the document.
+         *
+         * @param scriptURL - URL of the script to load
+         * @param appIDWithVersion - Versioned ID of the app
+         * @returns A promise that resolves when the script is loaded
+         */
         this.loadScriptIntoDocument = (scriptURL, appIDWithVersion) => {
             return new Promise((resolve, reject) => {
                 const aScript = document.createElement("script");
@@ -245,6 +359,12 @@ class MounterUCImp extends MounterUC {
                 document.head.appendChild(aScript);
             });
         };
+        /**
+         * Gets the app interface for a specific version.
+         *
+         * @param version - The version to get the interface for
+         * @returns The app interface or undefined if not found
+         */
         this.getAppInterface = (version) => {
             if (!this.app)
                 return;

package/dist/esm/Apps/UCs/Mounters/MounterUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MounterUC.js","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/MounterUC.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC,\r\n  Version,\r\n  VIVEDApp_3\r\n} from \"@vived/core\";\r\nimport { HostDispatchEntity } from \"../../../Dispatcher/Entities/HostDispatchEntity\";\r\nimport { HostHandlerEntity } from \"../../../Handler/Entities/HostHandler\";\r\nimport { GetAppFromAPIUC } from \"../../../VivedAPI/UCs/GetAppFromAPIUC\";\r\nimport { AppEntity, AppState } from \"../../Entities/AppEntity\";\r\nimport { formAppIDWithVersion } from \"../formAppIDWithVersion\";\r\n\r\nexport abstract class MounterUC extends AppObjectUC {\r\n  static type = \"MounterUC\";\r\n\r\n  abstract mount(majorVersion: number, minorVersion: number): Promise<void>;\r\n  abstract mountLatestVersion(): Promise<void>;\r\n  abstract unmount(): void;\r\n  abstract loadScriptIntoDocument(\r\n    scriptURL: string,\r\n    appIDWithVersion: string\r\n  ): Promise<void>; // Exposed for testing purposes\r\n  abstract getAppInterface(version: Version): VIVEDApp_3 | undefined; // Exposed for test purposes\r\n\r\n  static get(appObject: AppObject) {\r\n    return appObject.getComponent<MounterUC>(MounterUC.type);\r\n  }\r\n\r\n  static getById(id: string, appObjects: AppObjectRepo) {\r\n    const ao = appObjects.get(id);\r\n    return ao?.getComponent<MounterUC>(MounterUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMounterUC(appObject: AppObject): MounterUC {\r\n  return new MounterUCImp(appObject);\r\n}\r\n\r\nclass MounterUCImp extends MounterUC {\r\n  private get getAppFromAPI() {\r\n    return this.getCachedSingleton<GetAppFromAPIUC>(GetAppFromAPIUC.type);\r\n  }\r\n\r\n  private get app() {\r\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  private get hostHandler() {\r\n    return this.getCachedLocalComponent<HostHandlerEntity>(\r\n      HostHandlerEntity.type\r\n    );\r\n  }\r\n\r\n  private get hostDispatcher() {\r\n    return this.getCachedLocalComponent<HostDispatchEntity>(\r\n      HostDispatchEntity.type\r\n    );\r\n  }\r\n\r\n  private getAppVersion(major: number, minor: number): Version | undefined {\r\n    if (!this.app) {\r\n      return;\r\n    }\r\n\r\n    let appVersion = Version.GetLatestWithMajorMinor(\r\n      this.app.versions,\r\n      major,\r\n      minor\r\n    );\r\n\r\n    if (!appVersion) {\r\n      appVersion = Version.GetLatestWithMajor(this.app.versions, major);\r\n    }\r\n\r\n    if (!appVersion) {\r\n      this.error(\r\n        `Unable to find version ${major}.${minor}.X for App ${this.app.name}`\r\n      );\r\n    }\r\n\r\n    return appVersion;\r\n  }\r\n\r\n  private scriptElements: HTMLScriptElement[] = [];\r\n\r\n  mountLatestVersion(): Promise<void> {\r\n    if (!this.app) {\r\n      this.error(\"Missing Components\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const version = this.app.latestVersion;\r\n    if (!version) {\r\n      this.error(\"No Version\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    return this.mount(version.major, version.minor);\r\n  }\r\n\r\n  unmount = () => {\r\n    if (!this.app) return;\r\n    if (!this.app.mountedVersion) return;\r\n\r\n    const versionID = formAppIDWithVersion(this.app, this.app.mountedVersion);\r\n    (window as any)[versionID] = undefined;\r\n    delete (window as any)[versionID];\r\n\r\n    this.scriptElements.forEach((element) => {\r\n      element.remove();\r\n    });\r\n    this.scriptElements = [];\r\n\r\n    this.app.styles = [];\r\n    this.app.appAssetFolderURL = undefined;\r\n    this.app.mountedVersion = undefined;\r\n    this.app.state = AppState.INIT;\r\n  };\r\n\r\n  mount = (majorVersion: number, minorVersion: number): Promise<void> => {\r\n    const fetchApp = this.getAppFromAPI;\r\n    if (!fetchApp) {\r\n      this.error(\"No Fetch App UC\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const app = this.app;\r\n    if (!app) {\r\n      this.error(\"No App\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const hostHandler = this.hostHandler;\r\n    if (!hostHandler) {\r\n      this.error(\"No Host Handler\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const hostDispatcher = this.hostDispatcher;\r\n    if (!hostDispatcher) {\r\n      this.error(\"No Host Dispatcher\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const version = this.getAppVersion(majorVersion, minorVersion);\r\n    if (!version) {\r\n      return Promise.reject(\r\n        new Error(\r\n          `Unable to find version ${majorVersion}.${minorVersion}.X for App ${app.name}`\r\n        )\r\n      );\r\n    }\r\n\r\n    this.log(\r\n      `Initializing App ${app.name} [${app.id}] version ${version.displayString}`\r\n    );\r\n\r\n    if (app.mountedVersion) {\r\n      if (Version.AreEqual(app.mountedVersion, version)) {\r\n        return Promise.resolve();\r\n      } else {\r\n        this.unmount();\r\n      }\r\n    }\r\n\r\n    app.state = AppState.LOADING;\r\n\r\n    return new Promise<void>((resolve, reject) => {\r\n      fetchApp\r\n        .getApp(this.appObject.id, version.baseVersionString)\r\n        .then((appDTO) => {\r\n          app.appAssetFolderURL = appDTO.assetFolderURL;\r\n          const { scripts, styles } = this.parseEndpoints(appDTO.entrypoints);\r\n          app.styles = styles;\r\n          return this.loadScripts(scripts, version);\r\n        })\r\n        .then((appInterface) => {\r\n          const appHandler = appInterface.mount(hostHandler.handler);\r\n          hostDispatcher.registerAppHandler(appHandler);\r\n          return this.waitForAppIsReady(app, version);\r\n        })\r\n        .then(() => {\r\n          app.mountedVersion = version;\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          app.state = AppState.ERROR;\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  private loadScripts = (\r\n    scripts: string[],\r\n    version: Version\r\n  ): Promise<VIVEDApp_3> => {\r\n    const app = this.app;\r\n    if (!app) {\r\n      this.error(\"No app entity\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    let appInterface = this.getAppInterface(version);\r\n    const versionID = formAppIDWithVersion(app, version);\r\n\r\n    if (appInterface) {\r\n      return Promise.resolve(appInterface);\r\n    }\r\n\r\n    return new Promise<VIVEDApp_3>((resolve, reject) => {\r\n      const loaders = scripts.map((entryPoint) => {\r\n        return this.loadScriptIntoDocument(entryPoint, versionID);\r\n      });\r\n      Promise.all(loaders)\r\n        .then(() => {\r\n          appInterface = this.getAppInterface(version);\r\n\r\n          if (!appInterface) {\r\n            reject(\r\n              \"App is undefined for ID: \" +\r\n                app.id +\r\n                \". Make sure ID is correct in the 3 files in the app project.\"\r\n            );\r\n          } else {\r\n            resolve(appInterface);\r\n          }\r\n        })\r\n        .catch((e) => {\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  loadScriptIntoDocument = (\r\n    scriptURL: string,\r\n    appIDWithVersion: string\r\n  ): Promise<void> => {\r\n    return new Promise<void>((resolve, reject) => {\r\n      const aScript = document.createElement(\"script\");\r\n\r\n      aScript.onload = function onLoad() {\r\n        resolve();\r\n      };\r\n\r\n      aScript.onerror = function onError(e) {\r\n        reject(new Error(`Failed to add script to document`));\r\n      };\r\n\r\n      aScript.type = \"text/javascript\";\r\n      aScript.src = scriptURL;\r\n      aScript.className = appIDWithVersion;\r\n      this.scriptElements.push(aScript);\r\n\r\n      document.head.appendChild(aScript);\r\n    });\r\n  };\r\n\r\n  getAppInterface = (version: Version): VIVEDApp_3 | undefined => {\r\n    if (!this.app) return;\r\n\r\n    const versionID = formAppIDWithVersion(this.app, version);\r\n\r\n    let appInterface = (window as any)[versionID] as VIVEDApp_3;\r\n\r\n    if (!appInterface) {\r\n      appInterface = (window as any)[this.app.id] as VIVEDApp_3; // Old way of identifying apps\r\n    }\r\n\r\n    return appInterface;\r\n  };\r\n\r\n  private parseEndpoints(\r\n    endpoints: string[]\r\n  ): {\r\n    scripts: string[];\r\n    styles: string[];\r\n  } {\r\n    const scripts: string[] = [];\r\n    const styles: string[] = [];\r\n\r\n    endpoints.forEach((endpoint) => {\r\n      if (endpoint.includes(\".js\")) {\r\n        scripts.push(endpoint);\r\n      } else if (endpoint.includes(\".css\")) {\r\n        styles.push(endpoint);\r\n      } else {\r\n        this.warn(\"Unknown endpoint: \" + endpoint);\r\n      }\r\n    });\r\n\r\n    return {\r\n      scripts,\r\n      styles\r\n    };\r\n  }\r\n\r\n  waitForAppIsReady(app: AppEntity, appVersion: Version): Promise<void> {\r\n    // Edge cases here\r\n    if (\r\n      app.id === \"app4e48fbaa815a4857821bf7569b003751\" &&\r\n      appVersion.major === 1 &&\r\n      appVersion.minor === 0\r\n    ) {\r\n      // Mark board app has a problem with version 1.0\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    if (\r\n      app.id === \"appe860b51f49414e20ae7995dff4d9b152\" &&\r\n      appVersion.major === 1 &&\r\n      appVersion.minor <= 2\r\n    ) {\r\n      // Older versions of the text app do not report when ready\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    if (\r\n      app.id === \"app41df8a36f628451d9f633f8a9bdf3edb\" &&\r\n      appVersion.major === 1 &&\r\n      appVersion.minor <= 1\r\n    ) {\r\n      // Older versions of the YouTube app do not report when ready\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    if (app.id === \"app448f8f293fbb493a9e233f113ce8b56a\") {\r\n      // Asset Plugin\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    // Allows testing to not get hung up waiting for this\r\n    if (app.id === \"APP_FOR_JEST_TEST\") {\r\n      // Older versions of the YouTube app do not report when ready\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    return new Promise<void>((resolve) => {\r\n      const appObserver = () => {\r\n        if (app.state === AppState.READY) {\r\n          app.removeChangeObserver(appObserver);\r\n          resolve();\r\n        }\r\n      };\r\n      app.addChangeObserver(appObserver);\r\n    });\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, MounterUC.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MounterUC.js","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/MounterUC.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC,\r\n  Version,\r\n  VIVEDApp_3\r\n} from \"@vived/core\";\r\nimport { HostDispatchEntity } from \"../../../Dispatcher/Entities/HostDispatchEntity\";\r\nimport { HostHandlerEntity } from \"../../../Handler/Entities/HostHandler\";\r\nimport { GetAppFromAPIUC } from \"../../../VivedAPI/UCs/GetAppFromAPIUC\";\r\nimport { AppEntity, AppState } from \"../../Entities/AppEntity\";\r\nimport { formAppIDWithVersion } from \"../formAppIDWithVersion\";\r\n\r\n/**\r\n * Abstract base class for app mounting use cases.\r\n *\r\n * The MounterUC is responsible for loading, initializing, and managing app\r\n * lifecycle. It handles script loading, version management, and communication\r\n * setup between the host and app.\r\n *\r\n * @extends AppObjectUC from @vived/core\r\n */\r\nexport abstract class MounterUC extends AppObjectUC {\r\n  static type = \"MounterUC\";\r\n\r\n  /**\r\n   * Mounts a specific version of the app.\r\n   *\r\n   * @param majorVersion - The major version number\r\n   * @param minorVersion - The minor version number\r\n   * @returns A promise that resolves when the app is mounted\r\n   */\r\n  abstract mount(majorVersion: number, minorVersion: number): Promise<void>;\r\n\r\n  /**\r\n   * Mounts the latest available version of the app.\r\n   *\r\n   * @returns A promise that resolves when the app is mounted\r\n   */\r\n  abstract mountLatestVersion(): Promise<void>;\r\n\r\n  /**\r\n   * Unmounts the app, removing it from the runtime environment.\r\n   */\r\n  abstract unmount(): void;\r\n\r\n  /**\r\n   * Loads a script into the document.\r\n   *\r\n   * @param scriptURL - URL of the script to load\r\n   * @param appIDWithVersion - Versioned ID of the app\r\n   * @returns A promise that resolves when the script is loaded\r\n   */\r\n  abstract loadScriptIntoDocument(\r\n    scriptURL: string,\r\n    appIDWithVersion: string\r\n  ): Promise<void>; // Exposed for testing purposes\r\n\r\n  /**\r\n   * Gets the app interface for a specific version.\r\n   *\r\n   * @param version - The version to get the interface for\r\n   * @returns The app interface or undefined if not found\r\n   */\r\n  abstract getAppInterface(version: Version): VIVEDApp_3 | undefined; // Exposed for test purposes\r\n\r\n  /**\r\n   * Retrieves the MounterUC component from an app object.\r\n   *\r\n   * @param appObject - The app object to get the component from\r\n   * @returns The MounterUC component or undefined if not found\r\n   */\r\n  static get(appObject: AppObject) {\r\n    return appObject.getComponent<MounterUC>(MounterUC.type);\r\n  }\r\n\r\n  /**\r\n   * Retrieves the MounterUC component by app object ID.\r\n   *\r\n   * @param id - The ID of the app object\r\n   * @param appObjects - The app object repository\r\n   * @returns The MounterUC component or undefined if not found\r\n   */\r\n  static getById(id: string, appObjects: AppObjectRepo) {\r\n    const ao = appObjects.get(id);\r\n    return ao?.getComponent<MounterUC>(MounterUC.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new MounterUC instance.\r\n *\r\n * @param appObject - The app object to attach the mounter to\r\n * @returns A new MounterUC instance\r\n */\r\nexport function makeMounterUC(appObject: AppObject): MounterUC {\r\n  return new MounterUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of the MounterUC abstract class.\r\n *\r\n * This implementation provides the standard mounting behavior for loading\r\n * and initializing apps, handling script loading, and managing app lifecycle.\r\n */\r\nclass MounterUCImp extends MounterUC {\r\n  /**\r\n   * Gets the use case for retrieving apps from the API.\r\n   */\r\n  private get getAppFromAPI() {\r\n    return this.getCachedSingleton<GetAppFromAPIUC>(GetAppFromAPIUC.type);\r\n  }\r\n\r\n  /**\r\n   * Gets the app entity representing the app being mounted.\r\n   */\r\n  private get app() {\r\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Gets the host handler entity for receiving messages from apps.\r\n   */\r\n  private get hostHandler() {\r\n    return this.getCachedLocalComponent<HostHandlerEntity>(\r\n      HostHandlerEntity.type\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Gets the host dispatcher entity for sending messages to apps.\r\n   */\r\n  private get hostDispatcher() {\r\n    return this.getCachedLocalComponent<HostDispatchEntity>(\r\n      HostDispatchEntity.type\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Helper method to find a specific version of the app.\r\n   *\r\n   * @param major - Major version number\r\n   * @param minor - Minor version number\r\n   * @returns The Version object or undefined if not found\r\n   */\r\n  private getAppVersion(major: number, minor: number): Version | undefined {\r\n    if (!this.app) {\r\n      return;\r\n    }\r\n\r\n    let appVersion = Version.GetLatestWithMajorMinor(\r\n      this.app.versions,\r\n      major,\r\n      minor\r\n    );\r\n\r\n    if (!appVersion) {\r\n      appVersion = Version.GetLatestWithMajor(this.app.versions, major);\r\n    }\r\n\r\n    if (!appVersion) {\r\n      this.error(\r\n        `Unable to find version ${major}.${minor}.X for App ${this.app.name}`\r\n      );\r\n    }\r\n\r\n    return appVersion;\r\n  }\r\n\r\n  /**\r\n   * Tracks script elements added to the document to enable cleanup.\r\n   */\r\n  private scriptElements: HTMLScriptElement[] = [];\r\n\r\n  /**\r\n   * Mounts the latest available version of the app.\r\n   *\r\n   * @returns A promise that resolves when the app is mounted\r\n   */\r\n  mountLatestVersion(): Promise<void> {\r\n    if (!this.app) {\r\n      this.error(\"Missing Components\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const version = this.app.latestVersion;\r\n    if (!version) {\r\n      this.error(\"No Version\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    return this.mount(version.major, version.minor);\r\n  }\r\n\r\n  /**\r\n   * Unmounts the app, removing it from the runtime environment.\r\n   *\r\n   * This removes script elements, cleans up global references,\r\n   * and resets app state.\r\n   */\r\n  unmount = () => {\r\n    if (!this.app) return;\r\n    if (!this.app.mountedVersion) return;\r\n\r\n    const versionID = formAppIDWithVersion(this.app, this.app.mountedVersion);\r\n    (window as any)[versionID] = undefined;\r\n    delete (window as any)[versionID];\r\n\r\n    this.scriptElements.forEach((element) => {\r\n      element.remove();\r\n    });\r\n    this.scriptElements = [];\r\n\r\n    this.app.styles = [];\r\n    this.app.appAssetFolderURL = undefined;\r\n    this.app.mountedVersion = undefined;\r\n    this.app.state = AppState.INIT;\r\n  };\r\n\r\n  /**\r\n   * Mounts a specific version of the app.\r\n   *\r\n   * This method fetches the app from the API, loads scripts,\r\n   * establishes communication with the app, and waits for the\r\n   * app to be ready.\r\n   *\r\n   * @param majorVersion - The major version number\r\n   * @param minorVersion - The minor version number\r\n   * @returns A promise that resolves when the app is mounted\r\n   */\r\n  mount = (majorVersion: number, minorVersion: number): Promise<void> => {\r\n    const fetchApp = this.getAppFromAPI;\r\n    if (!fetchApp) {\r\n      this.error(\"No Fetch App UC\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const app = this.app;\r\n    if (!app) {\r\n      this.error(\"No App\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const hostHandler = this.hostHandler;\r\n    if (!hostHandler) {\r\n      this.error(\"No Host Handler\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const hostDispatcher = this.hostDispatcher;\r\n    if (!hostDispatcher) {\r\n      this.error(\"No Host Dispatcher\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const version = this.getAppVersion(majorVersion, minorVersion);\r\n    if (!version) {\r\n      return Promise.reject(\r\n        new Error(\r\n          `Unable to find version ${majorVersion}.${minorVersion}.X for App ${app.name}`\r\n        )\r\n      );\r\n    }\r\n\r\n    this.log(\r\n      `Initializing App ${app.name} [${app.id}] version ${version.displayString}`\r\n    );\r\n\r\n    if (app.mountedVersion) {\r\n      if (Version.AreEqual(app.mountedVersion, version)) {\r\n        return Promise.resolve();\r\n      } else {\r\n        this.unmount();\r\n      }\r\n    }\r\n\r\n    app.state = AppState.LOADING;\r\n\r\n    return new Promise<void>((resolve, reject) => {\r\n      fetchApp\r\n        .getApp(this.appObject.id, version.baseVersionString)\r\n        .then((appDTO) => {\r\n          app.appAssetFolderURL = appDTO.assetFolderURL;\r\n          const { scripts, styles } = this.parseEndpoints(appDTO.entrypoints);\r\n          app.styles = styles;\r\n          return this.loadScripts(scripts, version);\r\n        })\r\n        .then((appInterface) => {\r\n          const appHandler = appInterface.mount(hostHandler.handler);\r\n          hostDispatcher.registerAppHandler(appHandler);\r\n          return this.waitForAppIsReady(app, version);\r\n        })\r\n        .then(() => {\r\n          app.mountedVersion = version;\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          app.state = AppState.ERROR;\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Loads app scripts and retrieves the app interface.\r\n   *\r\n   * @param scripts - Array of script URLs to load\r\n   * @param version - The app version\r\n   * @returns A promise that resolves with the app interface\r\n   */\r\n  private loadScripts = (\r\n    scripts: string[],\r\n    version: Version\r\n  ): Promise<VIVEDApp_3> => {\r\n    const app = this.app;\r\n    if (!app) {\r\n      this.error(\"No app entity\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    let appInterface = this.getAppInterface(version);\r\n    const versionID = formAppIDWithVersion(app, version);\r\n\r\n    if (appInterface) {\r\n      return Promise.resolve(appInterface);\r\n    }\r\n\r\n    return new Promise<VIVEDApp_3>((resolve, reject) => {\r\n      const loaders = scripts.map((entryPoint) => {\r\n        return this.loadScriptIntoDocument(entryPoint, versionID);\r\n      });\r\n      Promise.all(loaders)\r\n        .then(() => {\r\n          appInterface = this.getAppInterface(version);\r\n\r\n          if (!appInterface) {\r\n            reject(\r\n              \"App is undefined for ID: \" +\r\n                app.id +\r\n                \". Make sure ID is correct in the 3 files in the app project.\"\r\n            );\r\n          } else {\r\n            resolve(appInterface);\r\n          }\r\n        })\r\n        .catch((e) => {\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Loads a script into the document.\r\n   *\r\n   * @param scriptURL - URL of the script to load\r\n   * @param appIDWithVersion - Versioned ID of the app\r\n   * @returns A promise that resolves when the script is loaded\r\n   */\r\n  loadScriptIntoDocument = (\r\n    scriptURL: string,\r\n    appIDWithVersion: string\r\n  ): Promise<void> => {\r\n    return new Promise<void>((resolve, reject) => {\r\n      const aScript = document.createElement(\"script\");\r\n\r\n      aScript.onload = function onLoad() {\r\n        resolve();\r\n      };\r\n\r\n      aScript.onerror = function onError(e) {\r\n        reject(new Error(`Failed to add script to document`));\r\n      };\r\n\r\n      aScript.type = \"text/javascript\";\r\n      aScript.src = scriptURL;\r\n      aScript.className = appIDWithVersion;\r\n      this.scriptElements.push(aScript);\r\n\r\n      document.head.appendChild(aScript);\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Gets the app interface for a specific version.\r\n   *\r\n   * @param version - The version to get the interface for\r\n   * @returns The app interface or undefined if not found\r\n   */\r\n  getAppInterface = (version: Version): VIVEDApp_3 | undefined => {\r\n    if (!this.app) return;\r\n\r\n    const versionID = formAppIDWithVersion(this.app, version);\r\n\r\n    let appInterface = (window as any)[versionID] as VIVEDApp_3;\r\n\r\n    if (!appInterface) {\r\n      appInterface = (window as any)[this.app.id] as VIVEDApp_3; // Old way of identifying apps\r\n    }\r\n\r\n    return appInterface;\r\n  };\r\n\r\n  /**\r\n   * Parses app entrypoints into scripts and styles.\r\n   *\r\n   * @param endpoints - Array of endpoint URLs\r\n   * @returns Object with separate arrays for scripts and styles\r\n   */\r\n  private parseEndpoints(endpoints: string[]): {\r\n    scripts: string[];\r\n    styles: string[];\r\n  } {\r\n    const scripts: string[] = [];\r\n    const styles: string[] = [];\r\n\r\n    endpoints.forEach((endpoint) => {\r\n      if (endpoint.includes(\".js\")) {\r\n        scripts.push(endpoint);\r\n      } else if (endpoint.includes(\".css\")) {\r\n        styles.push(endpoint);\r\n      } else {\r\n        this.warn(\"Unknown endpoint: \" + endpoint);\r\n      }\r\n    });\r\n\r\n    return {\r\n      scripts,\r\n      styles\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Waits for an app to report it's ready.\r\n   *\r\n   * This method handles special cases for apps that don't properly\r\n   * report their ready state, as well as the normal case where\r\n   * apps transition to the READY state.\r\n   *\r\n   * @param app - The app entity\r\n   * @param appVersion - The app version\r\n   * @returns A promise that resolves when the app is ready\r\n   */\r\n  waitForAppIsReady(app: AppEntity, appVersion: Version): Promise<void> {\r\n    // Edge cases here\r\n    if (\r\n      app.id === \"app4e48fbaa815a4857821bf7569b003751\" &&\r\n      appVersion.major === 1 &&\r\n      appVersion.minor === 0\r\n    ) {\r\n      // Mark board app has a problem with version 1.0\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    if (\r\n      app.id === \"appe860b51f49414e20ae7995dff4d9b152\" &&\r\n      appVersion.major === 1 &&\r\n      appVersion.minor <= 2\r\n    ) {\r\n      // Older versions of the text app do not report when ready\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    if (\r\n      app.id === \"app41df8a36f628451d9f633f8a9bdf3edb\" &&\r\n      appVersion.major === 1 &&\r\n      appVersion.minor <= 1\r\n    ) {\r\n      // Older versions of the YouTube app do not report when ready\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    if (app.id === \"app448f8f293fbb493a9e233f113ce8b56a\") {\r\n      // Asset Plugin\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    // Allows testing to not get hung up waiting for this\r\n    if (app.id === \"APP_FOR_JEST_TEST\") {\r\n      // Older versions of the YouTube app do not report when ready\r\n      app.state = AppState.READY;\r\n      return Promise.resolve();\r\n    }\r\n\r\n    return new Promise<void>((resolve) => {\r\n      const appObserver = () => {\r\n        if (app.state === AppState.READY) {\r\n          app.removeChangeObserver(appObserver);\r\n          resolve();\r\n        }\r\n      };\r\n      app.addChangeObserver(appObserver);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a new MounterUCImp instance.\r\n   *\r\n   * @param appObject - The app object to attach to\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, MounterUC.type);\r\n  }\r\n}\r\n"]}

package/dist/esm/Apps/UCs/Mounters/SandboxMounterUC.js

@@ -4,22 +4,57 @@ import { HostDispatchEntity } from "../../../Dispatcher/Entities/HostDispatchEnt
 import { HostHandlerEntity } from "../../../Handler/Entities/HostHandler";
 import { AppEntity, AppState } from "../../Entities/AppEntity";
 import { MounterUC } from "./MounterUC";
+/**
+ * Factory function to create a sandbox mounter for apps.
+ *
+ * The sandbox mounter is designed to mount apps in a sandboxed environment,
+ * providing isolation and security for app execution.
+ *
+ * @param appObject - The app object to attach the mounter to
+ * @returns A new SandboxMounterUC instance
+ */
 export function makeSandboxMounter(appObject) {
     return new SandboxMounterUC(appObject);
 }
+/**
+ * Implementation of MounterUC for mounting apps in a sandbox environment.
+ *
+ * The SandboxMounterUC is responsible for safely loading and initializing apps
+ * in a sandboxed context, handling app lifecycle events, and managing the
+ * communication between the host and app.
+ */
 class SandboxMounterUC extends MounterUC {
+    /**
+     * Gets the app entity representing the app being mounted
+     */
     get appEntity() {
         return this.getCachedLocalComponent(AppEntity.type);
     }
+    /**
+     * Gets the host dispatcher entity for sending messages to apps
+     */
     get hostDispatcher() {
         return this.getCachedLocalComponent(HostDispatchEntity.type);
     }
+    /**
+     * Gets the host handler entity for receiving messages from apps
+     */
     get hostHandler() {
         return this.getCachedLocalComponent(HostHandlerEntity.type);
     }
+    /**
+     * Gets the sandbox entity that manages the sandbox state
+     */
     get sandbox() {
         return this.getCachedSingleton(AppSandboxEntity.type);
     }
+    /**
+     * Helper method to find a specific version of the app.
+     *
+     * @param major - Major version number
+     * @param minor - Minor version number
+     * @returns The Version object or undefined if not found
+     */
     getAppVersion(major, minor) {
         if (!this.appEntity) {
             return;
@@ -33,10 +68,24 @@ class SandboxMounterUC extends MounterUC {
         }
         return appVersion;
     }
+    /**
+     * Loads a script into the document.
+     * This is a placeholder implementation for sandbox mounting.
+     *
+     * @param scriptURL - URL of the script to load
+     * @param appIDWithVersion - Versioned ID of the app
+     * @returns A promise that resolves when the script is loaded
+     */
     loadScriptIntoDocument(scriptURL, appIDWithVersion) {
         // Unused during dev
         return Promise.resolve();
     }
+    /**
+     * Gets the app interface for a specific version.
+     *
+     * @param version - The version to get the interface for
+     * @returns The app interface or undefined if not found
+     */
     getAppInterface(version) {
         const modifiedVersion = version.baseVersionString.split(".").join("_");
         const idWithVersion = `${this.appObject.id}-${modifiedVersion}`;
@@ -47,8 +96,18 @@ class SandboxMounterUC extends MounterUC {
         }
         return appInterface;
     }
+    /**
+     * Creates a new SandboxMounterUC instance.
+     *
+     * @param appObject - The app object to attach to
+     */
     constructor(appObject) {
         super(appObject, MounterUC.type);
+        /**
+         * Mounts the latest version of the app.
+         *
+         * @returns A promise that resolves when the app is mounted or rejects if an error occurs
+         */
         this.mountLatestVersion = () => {
             if (!this.appEntity) {
                 this.error("Missing Components");
@@ -61,6 +120,13 @@ class SandboxMounterUC extends MounterUC {
             }
             return this.mount(version.major, version.minor);
         };
+        /**
+         * Mounts a specific version of the app.
+         *
+         * @param majorVersion - The major version number
+         * @param minorVersion - The minor version number
+         * @returns A promise that resolves when the app is mounted or rejects if an error occurs
+         */
         this.mount = (majorVersion, minorVersion) => {
             if (!this.appEntity ||
                 !this.hostDispatcher ||
@@ -94,6 +160,9 @@ class SandboxMounterUC extends MounterUC {
                 app.addChangeObserver(waitForReady);
             });
         };
+        /**
+         * Unmounts the app from the sandbox.
+         */
         this.unmount = () => {
             if (!this.sandbox || !this.hostDispatcher) {
                 this.error("Missing Components");

package/dist/esm/Apps/UCs/Mounters/SandboxMounterUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxMounterUC.js","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/SandboxMounterUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, Version, VIVEDApp_3 } from \"@vived/core\";\r\nimport {\r\n  AppSandboxEntity,\r\n  SandboxState\r\n} from \"../../../AppSandbox/Entities/AppSandboxEntity\";\r\nimport { HostDispatchEntity } from \"../../../Dispatcher/Entities/HostDispatchEntity\";\r\nimport { HostHandlerEntity } from \"../../../Handler/Entities/HostHandler\";\r\nimport { AppEntity, AppState } from \"../../Entities/AppEntity\";\r\nimport { MounterUC } from \"./MounterUC\";\r\n\r\nexport function makeSandboxMounter(appObject: AppObject): MounterUC {\r\n  return new SandboxMounterUC(appObject);\r\n}\r\n\r\nclass SandboxMounterUC extends MounterUC {\r\n  private get appEntity() {\r\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  private get hostDispatcher() {\r\n    return this.getCachedLocalComponent<HostDispatchEntity>(\r\n      HostDispatchEntity.type\r\n    );\r\n  }\r\n\r\n  private get hostHandler() {\r\n    return this.getCachedLocalComponent<HostHandlerEntity>(\r\n      HostHandlerEntity.type\r\n    );\r\n  }\r\n\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  mountLatestVersion = (): Promise<void> => {\r\n    if (!this.appEntity) {\r\n      this.error(\"Missing Components\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const version = this.appEntity.latestVersion;\r\n    if (!version) {\r\n      this.error(\"No Version\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    return this.mount(version.major, version.minor);\r\n  };\r\n\r\n  mount = (majorVersion: number, minorVersion: number): Promise<void> => {\r\n    if (\r\n      !this.appEntity ||\r\n      !this.hostDispatcher ||\r\n      !this.hostHandler ||\r\n      !this.sandbox\r\n    ) {\r\n      this.error(\"Missing Components\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const version = this.getAppVersion(majorVersion, minorVersion);\r\n    if (!version) {\r\n      this.error(\"No Version\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const appInterface = this.getAppInterface(version);\r\n    if (!appInterface) {\r\n      this.error(\"No App Interface\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const appHandler = appInterface.mount(this.hostHandler.handler);\r\n    this.hostDispatcher.registerAppHandler(appHandler);\r\n\r\n    const app = this.appEntity;\r\n    const sandbox = this.sandbox;\r\n\r\n    return new Promise((resolve) => {\r\n      const waitForReady = () => {\r\n        if (app.state === AppState.READY) {\r\n          sandbox.state = SandboxState.MOUNTED;\r\n          app.removeChangeObserver(waitForReady);\r\n          resolve();\r\n        }\r\n      };\r\n\r\n      app.addChangeObserver(waitForReady);\r\n    });\r\n  };\r\n\r\n  private getAppVersion(major: number, minor: number): Version | undefined {\r\n    if (!this.appEntity) {\r\n      return;\r\n    }\r\n\r\n    let appVersion = Version.GetLatestWithMajorMinor(\r\n      this.appEntity.versions,\r\n      major,\r\n      minor\r\n    );\r\n\r\n    if (!appVersion) {\r\n      appVersion = Version.GetLatestWithMajor(this.appEntity.versions, major);\r\n    }\r\n\r\n    if (!appVersion) {\r\n      this.error(\r\n        `Unable to find version ${major}.${minor}.X for App ${this.appEntity.name}`\r\n      );\r\n    }\r\n\r\n    return appVersion;\r\n  }\r\n\r\n  unmount = (): void => {\r\n    if (!this.sandbox || !this.hostDispatcher) {\r\n      this.error(\"Missing Components\");\r\n      return;\r\n    }\r\n\r\n    this.hostDispatcher.clearAppHandler();\r\n\r\n    this.sandbox.state = SandboxState.UNMOUNTED;\r\n  };\r\n\r\n  loadScriptIntoDocument(\r\n    scriptURL: string,\r\n    appIDWithVersion: string\r\n  ): Promise<void> {\r\n    // Unused during dev\r\n    return Promise.resolve();\r\n  }\r\n\r\n  getAppInterface(version: Version): VIVEDApp_3 | undefined {\r\n    const modifiedVersion = version.baseVersionString.split(\".\").join(\"_\");\r\n    const idWithVersion = `${this.appObject.id}-${modifiedVersion}`;\r\n    const appInterface = (window as any)[idWithVersion] as VIVEDApp_3;\r\n    if (!appInterface) {\r\n      this.appObjects.submitFatal(\r\n        \"LocalMounterUC\",\r\n        \"Unable to find App Interface\"\r\n      );\r\n      return;\r\n    }\r\n\r\n    return appInterface;\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, MounterUC.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SandboxMounterUC.js","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/SandboxMounterUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, Version, VIVEDApp_3 } from \"@vived/core\";\r\nimport {\r\n  AppSandboxEntity,\r\n  SandboxState\r\n} from \"../../../AppSandbox/Entities/AppSandboxEntity\";\r\nimport { HostDispatchEntity } from \"../../../Dispatcher/Entities/HostDispatchEntity\";\r\nimport { HostHandlerEntity } from \"../../../Handler/Entities/HostHandler\";\r\nimport { AppEntity, AppState } from \"../../Entities/AppEntity\";\r\nimport { MounterUC } from \"./MounterUC\";\r\n\r\n/**\r\n * Factory function to create a sandbox mounter for apps.\r\n *\r\n * The sandbox mounter is designed to mount apps in a sandboxed environment,\r\n * providing isolation and security for app execution.\r\n *\r\n * @param appObject - The app object to attach the mounter to\r\n * @returns A new SandboxMounterUC instance\r\n */\r\nexport function makeSandboxMounter(appObject: AppObject): MounterUC {\r\n  return new SandboxMounterUC(appObject);\r\n}\r\n\r\n/**\r\n * Implementation of MounterUC for mounting apps in a sandbox environment.\r\n *\r\n * The SandboxMounterUC is responsible for safely loading and initializing apps\r\n * in a sandboxed context, handling app lifecycle events, and managing the\r\n * communication between the host and app.\r\n */\r\nclass SandboxMounterUC extends MounterUC {\r\n  /**\r\n   * Gets the app entity representing the app being mounted\r\n   */\r\n  private get appEntity() {\r\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Gets the host dispatcher entity for sending messages to apps\r\n   */\r\n  private get hostDispatcher() {\r\n    return this.getCachedLocalComponent<HostDispatchEntity>(\r\n      HostDispatchEntity.type\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Gets the host handler entity for receiving messages from apps\r\n   */\r\n  private get hostHandler() {\r\n    return this.getCachedLocalComponent<HostHandlerEntity>(\r\n      HostHandlerEntity.type\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Gets the sandbox entity that manages the sandbox state\r\n   */\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Mounts the latest version of the app.\r\n   *\r\n   * @returns A promise that resolves when the app is mounted or rejects if an error occurs\r\n   */\r\n  mountLatestVersion = (): Promise<void> => {\r\n    if (!this.appEntity) {\r\n      this.error(\"Missing Components\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const version = this.appEntity.latestVersion;\r\n    if (!version) {\r\n      this.error(\"No Version\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    return this.mount(version.major, version.minor);\r\n  };\r\n\r\n  /**\r\n   * Mounts a specific version of the app.\r\n   *\r\n   * @param majorVersion - The major version number\r\n   * @param minorVersion - The minor version number\r\n   * @returns A promise that resolves when the app is mounted or rejects if an error occurs\r\n   */\r\n  mount = (majorVersion: number, minorVersion: number): Promise<void> => {\r\n    if (\r\n      !this.appEntity ||\r\n      !this.hostDispatcher ||\r\n      !this.hostHandler ||\r\n      !this.sandbox\r\n    ) {\r\n      this.error(\"Missing Components\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const version = this.getAppVersion(majorVersion, minorVersion);\r\n    if (!version) {\r\n      this.error(\"No Version\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const appInterface = this.getAppInterface(version);\r\n    if (!appInterface) {\r\n      this.error(\"No App Interface\");\r\n      return Promise.reject();\r\n    }\r\n\r\n    const appHandler = appInterface.mount(this.hostHandler.handler);\r\n    this.hostDispatcher.registerAppHandler(appHandler);\r\n\r\n    const app = this.appEntity;\r\n    const sandbox = this.sandbox;\r\n\r\n    return new Promise((resolve) => {\r\n      const waitForReady = () => {\r\n        if (app.state === AppState.READY) {\r\n          sandbox.state = SandboxState.MOUNTED;\r\n          app.removeChangeObserver(waitForReady);\r\n          resolve();\r\n        }\r\n      };\r\n\r\n      app.addChangeObserver(waitForReady);\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Helper method to find a specific version of the app.\r\n   *\r\n   * @param major - Major version number\r\n   * @param minor - Minor version number\r\n   * @returns The Version object or undefined if not found\r\n   */\r\n  private getAppVersion(major: number, minor: number): Version | undefined {\r\n    if (!this.appEntity) {\r\n      return;\r\n    }\r\n\r\n    let appVersion = Version.GetLatestWithMajorMinor(\r\n      this.appEntity.versions,\r\n      major,\r\n      minor\r\n    );\r\n\r\n    if (!appVersion) {\r\n      appVersion = Version.GetLatestWithMajor(this.appEntity.versions, major);\r\n    }\r\n\r\n    if (!appVersion) {\r\n      this.error(\r\n        `Unable to find version ${major}.${minor}.X for App ${this.appEntity.name}`\r\n      );\r\n    }\r\n\r\n    return appVersion;\r\n  }\r\n\r\n  /**\r\n   * Unmounts the app from the sandbox.\r\n   */\r\n  unmount = (): void => {\r\n    if (!this.sandbox || !this.hostDispatcher) {\r\n      this.error(\"Missing Components\");\r\n      return;\r\n    }\r\n\r\n    this.hostDispatcher.clearAppHandler();\r\n\r\n    this.sandbox.state = SandboxState.UNMOUNTED;\r\n  };\r\n\r\n  /**\r\n   * Loads a script into the document.\r\n   * This is a placeholder implementation for sandbox mounting.\r\n   *\r\n   * @param scriptURL - URL of the script to load\r\n   * @param appIDWithVersion - Versioned ID of the app\r\n   * @returns A promise that resolves when the script is loaded\r\n   */\r\n  loadScriptIntoDocument(\r\n    scriptURL: string,\r\n    appIDWithVersion: string\r\n  ): Promise<void> {\r\n    // Unused during dev\r\n    return Promise.resolve();\r\n  }\r\n\r\n  /**\r\n   * Gets the app interface for a specific version.\r\n   *\r\n   * @param version - The version to get the interface for\r\n   * @returns The app interface or undefined if not found\r\n   */\r\n  getAppInterface(version: Version): VIVEDApp_3 | undefined {\r\n    const modifiedVersion = version.baseVersionString.split(\".\").join(\"_\");\r\n    const idWithVersion = `${this.appObject.id}-${modifiedVersion}`;\r\n    const appInterface = (window as any)[idWithVersion] as VIVEDApp_3;\r\n    if (!appInterface) {\r\n      this.appObjects.submitFatal(\r\n        \"LocalMounterUC\",\r\n        \"Unable to find App Interface\"\r\n      );\r\n      return;\r\n    }\r\n\r\n    return appInterface;\r\n  }\r\n\r\n  /**\r\n   * Creates a new SandboxMounterUC instance.\r\n   *\r\n   * @param appObject - The app object to attach to\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, MounterUC.type);\r\n  }\r\n}\r\n"]}

package/dist/esm/Apps/UCs/StartAppUC.js

@@ -2,7 +2,27 @@ import { AppObjectUC } from "@vived/core";
 import { AppSandboxEntity } from "../../AppSandbox";
 import { DispatchEnableFeatureUC, DispatchIsAuthoringUC, DispatchSetStateUC, DispatchStartAppUC, DispatchThemeUC } from "../../Dispatcher";
 import { HostEditingStateEntity, HostStateMachine } from "../../StateMachine/Entities";
+/**
+ * StartAppUC - Use case for starting an application in the host environment
+ *
+ * This use case is responsible for initializing and starting an application
+ * within the VIVED Learning platform. It handles setting up the application container,
+ * initializing the app with the appropriate state, and dispatching necessary configurations.
+ *
+ * The StartAppUC coordinates between several subsystems:
+ * - State Machine: Provides the current application state
+ * - Dispatcher: Communicates with the app via message passing
+ * - AppSandbox: Provides development features when enabled
+ *
+ * @extends AppObjectUC from @vived/core
+ */
 export class StartAppUC extends AppObjectUC {
+    /**
+     * Gets a StartAppUC instance from an app object
+     *
+     * @param appObject - App object to get the StartAppUC from
+     * @returns StartAppUC instance if found, undefined otherwise
+     */
     static get(appObject) {
         const asset = appObject.getComponent(StartAppUC.type);
         if (!asset) {
@@ -10,6 +30,13 @@ export class StartAppUC extends AppObjectUC {
         }
         return asset;
     }
+    /**
+     * Gets a StartAppUC instance by app ID
+     *
+     * @param id - ID of the app to start
+     * @param appObjects - Repository containing app objects
+     * @returns StartAppUC instance if found, undefined otherwise
+     */
     static getByID(id, appObjects) {
         const appObject = appObjects.get(id);
         if (!appObject) {
@@ -18,14 +45,33 @@ export class StartAppUC extends AppObjectUC {
         }
         return StartAppUC.get(appObject);
     }
+    /**
+     * Convenience method to start an app by ID
+     *
+     * @param container - HTML element to mount the app in
+     * @param id - ID of the app to start
+     * @param appObjects - Repository containing app objects
+     */
     static startByID(container, id, appObjects) {
         StartAppUC.getByID(id, appObjects)?.start(container);
     }
 }
+/** Type identifier for the StartAppUC component */
 StartAppUC.type = "StartAppUC";
+/**
+ * Factory function to create a new StartAppUC instance
+ *
+ * @param appObject - The app object to attach the use case to
+ * @returns A concrete implementation of StartAppUC
+ */
 export function makeStartAppUC(appObject) {
     return new StartAppUCImp(appObject);
 }
+/**
+ * Concrete implementation of StartAppUC
+ * Uses dependency injection to access required components
+ * Handles the app starting process
+ */
 class StartAppUCImp extends StartAppUC {
     get stateMachine() {
         return this.getCachedSingleton(HostStateMachine.type);

package/dist/esm/Apps/UCs/StartAppUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"StartAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StartAppUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { AppSandboxEntity } from \"../../AppSandbox\";\r\nimport {\r\n  DispatchEnableFeatureUC,\r\n  DispatchIsAuthoringUC,\r\n  DispatchSetStateUC,\r\n  DispatchStartAppUC,\r\n  DispatchStateDTO,\r\n  DispatchThemeUC\r\n} from \"../../Dispatcher\";\r\nimport {\r\n  HostEditingStateEntity,\r\n  HostStateMachine\r\n} from \"../../StateMachine/Entities\";\r\n\r\nexport abstract class StartAppUC extends AppObjectUC {\r\n  static type = \"StartAppUC\";\r\n\r\n  abstract start(container: HTMLElement): void;\r\n\r\n  static get(appObject: AppObject): StartAppUC | undefined {\r\n    const asset = appObject.getComponent<StartAppUC>(StartAppUC.type);\r\n    if (!asset) {\r\n      appObject.appObjectRepo.submitWarning(\r\n        \"StartAppUC.get\",\r\n        \"Unable to find StartAppUC on app object \" + appObject.id\r\n      );\r\n    }\r\n    return asset;\r\n  }\r\n\r\n  static getByID(\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ): StartAppUC | undefined {\r\n    const appObject = appObjects.get(id);\r\n\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"StartAppUC.getByID\",\r\n        \"Unable to find App Object by id \" + id\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return StartAppUC.get(appObject);\r\n  }\r\n\r\n  static startByID(\r\n    container: HTMLElement,\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ) {\r\n    StartAppUC.getByID(id, appObjects)?.start(container);\r\n  }\r\n}\r\n\r\nexport function makeStartAppUC(appObject: AppObject): StartAppUC {\r\n  return new StartAppUCImp(appObject);\r\n}\r\n\r\nclass StartAppUCImp extends StartAppUC {\r\n  private get stateMachine() {\r\n    return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n  }\r\n\r\n  private get editStateEntity() {\r\n    return this.getCachedSingleton<HostEditingStateEntity>(\r\n      HostEditingStateEntity.type\r\n    );\r\n  }\r\n\r\n  private get dispatchStart() {\r\n    return this.getCachedLocalComponent<DispatchStartAppUC>(\r\n      DispatchStartAppUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchSetState() {\r\n    return this.getCachedLocalComponent<DispatchSetStateUC>(\r\n      DispatchSetStateUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchSetIsAuthoring() {\r\n    return this.getCachedLocalComponent<DispatchIsAuthoringUC>(\r\n      DispatchIsAuthoringUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchThemeColors() {\r\n    return this.getCachedLocalComponent<DispatchThemeUC>(DispatchThemeUC.type);\r\n  }\r\n\r\n  private get dispatchEnableFeature() {\r\n    return this.getCachedLocalComponent<DispatchEnableFeatureUC>(\r\n      DispatchEnableFeatureUC.type\r\n    );\r\n  }\r\n\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  start = (container: HTMLElement) => {\r\n    if (!this.stateMachine) return;\r\n    if (!this.dispatchStart) return;\r\n    if (!this.editStateEntity) return;\r\n    if (!this.sandbox) return;\r\n\r\n    this.dispatchStart.doDispatch(container);\r\n\r\n    let state;\r\n    if (this.stateMachine.activeState) {\r\n      state = this.stateMachine.getStateByID(this.stateMachine.activeState)\r\n        ?.stateData;\r\n    }\r\n\r\n    const hideNavigation = this.stateMachine.states.length <= 1;\r\n    const hasNextSlide = this.stateMachine.nextState !== undefined;\r\n    const hasPreviousSlide = this.stateMachine.previousState !== undefined;\r\n    const dto: DispatchStateDTO = {\r\n      finalState: state,\r\n      hideNavigation,\r\n      hasNextSlide,\r\n      hasPreviousSlide\r\n    };\r\n    this.dispatchSetState?.doDispatch(dto);\r\n\r\n    let isAuthoring = this.editStateEntity.isEditing;\r\n    if (this.stateMachine.activeState === undefined) {\r\n      isAuthoring = true;\r\n    }\r\n    this.dispatchSetIsAuthoring?.doDispatch(isAuthoring);\r\n\r\n    this.dispatchThemeColors?.doDispatch();\r\n\r\n    if (this.sandbox.enableDevFeatures) {\r\n      this.sandbox.devFeatures.forEach((feature) => {\r\n        this.dispatchEnableFeature?.doDispatch(feature);\r\n      });\r\n    }\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, StartAppUC.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"StartAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StartAppUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { AppSandboxEntity } from \"../../AppSandbox\";\r\nimport {\r\n  DispatchEnableFeatureUC,\r\n  DispatchIsAuthoringUC,\r\n  DispatchSetStateUC,\r\n  DispatchStartAppUC,\r\n  DispatchStateDTO,\r\n  DispatchThemeUC\r\n} from \"../../Dispatcher\";\r\nimport {\r\n  HostEditingStateEntity,\r\n  HostStateMachine\r\n} from \"../../StateMachine/Entities\";\r\n\r\n/**\r\n * StartAppUC - Use case for starting an application in the host environment\r\n * \r\n * This use case is responsible for initializing and starting an application\r\n * within the VIVED Learning platform. It handles setting up the application container,\r\n * initializing the app with the appropriate state, and dispatching necessary configurations.\r\n * \r\n * The StartAppUC coordinates between several subsystems:\r\n * - State Machine: Provides the current application state\r\n * - Dispatcher: Communicates with the app via message passing\r\n * - AppSandbox: Provides development features when enabled\r\n * \r\n * @extends AppObjectUC from @vived/core\r\n */\r\nexport abstract class StartAppUC extends AppObjectUC {\r\n  /** Type identifier for the StartAppUC component */\r\n  static type = \"StartAppUC\";\r\n\r\n  /**\r\n   * Abstract method that starts the application\r\n   * \r\n   * @param container - HTML element that will contain the app\r\n   */\r\n  abstract start(container: HTMLElement): void;\r\n\r\n  /**\r\n   * Gets a StartAppUC instance from an app object\r\n   * \r\n   * @param appObject - App object to get the StartAppUC from\r\n   * @returns StartAppUC instance if found, undefined otherwise\r\n   */\r\n  static get(appObject: AppObject): StartAppUC | undefined {\r\n    const asset = appObject.getComponent<StartAppUC>(StartAppUC.type);\r\n    if (!asset) {\r\n      appObject.appObjectRepo.submitWarning(\r\n        \"StartAppUC.get\",\r\n        \"Unable to find StartAppUC on app object \" + appObject.id\r\n      );\r\n    }\r\n    return asset;\r\n  }\r\n\r\n  /**\r\n   * Gets a StartAppUC instance by app ID\r\n   * \r\n   * @param id - ID of the app to start\r\n   * @param appObjects - Repository containing app objects\r\n   * @returns StartAppUC instance if found, undefined otherwise\r\n   */\r\n  static getByID(\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ): StartAppUC | undefined {\r\n    const appObject = appObjects.get(id);\r\n\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"StartAppUC.getByID\",\r\n        \"Unable to find App Object by id \" + id\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return StartAppUC.get(appObject);\r\n  }\r\n\r\n  /**\r\n   * Convenience method to start an app by ID\r\n   * \r\n   * @param container - HTML element to mount the app in\r\n   * @param id - ID of the app to start\r\n   * @param appObjects - Repository containing app objects\r\n   */\r\n  static startByID(\r\n    container: HTMLElement,\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ) {\r\n    StartAppUC.getByID(id, appObjects)?.start(container);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new StartAppUC instance\r\n * \r\n * @param appObject - The app object to attach the use case to\r\n * @returns A concrete implementation of StartAppUC\r\n */\r\nexport function makeStartAppUC(appObject: AppObject): StartAppUC {\r\n  return new StartAppUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of StartAppUC\r\n * Uses dependency injection to access required components\r\n * Handles the app starting process\r\n */\r\nclass StartAppUCImp extends StartAppUC {\r\n  private get stateMachine() {\r\n    return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n  }\r\n\r\n  private get editStateEntity() {\r\n    return this.getCachedSingleton<HostEditingStateEntity>(\r\n      HostEditingStateEntity.type\r\n    );\r\n  }\r\n\r\n  private get dispatchStart() {\r\n    return this.getCachedLocalComponent<DispatchStartAppUC>(\r\n      DispatchStartAppUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchSetState() {\r\n    return this.getCachedLocalComponent<DispatchSetStateUC>(\r\n      DispatchSetStateUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchSetIsAuthoring() {\r\n    return this.getCachedLocalComponent<DispatchIsAuthoringUC>(\r\n      DispatchIsAuthoringUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchThemeColors() {\r\n    return this.getCachedLocalComponent<DispatchThemeUC>(DispatchThemeUC.type);\r\n  }\r\n\r\n  private get dispatchEnableFeature() {\r\n    return this.getCachedLocalComponent<DispatchEnableFeatureUC>(\r\n      DispatchEnableFeatureUC.type\r\n    );\r\n  }\r\n\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  start = (container: HTMLElement) => {\r\n    if (!this.stateMachine) return;\r\n    if (!this.dispatchStart) return;\r\n    if (!this.editStateEntity) return;\r\n    if (!this.sandbox) return;\r\n\r\n    this.dispatchStart.doDispatch(container);\r\n\r\n    let state;\r\n    if (this.stateMachine.activeState) {\r\n      state = this.stateMachine.getStateByID(this.stateMachine.activeState)\r\n        ?.stateData;\r\n    }\r\n\r\n    const hideNavigation = this.stateMachine.states.length <= 1;\r\n    const hasNextSlide = this.stateMachine.nextState !== undefined;\r\n    const hasPreviousSlide = this.stateMachine.previousState !== undefined;\r\n    const dto: DispatchStateDTO = {\r\n      finalState: state,\r\n      hideNavigation,\r\n      hasNextSlide,\r\n      hasPreviousSlide\r\n    };\r\n    this.dispatchSetState?.doDispatch(dto);\r\n\r\n    let isAuthoring = this.editStateEntity.isEditing;\r\n    if (this.stateMachine.activeState === undefined) {\r\n      isAuthoring = true;\r\n    }\r\n    this.dispatchSetIsAuthoring?.doDispatch(isAuthoring);\r\n\r\n    this.dispatchThemeColors?.doDispatch();\r\n\r\n    if (this.sandbox.enableDevFeatures) {\r\n      this.sandbox.devFeatures.forEach((feature) => {\r\n        this.dispatchEnableFeature?.doDispatch(feature);\r\n      });\r\n    }\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, StartAppUC.type);\r\n  }\r\n}\r\n"]}