@vived/host 4.2.0 → 4.3.0

package/dist/esm/Apps/PMs/AppPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AASlD,MAAM,CAAC,MAAM,YAAY,GAAU;IACjC,EAAE,EAAE,EAAE;IACN,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,OAAgB,KAAM,SAAQ,WAAkB;IAGpD,MAAM,CAAC,GAAG,CAAC,EAAU,EAAE,UAAyB;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO;QACT,CAAC;QAED,OAAO,EAAE,CAAC,YAAY,CAAQ,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;;AATM,UAAI,GAAG,OAAO,CAAC;AAYxB,MAAM,UAAU,SAAS,CAAC,SAAoB;IAC5C,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,QAAS,SAAQ,KAAK;IAC1B,IAAY,GAAG;QACb,OAAO,IAAI,CAAC,uBAAuB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAED,WAAW,CAAC,CAAQ,EAAE,CAAQ;QAC5B,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAeD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAdvB,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YAEtB,MAAM,EAAE,GAAU;gBAChB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW;gBACjC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;gBACf,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS;gBAC5B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;aACpB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAKA,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AppEntity } from \"../Entities/AppEntity\";\r\n\r\nexport interface AppVM {\r\n  id: string;\r\n  name: string;\r\n  description: string;\r\n  imageURL: string;\r\n}\r\n\r\nexport const defaultAppVM: AppVM = {\r\n  id: \"\",\r\n  description: \"\",\r\n  imageURL: \"\",\r\n  name: \"\"\r\n};\r\n\r\nexport abstract class AppPM extends AppObjectPM<AppVM> {\r\n  static type = \"AppPM\";\r\n\r\n  static get(id: string, appObjects: AppObjectRepo) {\r\n    const ao = appObjects.get(id);\r\n    if (!ao) {\r\n      return;\r\n    }\r\n\r\n    return ao.getComponent<AppPM>(AppPM.type);\r\n  }\r\n}\r\n\r\nexport function makeAppPM(appObject: AppObject): AppPM {\r\n  return new AppPMImp(appObject);\r\n}\r\n\r\nclass AppPMImp extends AppPM {\r\n  private get app() {\r\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  vmsAreEqual(a: AppVM, b: AppVM): boolean {\r\n    if (a.description !== b.description) return false;\r\n    if (a.name !== b.name) return false;\r\n    if (a.imageURL !== b.imageURL) return false;\r\n    return true;\r\n  }\r\n\r\n  private onEntityChange = () => {\r\n    if (!this.app) return;\r\n\r\n    const vm: AppVM = {\r\n      description: this.app.description,\r\n      id: this.app.id,\r\n      imageURL: this.app.image_url,\r\n      name: this.app.name\r\n    };\r\n\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppPM.type);\r\n\r\n    this.app?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAiBlD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAU;IACjC,EAAE,EAAE,EAAE;IACN,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,EAAE;CACT,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAgB,KAAM,SAAQ,WAAkB;IAGpD;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,EAAU,EAAE,UAAyB;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO;QACT,CAAC;QAED,OAAO,EAAE,CAAC,YAAY,CAAQ,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;;AAhBM,UAAI,GAAG,OAAO,CAAC;AAmBxB;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,SAAoB;IAC5C,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,QAAS,SAAQ,KAAK;IAC1B;;OAEG;IACH,IAAY,GAAG;QACb,OAAO,IAAI,CAAC,uBAAuB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,CAAQ,EAAE,CAAQ;QAC5B,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAmBD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAvB/B;;;WAGG;QACK,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YAEtB,MAAM,EAAE,GAAU;gBAChB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW;gBACjC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;gBACf,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS;gBAC5B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;aACpB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAUA,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AppEntity } from \"../Entities/AppEntity\";\r\n\r\n/**\r\n * View Model for App information\r\n * Represents the data needed by the view to display an app\r\n */\r\nexport interface AppVM {\r\n  /** Unique identifier for the app */\r\n  id: string;\r\n  /** Display name of the app */\r\n  name: string;\r\n  /** Description text for the app */\r\n  description: string;\r\n  /** URL to the app's thumbnail or preview image */\r\n  imageURL: string;\r\n}\r\n\r\n/**\r\n * Default empty AppVM for initialization\r\n */\r\nexport const defaultAppVM: AppVM = {\r\n  id: \"\",\r\n  description: \"\",\r\n  imageURL: \"\",\r\n  name: \"\"\r\n};\r\n\r\n/**\r\n * Presentation Manager for App entities\r\n * \r\n * The AppPM is responsible for:\r\n * - Converting the AppEntity data into a view-friendly format (AppVM)\r\n * - Notifying the view when app data changes\r\n * - Providing comparison utilities for view models\r\n * \r\n * Usage:\r\n * 1. Retrieve an instance with `AppPM.get(appId, appObjects)`\r\n * 2. Subscribe to view updates with `pm.addViewUpdateObserver(callback)`\r\n * 3. Access current view data with `pm.lastVM`\r\n */\r\nexport abstract class AppPM extends AppObjectPM<AppVM> {\r\n  static type = \"AppPM\";\r\n\r\n  /**\r\n   * Retrieves an AppPM instance for a specific app by ID\r\n   * \r\n   * @param id - The unique identifier of the app\r\n   * @param appObjects - The repository of app objects\r\n   * @returns The AppPM instance or undefined if not found\r\n   */\r\n  static get(id: string, appObjects: AppObjectRepo) {\r\n    const ao = appObjects.get(id);\r\n    if (!ao) {\r\n      return;\r\n    }\r\n\r\n    return ao.getComponent<AppPM>(AppPM.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Creates a new AppPM instance\r\n * \r\n * @param appObject - The app object to associate with this PM\r\n * @returns A new AppPM instance\r\n */\r\nexport function makeAppPM(appObject: AppObject): AppPM {\r\n  return new AppPMImp(appObject);\r\n}\r\n\r\n/**\r\n * Implementation of the AppPM abstract class\r\n * Handles the connection between AppEntity and view\r\n */\r\nclass AppPMImp extends AppPM {\r\n  /**\r\n   * Gets the associated AppEntity\r\n   */\r\n  private get app() {\r\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Compares two AppVM instances for equality\r\n   * Used to determine if the view needs to update\r\n   * \r\n   * @param a - First AppVM to compare\r\n   * @param b - Second AppVM to compare\r\n   * @returns True if view models are equal, false otherwise\r\n   */\r\n  vmsAreEqual(a: AppVM, b: AppVM): boolean {\r\n    if (a.description !== b.description) return false;\r\n    if (a.name !== b.name) return false;\r\n    if (a.imageURL !== b.imageURL) return false;\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Observer callback that updates the view model when the entity changes\r\n   * Transforms entity data into view model format\r\n   */\r\n  private onEntityChange = () => {\r\n    if (!this.app) return;\r\n\r\n    const vm: AppVM = {\r\n      description: this.app.description,\r\n      id: this.app.id,\r\n      imageURL: this.app.image_url,\r\n      name: this.app.name\r\n    };\r\n\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  /**\r\n   * Creates a new AppPM instance\r\n   * \r\n   * @param appObject - The app object to associate with this PM\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppPM.type);\r\n\r\n    this.app?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n  }\r\n}\r\n"]}

package/dist/esm/Apps/PMs/AppsListPM.js

@@ -1,18 +1,52 @@
 import { AppObjectPM } from "@vived/core";
 import { AppRepoEntity } from "../Entities";
+/**
+ * Presentation Manager for displaying a list of available apps.
+ *
+ * This singleton PM observes the AppRepoEntity and transforms the list of app entities
+ * into a simple array of app IDs for views to consume. It specifically filters for apps
+ * that are assigned to the current owner/user.
+ *
+ * @extends AppObjectPM<string[]> - The view model is a simple array of app IDs
+ */
 export class AppsListPM extends AppObjectPM {
+    /**
+     * Gets the singleton instance of AppsListPM.
+     *
+     * @param appObjects - The app object repository
+     * @returns The AppsListPM instance or undefined if not found
+     */
     static get(appObjects) {
         return appObjects.getSingleton(AppsListPM.type);
     }
 }
 AppsListPM.type = "AppsListPM";
-export function makeAppListPM(appObject) {
-    return new AppListImp(appObject);
+/**
+ * Factory function to create a new AppsListPM instance.
+ *
+ * @param appObject - The app object to attach the PM to
+ * @returns A new AppsListPM instance
+ */
+export function makeAppsListPM(appObject) {
+    return new AppsListPMImp(appObject);
 }
-class AppListImp extends AppsListPM {
+/**
+ * Concrete implementation of the AppsListPM abstract class.
+ */
+class AppsListPMImp extends AppsListPM {
+    /**
+     * Gets the app repository entity that contains all available apps.
+     */
     get slideApps() {
         return this.getCachedSingleton(AppRepoEntity.type);
     }
+    /**
+     * Compares two app ID arrays for equality.
+     *
+     * @param a - First array of app IDs
+     * @param b - Second array of app IDs
+     * @returns True if the arrays contain the same IDs in the same order
+     */
     vmsAreEqual(a, b) {
         if (a.length !== b.length)
             return false;
@@ -24,8 +58,19 @@ class AppListImp extends AppsListPM {
         });
         return areEqual;
     }
+    /**
+     * Creates a new AppsListPMImp instance.
+     *
+     * @param appObject - The app object to attach to
+     */
     constructor(appObject) {
         super(appObject, AppsListPM.type);
+        /**
+         * Handler for changes in the app repository.
+         *
+         * This filters apps to include only those assigned to the owner
+         * and updates the view model with their IDs.
+         */
         this.onEntityChange = () => {
             if (!this.slideApps)
                 return;

package/dist/esm/Apps/PMs/AppsListPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppsListPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppsListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAgB,UAAW,SAAQ,WAAqB;IAG5D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAa,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;;AAJM,eAAI,GAAG,YAAY,CAAC;AAO7B,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAW,SAAQ,UAAU;IACjC,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,aAAa,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,QAAQ,GAAG,IAAI,CAAC;QAEpB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,KAAK,GAAG;gBAAE,QAAQ,GAAG,KAAK,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAiBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAhB5B,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;YAEzB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtB,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;oBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AppRepoEntity } from \"../Entities\";\r\n\r\nexport abstract class AppsListPM extends AppObjectPM<string[]> {\r\n  static type = \"AppsListPM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return appObjects.getSingleton<AppsListPM>(AppsListPM.type);\r\n  }\r\n}\r\n\r\nexport function makeAppListPM(appObject: AppObject): AppsListPM {\r\n  return new AppListImp(appObject);\r\n}\r\n\r\nclass AppListImp extends AppsListPM {\r\n  private get slideApps() {\r\n    return this.getCachedSingleton<AppRepoEntity>(AppRepoEntity.type);\r\n  }\r\n\r\n  vmsAreEqual(a: string[], b: string[]): boolean {\r\n    if (a.length !== b.length) return false;\r\n    let areEqual = true;\r\n\r\n    a.forEach((aID, i) => {\r\n      const bID = b[i];\r\n      if (aID !== bID) areEqual = false;\r\n    });\r\n    return areEqual;\r\n  }\r\n\r\n  private onEntityChange = () => {\r\n    if (!this.slideApps) return;\r\n\r\n    const allApps = this.slideApps.getAllApps();\r\n    const vms: string[] = [];\r\n\r\n    allApps.forEach((app) => {\r\n      if (app.assignedToOwner) {\r\n        vms.push(app.id);\r\n      }\r\n    });\r\n\r\n    this.doUpdateView(vms);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppsListPM.type);\r\n\r\n    this.slideApps?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppsListPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppsListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,OAAgB,UAAW,SAAQ,WAAqB;IAG5D;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAa,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;;AAVM,eAAI,GAAG,YAAY,CAAC;AAa7B;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,aAAc,SAAQ,UAAU;IACpC;;OAEG;IACH,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,aAAa,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,QAAQ,GAAG,IAAI,CAAC;QAEpB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,KAAK,GAAG;gBAAE,QAAQ,GAAG,KAAK,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAuBD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QA3BpC;;;;;WAKG;QACK,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;YAEzB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtB,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;oBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC;QAUA,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AppRepoEntity } from \"../Entities\";\r\n\r\n/**\r\n * Presentation Manager for displaying a list of available apps.\r\n *\r\n * This singleton PM observes the AppRepoEntity and transforms the list of app entities\r\n * into a simple array of app IDs for views to consume. It specifically filters for apps\r\n * that are assigned to the current owner/user.\r\n *\r\n * @extends AppObjectPM<string[]> - The view model is a simple array of app IDs\r\n */\r\nexport abstract class AppsListPM extends AppObjectPM<string[]> {\r\n  static type = \"AppsListPM\";\r\n\r\n  /**\r\n   * Gets the singleton instance of AppsListPM.\r\n   *\r\n   * @param appObjects - The app object repository\r\n   * @returns The AppsListPM instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return appObjects.getSingleton<AppsListPM>(AppsListPM.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new AppsListPM instance.\r\n *\r\n * @param appObject - The app object to attach the PM to\r\n * @returns A new AppsListPM instance\r\n */\r\nexport function makeAppsListPM(appObject: AppObject): AppsListPM {\r\n  return new AppsListPMImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of the AppsListPM abstract class.\r\n */\r\nclass AppsListPMImp extends AppsListPM {\r\n  /**\r\n   * Gets the app repository entity that contains all available apps.\r\n   */\r\n  private get slideApps() {\r\n    return this.getCachedSingleton<AppRepoEntity>(AppRepoEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Compares two app ID arrays for equality.\r\n   *\r\n   * @param a - First array of app IDs\r\n   * @param b - Second array of app IDs\r\n   * @returns True if the arrays contain the same IDs in the same order\r\n   */\r\n  vmsAreEqual(a: string[], b: string[]): boolean {\r\n    if (a.length !== b.length) return false;\r\n    let areEqual = true;\r\n\r\n    a.forEach((aID, i) => {\r\n      const bID = b[i];\r\n      if (aID !== bID) areEqual = false;\r\n    });\r\n    return areEqual;\r\n  }\r\n\r\n  /**\r\n   * Handler for changes in the app repository.\r\n   *\r\n   * This filters apps to include only those assigned to the owner\r\n   * and updates the view model with their IDs.\r\n   */\r\n  private onEntityChange = () => {\r\n    if (!this.slideApps) return;\r\n\r\n    const allApps = this.slideApps.getAllApps();\r\n    const vms: string[] = [];\r\n\r\n    allApps.forEach((app) => {\r\n      if (app.assignedToOwner) {\r\n        vms.push(app.id);\r\n      }\r\n    });\r\n\r\n    this.doUpdateView(vms);\r\n  };\r\n\r\n  /**\r\n   * Creates a new AppsListPMImp instance.\r\n   *\r\n   * @param appObject - The app object to attach to\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppsListPM.type);\r\n\r\n    this.slideApps?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

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"]}