@vived/host 4.10.0 → 4.11.1

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

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

@@ -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"]}
+{"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

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

@@ -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"]}
+{"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"]}

package/dist/esm/Assets/UCs/DownloadAssetFileUC.js

@@ -1,8 +1,40 @@
+/**
+ * DownloadAssetFileUC.ts
+ *
+ * This use case handles downloading asset files to the user's local system,
+ * managing both cached and remote file retrieval with browser download triggers.
+ *
+ * Key Concepts:
+ * - Downloads asset files to user's local file system via browser
+ * - Handles both cached (blob URL) and remote file sources
+ * - Uses GetAssetFileUC for remote file retrieval when needed
+ * - Provides user feedback through spinner dialogs during downloads
+ * - Triggers browser download mechanism using temporary anchor elements
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Handles both immediate downloads (cached files) and fetch-then-download (remote files)
+ * - Manages async operations with proper error handling and user feedback
+ */
 import { AppObjectUC } from "@vived/core";
 import { MakeAlertDialogUC, MakeSpinnerDialogUC } from "../../Dialog";
 import { AssetEntity } from "../Entities/AssetEntity";
 import { GetAssetFileUC } from "./GetAssetFileUC";
+/**
+ * DownloadAssetFileUC manages downloading asset files to the user's local system.
+ *
+ * This use case handles the complete download workflow, from file retrieval
+ * (if necessary) to triggering the browser's download mechanism.
+ */
 export class DownloadAssetFileUC extends AppObjectUC {
+    /**
+     * Retrieves a DownloadAssetFileUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns DownloadAssetFileUC instance or undefined if not found
+     */
     static get(assetID, appObjects) {
         const appObject = appObjects.get(assetID);
         if (!appObject) {
@@ -17,30 +49,73 @@ export class DownloadAssetFileUC extends AppObjectUC {
         return uc;
     }
 }
+/** Static type identifier for component registration */
 DownloadAssetFileUC.type = "DownloadAssetFileUC";
+/**
+ * Factory function to create a new DownloadAssetFileUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new DownloadAssetFileUC implementation instance
+ */
 export function makeDownloadAssetFileUC(appObject) {
     return new DownloadAssetFileUCImp(appObject);
 }
+/**
+ * Private implementation of DownloadAssetFileUC that handles the concrete download operations.
+ *
+ * Key Implementation Details:
+ * - Checks for cached blob URLs to enable immediate downloads
+ * - Falls back to GetAssetFileUC for remote file retrieval
+ * - Shows spinner dialogs during file fetch operations
+ * - Handles errors gracefully with alert dialogs and logging
+ * - Uses DOM manipulation to trigger browser downloads
+ * - Preserves original filenames for downloaded files
+ */
 class DownloadAssetFileUCImp extends DownloadAssetFileUC {
+    /**
+     * Gets the use case for retrieving asset files from remote sources
+     * Used when the asset file is not already cached locally
+     */
     get getAssetFile() {
         return this.getCachedSingleton(GetAssetFileUC.type)
             ?.getAssetFile;
     }
+    /**
+     * Initializes the DownloadAssetFileUC with validation of required components.
+     *
+     * @param appObject - The AppObject that should contain the AssetEntity this UC will operate on
+     */
     constructor(appObject) {
         super(appObject, DownloadAssetFileUC.type);
+        /**
+         * Downloads the asset file with smart caching and user feedback.
+         *
+         * This method implements the complete download workflow:
+         * 1. Validates the asset exists
+         * 2. If a blob URL exists, triggers immediate download
+         * 3. If no blob URL, fetches the file from remote source first
+         * 4. Shows spinner dialog during remote fetch operations
+         * 5. Triggers download once file is available locally
+         * 6. Handles errors with appropriate user feedback
+         *
+         * @returns Promise that resolves when the download operation completes
+         */
         this.download = () => {
             const asset = this.asset;
             if (!asset) {
                 return Promise.reject(new Error("No Asset Entity"));
             }
+            // If file is already cached, download immediately
             if (asset.blobURL) {
                 this.saveFileLocally();
                 return Promise.resolve();
             }
+            // Need to fetch file first
             const getAssetFile = this.getAssetFile;
             if (!getAssetFile) {
                 return Promise.reject();
             }
+            // Show user feedback during fetch operation
             const title = "Download Asset";
             const spinnerDialog = MakeSpinnerDialogUC.make({
                 title,
@@ -54,6 +129,7 @@ class DownloadAssetFileUCImp extends DownloadAssetFileUC {
                     resolve();
                 })
                     .catch((e) => {
+                    // Handle errors with user feedback
                     this.error("Archive asset error: " + e.message);
                     spinnerDialog?.close();
                     const dialogDTO = {
@@ -62,10 +138,17 @@ class DownloadAssetFileUCImp extends DownloadAssetFileUC {
                         title: "Archive Asset Error"
                     };
                     MakeAlertDialogUC.make(dialogDTO, this.appObjects);
-                    resolve();
+                    resolve(); // Resolve to prevent unhandled rejections, error is already handled
                 });
             });
         };
+        /**
+         * Triggers the browser's download mechanism for the cached asset file.
+         *
+         * This method creates a temporary anchor element with the blob URL and
+         * programmatically clicks it to trigger the browser download. The download
+         * preserves the original filename from the asset metadata.
+         */
         this.saveFileLocally = () => {
             if (!this.asset) {
                 this.error("No Asset");
@@ -75,6 +158,7 @@ class DownloadAssetFileUCImp extends DownloadAssetFileUC {
                 this.error("No blob URL");
                 return;
             }
+            // Create temporary anchor element to trigger download
             const a = document.createElement("a");
             a.href = this.asset.blobURL;
             a.download = this.asset.filename;

package/dist/esm/Assets/UCs/DownloadAssetFileUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"DownloadAssetFileUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/DownloadAssetFileUC.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 { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { GetAssetFileUC } from \"./GetAssetFileUC\";\r\n\r\nexport abstract class DownloadAssetFileUC extends AppObjectUC {\r\n  static type = \"DownloadAssetFileUC\";\r\n\r\n  abstract download(): Promise<void>;\r\n  abstract saveFileLocally(): void;\r\n\r\n  static get(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): DownloadAssetFileUC | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"DownloadAssetFileUC.get\",\r\n        \"Unable to find app object\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    const uc = appObject.getComponent<DownloadAssetFileUC>(\r\n      DownloadAssetFileUC.type\r\n    );\r\n    if (!uc) {\r\n      appObjects.submitWarning(\r\n        \"DownloadAssetFileUC.get\",\r\n        \"App Object does not have DownloadAssetFileUC\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return uc;\r\n  }\r\n}\r\n\r\nexport function makeDownloadAssetFileUC(\r\n  appObject: AppObject\r\n): DownloadAssetFileUC {\r\n  return new DownloadAssetFileUCImp(appObject);\r\n}\r\n\r\nclass DownloadAssetFileUCImp extends DownloadAssetFileUC {\r\n  private asset?: AssetEntity;\r\n\r\n  private get getAssetFile() {\r\n    return this.getCachedSingleton<GetAssetFileUC>(GetAssetFileUC.type)\r\n      ?.getAssetFile;\r\n  }\r\n\r\n  download = (): 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.blobURL) {\r\n      this.saveFileLocally();\r\n      return Promise.resolve();\r\n    }\r\n\r\n    const getAssetFile = this.getAssetFile;\r\n    if (!getAssetFile) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    const title = \"Download Asset\";\r\n    const spinnerDialog = MakeSpinnerDialogUC.make(\r\n      {\r\n        title,\r\n        message: \"Downloading asset...\"\r\n      },\r\n      this.appObjects\r\n    );\r\n\r\n    return new Promise((resolve) => {\r\n      getAssetFile(asset.id)\r\n        .then(() => {\r\n          spinnerDialog?.close();\r\n          this.saveFileLocally();\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  saveFileLocally = () => {\r\n    if (!this.asset) {\r\n      this.error(\"No Asset\");\r\n      return;\r\n    }\r\n\r\n    if (!this.asset.blobURL) {\r\n      this.error(\"No blob URL\");\r\n      return;\r\n    }\r\n\r\n    const a = document.createElement(\"a\");\r\n    a.href = this.asset.blobURL;\r\n    a.download = this.asset.filename;\r\n    a.click();\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, DownloadAssetFileUC.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"]}
+{"version":3,"file":"DownloadAssetFileUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/DownloadAssetFileUC.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * DownloadAssetFileUC.ts\r\n *\r\n * This use case handles downloading asset files to the user's local system,\r\n * managing both cached and remote file retrieval with browser download triggers.\r\n *\r\n * Key Concepts:\r\n * - Downloads asset files to user's local file system via browser\r\n * - Handles both cached (blob URL) and remote file sources\r\n * - Uses GetAssetFileUC for remote file retrieval when needed\r\n * - Provides user feedback through spinner dialogs during downloads\r\n * - Triggers browser download mechanism using temporary anchor elements\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 immediate downloads (cached files) and fetch-then-download (remote files)\r\n * - Manages 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  MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { GetAssetFileUC } from \"./GetAssetFileUC\";\r\n\r\n/**\r\n * DownloadAssetFileUC manages downloading asset files to the user's local system.\r\n *\r\n * This use case handles the complete download workflow, from file retrieval\r\n * (if necessary) to triggering the browser's download mechanism.\r\n */\r\nexport abstract class DownloadAssetFileUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"DownloadAssetFileUC\";\r\n\r\n  /**\r\n   * Downloads the associated asset file to the user's local system.\r\n   *\r\n   * @returns Promise that resolves when the download operation completes\r\n   */\r\n  abstract download(): Promise<void>;\r\n\r\n  /**\r\n   * Triggers the browser download mechanism for a cached asset file.\r\n   * This method assumes the asset already has a blob URL available.\r\n   */\r\n  abstract saveFileLocally(): void;\r\n\r\n  /**\r\n   * Retrieves a DownloadAssetFileUC 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 DownloadAssetFileUC instance or undefined if not found\r\n   */\r\n  static get(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): DownloadAssetFileUC | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"DownloadAssetFileUC.get\",\r\n        \"Unable to find app object\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    const uc = appObject.getComponent<DownloadAssetFileUC>(\r\n      DownloadAssetFileUC.type\r\n    );\r\n    if (!uc) {\r\n      appObjects.submitWarning(\r\n        \"DownloadAssetFileUC.get\",\r\n        \"App Object does not have DownloadAssetFileUC\"\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 DownloadAssetFileUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)\r\n * @returns A new DownloadAssetFileUC implementation instance\r\n */\r\nexport function makeDownloadAssetFileUC(\r\n  appObject: AppObject\r\n): DownloadAssetFileUC {\r\n  return new DownloadAssetFileUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of DownloadAssetFileUC that handles the concrete download operations.\r\n *\r\n * Key Implementation Details:\r\n * - Checks for cached blob URLs to enable immediate downloads\r\n * - Falls back to GetAssetFileUC for remote file retrieval\r\n * - Shows spinner dialogs during file fetch operations\r\n * - Handles errors gracefully with alert dialogs and logging\r\n * - Uses DOM manipulation to trigger browser downloads\r\n * - Preserves original filenames for downloaded files\r\n */\r\nclass DownloadAssetFileUCImp extends DownloadAssetFileUC {\r\n  /** The asset entity this use case operates on */\r\n  private asset?: AssetEntity;\r\n\r\n  /**\r\n   * Gets the use case for retrieving asset files from remote sources\r\n   * Used when the asset file is not already cached locally\r\n   */\r\n  private get getAssetFile() {\r\n    return this.getCachedSingleton<GetAssetFileUC>(GetAssetFileUC.type)\r\n      ?.getAssetFile;\r\n  }\r\n\r\n  /**\r\n   * Downloads the asset file with smart caching and user feedback.\r\n   *\r\n   * This method implements the complete download workflow:\r\n   * 1. Validates the asset exists\r\n   * 2. If a blob URL exists, triggers immediate download\r\n   * 3. If no blob URL, fetches the file from remote source first\r\n   * 4. Shows spinner dialog during remote fetch operations\r\n   * 5. Triggers download once file is available locally\r\n   * 6. Handles errors with appropriate user feedback\r\n   *\r\n   * @returns Promise that resolves when the download operation completes\r\n   */\r\n  download = (): 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 file is already cached, download immediately\r\n    if (asset.blobURL) {\r\n      this.saveFileLocally();\r\n      return Promise.resolve();\r\n    }\r\n\r\n    // Need to fetch file first\r\n    const getAssetFile = this.getAssetFile;\r\n    if (!getAssetFile) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    // Show user feedback during fetch operation\r\n    const title = \"Download Asset\";\r\n    const spinnerDialog = MakeSpinnerDialogUC.make(\r\n      {\r\n        title,\r\n        message: \"Downloading asset...\"\r\n      },\r\n      this.appObjects\r\n    );\r\n\r\n    return new Promise((resolve) => {\r\n      getAssetFile(asset.id)\r\n        .then(() => {\r\n          spinnerDialog?.close();\r\n          this.saveFileLocally();\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   * Triggers the browser's download mechanism for the cached asset file.\r\n   *\r\n   * This method creates a temporary anchor element with the blob URL and\r\n   * programmatically clicks it to trigger the browser download. The download\r\n   * preserves the original filename from the asset metadata.\r\n   */\r\n  saveFileLocally = () => {\r\n    if (!this.asset) {\r\n      this.error(\"No Asset\");\r\n      return;\r\n    }\r\n\r\n    if (!this.asset.blobURL) {\r\n      this.error(\"No blob URL\");\r\n      return;\r\n    }\r\n\r\n    // Create temporary anchor element to trigger download\r\n    const a = document.createElement(\"a\");\r\n    a.href = this.asset.blobURL;\r\n    a.download = this.asset.filename;\r\n    a.click();\r\n  };\r\n\r\n  /**\r\n   * Initializes the DownloadAssetFileUC 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, DownloadAssetFileUC.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"]}