@vived/host 5.8.0 → 5.8.1

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

@@ -4,6 +4,7 @@ exports.makeSandboxMounter = makeSandboxMounter;
 const core_1 = require("@vived/core");
 const AppSandboxEntity_1 = require("../../../AppSandbox/Entities/AppSandboxEntity");
 const HostDispatchEntity_1 = require("../../../Dispatcher/Entities/HostDispatchEntity");
+const UCs_1 = require("../../../Dispatcher/UCs");
 const HostHandler_1 = require("../../../Handler/Entities/HostHandler");
 const AppEntity_1 = require("../../Entities/AppEntity");
 const MounterUC_1 = require("./MounterUC");
@@ -71,6 +72,26 @@ class SandboxMounterUC extends MounterUC_1.MounterUC {
         }
         return appVersion;
     }
+    /**
+     * Dispatches the App lifecycle teardown Requests, in order, while the App's
+     * handler is still registered.
+     */
+    dispatchTeardownToApp() {
+        const dispatchStopApp = UCs_1.DispatchStopAppUC.get(this.appObject);
+        if (dispatchStopApp) {
+            dispatchStopApp.doDispatch();
+        }
+        else {
+            this.error("Cannot find DispatchStopAppUC");
+        }
+        const dispatchDisposeApp = UCs_1.DispatchDisposeAppUC.get(this.appObject);
+        if (dispatchDisposeApp) {
+            dispatchDisposeApp.doDispatch();
+        }
+        else {
+            this.error("Cannot find DispatchDisposeAppUC");
+        }
+    }
     /**
      * Loads a script into the document.
      * This is a placeholder implementation for sandbox mounting.
@@ -166,12 +187,23 @@ class SandboxMounterUC extends MounterUC_1.MounterUC {
         };
         /**
          * Unmounts the app from the sandbox.
+         *
+         * Tells the App to tear itself down before the channel to it is severed:
+         * STOP_APP then DISPOSE_APP, matching the teardown order the asset-system
+         * plugin uses (CloseAssetSystemPluginUC). Ordering is load-bearing —
+         * clearAppHandler() unregisters the App's handler, after which a Request
+         * cannot reach the App at all.
+         *
+         * A missing dispatcher is reported but does not abort the unmount: leaving
+         * the Sandbox stuck in MOUNTED would be worse than an App that never heard
+         * it was being torn down.
          */
         this.unmount = () => {
             if (!this.sandbox || !this.hostDispatcher) {
                 this.error("Missing Components");
                 return;
             }
+            this.dispatchTeardownToApp();
             this.hostDispatcher.clearAppHandler();
             this.sandbox.state = AppSandboxEntity_1.SandboxState.UNMOUNTED;
         };

package/dist/cjs/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\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      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"]}
+{"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\";\nimport {\n  AppSandboxEntity,\n  SandboxState\n} from \"../../../AppSandbox/Entities/AppSandboxEntity\";\nimport { HostDispatchEntity } from \"../../../Dispatcher/Entities/HostDispatchEntity\";\nimport {\n  DispatchDisposeAppUC,\n  DispatchStopAppUC\n} from \"../../../Dispatcher/UCs\";\nimport { HostHandlerEntity } from \"../../../Handler/Entities/HostHandler\";\nimport { AppEntity, AppState } from \"../../Entities/AppEntity\";\nimport { MounterUC } from \"./MounterUC\";\n\n/**\n * Factory function to create a sandbox mounter for apps.\n *\n * The sandbox mounter is designed to mount apps in a sandboxed environment,\n * providing isolation and security for app execution.\n *\n * @param appObject - The app object to attach the mounter to\n * @returns A new SandboxMounterUC instance\n */\nexport function makeSandboxMounter(appObject: AppObject): MounterUC {\n  return new SandboxMounterUC(appObject);\n}\n\n/**\n * Implementation of MounterUC for mounting apps in a sandbox environment.\n *\n * The SandboxMounterUC is responsible for safely loading and initializing apps\n * in a sandboxed context, handling app lifecycle events, and managing the\n * communication between the host and app.\n */\nclass SandboxMounterUC extends MounterUC {\n  /**\n   * Gets the app entity representing the app being mounted\n   */\n  private get appEntity() {\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\n  }\n\n  /**\n   * Gets the host dispatcher entity for sending messages to apps\n   */\n  private get hostDispatcher() {\n    return this.getCachedLocalComponent<HostDispatchEntity>(\n      HostDispatchEntity.type\n    );\n  }\n\n  /**\n   * Gets the host handler entity for receiving messages from apps\n   */\n  private get hostHandler() {\n    return this.getCachedLocalComponent<HostHandlerEntity>(\n      HostHandlerEntity.type\n    );\n  }\n\n  /**\n   * Gets the sandbox entity that manages the sandbox state\n   */\n  private get sandbox() {\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\n  }\n\n  /**\n   * Mounts the latest version of the app.\n   *\n   * @returns A promise that resolves when the app is mounted or rejects if an error occurs\n   */\n  mountLatestVersion = (): Promise<void> => {\n    if (!this.appEntity) {\n      this.error(\"Missing Components\");\n      return Promise.reject();\n    }\n\n    const version = this.appEntity.latestVersion;\n    if (!version) {\n      this.error(\"No Version\");\n      return Promise.reject();\n    }\n\n    return this.mount(version.major, version.minor);\n  };\n\n  /**\n   * Mounts a specific version of the app.\n   *\n   * @param majorVersion - The major version number\n   * @param minorVersion - The minor version number\n   * @returns A promise that resolves when the app is mounted or rejects if an error occurs\n   */\n  mount = (majorVersion: number, minorVersion: number): Promise<void> => {\n    if (\n      !this.appEntity ||\n      !this.hostDispatcher ||\n      !this.hostHandler ||\n      !this.sandbox\n    ) {\n      this.error(\"Missing Components\");\n      return Promise.reject();\n    }\n\n    const version = this.getAppVersion(majorVersion, minorVersion);\n    if (!version) {\n      this.error(\"No Version\");\n      return Promise.reject();\n    }\n\n    const appInterface = this.getAppInterface(version);\n    if (!appInterface) {\n      this.error(\"No App Interface\");\n      return Promise.reject();\n    }\n\n    const appHandler = appInterface.mount(this.hostHandler.handler);\n    this.hostDispatcher.registerAppHandler(appHandler);\n\n    const app = this.appEntity;\n    const sandbox = this.sandbox;\n\n    return new Promise((resolve) => {\n      const waitForReady = () => {\n        if (app.state === AppState.READY) {\n          sandbox.state = SandboxState.MOUNTED;\n          app.removeChangeObserver(waitForReady);\n          resolve();\n        }\n      };\n\n      app.addChangeObserver(waitForReady);\n      waitForReady();\n    });\n  };\n\n  /**\n   * Helper method to find a specific version of the app.\n   *\n   * @param major - Major version number\n   * @param minor - Minor version number\n   * @returns The Version object or undefined if not found\n   */\n  private getAppVersion(major: number, minor: number): Version | undefined {\n    if (!this.appEntity) {\n      return;\n    }\n\n    let appVersion = Version.GetLatestWithMajorMinor(\n      this.appEntity.versions,\n      major,\n      minor\n    );\n\n    if (!appVersion) {\n      appVersion = Version.GetLatestWithMajor(this.appEntity.versions, major);\n    }\n\n    if (!appVersion) {\n      this.error(\n        `Unable to find version ${major}.${minor}.X for App ${this.appEntity.name}`\n      );\n    }\n\n    return appVersion;\n  }\n\n  /**\n   * Unmounts the app from the sandbox.\n   *\n   * Tells the App to tear itself down before the channel to it is severed:\n   * STOP_APP then DISPOSE_APP, matching the teardown order the asset-system\n   * plugin uses (CloseAssetSystemPluginUC). Ordering is load-bearing —\n   * clearAppHandler() unregisters the App's handler, after which a Request\n   * cannot reach the App at all.\n   *\n   * A missing dispatcher is reported but does not abort the unmount: leaving\n   * the Sandbox stuck in MOUNTED would be worse than an App that never heard\n   * it was being torn down.\n   */\n  unmount = (): void => {\n    if (!this.sandbox || !this.hostDispatcher) {\n      this.error(\"Missing Components\");\n      return;\n    }\n\n    this.dispatchTeardownToApp();\n\n    this.hostDispatcher.clearAppHandler();\n\n    this.sandbox.state = SandboxState.UNMOUNTED;\n  };\n\n  /**\n   * Dispatches the App lifecycle teardown Requests, in order, while the App's\n   * handler is still registered.\n   */\n  private dispatchTeardownToApp(): void {\n    const dispatchStopApp = DispatchStopAppUC.get(this.appObject);\n    if (dispatchStopApp) {\n      dispatchStopApp.doDispatch();\n    } else {\n      this.error(\"Cannot find DispatchStopAppUC\");\n    }\n\n    const dispatchDisposeApp = DispatchDisposeAppUC.get(this.appObject);\n    if (dispatchDisposeApp) {\n      dispatchDisposeApp.doDispatch();\n    } else {\n      this.error(\"Cannot find DispatchDisposeAppUC\");\n    }\n  }\n\n  /**\n   * Loads a script into the document.\n   * This is a placeholder implementation for sandbox mounting.\n   *\n   * @param scriptURL - URL of the script to load\n   * @param appIDWithVersion - Versioned ID of the app\n   * @returns A promise that resolves when the script is loaded\n   */\n  loadScriptIntoDocument(\n    scriptURL: string,\n    appIDWithVersion: string\n  ): Promise<void> {\n    // Unused during dev\n    return Promise.resolve();\n  }\n\n  /**\n   * Gets the app interface for a specific version.\n   *\n   * @param version - The version to get the interface for\n   * @returns The app interface or undefined if not found\n   */\n  getAppInterface(version: Version): VIVEDApp_3 | undefined {\n    const modifiedVersion = version.baseVersionString.split(\".\").join(\"_\");\n    const idWithVersion = `${this.appObject.id}-${modifiedVersion}`;\n    const appInterface = (window as any)[idWithVersion] as VIVEDApp_3;\n    if (!appInterface) {\n      this.appObjects.submitFatal(\n        \"LocalMounterUC\",\n        \"Unable to find App Interface\"\n      );\n      return;\n    }\n\n    return appInterface;\n  }\n\n  /**\n   * Creates a new SandboxMounterUC instance.\n   *\n   * @param appObject - The app object to attach to\n   */\n  constructor(appObject: AppObject) {\n    super(appObject, MounterUC.type);\n  }\n}\n"]}

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

@@ -1,6 +1,7 @@
 import { Version } from "@vived/core";
 import { AppSandboxEntity, SandboxState } from "../../../AppSandbox/Entities/AppSandboxEntity";
 import { HostDispatchEntity } from "../../../Dispatcher/Entities/HostDispatchEntity";
+import { DispatchDisposeAppUC, DispatchStopAppUC } from "../../../Dispatcher/UCs";
 import { HostHandlerEntity } from "../../../Handler/Entities/HostHandler";
 import { AppEntity, AppState } from "../../Entities/AppEntity";
 import { MounterUC } from "./MounterUC";
@@ -68,6 +69,26 @@ class SandboxMounterUC extends MounterUC {
         }
         return appVersion;
     }
+    /**
+     * Dispatches the App lifecycle teardown Requests, in order, while the App's
+     * handler is still registered.
+     */
+    dispatchTeardownToApp() {
+        const dispatchStopApp = DispatchStopAppUC.get(this.appObject);
+        if (dispatchStopApp) {
+            dispatchStopApp.doDispatch();
+        }
+        else {
+            this.error("Cannot find DispatchStopAppUC");
+        }
+        const dispatchDisposeApp = DispatchDisposeAppUC.get(this.appObject);
+        if (dispatchDisposeApp) {
+            dispatchDisposeApp.doDispatch();
+        }
+        else {
+            this.error("Cannot find DispatchDisposeAppUC");
+        }
+    }
     /**
      * Loads a script into the document.
      * This is a placeholder implementation for sandbox mounting.
@@ -163,12 +184,23 @@ class SandboxMounterUC extends MounterUC {
         };
         /**
          * Unmounts the app from the sandbox.
+         *
+         * Tells the App to tear itself down before the channel to it is severed:
+         * STOP_APP then DISPOSE_APP, matching the teardown order the asset-system
+         * plugin uses (CloseAssetSystemPluginUC). Ordering is load-bearing —
+         * clearAppHandler() unregisters the App's handler, after which a Request
+         * cannot reach the App at all.
+         *
+         * A missing dispatcher is reported but does not abort the unmount: leaving
+         * the Sandbox stuck in MOUNTED would be worse than an App that never heard
+         * it was being torn down.
          */
         this.unmount = () => {
             if (!this.sandbox || !this.hostDispatcher) {
                 this.error("Missing Components");
                 return;
             }
+            this.dispatchTeardownToApp();
             this.hostDispatcher.clearAppHandler();
             this.sandbox.state = SandboxState.UNMOUNTED;
         };

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\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      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"]}
+{"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\";\nimport {\n  AppSandboxEntity,\n  SandboxState\n} from \"../../../AppSandbox/Entities/AppSandboxEntity\";\nimport { HostDispatchEntity } from \"../../../Dispatcher/Entities/HostDispatchEntity\";\nimport {\n  DispatchDisposeAppUC,\n  DispatchStopAppUC\n} from \"../../../Dispatcher/UCs\";\nimport { HostHandlerEntity } from \"../../../Handler/Entities/HostHandler\";\nimport { AppEntity, AppState } from \"../../Entities/AppEntity\";\nimport { MounterUC } from \"./MounterUC\";\n\n/**\n * Factory function to create a sandbox mounter for apps.\n *\n * The sandbox mounter is designed to mount apps in a sandboxed environment,\n * providing isolation and security for app execution.\n *\n * @param appObject - The app object to attach the mounter to\n * @returns A new SandboxMounterUC instance\n */\nexport function makeSandboxMounter(appObject: AppObject): MounterUC {\n  return new SandboxMounterUC(appObject);\n}\n\n/**\n * Implementation of MounterUC for mounting apps in a sandbox environment.\n *\n * The SandboxMounterUC is responsible for safely loading and initializing apps\n * in a sandboxed context, handling app lifecycle events, and managing the\n * communication between the host and app.\n */\nclass SandboxMounterUC extends MounterUC {\n  /**\n   * Gets the app entity representing the app being mounted\n   */\n  private get appEntity() {\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\n  }\n\n  /**\n   * Gets the host dispatcher entity for sending messages to apps\n   */\n  private get hostDispatcher() {\n    return this.getCachedLocalComponent<HostDispatchEntity>(\n      HostDispatchEntity.type\n    );\n  }\n\n  /**\n   * Gets the host handler entity for receiving messages from apps\n   */\n  private get hostHandler() {\n    return this.getCachedLocalComponent<HostHandlerEntity>(\n      HostHandlerEntity.type\n    );\n  }\n\n  /**\n   * Gets the sandbox entity that manages the sandbox state\n   */\n  private get sandbox() {\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\n  }\n\n  /**\n   * Mounts the latest version of the app.\n   *\n   * @returns A promise that resolves when the app is mounted or rejects if an error occurs\n   */\n  mountLatestVersion = (): Promise<void> => {\n    if (!this.appEntity) {\n      this.error(\"Missing Components\");\n      return Promise.reject();\n    }\n\n    const version = this.appEntity.latestVersion;\n    if (!version) {\n      this.error(\"No Version\");\n      return Promise.reject();\n    }\n\n    return this.mount(version.major, version.minor);\n  };\n\n  /**\n   * Mounts a specific version of the app.\n   *\n   * @param majorVersion - The major version number\n   * @param minorVersion - The minor version number\n   * @returns A promise that resolves when the app is mounted or rejects if an error occurs\n   */\n  mount = (majorVersion: number, minorVersion: number): Promise<void> => {\n    if (\n      !this.appEntity ||\n      !this.hostDispatcher ||\n      !this.hostHandler ||\n      !this.sandbox\n    ) {\n      this.error(\"Missing Components\");\n      return Promise.reject();\n    }\n\n    const version = this.getAppVersion(majorVersion, minorVersion);\n    if (!version) {\n      this.error(\"No Version\");\n      return Promise.reject();\n    }\n\n    const appInterface = this.getAppInterface(version);\n    if (!appInterface) {\n      this.error(\"No App Interface\");\n      return Promise.reject();\n    }\n\n    const appHandler = appInterface.mount(this.hostHandler.handler);\n    this.hostDispatcher.registerAppHandler(appHandler);\n\n    const app = this.appEntity;\n    const sandbox = this.sandbox;\n\n    return new Promise((resolve) => {\n      const waitForReady = () => {\n        if (app.state === AppState.READY) {\n          sandbox.state = SandboxState.MOUNTED;\n          app.removeChangeObserver(waitForReady);\n          resolve();\n        }\n      };\n\n      app.addChangeObserver(waitForReady);\n      waitForReady();\n    });\n  };\n\n  /**\n   * Helper method to find a specific version of the app.\n   *\n   * @param major - Major version number\n   * @param minor - Minor version number\n   * @returns The Version object or undefined if not found\n   */\n  private getAppVersion(major: number, minor: number): Version | undefined {\n    if (!this.appEntity) {\n      return;\n    }\n\n    let appVersion = Version.GetLatestWithMajorMinor(\n      this.appEntity.versions,\n      major,\n      minor\n    );\n\n    if (!appVersion) {\n      appVersion = Version.GetLatestWithMajor(this.appEntity.versions, major);\n    }\n\n    if (!appVersion) {\n      this.error(\n        `Unable to find version ${major}.${minor}.X for App ${this.appEntity.name}`\n      );\n    }\n\n    return appVersion;\n  }\n\n  /**\n   * Unmounts the app from the sandbox.\n   *\n   * Tells the App to tear itself down before the channel to it is severed:\n   * STOP_APP then DISPOSE_APP, matching the teardown order the asset-system\n   * plugin uses (CloseAssetSystemPluginUC). Ordering is load-bearing —\n   * clearAppHandler() unregisters the App's handler, after which a Request\n   * cannot reach the App at all.\n   *\n   * A missing dispatcher is reported but does not abort the unmount: leaving\n   * the Sandbox stuck in MOUNTED would be worse than an App that never heard\n   * it was being torn down.\n   */\n  unmount = (): void => {\n    if (!this.sandbox || !this.hostDispatcher) {\n      this.error(\"Missing Components\");\n      return;\n    }\n\n    this.dispatchTeardownToApp();\n\n    this.hostDispatcher.clearAppHandler();\n\n    this.sandbox.state = SandboxState.UNMOUNTED;\n  };\n\n  /**\n   * Dispatches the App lifecycle teardown Requests, in order, while the App's\n   * handler is still registered.\n   */\n  private dispatchTeardownToApp(): void {\n    const dispatchStopApp = DispatchStopAppUC.get(this.appObject);\n    if (dispatchStopApp) {\n      dispatchStopApp.doDispatch();\n    } else {\n      this.error(\"Cannot find DispatchStopAppUC\");\n    }\n\n    const dispatchDisposeApp = DispatchDisposeAppUC.get(this.appObject);\n    if (dispatchDisposeApp) {\n      dispatchDisposeApp.doDispatch();\n    } else {\n      this.error(\"Cannot find DispatchDisposeAppUC\");\n    }\n  }\n\n  /**\n   * Loads a script into the document.\n   * This is a placeholder implementation for sandbox mounting.\n   *\n   * @param scriptURL - URL of the script to load\n   * @param appIDWithVersion - Versioned ID of the app\n   * @returns A promise that resolves when the script is loaded\n   */\n  loadScriptIntoDocument(\n    scriptURL: string,\n    appIDWithVersion: string\n  ): Promise<void> {\n    // Unused during dev\n    return Promise.resolve();\n  }\n\n  /**\n   * Gets the app interface for a specific version.\n   *\n   * @param version - The version to get the interface for\n   * @returns The app interface or undefined if not found\n   */\n  getAppInterface(version: Version): VIVEDApp_3 | undefined {\n    const modifiedVersion = version.baseVersionString.split(\".\").join(\"_\");\n    const idWithVersion = `${this.appObject.id}-${modifiedVersion}`;\n    const appInterface = (window as any)[idWithVersion] as VIVEDApp_3;\n    if (!appInterface) {\n      this.appObjects.submitFatal(\n        \"LocalMounterUC\",\n        \"Unable to find App Interface\"\n      );\n      return;\n    }\n\n    return appInterface;\n  }\n\n  /**\n   * Creates a new SandboxMounterUC instance.\n   *\n   * @param appObject - The app object to attach to\n   */\n  constructor(appObject: AppObject) {\n    super(appObject, MounterUC.type);\n  }\n}\n"]}

package/dist/types/Apps/UCs/Mounters/SandboxMounterUC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxMounterUC.d.ts","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/SandboxMounterUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAQ7D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAElE"}
+{"version":3,"file":"SandboxMounterUC.d.ts","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/SandboxMounterUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAY7D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAElE"}

package/package.json

@@ -1,67 +1,67 @@
-{
-  "name": "@vived/host",
-  "version": "5.8.0",
-  "description": "Public Host package for the VIVED Learning App system",
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/types/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js",
-      "types": "./dist/types/index.d.ts"
-    }
-  },
-  "scripts": {
-    "test": "jest --watch --config jestconfig.json",
-    "test:once": "jest --config jestconfig.json",
-    "test:unit": "jest --config jestconfig.json --testMatch \"**/?(*.)+(test).+(ts|tsx|js)\" --watch",
-    "test:unit:once": "jest --config jestconfig.json --testMatch \"**/?(*.)+(test).+(ts|tsx|js)\"",
-    "test:integration": "jest --config jestconfig.json --testMatch \"**/__tests__/integration/**/*.+(ts|tsx|js)\" --watch",
-    "test:integration:once": "jest --config jestconfig.json --testMatch \"**/__tests__/integration/**/*.+(ts|tsx|js)\"",
-    "build": "npm run build:esm && npm run build:cjs",
-    "build:esm": "tsc",
-    "build:cjs": "tsc -p tsconfig.cjs.json",
-    "format": "prettier --write",
-    "format:all": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
-    "lint": "tslint -p tsconfig.json",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run test:once && npm run test:integration:once && npm run lint",
-    "preversion": "npm run lint",
-    "version": "npm run format && git add -A src",
-    "postversion": "git push && git push --tags"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://bitbucket.org/cyberscience3d/vivedlearning_host.git"
-  },
-  "keywords": [
-    "VIVED"
-  ],
-  "author": "Amos Patrick",
-  "license": "ISC",
-  "homepage": "https://bitbucket.org/cyberscience3d/vivedlearning_host#readme",
-  "devDependencies": {
-    "@types/jest": "^29.5.14",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "jsdom": "^26.0.0",
-    "prettier": "^3.5.3",
-    "ts-jest": "^29.2.6",
-    "tslint": "^6.1.3",
-    "tslint-config-prettier": "^1.18.0",
-    "typescript": "^5.8.2"
-  },
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@types/webxr": "^0.5.20"
-  },
-  "peerDependencies": {
-    "@vived/core": "^2.0.1"
-  }
-}
+{
+  "name": "@vived/host",
+  "version": "5.8.1",
+  "description": "Public Host package for the VIVED Learning App system",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "scripts": {
+    "test": "jest --watch --config jestconfig.json",
+    "test:once": "jest --config jestconfig.json",
+    "test:unit": "jest --config jestconfig.json --testMatch \"**/?(*.)+(test).+(ts|tsx|js)\" --watch",
+    "test:unit:once": "jest --config jestconfig.json --testMatch \"**/?(*.)+(test).+(ts|tsx|js)\"",
+    "test:integration": "jest --config jestconfig.json --testMatch \"**/__tests__/integration/**/*.+(ts|tsx|js)\" --watch",
+    "test:integration:once": "jest --config jestconfig.json --testMatch \"**/__tests__/integration/**/*.+(ts|tsx|js)\"",
+    "build": "npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "format": "prettier --write",
+    "format:all": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
+    "lint": "tslint -p tsconfig.json",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run test:once && npm run test:integration:once && npm run lint",
+    "preversion": "npm run lint",
+    "version": "npm run format && git add -A src",
+    "postversion": "git push && git push --tags"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://bitbucket.org/cyberscience3d/vivedlearning_host.git"
+  },
+  "keywords": [
+    "VIVED"
+  ],
+  "author": "Amos Patrick",
+  "license": "ISC",
+  "homepage": "https://bitbucket.org/cyberscience3d/vivedlearning_host#readme",
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "jsdom": "^26.0.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.2.6",
+    "tslint": "^6.1.3",
+    "tslint-config-prettier": "^1.18.0",
+    "typescript": "^5.8.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@types/webxr": "^0.5.20"
+  },
+  "peerDependencies": {
+    "@vived/core": "^2.0.1"
+  }
+}