npm - @vived/host - Versions diffs - 4.9.1 → 4.11.0 - Mend

@vived/host 4.9.1 → 4.11.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 (1331) hide show

package/dist/esm/Assets/PMs/AppAssetListPM.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AppAssetListPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AppAssetListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,OAAgB,cAAe,SAAQ,WAAqB;IAGhE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;;AAJM,mBAAI,GAAG,gBAAgB,CAAC;AAOjC,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACrD,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,iBAAkB,SAAQ,cAAc;IAG5C,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAExC,IAAI,aAAa,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAChB,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC;IACvB,CAAC;IAuBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QAtBhC,sBAAiB,GAAG,GAAG,EAAE;YAC/B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAE7C,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,MAAM,iBAAiB,GAAa,EAAE,CAAC;YAEvC,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;oBACtC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QACvC,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CACR,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEzD,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;CACF","sourcesContent":["import {\r\n getSingletonComponent,\r\n AppObject,\r\n AppObjectPM,\r\n AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\n\r\nexport abstract class AppAssetListPM extends AppObjectPM<string[]> {\r\n static type = \"AppAssetListPM\";\r\n\r\n static get(appObjects: AppObjectRepo): AppAssetListPM \| undefined {\r\n return getSingletonComponent(AppAssetListPM.type, appObjects);\r\n }\r\n}\r\n\r\nexport function makeAppAssetListPM(appObject: AppObject): AppAssetListPM {\r\n return new AppAssetListPMImp(appObject);\r\n}\r\n\r\nclass AppAssetListPMImp extends AppAssetListPM {\r\n private appAssets?: AppAssetsEntity;\r\n\r\n private get assetRepo() {\r\n return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n }\r\n\r\n vmsAreEqual(a: string[], b: string[]): boolean {\r\n if (a.length !== b.length) return false;\r\n\r\n let listsAreEqual = true;\r\n a.forEach((aID, i) => {\r\n const bID = b[i];\r\n if (bID !== aID) {\r\n listsAreEqual = false;\r\n }\r\n });\r\n\r\n return listsAreEqual;\r\n }\r\n\r\n private onAppAssetsChange = () => {\r\n if (!this.appAssets) return;\r\n const allAppAssets = this.appAssets.getAll();\r\n\r\n if (this.appAssets.showArchived) {\r\n this.doUpdateView(allAppAssets);\r\n return;\r\n }\r\n\r\n const nonArchivedAssets: string[] = [];\r\n\r\n allAppAssets.forEach((assetID) => {\r\n const asset = this.assetRepo?.get(assetID);\r\n if (asset && asset.archived === false) {\r\n nonArchivedAssets.push(assetID);\r\n }\r\n });\r\n\r\n this.doUpdateView(nonArchivedAssets);\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, AppAssetListPM.type);\r\n\r\n this.appAssets = appObject.getComponent<AppAssetsEntity>(\r\n AppAssetsEntity.type\r\n );\r\n if (!this.appAssets) {\r\n this.error(\r\n \"PM has been added to an app object without an AppAssetsEntity\"\r\n );\r\n return;\r\n }\r\n\r\n this.appAssets.addChangeObserver(this.onAppAssetsChange);\r\n\r\n this.appObjects.registerSingleton(this);\r\n\r\n this.onAppAssetsChange();\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"AppAssetListPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AppAssetListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,OAAgB,cAAe,SAAQ,WAAqB;IAGhE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;;AAJM,mBAAI,GAAG,gBAAgB,CAAC;AAOjC,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACrD,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,iBAAkB,SAAQ,cAAc;IAG5C,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAExC,IAAI,aAAa,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAChB,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC;IACvB,CAAC;IAuBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QAtBhC,sBAAiB,GAAG,GAAG,EAAE;YAC/B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAE7C,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,MAAM,iBAAiB,GAAa,EAAE,CAAC;YAEvC,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;oBACtC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QACvC,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CACR,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEzD,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;CACF","sourcesContent":["import {\n getSingletonComponent,\n AppObject,\n AppObjectPM,\n AppObjectRepo\n} from \"@vived/core\";\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\nimport { AssetRepo } from \"../Entities/AssetRepo\";\n\nexport abstract class AppAssetListPM extends AppObjectPM<string[]> {\n static type = \"AppAssetListPM\";\n\n static get(appObjects: AppObjectRepo): AppAssetListPM \| undefined {\n return getSingletonComponent(AppAssetListPM.type, appObjects);\n }\n}\n\nexport function makeAppAssetListPM(appObject: AppObject): AppAssetListPM {\n return new AppAssetListPMImp(appObject);\n}\n\nclass AppAssetListPMImp extends AppAssetListPM {\n private appAssets?: AppAssetsEntity;\n\n private get assetRepo() {\n return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\n }\n\n vmsAreEqual(a: string[], b: string[]): boolean {\n if (a.length !== b.length) return false;\n\n let listsAreEqual = true;\n a.forEach((aID, i) => {\n const bID = b[i];\n if (bID !== aID) {\n listsAreEqual = false;\n }\n });\n\n return listsAreEqual;\n }\n\n private onAppAssetsChange = () => {\n if (!this.appAssets) return;\n const allAppAssets = this.appAssets.getAll();\n\n if (this.appAssets.showArchived) {\n this.doUpdateView(allAppAssets);\n return;\n }\n\n const nonArchivedAssets: string[] = [];\n\n allAppAssets.forEach((assetID) => {\n const asset = this.assetRepo?.get(assetID);\n if (asset && asset.archived === false) {\n nonArchivedAssets.push(assetID);\n }\n });\n\n this.doUpdateView(nonArchivedAssets);\n };\n\n constructor(appObject: AppObject) {\n super(appObject, AppAssetListPM.type);\n\n this.appAssets = appObject.getComponent<AppAssetsEntity>(\n AppAssetsEntity.type\n );\n if (!this.appAssets) {\n this.error(\n \"PM has been added to an app object without an AppAssetsEntity\"\n );\n return;\n }\n\n this.appAssets.addChangeObserver(this.onAppAssetsChange);\n\n this.appObjects.registerSingleton(this);\n\n this.onAppAssetsChange();\n }\n}\n"]}

package/dist/esm/Assets/PMs/AssetFilePM.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AssetFilePM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetFilePM.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAiBtD;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,KAAK;IACrB,kBAAkB,EAAE,KAAK;IACzB,UAAU,EAAE,SAAS;CACtB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAgB,WAAY,SAAQ,WAAwB;IAGhE;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CACZ,OAAe,EACf,UAAyB;QAEzB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,qBAAqB,EACrB,kCAAkC,GAAG,OAAO,CAC7C,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,aAAa,CACtB,qBAAqB,EACrB,wCAAwC,CACzC,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;;AA/BM,gBAAI,GAAG,aAAa,CAAC;AAkC9B;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,cAAe,SAAQ,WAAW;IACtC,IAAY,KAAK;~~QACjB~~,OAAO,IAAI,CAAC,uBAAuB,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;~~IACpE~~,CAAC;~~IAEA~~;;;;;;;OAOG;IACH,WAAW,CAAC,CAAc,EAAE,CAAc;QACxC,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,CAAC,cAAc,KAAK,CAAC,CAAC,cAAc;YAAE,OAAO,KAAK,CAAC;QACxD,IAAI,CAAC,CAAC,kBAAkB,KAAK,CAAC,CAAC,kBAAkB;YAAE,OAAO,KAAK,CAAC;QAEhE,6DAA6D;QAC7D,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;gBAC1D,OAAO,KAAK,CAAC;YACf,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;gBAC1D,OAAO,KAAK,CAAC;YACf,IACE,CAAC,CAAC,UAAU,KAAK,SAAS;gBAC1B,CAAC,CAAC,UAAU,KAAK,SAAS;gBAC1B,CAAC,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO;gBAE7C,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAmBD;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAjCrC;;;WAGG;QACK,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,OAAO;YAExB,MAAM,EAAE,GAAgB;gBACtB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;gBAC3B,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc;gBACzC,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,kBAAkB;gBACjD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;aAClC,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAoBA,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["// filepath: c:\\Users\\amosp\\Documents\\WebGL\\vivedlearning_host\\src\\Assets\\PMs\\AssetFilePM.ts\r\nimport { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\n/*\r\n View Model for Asset file information\r\n * Represents the data needed by the view to display asset file status\r\n /\r\nexport interface AssetFileVM {\r\n /* URL to the asset's file blob for direct access /\r\n blobURL: string \| undefined;\r\n /* Whether the asset file is currently being fetched /\r\n isFetchingFile: boolean;\r\n /* Whether the asset file has been successfully fetched /\r\n fileHasBeenFetched: boolean;\r\n /* Error that occurred during file fetching, if any /\r\n fetchError: Error \| undefined;\r\n}\r\n\r\n/\r\n Default empty AssetFileVM for initialization\r\n /\r\nexport const defaultAssetFileVM: AssetFileVM = {\r\n blobURL: undefined,\r\n isFetchingFile: false,\r\n fileHasBeenFetched: false,\r\n fetchError: undefined\r\n};\r\n\r\n/\r\n Presentation Manager for Asset file status\r\n \r\n The AssetFilePM is responsible for:\r\n * - Converting the file-related properties of AssetEntity into a view-friendly format (AssetFileVM)\r\n * - Notifying the view when asset file status changes\r\n * - Providing comparison utilities for view models\r\n \r\n Usage:\r\n * 1. Retrieve an instance with `AssetFilePM.getByID(assetId, appObjects)`\r\n * 2. Subscribe to view updates with `pm.addView(callback)`\r\n * 3. Access current view data with `pm.lastVM`\r\n /\r\nexport abstract class AssetFilePM extends AppObjectPM<AssetFileVM> {\r\n static type = \"AssetFilePM\";\r\n\r\n /\r\n Retrieves an AssetFilePM instance for a specific asset by ID\r\n \r\n @param assetID - The unique identifier of the asset\r\n * @param appObjects - The repository of app objects\r\n * @returns The AssetFilePM instance or undefined if not found\r\n /\r\n static getByID(\r\n assetID: string,\r\n appObjects: AppObjectRepo\r\n ): AssetFilePM \| undefined {\r\n const appObject = appObjects.get(assetID);\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"AssetFilePM.getByID\",\r\n \"Unable to find app object by ID \" + assetID\r\n );\r\n return;\r\n }\r\n\r\n const pm = appObject.getComponent<AssetFilePM>(AssetFilePM.type);\r\n if (!pm) {\r\n appObjects.submitWarning(\r\n \"AssetFilePM.getByID\",\r\n \"App Object does not have a AssetFilePM\"\r\n );\r\n return;\r\n }\r\n return pm;\r\n }\r\n}\r\n\r\n/\r\n Creates a new AssetFilePM instance\r\n \r\n @param appObject - The app object to associate with this PM\r\n * @returns A new AssetFilePM instance\r\n /\r\nexport function makeAssetFilePM(appObject: AppObject): AssetFilePM {\r\n return new AssetFilePMImp(appObject);\r\n}\r\n\r\n/\r\n Implementation of the AssetFilePM abstract class\r\n * Handles the connection between AssetEntity file properties and view\r\n /\r\nclass AssetFilePMImp extends AssetFilePM {\r\n private get asset() {\r\n~~\t\treturn~~ this.getCachedLocalComponent<AssetEntity>(AssetEntity.type);\r\n\t}\r\n\r\n /\r\n Compares two AssetFileVM instances for equality\r\n * Used to determine if the view needs to update\r\n \r\n @param a - First AssetFileVM to compare\r\n * @param b - Second AssetFileVM to compare\r\n * @returns True if view models are equal, false otherwise\r\n /\r\n vmsAreEqual(a: AssetFileVM, b: AssetFileVM): boolean {\r\n if (a.blobURL !== b.blobURL) return false;\r\n if (a.isFetchingFile !== b.isFetchingFile) return false;\r\n if (a.fileHasBeenFetched !== b.fileHasBeenFetched) return false;\r\n\r\n // Handle errors comparison (both undefined, or same message)\r\n if (a.fetchError !== b.fetchError) {\r\n if (a.fetchError === undefined && b.fetchError !== undefined)\r\n return false;\r\n if (a.fetchError !== undefined && b.fetchError === undefined)\r\n return false;\r\n if (\r\n a.fetchError !== undefined &&\r\n b.fetchError !== undefined &&\r\n a.fetchError.message !== b.fetchError.message\r\n )\r\n return false;\r\n }\r\n\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 onAssetChange = () => {\r\n if (!this.asset) return;\r\n\r\n const vm: AssetFileVM = {\r\n blobURL: this.asset.blobURL,\r\n isFetchingFile: this.asset.isFetchingFile,\r\n fileHasBeenFetched: this.asset.fileHasBeenFetched,\r\n fetchError: this.asset.fetchError\r\n };\r\n\r\n this.doUpdateView(vm);\r\n };\r\n\r\n /\r\n Cleans up resources and removes observers when the PM is disposed\r\n /\r\n dispose(): void {\r\n if (this.asset) {\r\n this.asset.removeChangeObserver(this.onAssetChange);\r\n }\r\n super.dispose();\r\n }\r\n\r\n /\r\n Creates a new AssetFilePMImp 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, AssetFilePM.type);\r\n\r\n this.asset?.addChangeObserver(this.onAssetChange);\r\n this.onAssetChange();\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"AssetFilePM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetFilePM.ts"],"names":[],"mappings":"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","sourcesContent":["// filepath: c:\\Users\\amosp\\Documents\\WebGL\\vivedlearning_host\\src\\Assets\\PMs\\AssetFilePM.ts\nimport { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\nimport { AssetEntity } from \"../Entities/AssetEntity\";\n\n/*\n View Model for Asset file information\n * Represents the data needed by the view to display asset file status\n /\nexport interface AssetFileVM {\n /* URL to the asset's file blob for direct access /\n blobURL: string \| undefined;\n /* Whether the asset file is currently being fetched /\n isFetchingFile: boolean;\n /* Whether the asset file has been successfully fetched /\n fileHasBeenFetched: boolean;\n /* Error that occurred during file fetching, if any /\n fetchError: Error \| undefined;\n}\n\n/\n Default empty AssetFileVM for initialization\n /\nexport const defaultAssetFileVM: AssetFileVM = {\n blobURL: undefined,\n isFetchingFile: false,\n fileHasBeenFetched: false,\n fetchError: undefined\n};\n\n/\n Presentation Manager for Asset file status\n \n The AssetFilePM is responsible for:\n * - Converting the file-related properties of AssetEntity into a view-friendly format (AssetFileVM)\n * - Notifying the view when asset file status changes\n * - Providing comparison utilities for view models\n \n Usage:\n * 1. Retrieve an instance with `AssetFilePM.getByID(assetId, appObjects)`\n * 2. Subscribe to view updates with `pm.addView(callback)`\n * 3. Access current view data with `pm.lastVM`\n /\nexport abstract class AssetFilePM extends AppObjectPM<AssetFileVM> {\n static type = \"AssetFilePM\";\n\n /\n Retrieves an AssetFilePM instance for a specific asset by ID\n \n @param assetID - The unique identifier of the asset\n * @param appObjects - The repository of app objects\n * @returns The AssetFilePM instance or undefined if not found\n /\n static getByID(\n assetID: string,\n appObjects: AppObjectRepo\n ): AssetFilePM \| undefined {\n const appObject = appObjects.get(assetID);\n if (!appObject) {\n appObjects.submitWarning(\n \"AssetFilePM.getByID\",\n \"Unable to find app object by ID \" + assetID\n );\n return;\n }\n\n const pm = appObject.getComponent<AssetFilePM>(AssetFilePM.type);\n if (!pm) {\n appObjects.submitWarning(\n \"AssetFilePM.getByID\",\n \"App Object does not have a AssetFilePM\"\n );\n return;\n }\n return pm;\n }\n}\n\n/\n Creates a new AssetFilePM instance\n \n @param appObject - The app object to associate with this PM\n * @returns A new AssetFilePM instance\n /\nexport function makeAssetFilePM(appObject: AppObject): AssetFilePM {\n return new AssetFilePMImp(appObject);\n}\n\n/\n Implementation of the AssetFilePM abstract class\n * Handles the connection between AssetEntity file properties and view\n /\nclass AssetFilePMImp extends AssetFilePM {\n private get asset() {\n return this.getCachedLocalComponent<AssetEntity>(AssetEntity.type);\n }\n\n /\n Compares two AssetFileVM instances for equality\n * Used to determine if the view needs to update\n \n @param a - First AssetFileVM to compare\n * @param b - Second AssetFileVM to compare\n * @returns True if view models are equal, false otherwise\n /\n vmsAreEqual(a: AssetFileVM, b: AssetFileVM): boolean {\n if (a.blobURL !== b.blobURL) return false;\n if (a.isFetchingFile !== b.isFetchingFile) return false;\n if (a.fileHasBeenFetched !== b.fileHasBeenFetched) return false;\n\n // Handle errors comparison (both undefined, or same message)\n if (a.fetchError !== b.fetchError) {\n if (a.fetchError === undefined && b.fetchError !== undefined)\n return false;\n if (a.fetchError !== undefined && b.fetchError === undefined)\n return false;\n if (\n a.fetchError !== undefined &&\n b.fetchError !== undefined &&\n a.fetchError.message !== b.fetchError.message\n )\n return false;\n }\n\n return true;\n }\n\n /\n Observer callback that updates the view model when the entity changes\n * Transforms entity data into view model format\n /\n private onAssetChange = () => {\n if (!this.asset) return;\n\n const vm: AssetFileVM = {\n blobURL: this.asset.blobURL,\n isFetchingFile: this.asset.isFetchingFile,\n fileHasBeenFetched: this.asset.fileHasBeenFetched,\n fetchError: this.asset.fetchError\n };\n\n this.doUpdateView(vm);\n };\n\n /\n Cleans up resources and removes observers when the PM is disposed\n /\n dispose(): void {\n if (this.asset) {\n this.asset.removeChangeObserver(this.onAssetChange);\n }\n super.dispose();\n }\n\n /\n Creates a new AssetFilePMImp instance\n \n @param appObject - The app object to associate with this PM\n */\n constructor(appObject: AppObject) {\n super(appObject, AssetFilePM.type);\n\n this.asset?.addChangeObserver(this.onAssetChange);\n this.onAssetChange();\n }\n}\n"]}

package/dist/esm/Assets/PMs/AssetPM.js CHANGED Viewed

@@ -1,6 +1,39 @@
+/**
+ * AssetPM.ts
+ *
+ * This presentation manager handles the view model generation and change tracking
+ * for individual asset entities, providing a clean interface between asset data
+ * and UI components.
+ *
+ * Key Concepts:
+ * - Transforms asset entity data into view models for UI consumption
+ * - Tracks entity changes and triggers UI updates when needed
+ * - Provides efficient comparison methods for view model equality
+ * - Manages asset entity lifecycle and observer patterns
+ * - Follows the PM pattern for separation of concerns between domain and presentation
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static getByID() method with asset ID
+ * - Automatically updates UI components when underlying asset data changes
+ * - Used by adapters to connect asset data to React components and other UI frameworks
+ */
 import { AppObjectPM } from "@vived/core";
 import { AssetEntity } from "../Entities/AssetEntity";
+/**
+ * AssetPM manages presentation logic for individual asset entities.
+ *
+ * This presentation manager bridges the gap between asset domain entities
+ * and UI components by providing optimized view models and change tracking.
+ */
 export class AssetPM extends AppObjectPM {
+    /**
+     * Retrieves an AssetPM component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns AssetPM instance or undefined if not found
+     */
     static getByID(assetID, appObjects) {
         const appObject = appObjects.get(assetID);
         if (!appObject) {
@@ -15,11 +48,34 @@ export class AssetPM extends AppObjectPM {
         return pm;
     }
 }
+/** Static type identifier for component registration */
 AssetPM.type = "AssetPM";
+/**
+ * Factory function to create a new AssetPM instance.
+ *
+ * @param appObject - The AppObject that will host this PM (should contain an AssetEntity)
+ * @returns A new AssetPM implementation instance
+ */
 export function makeAssetPM(appObject) {
     return new AssetPMImp(appObject);
 }
+/**
+ * Private implementation of AssetPM with entity integration and change tracking.
+ *
+ * Key Implementation Details:
+ * - Observes AssetEntity changes and generates view models accordingly
+ * - Implements efficient view model comparison for performance optimization
+ * - Handles entity lifecycle management and cleanup
+ * - Provides error handling for missing entity dependencies
+ */
 class AssetPMImp extends AssetPM {
+    /**
+     * Compares two asset view models for equality to optimize UI updates.
+     *
+     * @param a - First asset view model to compare
+     * @param b - Second asset view model to compare
+     * @returns true if view models are equal, false otherwise
+     */
     vmsAreEqual(a, b) {
         if (a.archived !== b.archived)
             return false;

package/dist/esm/Assets/PMs/AssetPM.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;~~AAStD~~,MAAM,OAAgB,OAAQ,SAAQ,WAAoB;~~IAGxD~~,MAAM,CAAC,OAAO,CACZ,OAAe,EACf,UAAyB;QAEzB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,iBAAiB,EACjB,kCAAkC,GAAG,OAAO,CAC7C,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,YAAY,CAAU,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,aAAa,CACtB,iBAAiB,EACjB,oCAAoC,CACrC,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;;~~AAxBM~~,YAAI,GAAG,SAAS,CAAC;~~AA2B1B~~,MAAM,UAAU,WAAW,CAAC,SAAoB;IAC9C,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAW,SAAQ,OAAO;~~IAG9B~~,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,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,EAAE,KAAK,CAAC,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAEhC,OAAO,IAAI,CAAC;IACd,CAAC;IAeD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAdzB,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,OAAO;YAExB,MAAM,EAAE,GAAY;gBAClB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAC7B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;gBACnC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;gBACjB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;aACtB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAKA,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,EAAE;IACf,EAAE,EAAE,EAAE;IACN,IAAI,EAAE,EAAE;CACT,CAAC","sourcesContent":["~~import~~ { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\nexport interface AssetVM {\r\n id: string;\r\n name: string;\r\n description: string;\r\n archived: boolean;\r\n}\r\n\r\nexport abstract class AssetPM extends AppObjectPM<AssetVM> {\r\n static type = \"AssetPM\";\r\n\r\n static getByID(\r\n assetID: string,\r\n appObjects: AppObjectRepo\r\n ): AssetPM \| undefined {\r\n const appObject = appObjects.get(assetID);\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"AssetPM.getByID\",\r\n \"Unable to find app object by ID \" + assetID\r\n );\r\n return;\r\n }\r\n\r\n const pm = appObject.getComponent<AssetPM>(AssetPM.type);\r\n if (!pm) {\r\n appObjects.submitWarning(\r\n \"AssetPM.getByID\",\r\n \"App Object does not have a AssetPM\"\r\n );\r\n return;\r\n }\r\n return pm;\r\n }\r\n}\r\n\r\nexport function makeAssetPM(appObject: AppObject): AssetPM {\r\n return new AssetPMImp(appObject);\r\n}\r\n\r\nclass AssetPMImp extends AssetPM {\r\n private asset?: AssetEntity;\r\n\r\n vmsAreEqual(a: AssetVM, b: AssetVM): boolean {\r\n if (a.archived !== b.archived) return false;\r\n if (a.description !== b.description) return false;\r\n if (a.name !== b.name) return false;\r\n if (a.id !== b.id) return false;\r\n\r\n return true;\r\n }\r\n\r\n private onAssetChange = () => {\r\n if (!this.asset) return;\r\n\r\n const vm: AssetVM = {\r\n archived: this.asset.archived,\r\n description: this.asset.description,\r\n id: this.asset.id,\r\n name: this.asset.name\r\n };\r\n\r\n this.doUpdateView(vm);\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, AssetPM.type);\r\n\r\n this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n if (!this.asset) {\r\n this.warn(\"PM has been added to an App Object without an AssetEntity\");\r\n return;\r\n }\r\n\r\n this.asset.addChangeObserver(this.onAssetChange);\r\n this.onAssetChange();\r\n }\r\n}\r\n\r\nexport const defaultAssetVM: AssetVM = {\r\n archived: false,\r\n description: \"\",\r\n id: \"\",\r\n name: \"\"\r\n};\r\n"]}
1	+ {"version":3,"file":"AssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetPM.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAiBtD;;;;;GAKG;AACH,MAAM,OAAgB,OAAQ,SAAQ,WAAoB;IAIxD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CACZ,OAAe,EACf,UAAyB;QAEzB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,iBAAiB,EACjB,kCAAkC,GAAG,OAAO,CAC7C,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,YAAY,CAAU,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,aAAa,CACtB,iBAAiB,EACjB,oCAAoC,CACrC,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;;AAhCD,wDAAwD;AACjD,YAAI,GAAG,SAAS,CAAC;AAkC1B;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,SAAoB;IAC9C,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAW,SAAQ,OAAO;IAI9B;;;;;;OAMG;IACH,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,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,EAAE,KAAK,CAAC,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAEhC,OAAO,IAAI,CAAC;IACd,CAAC;IAeD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAdzB,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,OAAO;YAExB,MAAM,EAAE,GAAY;gBAClB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAC7B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;gBACnC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;gBACjB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;aACtB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAKA,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,EAAE;IACf,EAAE,EAAE,EAAE;IACN,IAAI,EAAE,EAAE;CACT,CAAC","sourcesContent":["/*\r\n AssetPM.ts\r\n \r\n This presentation manager handles the view model generation and change tracking\r\n * for individual asset entities, providing a clean interface between asset data\r\n * and UI components.\r\n \r\n Key Concepts:\r\n * - Transforms asset entity data into view models for UI consumption\r\n * - Tracks entity changes and triggers UI updates when needed\r\n * - Provides efficient comparison methods for view model equality\r\n * - Manages asset entity lifecycle and observer patterns\r\n * - Follows the PM pattern for separation of concerns between domain and presentation\r\n \r\n Usage Patterns:\r\n * - Created per-asset during factory setup\r\n * - Accessed through static getByID() method with asset ID\r\n * - Automatically updates UI components when underlying asset data changes\r\n * - Used by adapters to connect asset data to React components and other UI frameworks\r\n /\r\n\r\nimport { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\n/\r\n View model interface representing asset data optimized for UI display.\r\n * Contains essential asset information formatted for presentation components.\r\n /\r\nexport interface AssetVM {\r\n /* Unique identifier of the asset /\r\n id: string;\r\n /* Display name of the asset /\r\n name: string;\r\n /* Description of the asset's purpose or content /\r\n description: string;\r\n /* Whether the asset is archived (hidden from normal views) /\r\n archived: boolean;\r\n}\r\n\r\n/\r\n AssetPM manages presentation logic for individual asset entities.\r\n \r\n This presentation manager bridges the gap between asset domain entities\r\n * and UI components by providing optimized view models and change tracking.\r\n /\r\nexport abstract class AssetPM extends AppObjectPM<AssetVM> {\r\n /* Static type identifier for component registration /\r\n static type = \"AssetPM\";\r\n\r\n /\r\n Retrieves an AssetPM component for a specific asset.\r\n \r\n @param assetID - The unique identifier of the asset\r\n * @param appObjects - Repository for accessing app objects and components\r\n * @returns AssetPM instance or undefined if not found\r\n /\r\n static getByID(\r\n assetID: string,\r\n appObjects: AppObjectRepo\r\n ): AssetPM \| undefined {\r\n const appObject = appObjects.get(assetID);\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"AssetPM.getByID\",\r\n \"Unable to find app object by ID \" + assetID\r\n );\r\n return;\r\n }\r\n\r\n const pm = appObject.getComponent<AssetPM>(AssetPM.type);\r\n if (!pm) {\r\n appObjects.submitWarning(\r\n \"AssetPM.getByID\",\r\n \"App Object does not have a AssetPM\"\r\n );\r\n return;\r\n }\r\n return pm;\r\n }\r\n}\r\n\r\n/\r\n Factory function to create a new AssetPM instance.\r\n \r\n @param appObject - The AppObject that will host this PM (should contain an AssetEntity)\r\n * @returns A new AssetPM implementation instance\r\n /\r\nexport function makeAssetPM(appObject: AppObject): AssetPM {\r\n return new AssetPMImp(appObject);\r\n}\r\n\r\n/\r\n Private implementation of AssetPM with entity integration and change tracking.\r\n \r\n Key Implementation Details:\r\n * - Observes AssetEntity changes and generates view models accordingly\r\n * - Implements efficient view model comparison for performance optimization\r\n * - Handles entity lifecycle management and cleanup\r\n * - Provides error handling for missing entity dependencies\r\n /\r\nclass AssetPMImp extends AssetPM {\r\n /* The asset entity this PM observes and presents /\r\n private asset?: AssetEntity;\r\n\r\n /\r\n Compares two asset view models for equality to optimize UI updates.\r\n \r\n @param a - First asset view model to compare\r\n * @param b - Second asset view model to compare\r\n * @returns true if view models are equal, false otherwise\r\n */\r\n vmsAreEqual(a: AssetVM, b: AssetVM): boolean {\r\n if (a.archived !== b.archived) return false;\r\n if (a.description !== b.description) return false;\r\n if (a.name !== b.name) return false;\r\n if (a.id !== b.id) return false;\r\n\r\n return true;\r\n }\r\n\r\n private onAssetChange = () => {\r\n if (!this.asset) return;\r\n\r\n const vm: AssetVM = {\r\n archived: this.asset.archived,\r\n description: this.asset.description,\r\n id: this.asset.id,\r\n name: this.asset.name\r\n };\r\n\r\n this.doUpdateView(vm);\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, AssetPM.type);\r\n\r\n this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n if (!this.asset) {\r\n this.warn(\"PM has been added to an App Object without an AssetEntity\");\r\n return;\r\n }\r\n\r\n this.asset.addChangeObserver(this.onAssetChange);\r\n this.onAssetChange();\r\n }\r\n}\r\n\r\nexport const defaultAssetVM: AssetVM = {\r\n archived: false,\r\n description: \"\",\r\n id: \"\",\r\n name: \"\"\r\n};\r\n"]}

package/dist/esm/Assets/PMs/EditingAppAssetPM.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"EditingAppAssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/EditingAppAssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAU9D,MAAM,OAAgB,iBAAkB,SAAQ,WAE/C;IAGC,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;;AAJM,sBAAI,GAAG,mBAAmB,CAAC;AAOpC,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAqB,SAAQ,iBAAiB;IAGlD,WAAW,CACT,CAAgC,EAChC,CAAgC;QAEhC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAEpD,IAAI,CAAC,EAAE,QAAQ,KAAK,CAAC,EAAE,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,CAAC,EAAE,WAAW,KAAK,CAAC,EAAE,WAAW;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,CAAC,EAAE,QAAQ,KAAK,CAAC,EAAE,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,IAAI;YAAE,OAAO,KAAK,CAAC;QAEtC,OAAO,IAAI,CAAC;IACd,CAAC;~~IA0BD~~,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;~~QAzBnC~~,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5B,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,MAAM,~~EACJ~~,EAAE,~~EACF~~,IAAI,~~EACJ~~,WAAW,~~EACX~~,QAAQ,~~EACR~~,QAAQ,~~EACT~~,~~GAAG~~,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;~~gBAChC~~,MAAM,EAAE,GAAsB;oBAC5B,EAAE;oBACF,IAAI;oBACJ,WAAW;oBACX,QAAQ;oBACR,QAAQ;iBACT,CAAC;gBACF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CACP,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import {\r\n getSingletonComponent,\r\n AppObject,\r\n AppObjectPM,\r\n AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\n\r\nexport interface EditingAppAssetVM {\r\n id: string;\r\n name: string;\r\n description: string;\r\n archived: boolean;\r\n filename: string;\r\n}\r\n\r\nexport abstract class EditingAppAssetPM extends AppObjectPM<\r\n EditingAppAssetVM \| undefined\r\n> {\r\n static type = \"EditingAppAssetPM\";\r\n\r\n static get(appObjects: AppObjectRepo): EditingAppAssetPM \| undefined {\r\n return getSingletonComponent(EditingAppAssetPM.type, appObjects);\r\n }\r\n}\r\n\r\nexport function makeEditingAppAssetPM(appObject: AppObject): EditingAppAssetPM {\r\n return new EditingAppAssetPMImp(appObject);\r\n}\r\n\r\nclass EditingAppAssetPMImp extends EditingAppAssetPM {\r\n private appAssets?: AppAssetsEntity;\r\n\r\n vmsAreEqual(\r\n a: EditingAppAssetVM \| undefined,\r\n b: EditingAppAssetVM \| undefined\r\n ): boolean {\r\n if (a === undefined && b === undefined) return true;\r\n\r\n if (a?.archived !== b?.archived) return false;\r\n if (a?.description !== b?.description) return false;\r\n if (a?.filename !== b?.filename) return false;\r\n if (a?.id !== b?.id) return false;\r\n if (a?.name !== b?.name) return false;\r\n\r\n return true;\r\n }\r\n\r\n private onAssetChange = () => {\r\n if (!this.appAssets) return;\r\n\r\n if (this.appAssets.editingAsset) {\r\n const {~~\r\n~~ id~~,\r\n~~ name~~,\r\n~~ description~~,\r\n~~ archived~~,\r\n~~ filename~~\r\n~~ } = this.appAssets.editingAsset;\r\n const vm: EditingAppAssetVM = {\r\n id,\r\n name,\r\n description,\r\n archived,\r\n filename\r\n };\r\n this.doUpdateView(vm);\r\n } else {\r\n this.doUpdateView(undefined);\r\n }\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, EditingAppAssetPM.type);\r\n\r\n this.appAssets = appObject.getComponent<AppAssetsEntity>(\r\n AppAssetsEntity.type\r\n );\r\n if (!this.appAssets) {\r\n this.warn(\r\n \"PM has been added to an App Object without an AppAssetsEntity\"\r\n );\r\n return;\r\n }\r\n\r\n this.appObjects.registerSingleton(this);\r\n\r\n this.appAssets.addChangeObserver(this.onAssetChange);\r\n this.onAssetChange();\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"EditingAppAssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/EditingAppAssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAU9D,MAAM,OAAgB,iBAAkB,SAAQ,WAE/C;IAGC,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;;AAJM,sBAAI,GAAG,mBAAmB,CAAC;AAOpC,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAqB,SAAQ,iBAAiB;IAGlD,WAAW,CACT,CAAgC,EAChC,CAAgC;QAEhC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAEpD,IAAI,CAAC,EAAE,QAAQ,KAAK,CAAC,EAAE,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,CAAC,EAAE,WAAW,KAAK,CAAC,EAAE,WAAW;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,CAAC,EAAE,QAAQ,KAAK,CAAC,EAAE,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,IAAI;YAAE,OAAO,KAAK,CAAC;QAEtC,OAAO,IAAI,CAAC;IACd,CAAC;IAqBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QApBnC,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5B,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,GACjD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBAC9B,MAAM,EAAE,GAAsB;oBAC5B,EAAE;oBACF,IAAI;oBACJ,WAAW;oBACX,QAAQ;oBACR,QAAQ;iBACT,CAAC;gBACF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CACP,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import {\n getSingletonComponent,\n AppObject,\n AppObjectPM,\n AppObjectRepo\n} from \"@vived/core\";\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\n\nexport interface EditingAppAssetVM {\n id: string;\n name: string;\n description: string;\n archived: boolean;\n filename: string;\n}\n\nexport abstract class EditingAppAssetPM extends AppObjectPM<\n EditingAppAssetVM \| undefined\n> {\n static type = \"EditingAppAssetPM\";\n\n static get(appObjects: AppObjectRepo): EditingAppAssetPM \| undefined {\n return getSingletonComponent(EditingAppAssetPM.type, appObjects);\n }\n}\n\nexport function makeEditingAppAssetPM(appObject: AppObject): EditingAppAssetPM {\n return new EditingAppAssetPMImp(appObject);\n}\n\nclass EditingAppAssetPMImp extends EditingAppAssetPM {\n private appAssets?: AppAssetsEntity;\n\n vmsAreEqual(\n a: EditingAppAssetVM \| undefined,\n b: EditingAppAssetVM \| undefined\n ): boolean {\n if (a === undefined && b === undefined) return true;\n\n if (a?.archived !== b?.archived) return false;\n if (a?.description !== b?.description) return false;\n if (a?.filename !== b?.filename) return false;\n if (a?.id !== b?.id) return false;\n if (a?.name !== b?.name) return false;\n\n return true;\n }\n\n private onAssetChange = () => {\n if (!this.appAssets) return;\n\n if (this.appAssets.editingAsset) {\n const { id, name, description, archived, filename } =\n this.appAssets.editingAsset;\n const vm: EditingAppAssetVM = {\n id,\n name,\n description,\n archived,\n filename\n };\n this.doUpdateView(vm);\n } else {\n this.doUpdateView(undefined);\n }\n };\n\n constructor(appObject: AppObject) {\n super(appObject, EditingAppAssetPM.type);\n\n this.appAssets = appObject.getComponent<AppAssetsEntity>(\n AppAssetsEntity.type\n );\n if (!this.appAssets) {\n this.warn(\n \"PM has been added to an App Object without an AppAssetsEntity\"\n );\n return;\n }\n\n this.appObjects.registerSingleton(this);\n\n this.appAssets.addChangeObserver(this.onAssetChange);\n this.onAssetChange();\n }\n}\n"]}

package/dist/esm/Assets/PMs/ShowArchivedAppAssetPM.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ShowArchivedAppAssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/ShowArchivedAppAssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,OAAgB,sBAAuB,SAAQ,WAAoB;IAGvE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAJM,2BAAI,GAAG,wBAAwB,CAAC;AAOzC,MAAM,UAAU,0BAA0B,CACxC,SAAoB;IAEpB,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,yBAA0B,SAAQ,sBAAsB;IAG5D,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAOD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QANxC,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC5B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CACP,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import {\r\n getSingletonComponent,\r\n AppObject,\r\n AppObjectPM,\r\n AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\n\r\nexport abstract class ShowArchivedAppAssetPM extends AppObjectPM<boolean> {\r\n static type = \"ShowArchivedAppAssetPM\";\r\n\r\n static get(appObjects: AppObjectRepo): ShowArchivedAppAssetPM \| undefined {\r\n return getSingletonComponent(ShowArchivedAppAssetPM.type, appObjects);\r\n }\r\n}\r\n\r\nexport function makeShowArchivedAppAssetPM(\r\n appObject: AppObject\r\n): ShowArchivedAppAssetPM {\r\n return new ShowArchivedAppAssetPMImp(appObject);\r\n}\r\n\r\nclass ShowArchivedAppAssetPMImp extends ShowArchivedAppAssetPM {\r\n private appAssets?: AppAssetsEntity;\r\n\r\n vmsAreEqual(a: boolean, b: boolean): boolean {\r\n return a === b;\r\n }\r\n\r\n private onAssetChange = () => {\r\n if (!this.appAssets) return;\r\n this.doUpdateView(this.appAssets.showArchived);\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, ShowArchivedAppAssetPM.type);\r\n\r\n this.appAssets = appObject.getComponent<AppAssetsEntity>(\r\n AppAssetsEntity.type\r\n );\r\n if (!this.appAssets) {\r\n this.warn(\r\n \"PM has been added to an App Object without an AppAssetsEntity\"\r\n );\r\n return;\r\n }\r\n\r\n this.appObjects.registerSingleton(this);\r\n\r\n this.appAssets.addChangeObserver(this.onAssetChange);\r\n this.onAssetChange();\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"ShowArchivedAppAssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/ShowArchivedAppAssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,OAAgB,sBAAuB,SAAQ,WAAoB;IAGvE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAJM,2BAAI,GAAG,wBAAwB,CAAC;AAOzC,MAAM,UAAU,0BAA0B,CACxC,SAAoB;IAEpB,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,yBAA0B,SAAQ,sBAAsB;IAG5D,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAOD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QANxC,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC5B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CACP,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import {\n getSingletonComponent,\n AppObject,\n AppObjectPM,\n AppObjectRepo\n} from \"@vived/core\";\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\n\nexport abstract class ShowArchivedAppAssetPM extends AppObjectPM<boolean> {\n static type = \"ShowArchivedAppAssetPM\";\n\n static get(appObjects: AppObjectRepo): ShowArchivedAppAssetPM \| undefined {\n return getSingletonComponent(ShowArchivedAppAssetPM.type, appObjects);\n }\n}\n\nexport function makeShowArchivedAppAssetPM(\n appObject: AppObject\n): ShowArchivedAppAssetPM {\n return new ShowArchivedAppAssetPMImp(appObject);\n}\n\nclass ShowArchivedAppAssetPMImp extends ShowArchivedAppAssetPM {\n private appAssets?: AppAssetsEntity;\n\n vmsAreEqual(a: boolean, b: boolean): boolean {\n return a === b;\n }\n\n private onAssetChange = () => {\n if (!this.appAssets) return;\n this.doUpdateView(this.appAssets.showArchived);\n };\n\n constructor(appObject: AppObject) {\n super(appObject, ShowArchivedAppAssetPM.type);\n\n this.appAssets = appObject.getComponent<AppAssetsEntity>(\n AppAssetsEntity.type\n );\n if (!this.appAssets) {\n this.warn(\n \"PM has been added to an App Object without an AppAssetsEntity\"\n );\n return;\n }\n\n this.appObjects.registerSingleton(this);\n\n this.appAssets.addChangeObserver(this.onAssetChange);\n this.onAssetChange();\n }\n}\n"]}

package/dist/esm/Assets/PMs/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC","sourcesContent":["export * from \"./AppAssetListPM\";\r\nexport * from \"./AssetPM\";\r\nexport * from \"./AssetFilePM\";\r\nexport * from \"./EditingAppAssetPM\";\r\nexport * from \"./ShowArchivedAppAssetPM\";\r\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC","sourcesContent":["export * from \"./AppAssetListPM\";\nexport * from \"./AssetPM\";\nexport * from \"./AssetFilePM\";\nexport * from \"./EditingAppAssetPM\";\nexport * from \"./ShowArchivedAppAssetPM\";\n"]}

package/dist/esm/Assets/UCs/ArchiveAssetUC.js CHANGED Viewed

@@ -1,9 +1,43 @@
+/**
+ * ArchiveAssetUC.ts
+ *
+ * This use case handles the archiving and unarchiving of assets, providing
+ * a reversible soft-deletion mechanism that hides assets from normal views
+ * while preserving them in the system.
+ *
+ * Key Concepts:
+ * - Archive operations are reversible soft-deletion mechanisms
+ * - Archived assets remain in the system but are hidden from normal views
+ * - Uses API calls to persist archive state changes
+ * - Provides user feedback through spinner and error dialogs
+ * - Updates both local entity state and collection notifications
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Handles both archiving (hiding) and unarchiving (showing) operations
+ * - Manages async API calls with proper error handling and user feedback
+ */
 import { AppObjectUC } from "@vived/core";
 import { MakeAlertDialogUC, MakeSpinnerDialogUC } from "../../Dialog";
 import { PatchAssetIsArchivedUC } from "../../VivedAPI";
 import { AppAssetsEntity } from "../Entities/AppAssetsEntity";
 import { AssetEntity } from "../Entities/AssetEntity";
+/**
+ * ArchiveAssetUC manages the archiving and unarchiving operations for individual assets.
+ *
+ * This use case provides the business logic for toggling asset archive status,
+ * handling API persistence, and managing user feedback during the operation.
+ * Archive operations are reversible and provide a soft-deletion mechanism.
+ */
 export class ArchiveAssetUC extends AppObjectUC {
+    /**
+     * Retrieves an ArchiveAssetUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns ArchiveAssetUC instance or undefined if not found
+     */
     static get(assetID, appObjects) {
         const appObject = appObjects.get(assetID);
         if (!appObject) {
@@ -18,24 +52,68 @@ export class ArchiveAssetUC extends AppObjectUC {
         return uc;
     }
 }
+/** Static type identifier for component registration */
 ArchiveAssetUC.type = "ArchiveAssetUC";
+/**
+ * Factory function to create a new ArchiveAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new ArchiveAssetUC implementation instance
+ */
 export function makeArchiveAssetUC(appObject) {
     return new ArchiveAssetUCImp(appObject);
 }
+/**
+ * Private implementation of ArchiveAssetUC that handles the concrete archive operations.
+ *
+ * Key Implementation Details:
+ * - Validates asset entity existence and current archive state
+ * - Uses PatchAssetIsArchivedUC for API persistence
+ * - Provides user feedback through spinner dialogs during operations
+ * - Handles errors gracefully with alert dialogs and logging
+ * - Updates local asset state and triggers collection change notifications
+ * - Prevents redundant operations when archive state hasn't changed
+ */
 class ArchiveAssetUCImp extends ArchiveAssetUC {
+    /**
+     * Gets the API use case for patching asset archive status
+     * Cached for efficient repeated access during operations
+     */
     get patchAssetIsArchived() {
         return this.getCachedSingleton(PatchAssetIsArchivedUC.type)?.doPatch;
     }
+    /**
+     * Gets the app assets collection entity for triggering collection updates
+     * Used to notify UI components when asset visibility changes
+     */
     get appAssets() {
         return this.getCachedSingleton(AppAssetsEntity.type);
     }
+    /**
+     * Initializes the ArchiveAssetUC with validation of required components.
+     *
+     * @param appObject - The AppObject that should contain the AssetEntity this UC will operate on
+     */
     constructor(appObject) {
         super(appObject, ArchiveAssetUC.type);
+        /**
+         * Sets the archived status of the asset with full error handling and user feedback.
+         *
+         * This method handles the complete archive workflow:
+         * 1. Validates the asset exists and state change is needed
+         * 2. Shows a spinner dialog during the API operation
+         * 3. Updates the asset entity and collection on success
+         * 4. Shows error dialogs and logs failures appropriately
+         *
+         * @param archived - True to archive the asset, false to unarchive it
+         * @returns Promise that resolves when the operation completes (successfully or with handled error)
+         */
         this.setArchived = (archived) => {
             const asset = this.asset;
             if (!asset) {
                 return Promise.reject(new Error("No Asset Entity"));
             }
+            // Prevent redundant operations
             if (asset.archived === archived) {
                 return Promise.resolve();
             }
@@ -43,6 +121,7 @@ class ArchiveAssetUCImp extends ArchiveAssetUC {
             if (!patchAssetIsArchived) {
                 return Promise.reject();
             }
+            // Show user feedback during operation
             const title = archived ? "Archiving Asset" : "Unarchive Asset";
             const spinner = MakeSpinnerDialogUC.make({
                 title,
@@ -51,7 +130,9 @@ class ArchiveAssetUCImp extends ArchiveAssetUC {
             return new Promise((resolve, reject) => {
                 patchAssetIsArchived(asset.id, archived)
                     .then(() => {
+                    // Update local state
                     asset.archived = archived;
+                    // Notify collections if this asset is part of them
                     if (this.appAssets && this.appAssets.has(asset.id)) {
                         this.appAssets.notifyOnChange();
                     }
@@ -59,6 +140,7 @@ class ArchiveAssetUCImp extends ArchiveAssetUC {
                     resolve();
                 })
                     .catch((e) => {
+                    // Handle errors with user feedback
                     this.error("Archive asset error: " + e.message);
                     spinner?.close();
                     const dialogDTO = {
@@ -67,7 +149,7 @@ class ArchiveAssetUCImp extends ArchiveAssetUC {
                         title: "Archive Asset Error"
                     };
                     MakeAlertDialogUC.make(dialogDTO, this.appObjects);
-                    resolve();
+                    resolve(); // Resolve to prevent unhandled rejections, error is already handled
                 });
             });
         };

package/dist/esm/Assets/UCs/ArchiveAssetUC.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ArchiveAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/ArchiveAssetUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport {\r\n DialogAlertDTO,\r\n MakeAlertDialogUC,\r\n MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { PatchAssetIsArchivedUC } from \"../../VivedAPI\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\nexport abstract class ArchiveAssetUC extends AppObjectUC {\r\n static type = \"ArchiveAssetUC\";\r\n\r\n abstract setArchived(archived: boolean): Promise<void>;\r\n\r\n static get(\r\n assetID: string,\r\n appObjects: AppObjectRepo\r\n ): ArchiveAssetUC \| undefined {\r\n const appObject = appObjects.get(assetID);\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"ArchiveAssetUC.get\",\r\n \"Unable to find app object\"\r\n );\r\n return undefined;\r\n }\r\n\r\n const uc = appObject.getComponent<ArchiveAssetUC>(ArchiveAssetUC.type);\r\n if (!uc) {\r\n appObjects.submitWarning(\r\n \"ArchiveAssetUC.get\",\r\n \"App Object does not have ArchiveAssetUC\"\r\n );\r\n return undefined;\r\n }\r\n\r\n return uc;\r\n }\r\n}\r\n\r\nexport function makeArchiveAssetUC(appObject: AppObject): ArchiveAssetUC {\r\n return new ArchiveAssetUCImp(appObject);\r\n}\r\n\r\nclass ArchiveAssetUCImp extends ArchiveAssetUC {\r\n private asset?: AssetEntity;\r\n\r\n private get patchAssetIsArchived() {\r\n return this.getCachedSingleton<PatchAssetIsArchivedUC>(\r\n PatchAssetIsArchivedUC.type\r\n )?.doPatch;\r\n }\r\n\r\n private get appAssets() {\r\n return this.getCachedSingleton<AppAssetsEntity>(AppAssetsEntity.type);\r\n }\r\n\r\n setArchived = (archived: boolean): Promise<void> => {\r\n const asset = this.asset;\r\n\r\n if (!asset) {\r\n return Promise.reject(new Error(\"No Asset Entity\"));\r\n }\r\n\r\n if (asset.archived === archived) {\r\n return Promise.resolve();\r\n }\r\n\r\n const patchAssetIsArchived = this.patchAssetIsArchived;\r\n if (!patchAssetIsArchived) {\r\n return Promise.reject();\r\n }\r\n\r\n const title = archived ? \"Archiving Asset\" : \"Unarchive Asset\";\r\n const spinner = MakeSpinnerDialogUC.make(\r\n {\r\n title,\r\n message: \"Updating asset's archived flag...\"\r\n },\r\n this.appObjects\r\n );\r\n\r\n return new Promise((resolve, reject) => {\r\n patchAssetIsArchived(asset.id, archived)\r\n .then(() => {\r\n asset.archived = archived;\r\n\r\n if (this.appAssets && this.appAssets.has(asset.id)) {\r\n this.appAssets.notifyOnChange();\r\n }\r\n spinner?.close();\r\n resolve();\r\n })\r\n .catch((e) => {\r\n this.error(\"Archive asset error: \" + e.message);\r\n spinner?.close();\r\n const dialogDTO: DialogAlertDTO = {\r\n buttonLabel: \"OK\",\r\n message: `Something went wrong when setting the asset's archived flag. Check the console. ${e.message}`,\r\n title: \"Archive Asset Error\"\r\n };\r\n\r\n MakeAlertDialogUC.make(dialogDTO, this.appObjects);\r\n resolve();\r\n });\r\n });\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, ArchiveAssetUC.type);\r\n\r\n this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n if (!this.asset) {\r\n this.error(\r\n \"UC has been added to an App Object that does not have ArchiveAssetUC\"\r\n );\r\n }\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"ArchiveAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/ArchiveAssetUC.ts"],"names":[],"mappings":"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","sourcesContent":["/*\r\n ArchiveAssetUC.ts\r\n \r\n This use case handles the archiving and unarchiving of assets, providing\r\n * a reversible soft-deletion mechanism that hides assets from normal views\r\n * while preserving them in the system.\r\n \r\n Key Concepts:\r\n * - Archive operations are reversible soft-deletion mechanisms\r\n * - Archived assets remain in the system but are hidden from normal views\r\n * - Uses API calls to persist archive state changes\r\n * - Provides user feedback through spinner and error dialogs\r\n * - Updates both local entity state and collection notifications\r\n \r\n Usage Patterns:\r\n * - Created per-asset during factory setup\r\n * - Accessed through static get() method with asset ID\r\n * - Handles both archiving (hiding) and unarchiving (showing) operations\r\n * - Manages async API calls with proper error handling and user feedback\r\n /\r\n\r\nimport { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport {\r\n DialogAlertDTO,\r\n MakeAlertDialogUC,\r\n MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { PatchAssetIsArchivedUC } from \"../../VivedAPI\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\n/\r\n ArchiveAssetUC manages the archiving and unarchiving operations for individual assets.\r\n \r\n This use case provides the business logic for toggling asset archive status,\r\n * handling API persistence, and managing user feedback during the operation.\r\n * Archive operations are reversible and provide a soft-deletion mechanism.\r\n /\r\nexport abstract class ArchiveAssetUC extends AppObjectUC {\r\n /* Static type identifier for component registration /\r\n static type = \"ArchiveAssetUC\";\r\n\r\n /\r\n Sets the archived status of the associated asset.\r\n \r\n @param archived - True to archive (hide) the asset, false to unarchive (show) it\r\n * @returns Promise that resolves when the operation completes successfully\r\n /\r\n abstract setArchived(archived: boolean): Promise<void>;\r\n\r\n /\r\n Retrieves an ArchiveAssetUC component for a specific asset.\r\n \r\n @param assetID - The unique identifier of the asset\r\n * @param appObjects - Repository for accessing app objects and components\r\n * @returns ArchiveAssetUC instance or undefined if not found\r\n /\r\n static get(\r\n assetID: string,\r\n appObjects: AppObjectRepo\r\n ): ArchiveAssetUC \| undefined {\r\n const appObject = appObjects.get(assetID);\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"ArchiveAssetUC.get\",\r\n \"Unable to find app object\"\r\n );\r\n return undefined;\r\n }\r\n\r\n const uc = appObject.getComponent<ArchiveAssetUC>(ArchiveAssetUC.type);\r\n if (!uc) {\r\n appObjects.submitWarning(\r\n \"ArchiveAssetUC.get\",\r\n \"App Object does not have ArchiveAssetUC\"\r\n );\r\n return undefined;\r\n }\r\n\r\n return uc;\r\n }\r\n}\r\n\r\n/\r\n Factory function to create a new ArchiveAssetUC instance.\r\n \r\n @param appObject - The AppObject that will host this use case (should contain an AssetEntity)\r\n * @returns A new ArchiveAssetUC implementation instance\r\n /\r\nexport function makeArchiveAssetUC(appObject: AppObject): ArchiveAssetUC {\r\n return new ArchiveAssetUCImp(appObject);\r\n}\r\n\r\n/\r\n Private implementation of ArchiveAssetUC that handles the concrete archive operations.\r\n \r\n Key Implementation Details:\r\n * - Validates asset entity existence and current archive state\r\n * - Uses PatchAssetIsArchivedUC for API persistence\r\n * - Provides user feedback through spinner dialogs during operations\r\n * - Handles errors gracefully with alert dialogs and logging\r\n * - Updates local asset state and triggers collection change notifications\r\n * - Prevents redundant operations when archive state hasn't changed\r\n /\r\nclass ArchiveAssetUCImp extends ArchiveAssetUC {\r\n /* The asset entity this use case operates on /\r\n private asset?: AssetEntity;\r\n\r\n /\r\n Gets the API use case for patching asset archive status\r\n * Cached for efficient repeated access during operations\r\n /\r\n private get patchAssetIsArchived() {\r\n return this.getCachedSingleton<PatchAssetIsArchivedUC>(\r\n PatchAssetIsArchivedUC.type\r\n )?.doPatch;\r\n }\r\n\r\n /\r\n Gets the app assets collection entity for triggering collection updates\r\n * Used to notify UI components when asset visibility changes\r\n /\r\n private get appAssets() {\r\n return this.getCachedSingleton<AppAssetsEntity>(AppAssetsEntity.type);\r\n }\r\n\r\n /\r\n Sets the archived status of the asset with full error handling and user feedback.\r\n \r\n This method handles the complete archive workflow:\r\n * 1. Validates the asset exists and state change is needed\r\n * 2. Shows a spinner dialog during the API operation\r\n * 3. Updates the asset entity and collection on success\r\n * 4. Shows error dialogs and logs failures appropriately\r\n \r\n @param archived - True to archive the asset, false to unarchive it\r\n * @returns Promise that resolves when the operation completes (successfully or with handled error)\r\n /\r\n setArchived = (archived: boolean): Promise<void> => {\r\n const asset = this.asset;\r\n\r\n if (!asset) {\r\n return Promise.reject(new Error(\"No Asset Entity\"));\r\n }\r\n\r\n // Prevent redundant operations\r\n if (asset.archived === archived) {\r\n return Promise.resolve();\r\n }\r\n\r\n const patchAssetIsArchived = this.patchAssetIsArchived;\r\n if (!patchAssetIsArchived) {\r\n return Promise.reject();\r\n }\r\n\r\n // Show user feedback during operation\r\n const title = archived ? \"Archiving Asset\" : \"Unarchive Asset\";\r\n const spinner = MakeSpinnerDialogUC.make(\r\n {\r\n title,\r\n message: \"Updating asset's archived flag...\"\r\n },\r\n this.appObjects\r\n );\r\n\r\n return new Promise((resolve, reject) => {\r\n patchAssetIsArchived(asset.id, archived)\r\n .then(() => {\r\n // Update local state\r\n asset.archived = archived;\r\n\r\n // Notify collections if this asset is part of them\r\n if (this.appAssets && this.appAssets.has(asset.id)) {\r\n this.appAssets.notifyOnChange();\r\n }\r\n spinner?.close();\r\n resolve();\r\n })\r\n .catch((e) => {\r\n // Handle errors with user feedback\r\n this.error(\"Archive asset error: \" + e.message);\r\n spinner?.close();\r\n const dialogDTO: DialogAlertDTO = {\r\n buttonLabel: \"OK\",\r\n message: `Something went wrong when setting the asset's archived flag. Check the console. ${e.message}`,\r\n title: \"Archive Asset Error\"\r\n };\r\n\r\n MakeAlertDialogUC.make(dialogDTO, this.appObjects);\r\n resolve(); // Resolve to prevent unhandled rejections, error is already handled\r\n });\r\n });\r\n };\r\n\r\n /\r\n Initializes the ArchiveAssetUC with validation of required components.\r\n \r\n @param appObject - The AppObject that should contain the AssetEntity this UC will operate on\r\n */\r\n constructor(appObject: AppObject) {\r\n super(appObject, ArchiveAssetUC.type);\r\n\r\n this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n if (!this.asset) {\r\n this.error(\r\n \"UC has been added to an App Object that does not have ArchiveAssetUC\"\r\n );\r\n }\r\n }\r\n}\r\n"]}

package/dist/esm/Assets/UCs/DeleteAssetUC.js CHANGED Viewed

@@ -1,10 +1,42 @@
+/**
+ * DeleteAssetUC.ts
+ *
+ * This use case handles the permanent deletion of assets from the system,
+ * including user confirmation dialogs and cleanup of all related data.
+ *
+ * Key Concepts:
+ * - Permanent deletion removes assets completely from the system
+ * - Includes mandatory user confirmation to prevent accidental deletions
+ * - Cleans up asset from all collections and repositories
+ * - Uses API calls to persist deletion on the backend
+ * - Provides user feedback through dialogs during the operation
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Provides both confirmed and unconfirmed deletion methods
+ * - Handles async operations with proper error handling and user feedback
+ */
 import { AppObjectUC } from "@vived/core";
 import { MakeAlertDialogUC, MakeConfirmDialogUC, MakeSpinnerDialogUC } from "../../Dialog";
 import { DeleteAssetOnAPIUC } from "../../VivedAPI";
 import { AppAssetsEntity } from "../Entities/AppAssetsEntity";
 import { AssetEntity } from "../Entities/AssetEntity";
 import { AssetRepo } from "../Entities/AssetRepo";
+/**
+ * DeleteAssetUC manages the permanent deletion of individual assets.
+ *
+ * This use case provides both confirmed and unconfirmed deletion methods,
+ * handling complete cleanup of asset data from all system components.
+ */
 export class DeleteAssetUC extends AppObjectUC {
+    /**
+     * Retrieves a DeleteAssetUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns DeleteAssetUC instance or undefined if not found
+     */
     static get(assetID, appObjects) {
         const appObject = appObjects.get(assetID);
         if (!appObject) {
@@ -19,23 +51,65 @@ export class DeleteAssetUC extends AppObjectUC {
         return uc;
     }
 }
+/** Static type identifier for component registration */
 DeleteAssetUC.type = "DeleteAssetUC";
+/**
+ * Factory function to create a new DeleteAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new DeleteAssetUC implementation instance
+ */
 export function makeDeleteAssetUC(appObject) {
     return new DeleteAssetUCImp(appObject);
 }
+/**
+ * Private implementation of DeleteAssetUC that handles the concrete deletion operations.
+ *
+ * Key Implementation Details:
+ * - Validates asset entity existence before operations
+ * - Uses DeleteAssetOnAPIUC for backend persistence
+ * - Provides user confirmation through dialog system
+ * - Shows spinner dialogs during deletion operations
+ * - Handles errors gracefully with alert dialogs and logging
+ * - Cleans up asset from all collections and repositories
+ * - Removes asset from both AppAssetsEntity and AssetRepo
+ */
 class DeleteAssetUCImp extends DeleteAssetUC {
+    /**
+     * Gets the API use case for deleting assets from the backend
+     * Cached for efficient repeated access during operations
+     */
     get doDelete() {
         return this.getCachedSingleton(DeleteAssetOnAPIUC.type)
             ?.doDelete;
     }
+    /**
+     * Gets the app assets collection entity for cleanup operations
+     * Used to remove the asset from collection displays
+     */
     get appAssets() {
         return this.getCachedSingleton(AppAssetsEntity.type);
     }
+    /**
+     * Gets the asset repository for cleanup operations
+     * Used to remove the asset from the global asset repository
+     */
     get assetRepo() {
         return this.getCachedSingleton(AssetRepo.type);
     }
+    /**
+     * Initializes the DeleteAssetUC with validation of required components.
+     *
+     * @param appObject - The AppObject that should contain the AssetEntity this UC will operate on
+     */
     constructor(appObject) {
         super(appObject, DeleteAssetUC.type);
+        /**
+         * Initiates asset deletion with user confirmation.
+         *
+         * Shows a confirmation dialog with warnings about the irreversible nature
+         * of the operation and suggests archiving as an alternative.
+         */
         this.deleteWithConfirm = () => {
             MakeConfirmDialogUC.make({
                 cancelButtonLabel: "Cancel",
@@ -45,6 +119,18 @@ class DeleteAssetUCImp extends DeleteAssetUC {
                 onConfirm: this.delete
             }, this.appObjects);
         };
+        /**
+         * Permanently deletes the asset with full cleanup and user feedback.
+         *
+         * This method handles the complete deletion workflow:
+         * 1. Validates the asset exists
+         * 2. Shows a spinner dialog during the API operation
+         * 3. Removes the asset from backend via API
+         * 4. Cleans up the asset from all local collections and repositories
+         * 5. Shows error dialogs and logs failures appropriately
+         *
+         * @returns Promise that resolves when the operation completes (successfully or with handled error)
+         */
         this.delete = () => {
             const asset = this.asset;
             if (!asset) {
@@ -54,6 +140,7 @@ class DeleteAssetUCImp extends DeleteAssetUC {
             if (!doDelete) {
                 return Promise.reject();
             }
+            // Show user feedback during operation
             const title = "Delete Asset";
             const spinnerDialog = MakeSpinnerDialogUC.make({
                 title,
@@ -62,6 +149,7 @@ class DeleteAssetUCImp extends DeleteAssetUC {
             return new Promise((resolve) => {
                 doDelete(asset.id)
                     .then(() => {
+                    // Clean up from all collections and repositories
                     if (this.appAssets && this.appAssets.has(asset.id)) {
                         this.appAssets.remove(asset.id);
                     }
@@ -72,6 +160,7 @@ class DeleteAssetUCImp extends DeleteAssetUC {
                     resolve();
                 })
                     .catch((e) => {
+                    // Handle errors with user feedback
                     this.error("Archive asset error: " + e.message);
                     spinnerDialog?.close();
                     const dialogDTO = {
@@ -80,7 +169,7 @@ class DeleteAssetUCImp extends DeleteAssetUC {
                         title: "Archive Asset Error"
                     };
                     MakeAlertDialogUC.make(dialogDTO, this.appObjects);
-                    resolve();
+                    resolve(); // Resolve to prevent unhandled rejections, error is already handled
                 });
             });
         };

package/dist/esm/Assets/UCs/DeleteAssetUC.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DeleteAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/DeleteAssetUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport {\r\n DialogAlertDTO,\r\n MakeAlertDialogUC,\r\n MakeConfirmDialogUC,\r\n MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { DeleteAssetOnAPIUC } from \"../../VivedAPI\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\n\r\nexport abstract class DeleteAssetUC extends AppObjectUC {\r\n static type = \"DeleteAssetUC\";\r\n\r\n abstract delete(): Promise<void>;\r\n abstract deleteWithConfirm(): void;\r\n\r\n static get(\r\n assetID: string,\r\n appObjects: AppObjectRepo\r\n ): DeleteAssetUC \| undefined {\r\n const appObject = appObjects.get(assetID);\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"DeleteAssetUC.get\",\r\n \"Unable to find app object\"\r\n );\r\n return undefined;\r\n }\r\n\r\n const uc = appObject.getComponent<DeleteAssetUC>(DeleteAssetUC.type);\r\n if (!uc) {\r\n appObjects.submitWarning(\r\n \"DeleteAssetUC.get\",\r\n \"App Object does not have DeleteAssetUC\"\r\n );\r\n return undefined;\r\n }\r\n\r\n return uc;\r\n }\r\n}\r\n\r\nexport function makeDeleteAssetUC(appObject: AppObject): DeleteAssetUC {\r\n return new DeleteAssetUCImp(appObject);\r\n}\r\n\r\nclass DeleteAssetUCImp extends DeleteAssetUC {\r\n private asset?: AssetEntity;\r\n\r\n private get doDelete() {\r\n return this.getCachedSingleton<DeleteAssetOnAPIUC>(DeleteAssetOnAPIUC.type)\r\n ?.doDelete;\r\n }\r\n\r\n private get appAssets() {\r\n return this.getCachedSingleton<AppAssetsEntity>(AppAssetsEntity.type);\r\n }\r\n\r\n private get assetRepo() {\r\n return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n }\r\n\r\n deleteWithConfirm = () => {\r\n MakeConfirmDialogUC.make(\r\n {\r\n cancelButtonLabel: \"Cancel\",\r\n confirmButtonLabel: \"Delete Asset\",\r\n message:\r\n \"Are you sure you want to delete this asset. This cannot be undone and could affect users. Consider archiving it instead\",\r\n title: \"Delete Asset\",\r\n onConfirm: this.delete\r\n },\r\n this.appObjects\r\n );\r\n };\r\n\r\n delete = (): Promise<void> => {\r\n const asset = this.asset;\r\n\r\n if (!asset) {\r\n return Promise.reject(new Error(\"No Asset Entity\"));\r\n }\r\n\r\n const doDelete = this.doDelete;\r\n if (!doDelete) {\r\n return Promise.reject();\r\n }\r\n\r\n const title = \"Delete Asset\";\r\n const spinnerDialog = MakeSpinnerDialogUC.make(\r\n {\r\n title,\r\n message: \"Deleting asset...\"\r\n },\r\n this.appObjects\r\n );\r\n\r\n return new Promise((resolve) => {\r\n doDelete(asset.id)\r\n .then(() => {\r\n if (this.appAssets && this.appAssets.has(asset.id)) {\r\n this.appAssets.remove(asset.id);\r\n }\r\n\r\n if (this.assetRepo && this.assetRepo.has(asset.id)) {\r\n this.assetRepo.remove(asset.id);\r\n }\r\n\r\n spinnerDialog?.close();\r\n resolve();\r\n })\r\n .catch((e) => {\r\n this.error(\"Archive asset error: \" + e.message);\r\n spinnerDialog?.close();\r\n const dialogDTO: DialogAlertDTO = {\r\n buttonLabel: \"OK\",\r\n message: `Something went wrong when setting the asset's archived flag. Check the console. ${e.message}`,\r\n title: \"Archive Asset Error\"\r\n };\r\n MakeAlertDialogUC.make(dialogDTO, this.appObjects);\r\n resolve();\r\n });\r\n });\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, DeleteAssetUC.type);\r\n\r\n this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n if (!this.asset) {\r\n this.error(\r\n \"UC has been added to an App Object that does not have ArchiveAssetUC\"\r\n );\r\n }\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"DeleteAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/DeleteAssetUC.ts"],"names":[],"mappings":"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","sourcesContent":["/*\r\n DeleteAssetUC.ts\r\n \r\n This use case handles the permanent deletion of assets from the system,\r\n * including user confirmation dialogs and cleanup of all related data.\r\n \r\n Key Concepts:\r\n * - Permanent deletion removes assets completely from the system\r\n * - Includes mandatory user confirmation to prevent accidental deletions\r\n * - Cleans up asset from all collections and repositories\r\n * - Uses API calls to persist deletion on the backend\r\n * - Provides user feedback through dialogs during the operation\r\n \r\n Usage Patterns:\r\n * - Created per-asset during factory setup\r\n * - Accessed through static get() method with asset ID\r\n * - Provides both confirmed and unconfirmed deletion methods\r\n * - Handles async operations with proper error handling and user feedback\r\n /\r\n\r\nimport { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport {\r\n DialogAlertDTO,\r\n MakeAlertDialogUC,\r\n MakeConfirmDialogUC,\r\n MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { DeleteAssetOnAPIUC } from \"../../VivedAPI\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\n\r\n/\r\n DeleteAssetUC manages the permanent deletion of individual assets.\r\n \r\n This use case provides both confirmed and unconfirmed deletion methods,\r\n * handling complete cleanup of asset data from all system components.\r\n /\r\nexport abstract class DeleteAssetUC extends AppObjectUC {\r\n /* Static type identifier for component registration /\r\n static type = \"DeleteAssetUC\";\r\n\r\n /\r\n Permanently deletes the associated asset without user confirmation.\r\n \r\n @returns Promise that resolves when the deletion completes successfully\r\n /\r\n abstract delete(): Promise<void>;\r\n\r\n /\r\n Initiates asset deletion with user confirmation dialog.\r\n * Shows a confirmation dialog before proceeding with the deletion.\r\n /\r\n abstract deleteWithConfirm(): void;\r\n\r\n /\r\n Retrieves a DeleteAssetUC component for a specific asset.\r\n \r\n @param assetID - The unique identifier of the asset\r\n * @param appObjects - Repository for accessing app objects and components\r\n * @returns DeleteAssetUC instance or undefined if not found\r\n /\r\n static get(\r\n assetID: string,\r\n appObjects: AppObjectRepo\r\n ): DeleteAssetUC \| undefined {\r\n const appObject = appObjects.get(assetID);\r\n if (!appObject) {\r\n appObjects.submitWarning(\r\n \"DeleteAssetUC.get\",\r\n \"Unable to find app object\"\r\n );\r\n return undefined;\r\n }\r\n\r\n const uc = appObject.getComponent<DeleteAssetUC>(DeleteAssetUC.type);\r\n if (!uc) {\r\n appObjects.submitWarning(\r\n \"DeleteAssetUC.get\",\r\n \"App Object does not have DeleteAssetUC\"\r\n );\r\n return undefined;\r\n }\r\n\r\n return uc;\r\n }\r\n}\r\n\r\n/\r\n Factory function to create a new DeleteAssetUC instance.\r\n \r\n @param appObject - The AppObject that will host this use case (should contain an AssetEntity)\r\n * @returns A new DeleteAssetUC implementation instance\r\n /\r\nexport function makeDeleteAssetUC(appObject: AppObject): DeleteAssetUC {\r\n return new DeleteAssetUCImp(appObject);\r\n}\r\n\r\n/\r\n Private implementation of DeleteAssetUC that handles the concrete deletion operations.\r\n \r\n Key Implementation Details:\r\n * - Validates asset entity existence before operations\r\n * - Uses DeleteAssetOnAPIUC for backend persistence\r\n * - Provides user confirmation through dialog system\r\n * - Shows spinner dialogs during deletion operations\r\n * - Handles errors gracefully with alert dialogs and logging\r\n * - Cleans up asset from all collections and repositories\r\n * - Removes asset from both AppAssetsEntity and AssetRepo\r\n /\r\nclass DeleteAssetUCImp extends DeleteAssetUC {\r\n /* The asset entity this use case operates on /\r\n private asset?: AssetEntity;\r\n\r\n /\r\n Gets the API use case for deleting assets from the backend\r\n * Cached for efficient repeated access during operations\r\n /\r\n private get doDelete() {\r\n return this.getCachedSingleton<DeleteAssetOnAPIUC>(DeleteAssetOnAPIUC.type)\r\n ?.doDelete;\r\n }\r\n\r\n /\r\n Gets the app assets collection entity for cleanup operations\r\n * Used to remove the asset from collection displays\r\n /\r\n private get appAssets() {\r\n return this.getCachedSingleton<AppAssetsEntity>(AppAssetsEntity.type);\r\n }\r\n\r\n /\r\n Gets the asset repository for cleanup operations\r\n * Used to remove the asset from the global asset repository\r\n /\r\n private get assetRepo() {\r\n return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n }\r\n\r\n /\r\n Initiates asset deletion with user confirmation.\r\n \r\n Shows a confirmation dialog with warnings about the irreversible nature\r\n * of the operation and suggests archiving as an alternative.\r\n /\r\n deleteWithConfirm = () => {\r\n MakeConfirmDialogUC.make(\r\n {\r\n cancelButtonLabel: \"Cancel\",\r\n confirmButtonLabel: \"Delete Asset\",\r\n message:\r\n \"Are you sure you want to delete this asset. This cannot be undone and could affect users. Consider archiving it instead\",\r\n title: \"Delete Asset\",\r\n onConfirm: this.delete\r\n },\r\n this.appObjects\r\n );\r\n };\r\n\r\n /\r\n Permanently deletes the asset with full cleanup and user feedback.\r\n \r\n This method handles the complete deletion workflow:\r\n * 1. Validates the asset exists\r\n * 2. Shows a spinner dialog during the API operation\r\n * 3. Removes the asset from backend via API\r\n * 4. Cleans up the asset from all local collections and repositories\r\n * 5. Shows error dialogs and logs failures appropriately\r\n \r\n @returns Promise that resolves when the operation completes (successfully or with handled error)\r\n /\r\n delete = (): Promise<void> => {\r\n const asset = this.asset;\r\n\r\n if (!asset) {\r\n return Promise.reject(new Error(\"No Asset Entity\"));\r\n }\r\n\r\n const doDelete = this.doDelete;\r\n if (!doDelete) {\r\n return Promise.reject();\r\n }\r\n\r\n // Show user feedback during operation\r\n const title = \"Delete Asset\";\r\n const spinnerDialog = MakeSpinnerDialogUC.make(\r\n {\r\n title,\r\n message: \"Deleting asset...\"\r\n },\r\n this.appObjects\r\n );\r\n\r\n return new Promise((resolve) => {\r\n doDelete(asset.id)\r\n .then(() => {\r\n // Clean up from all collections and repositories\r\n if (this.appAssets && this.appAssets.has(asset.id)) {\r\n this.appAssets.remove(asset.id);\r\n }\r\n\r\n if (this.assetRepo && this.assetRepo.has(asset.id)) {\r\n this.assetRepo.remove(asset.id);\r\n }\r\n\r\n spinnerDialog?.close();\r\n resolve();\r\n })\r\n .catch((e) => {\r\n // Handle errors with user feedback\r\n this.error(\"Archive asset error: \" + e.message);\r\n spinnerDialog?.close();\r\n const dialogDTO: DialogAlertDTO = {\r\n buttonLabel: \"OK\",\r\n message: `Something went wrong when setting the asset's archived flag. Check the console. ${e.message}`,\r\n title: \"Archive Asset Error\"\r\n };\r\n MakeAlertDialogUC.make(dialogDTO, this.appObjects);\r\n resolve(); // Resolve to prevent unhandled rejections, error is already handled\r\n });\r\n });\r\n };\r\n\r\n /\r\n Initializes the DeleteAssetUC with validation of required components.\r\n \r\n @param appObject - The AppObject that should contain the AssetEntity this UC will operate on\r\n */\r\n constructor(appObject: AppObject) {\r\n super(appObject, DeleteAssetUC.type);\r\n\r\n this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n if (!this.asset) {\r\n this.error(\r\n \"UC has been added to an App Object that does not have ArchiveAssetUC\"\r\n );\r\n }\r\n }\r\n}\r\n"]}