npm - @vived/host - Versions diffs - 4.1.0 → 4.3.0 - Mend

@vived/host 4.1.0 → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1677) hide show

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

	@@ -1 +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"]}
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\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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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"]}
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 });\r\n };\r\n\r\n /\r\n Helper method to find a specific version of the app.\r\n \r\n @param major - Major version number\r\n * @param minor - Minor version number\r\n * @returns The Version object or undefined if not found\r\n /\r\n private getAppVersion(major: number, minor: number): Version \| undefined {\r\n if (!this.appEntity) {\r\n return;\r\n }\r\n\r\n let appVersion = Version.GetLatestWithMajorMinor(\r\n this.appEntity.versions,\r\n major,\r\n minor\r\n );\r\n\r\n if (!appVersion) {\r\n appVersion = Version.GetLatestWithMajor(this.appEntity.versions, major);\r\n }\r\n\r\n if (!appVersion) {\r\n this.error(\r\n `Unable to find version ${major}.${minor}.X for App ${this.appEntity.name}`\r\n );\r\n }\r\n\r\n return appVersion;\r\n }\r\n\r\n /\r\n Unmounts the app from the sandbox.\r\n /\r\n unmount = (): void => {\r\n if (!this.sandbox \|\| !this.hostDispatcher) {\r\n this.error(\"Missing Components\");\r\n return;\r\n }\r\n\r\n this.hostDispatcher.clearAppHandler();\r\n\r\n this.sandbox.state = SandboxState.UNMOUNTED;\r\n };\r\n\r\n /\r\n Loads a script into the document.\r\n * This is a placeholder implementation for sandbox mounting.\r\n \r\n @param scriptURL - URL of the script to load\r\n * @param appIDWithVersion - Versioned ID of the app\r\n * @returns A promise that resolves when the script is loaded\r\n /\r\n loadScriptIntoDocument(\r\n scriptURL: string,\r\n appIDWithVersion: string\r\n ): Promise<void> {\r\n // Unused during dev\r\n return Promise.resolve();\r\n }\r\n\r\n /\r\n Gets the app interface for a specific version.\r\n \r\n @param version - The version to get the interface for\r\n * @returns The app interface or undefined if not found\r\n /\r\n getAppInterface(version: Version): VIVEDApp_3 \| undefined {\r\n const modifiedVersion = version.baseVersionString.split(\".\").join(\"_\");\r\n const idWithVersion = `${this.appObject.id}-${modifiedVersion}`;\r\n const appInterface = (window as any)[idWithVersion] as VIVEDApp_3;\r\n if (!appInterface) {\r\n this.appObjects.submitFatal(\r\n \"LocalMounterUC\",\r\n \"Unable to find App Interface\"\r\n );\r\n return;\r\n }\r\n\r\n return appInterface;\r\n }\r\n\r\n /\r\n Creates a new SandboxMounterUC instance.\r\n \r\n @param appObject - The app object to attach to\r\n */\r\n constructor(appObject: AppObject) {\r\n super(appObject, MounterUC.type);\r\n }\r\n}\r\n"]}

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

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

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

	@@ -1 +1 @@
1	- {"version":3,"file":"StartAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StartAppUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,WAAW,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAElB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,MAAM,OAAgB,UAAW,SAAQ,WAAW;~~IAKlD~~,MAAM,CAAC,GAAG,CAAC,SAAoB;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAa,UAAU,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,CAAC,aAAa,CAAC,aAAa,CACnC,gBAAgB,EAChB,0CAA0C,GAAG,SAAS,CAAC,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,OAAO,CACZ,EAAU,EACV,UAAyB;QAEzB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAErC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,oBAAoB,EACpB,kCAAkC,GAAG,EAAE,CACxC,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,SAAS,CACd,SAAsB,EACtB,EAAU,EACV,UAAyB;QAEzB,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;;~~AAtCM~~,eAAI,GAAG,YAAY,CAAC;~~AAyC7B~~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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { AppSandboxEntity } from \"../../AppSandbox\";\r\nimport {\r\n DispatchEnableFeatureUC,\r\n DispatchIsAuthoringUC,\r\n DispatchSetStateUC,\r\n DispatchStartAppUC,\r\n DispatchStateDTO,\r\n DispatchThemeUC\r\n} from \"../../Dispatcher\";\r\nimport {\r\n HostEditingStateEntity,\r\n HostStateMachine\r\n} from \"../../StateMachine/Entities\";\r\n\r\nexport abstract class StartAppUC extends AppObjectUC {\r\n static type = \"StartAppUC\";\r\n\r\n abstract start(container: HTMLElement): void;\r\n\r\n static get(appObject: AppObject): StartAppUC \| undefined {\r\n const asset = appObject.getComponent<StartAppUC>(StartAppUC.type);\r\n if (!asset) {\r\n appObject.appObjectRepo.submitWarning(\r\n \"StartAppUC.get\",\r\n \"Unable to find StartAppUC on app object \" + appObject.id\r\n );\r\n }\r\n return asset;\r\n }\r\n\r\n static getByID(\r\n id: string,\r\n appObjects: AppObjectRepo\r\n ): StartAppUC \| undefined {\r\n const appObject = appObjects.get(id);\r\n\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"StartAppUC.getByID\",\r\n \"Unable to find App Object by id \" + id\r\n );\r\n return undefined;\r\n }\r\n\r\n return StartAppUC.get(appObject);\r\n }\r\n\r\n static startByID(\r\n container: HTMLElement,\r\n id: string,\r\n appObjects: AppObjectRepo\r\n ) {\r\n StartAppUC.getByID(id, appObjects)?.start(container);\r\n }\r\n}\r\n\r\nexport function makeStartAppUC(appObject: AppObject): StartAppUC {\r\n return new StartAppUCImp(appObject);\r\n}\r\n\r\nclass StartAppUCImp extends StartAppUC {\r\n private get stateMachine() {\r\n return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n }\r\n\r\n private get editStateEntity() {\r\n return this.getCachedSingleton<HostEditingStateEntity>(\r\n HostEditingStateEntity.type\r\n );\r\n }\r\n\r\n private get dispatchStart() {\r\n return this.getCachedLocalComponent<DispatchStartAppUC>(\r\n DispatchStartAppUC.type\r\n );\r\n }\r\n\r\n private get dispatchSetState() {\r\n return this.getCachedLocalComponent<DispatchSetStateUC>(\r\n DispatchSetStateUC.type\r\n );\r\n }\r\n\r\n private get dispatchSetIsAuthoring() {\r\n return this.getCachedLocalComponent<DispatchIsAuthoringUC>(\r\n DispatchIsAuthoringUC.type\r\n );\r\n }\r\n\r\n private get dispatchThemeColors() {\r\n return this.getCachedLocalComponent<DispatchThemeUC>(DispatchThemeUC.type);\r\n }\r\n\r\n private get dispatchEnableFeature() {\r\n return this.getCachedLocalComponent<DispatchEnableFeatureUC>(\r\n DispatchEnableFeatureUC.type\r\n );\r\n }\r\n\r\n private get sandbox() {\r\n return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n }\r\n\r\n start = (container: HTMLElement) => {\r\n if (!this.stateMachine) return;\r\n if (!this.dispatchStart) return;\r\n if (!this.editStateEntity) return;\r\n if (!this.sandbox) return;\r\n\r\n this.dispatchStart.doDispatch(container);\r\n\r\n let state;\r\n if (this.stateMachine.activeState) {\r\n state = this.stateMachine.getStateByID(this.stateMachine.activeState)\r\n ?.stateData;\r\n }\r\n\r\n const hideNavigation = this.stateMachine.states.length <= 1;\r\n const hasNextSlide = this.stateMachine.nextState !== undefined;\r\n const hasPreviousSlide = this.stateMachine.previousState !== undefined;\r\n const dto: DispatchStateDTO = {\r\n finalState: state,\r\n hideNavigation,\r\n hasNextSlide,\r\n hasPreviousSlide\r\n };\r\n this.dispatchSetState?.doDispatch(dto);\r\n\r\n let isAuthoring = this.editStateEntity.isEditing;\r\n if (this.stateMachine.activeState === undefined) {\r\n isAuthoring = true;\r\n }\r\n this.dispatchSetIsAuthoring?.doDispatch(isAuthoring);\r\n\r\n this.dispatchThemeColors?.doDispatch();\r\n\r\n if (this.sandbox.enableDevFeatures) {\r\n this.sandbox.devFeatures.forEach((feature) => {\r\n this.dispatchEnableFeature?.doDispatch(feature);\r\n });\r\n }\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, StartAppUC.type);\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"StartAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StartAppUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { AppSandboxEntity } from \"../../AppSandbox\";\r\nimport {\r\n DispatchEnableFeatureUC,\r\n DispatchIsAuthoringUC,\r\n DispatchSetStateUC,\r\n DispatchStartAppUC,\r\n DispatchStateDTO,\r\n DispatchThemeUC\r\n} from \"../../Dispatcher\";\r\nimport {\r\n HostEditingStateEntity,\r\n HostStateMachine\r\n} from \"../../StateMachine/Entities\";\r\n\r\n/*\r\n StartAppUC - Use case for starting an application in the host environment\r\n * \r\n * This use case is responsible for initializing and starting an application\r\n * within the VIVED Learning platform. It handles setting up the application container,\r\n * initializing the app with the appropriate state, and dispatching necessary configurations.\r\n * \r\n * The StartAppUC coordinates between several subsystems:\r\n * - State Machine: Provides the current application state\r\n * - Dispatcher: Communicates with the app via message passing\r\n * - AppSandbox: Provides development features when enabled\r\n * \r\n * @extends AppObjectUC from @vived/core\r\n /\r\nexport abstract class StartAppUC extends AppObjectUC {\r\n /* Type identifier for the StartAppUC component /\r\n static type = \"StartAppUC\";\r\n\r\n /\r\n Abstract method that starts the application\r\n * \r\n * @param container - HTML element that will contain the app\r\n /\r\n abstract start(container: HTMLElement): void;\r\n\r\n /\r\n Gets a StartAppUC instance from an app object\r\n * \r\n * @param appObject - App object to get the StartAppUC from\r\n * @returns StartAppUC instance if found, undefined otherwise\r\n /\r\n static get(appObject: AppObject): StartAppUC \| undefined {\r\n const asset = appObject.getComponent<StartAppUC>(StartAppUC.type);\r\n if (!asset) {\r\n appObject.appObjectRepo.submitWarning(\r\n \"StartAppUC.get\",\r\n \"Unable to find StartAppUC on app object \" + appObject.id\r\n );\r\n }\r\n return asset;\r\n }\r\n\r\n /\r\n Gets a StartAppUC instance by app ID\r\n * \r\n * @param id - ID of the app to start\r\n * @param appObjects - Repository containing app objects\r\n * @returns StartAppUC instance if found, undefined otherwise\r\n /\r\n static getByID(\r\n id: string,\r\n appObjects: AppObjectRepo\r\n ): StartAppUC \| undefined {\r\n const appObject = appObjects.get(id);\r\n\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"StartAppUC.getByID\",\r\n \"Unable to find App Object by id \" + id\r\n );\r\n return undefined;\r\n }\r\n\r\n return StartAppUC.get(appObject);\r\n }\r\n\r\n /\r\n Convenience method to start an app by ID\r\n * \r\n * @param container - HTML element to mount the app in\r\n * @param id - ID of the app to start\r\n * @param appObjects - Repository containing app objects\r\n /\r\n static startByID(\r\n container: HTMLElement,\r\n id: string,\r\n appObjects: AppObjectRepo\r\n ) {\r\n StartAppUC.getByID(id, appObjects)?.start(container);\r\n }\r\n}\r\n\r\n/\r\n Factory function to create a new StartAppUC instance\r\n * \r\n * @param appObject - The app object to attach the use case to\r\n * @returns A concrete implementation of StartAppUC\r\n /\r\nexport function makeStartAppUC(appObject: AppObject): StartAppUC {\r\n return new StartAppUCImp(appObject);\r\n}\r\n\r\n/\r\n Concrete implementation of StartAppUC\r\n * Uses dependency injection to access required components\r\n * Handles the app starting process\r\n */\r\nclass StartAppUCImp extends StartAppUC {\r\n private get stateMachine() {\r\n return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n }\r\n\r\n private get editStateEntity() {\r\n return this.getCachedSingleton<HostEditingStateEntity>(\r\n HostEditingStateEntity.type\r\n );\r\n }\r\n\r\n private get dispatchStart() {\r\n return this.getCachedLocalComponent<DispatchStartAppUC>(\r\n DispatchStartAppUC.type\r\n );\r\n }\r\n\r\n private get dispatchSetState() {\r\n return this.getCachedLocalComponent<DispatchSetStateUC>(\r\n DispatchSetStateUC.type\r\n );\r\n }\r\n\r\n private get dispatchSetIsAuthoring() {\r\n return this.getCachedLocalComponent<DispatchIsAuthoringUC>(\r\n DispatchIsAuthoringUC.type\r\n );\r\n }\r\n\r\n private get dispatchThemeColors() {\r\n return this.getCachedLocalComponent<DispatchThemeUC>(DispatchThemeUC.type);\r\n }\r\n\r\n private get dispatchEnableFeature() {\r\n return this.getCachedLocalComponent<DispatchEnableFeatureUC>(\r\n DispatchEnableFeatureUC.type\r\n );\r\n }\r\n\r\n private get sandbox() {\r\n return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n }\r\n\r\n start = (container: HTMLElement) => {\r\n if (!this.stateMachine) return;\r\n if (!this.dispatchStart) return;\r\n if (!this.editStateEntity) return;\r\n if (!this.sandbox) return;\r\n\r\n this.dispatchStart.doDispatch(container);\r\n\r\n let state;\r\n if (this.stateMachine.activeState) {\r\n state = this.stateMachine.getStateByID(this.stateMachine.activeState)\r\n ?.stateData;\r\n }\r\n\r\n const hideNavigation = this.stateMachine.states.length <= 1;\r\n const hasNextSlide = this.stateMachine.nextState !== undefined;\r\n const hasPreviousSlide = this.stateMachine.previousState !== undefined;\r\n const dto: DispatchStateDTO = {\r\n finalState: state,\r\n hideNavigation,\r\n hasNextSlide,\r\n hasPreviousSlide\r\n };\r\n this.dispatchSetState?.doDispatch(dto);\r\n\r\n let isAuthoring = this.editStateEntity.isEditing;\r\n if (this.stateMachine.activeState === undefined) {\r\n isAuthoring = true;\r\n }\r\n this.dispatchSetIsAuthoring?.doDispatch(isAuthoring);\r\n\r\n this.dispatchThemeColors?.doDispatch();\r\n\r\n if (this.sandbox.enableDevFeatures) {\r\n this.sandbox.devFeatures.forEach((feature) => {\r\n this.dispatchEnableFeature?.doDispatch(feature);\r\n });\r\n }\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, StartAppUC.type);\r\n }\r\n}\r\n"]}

package/dist/esm/Apps/UCs/StopAppUC.js CHANGED Viewed

@@ -1,6 +1,20 @@
 import { AppObjectUC } from "@vived/core";
 import { DispatchStopAppUC } from "../../Dispatcher";
+/**
+ * Use Case for stopping an application.
+ *
+ * This class provides functionality to stop a running app through the dispatcher
+ * system. It acts as a bridge between controllers and the dispatch mechanism.
+ *
+ * @extends AppObjectUC from @vived/core
+ */
 export class StopAppUC extends AppObjectUC {
+    /**
+     * Retrieves the StopAppUC component from a specific App Object.
+     *
+     * @param appObject - The App Object to get the component from
+     * @returns The StopAppUC component or undefined if not found
+     */
     static get(appObject) {
         const asset = appObject.getComponent(StopAppUC.type);
         if (!asset) {
@@ -8,6 +22,13 @@ export class StopAppUC extends AppObjectUC {
         }
         return asset;
     }
+    /**
+     * Retrieves the StopAppUC component by App Object ID.
+     *
+     * @param id - The ID of the App Object
+     * @param appObjects - The App Object repository
+     * @returns The StopAppUC component or undefined if not found
+     */
     static getByID(id, appObjects) {
         const appObject = appObjects.get(id);
         if (!appObject) {
@@ -16,21 +37,47 @@ export class StopAppUC extends AppObjectUC {
         }
         return StopAppUC.get(appObject);
     }
+    /**
+     * Convenience method to stop an app by its ID.
+     *
+     * @param id - The ID of the app to stop
+     * @param appObjects - The App Object repository
+     */
     static stopByID(id, appObjects) {
         StopAppUC.getByID(id, appObjects)?.stop();
     }
 }
 StopAppUC.type = "StopAppUC";
+/**
+ * Factory function to create a new StopAppUC instance.
+ *
+ * @param appObject - The App Object to attach the component to
+ * @returns A new StopAppUC instance
+ */
 export function makeStopAppUC(appObject) {
     return new StartAppUCImp(appObject);
 }
+/**
+ * Concrete implementation of the StopAppUC abstract class.
+ */
 class StartAppUCImp extends StopAppUC {
+    /**
+     * Gets the dispatch component that sends the stop command to the app.
+     */
     get dispatchStop() {
         return this.getCachedLocalComponent(DispatchStopAppUC.type);
     }
+    /**
+     * Stops the app by triggering the dispatch mechanism.
+     */
     stop() {
         this.dispatchStop?.doDispatch();
     }
+    /**
+     * Creates a new instance of the StopAppUC implementation.
+     *
+     * @param appObject - The App Object to attach to
+     */
     constructor(appObject) {
         super(appObject, StopAppUC.type);
     }

package/dist/esm/Apps/UCs/StopAppUC.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"StopAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StopAppUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,WAAW,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,OAAgB,SAAU,SAAQ,WAAW;~~IAKjD~~,MAAM,CAAC,GAAG,CAAC,SAAoB;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,CAAC,aAAa,CAAC,aAAa,CACnC,eAAe,EACf,0CAA0C,GAAG,SAAS,CAAC,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,EAAU,EAAE,UAAyB;QAClD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAErC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,mBAAmB,EACnB,kCAAkC,GAAG,EAAE,CACxC,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,EAAU,EAAE,UAAyB;QACnD,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;;~~AA/BM~~,cAAI,GAAG,WAAW,CAAC;~~AAkC5B~~,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,SAAS;IACnC,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,uBAAuB,CACjC,iBAAiB,CAAC,IAAI,CACvB,CAAC;IACJ,CAAC;IAED,IAAI;QACF,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { DispatchStopAppUC } from \"../../Dispatcher\";\r\n\r\nexport abstract class StopAppUC extends AppObjectUC {\r\n static type = \"StopAppUC\";\r\n\r\n abstract stop(): void;\r\n\r\n static get(appObject: AppObject): StopAppUC \| undefined {\r\n const asset = appObject.getComponent<StopAppUC>(StopAppUC.type);\r\n if (!asset) {\r\n appObject.appObjectRepo.submitWarning(\r\n \"StopAppUC.get\",\r\n \"Unable to find StartAppUC on app object \" + appObject.id\r\n );\r\n }\r\n return asset;\r\n }\r\n\r\n static getByID(id: string, appObjects: AppObjectRepo): StopAppUC \| undefined {\r\n const appObject = appObjects.get(id);\r\n\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"StopAppUC.getByID\",\r\n \"Unable to find App Object by id \" + id\r\n );\r\n return undefined;\r\n }\r\n\r\n return StopAppUC.get(appObject);\r\n }\r\n\r\n static stopByID(id: string, appObjects: AppObjectRepo) {\r\n StopAppUC.getByID(id, appObjects)?.stop();\r\n }\r\n}\r\n\r\nexport function makeStopAppUC(appObject: AppObject): StopAppUC {\r\n return new StartAppUCImp(appObject);\r\n}\r\n\r\nclass StartAppUCImp extends StopAppUC {\r\n private get dispatchStop() {\r\n return this.getCachedLocalComponent<DispatchStopAppUC>(\r\n DispatchStopAppUC.type\r\n );\r\n }\r\n\r\n stop(): void {\r\n this.dispatchStop?.doDispatch();\r\n }\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, StopAppUC.type);\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"StopAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StopAppUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,WAAW,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,OAAgB,SAAU,SAAQ,WAAW;IAQjD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,SAAoB;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,CAAC,aAAa,CAAC,aAAa,CACnC,eAAe,EACf,0CAA0C,GAAG,SAAS,CAAC,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,EAAU,EAAE,UAAyB;QAClD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAErC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,mBAAmB,EACnB,kCAAkC,GAAG,EAAE,CACxC,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAU,EAAE,UAAyB;QACnD,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;;AArDM,cAAI,GAAG,WAAW,CAAC;AAwD5B;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,aAAc,SAAQ,SAAS;IACnC;;OAEG;IACH,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,uBAAuB,CACjC,iBAAiB,CAAC,IAAI,CACvB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { DispatchStopAppUC } from \"../../Dispatcher\";\r\n\r\n/*\r\n Use Case for stopping an application.\r\n \r\n This class provides functionality to stop a running app through the dispatcher\r\n * system. It acts as a bridge between controllers and the dispatch mechanism.\r\n \r\n @extends AppObjectUC from @vived/core\r\n /\r\nexport abstract class StopAppUC extends AppObjectUC {\r\n static type = \"StopAppUC\";\r\n\r\n /\r\n Stops the application associated with this Use Case.\r\n /\r\n abstract stop(): void;\r\n\r\n /\r\n Retrieves the StopAppUC component from a specific App Object.\r\n \r\n @param appObject - The App Object to get the component from\r\n * @returns The StopAppUC component or undefined if not found\r\n /\r\n static get(appObject: AppObject): StopAppUC \| undefined {\r\n const asset = appObject.getComponent<StopAppUC>(StopAppUC.type);\r\n if (!asset) {\r\n appObject.appObjectRepo.submitWarning(\r\n \"StopAppUC.get\",\r\n \"Unable to find StartAppUC on app object \" + appObject.id\r\n );\r\n }\r\n return asset;\r\n }\r\n\r\n /\r\n Retrieves the StopAppUC 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 StopAppUC component or undefined if not found\r\n /\r\n static getByID(id: string, appObjects: AppObjectRepo): StopAppUC \| undefined {\r\n const appObject = appObjects.get(id);\r\n\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"StopAppUC.getByID\",\r\n \"Unable to find App Object by id \" + id\r\n );\r\n return undefined;\r\n }\r\n\r\n return StopAppUC.get(appObject);\r\n }\r\n\r\n /\r\n Convenience method to stop an app by its ID.\r\n \r\n @param id - The ID of the app to stop\r\n * @param appObjects - The App Object repository\r\n /\r\n static stopByID(id: string, appObjects: AppObjectRepo) {\r\n StopAppUC.getByID(id, appObjects)?.stop();\r\n }\r\n}\r\n\r\n/\r\n Factory function to create a new StopAppUC instance.\r\n \r\n @param appObject - The App Object to attach the component to\r\n * @returns A new StopAppUC instance\r\n /\r\nexport function makeStopAppUC(appObject: AppObject): StopAppUC {\r\n return new StartAppUCImp(appObject);\r\n}\r\n\r\n/\r\n Concrete implementation of the StopAppUC abstract class.\r\n /\r\nclass StartAppUCImp extends StopAppUC {\r\n /\r\n Gets the dispatch component that sends the stop command to the app.\r\n /\r\n private get dispatchStop() {\r\n return this.getCachedLocalComponent<DispatchStopAppUC>(\r\n DispatchStopAppUC.type\r\n );\r\n }\r\n\r\n /\r\n Stops the app by triggering the dispatch mechanism.\r\n /\r\n stop(): void {\r\n this.dispatchStop?.doDispatch();\r\n }\r\n\r\n /\r\n Creates a new instance of the StopAppUC implementation.\r\n \r\n @param appObject - The App Object to attach to\r\n */\r\n constructor(appObject: AppObject) {\r\n super(appObject, StopAppUC.type);\r\n }\r\n}\r\n"]}

package/dist/esm/Apps/UCs/formAppIDWithVersion.js CHANGED Viewed

@@ -1,3 +1,21 @@
+/**
+ * Creates a versioned ID for an app by combining the app ID with its version.
+ *
+ * This utility function forms a unique identifier that includes both the app ID
+ * and version information. This is used to identify specific versions of apps,
+ * particularly when loading scripts into the DOM or accessing app interfaces from
+ * the window object.
+ *
+ * The version is formatted by replacing periods with underscores to create a
+ * valid JavaScript identifier (e.g., "1.2.3" becomes "1_2_3").
+ *
+ * @param app - The app entity
+ * @param version - The version to include in the ID
+ * @returns A string in the format "{appId}-{version_with_underscores}"
+ * @example
+ * // Returns "myApp-1_2_3" for app.id="myApp" and version="1.2.3"
+ * formAppIDWithVersion(app, version)
+ */
 export function formAppIDWithVersion(app, version) {
     const versionString = version.baseVersionString.split(".").join("_");
     return `${app.id}-${versionString}`;

package/dist/esm/Apps/UCs/formAppIDWithVersion.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"formAppIDWithVersion.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/formAppIDWithVersion.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,oBAAoB,CAAC,GAAc,EAAE,OAAgB;IACnE,MAAM,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,OAAO,GAAG,GAAG,CAAC,EAAE,IAAI,aAAa,EAAE,CAAC;AACtC,CAAC","sourcesContent":["import { Version } from \"@vived/core\";\r\nimport { AppEntity } from \"../Entities\";\r\n\r\nexport function formAppIDWithVersion(app: AppEntity, version: Version) {\r\n const versionString = version.baseVersionString.split(\".\").join(\"_\");\r\n return `${app.id}-${versionString}`;\r\n}\r\n"]}
1	+ {"version":3,"file":"formAppIDWithVersion.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/formAppIDWithVersion.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAc,EAAE,OAAgB;IACnE,MAAM,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,OAAO,GAAG,GAAG,CAAC,EAAE,IAAI,aAAa,EAAE,CAAC;AACtC,CAAC","sourcesContent":["import { Version } from \"@vived/core\";\r\nimport { AppEntity } from \"../Entities\";\r\n\r\n/*\r\n Creates a versioned ID for an app by combining the app ID with its version.\r\n \r\n This utility function forms a unique identifier that includes both the app ID\r\n * and version information. This is used to identify specific versions of apps,\r\n * particularly when loading scripts into the DOM or accessing app interfaces from\r\n * the window object.\r\n \r\n The version is formatted by replacing periods with underscores to create a\r\n * valid JavaScript identifier (e.g., \"1.2.3\" becomes \"1_2_3\").\r\n \r\n @param app - The app entity\r\n * @param version - The version to include in the ID\r\n * @returns A string in the format \"{appId}-{version_with_underscores}\"\r\n * @example\r\n * // Returns \"myApp-1_2_3\" for app.id=\"myApp\" and version=\"1.2.3\"\r\n * formAppIDWithVersion(app, version)\r\n */\r\nexport function formAppIDWithVersion(app: AppEntity, version: Version) {\r\n const versionString = version.baseVersionString.split(\".\").join(\"_\");\r\n return `${app.id}-${versionString}`;\r\n}\r\n"]}

package/dist/esm/Apps/index.js CHANGED Viewed

@@ -1,3 +1,22 @@
+/**
+ * Apps Module - Core module for managing application lifecycle in the VIVED Learning platform
+ *
+ * This module handles app loading, mounting, starting, stopping, and state management.
+ * It follows a clean architecture pattern with the following layers:
+ *
+ * - Entities: Core domain models (AppEntity, AppRepo)
+ * - PMs (Presentation Models): Business logic and state management
+ * - UCs (Use Cases): Implementation of specific operations
+ * - Adapters: Connect PMs to UI components
+ * - Controllers: Entry points for UI interactions
+ *
+ * To use this module, typically you would:
+ * 1. Load an app using the AppEntity
+ * 2. Mount the app using MounterUC
+ * 3. Start the app using StartAppUC
+ * 4. Manage app state via the AppPM or ActiveAppPM
+ * 5. Stop the app using StopAppUC when done
+ */
 export * from "./Adapters";
 export * from "./Controllers";
 export * from "./Entities";

package/dist/esm/Apps/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Apps/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC","sourcesContent":["~~export~~ * from \"./Adapters\";\r\nexport * from \"./Controllers\";\r\nexport * from \"./Entities\";\r\nexport * from \"./Mocks\";\r\nexport * from \"./PMs\";\r\nexport * from \"./UCs\";\r\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Apps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC","sourcesContent":["/*\r\n Apps Module - Core module for managing application lifecycle in the VIVED Learning platform\r\n * \r\n * This module handles app loading, mounting, starting, stopping, and state management.\r\n * It follows a clean architecture pattern with the following layers:\r\n * \r\n * - Entities: Core domain models (AppEntity, AppRepo)\r\n * - PMs (Presentation Models): Business logic and state management\r\n * - UCs (Use Cases): Implementation of specific operations\r\n * - Adapters: Connect PMs to UI components\r\n * - Controllers: Entry points for UI interactions\r\n * \r\n * To use this module, typically you would:\r\n * 1. Load an app using the AppEntity\r\n * 2. Mount the app using MounterUC\r\n * 3. Start the app using StartAppUC\r\n * 4. Manage app state via the AppPM or ActiveAppPM\r\n * 5. Stop the app using StopAppUC when done\r\n /\r\n\r\nexport from \"./Adapters\";\r\nexport * from \"./Controllers\";\r\nexport * from \"./Entities\";\r\nexport * from \"./Mocks\";\r\nexport * from \"./PMs\";\r\nexport * from \"./UCs\";\r\n"]}

package/dist/esm/ChallengeResults/Adapters/hasChallengeResultsPMAdapter.js ADDED Viewed

@@ -0,0 +1,21 @@
+import { HasChallengeResultsPM } from "../PMs/HasChallengeResultsPM";
+export const hasChallengeResultsPMAdapter = {
+    defaultVM: false,
+    subscribe: (appObjects, setVM) => {
+        const pm = HasChallengeResultsPM.get(appObjects);
+        if (!pm) {
+            appObjects.submitError("hasChallengeResultsPMAdapter", "Unable to find HasChallengeResultsPM");
+            return;
+        }
+        pm.addView(setVM);
+    },
+    unsubscribe: (appObjects, setVM) => {
+        const pm = HasChallengeResultsPM.get(appObjects);
+        if (!pm) {
+            appObjects.submitError("hasChallengeResultsPMAdapter", "Unable to find HasChallengeResultsPM");
+            return;
+        }
+        pm.removeView(setVM);
+    }
+};
+//# sourceMappingURL=hasChallengeResultsPMAdapter.js.map

package/dist/esm/ChallengeResults/Adapters/hasChallengeResultsPMAdapter.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"hasChallengeResultsPMAdapter.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/hasChallengeResultsPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,CAAC,MAAM,4BAA4B,GAAgC;IACvE,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,CAAC,UAAyB,EAAE,KAA4B,EAAE,EAAE;QACrE,MAAM,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,8BAA8B,EAC9B,sCAAsC,CACvC,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,WAAW,EAAE,CAAC,UAAyB,EAAE,KAA4B,EAAE,EAAE;QACvE,MAAM,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,8BAA8B,EAC9B,sCAAsC,CACvC,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport { HasChallengeResultsPM } from \"../PMs/HasChallengeResultsPM\";\r\n\r\nexport const hasChallengeResultsPMAdapter: SingletonPmAdapter<boolean> = {\r\n defaultVM: false,\r\n subscribe: (appObjects: AppObjectRepo, setVM: (vm: boolean) => void) => {\r\n const pm = HasChallengeResultsPM.get(appObjects);\r\n if (!pm) {\r\n appObjects.submitError(\r\n \"hasChallengeResultsPMAdapter\",\r\n \"Unable to find HasChallengeResultsPM\"\r\n );\r\n return;\r\n }\r\n pm.addView(setVM);\r\n },\r\n unsubscribe: (appObjects: AppObjectRepo, setVM: (vm: boolean) => void) => {\r\n const pm = HasChallengeResultsPM.get(appObjects);\r\n if (!pm) {\r\n appObjects.submitError(\r\n \"hasChallengeResultsPMAdapter\",\r\n \"Unable to find HasChallengeResultsPM\"\r\n );\r\n return;\r\n }\r\n pm.removeView(setVM);\r\n }\r\n};\r\n"]}

package/dist/esm/ChallengeResults/Adapters/index.js CHANGED Viewed

@@ -1,2 +1,3 @@
 export * from "./challengeResultsListAdapter";
+export * from "./hasChallengeResultsPMAdapter";
 //# sourceMappingURL=index.js.map

package/dist/esm/ChallengeResults/Adapters/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC","sourcesContent":["export * from \"./challengeResultsListAdapter\";\r\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC","sourcesContent":["export * from \"./challengeResultsListAdapter\";\r\nexport * from \"./hasChallengeResultsPMAdapter\";\r\n"]}

package/dist/esm/ChallengeResults/Factories/index.js CHANGED Viewed

@@ -1,2 +1,2 @@
-export * from "./setupChallengeResultsForSandbox";
+export * from "./setupChallengeResults";
 //# sourceMappingURL=index.js.map

package/dist/esm/ChallengeResults/Factories/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,~~mCAAmC~~,CAAA","sourcesContent":["export * from \"./~~setupChallengeResultsForSandbox~~\""]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA","sourcesContent":["export * from \"./setupChallengeResults\""]}

package/dist/esm/ChallengeResults/Factories/setupChallengeResults.js ADDED Viewed

@@ -0,0 +1,11 @@
+import { makeChallengeResults } from "../Entities";
+import { makeChallengeResultsPM, makeHasChallengeResultsPM } from "../PMs";
+export function setupChallengeResults(appObjects) {
+    const ao = appObjects.getOrCreate("ChallengeResults");
+    const entity = makeChallengeResults(ao);
+    // PM
+    makeChallengeResultsPM(ao);
+    makeHasChallengeResultsPM(ao);
+    return entity;
+}
+//# sourceMappingURL=setupChallengeResults.js.map