@vived/host 4.9.1 → 4.11.0

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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAA4B,WAAW,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAEL,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,OAAgB,mBAAoB,SAAQ,WAAW;IAiB3D;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CACR,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,yBAAyB,EACzB,2BAA2B,CAC5B,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,YAAY,CAC/B,mBAAmB,CAAC,IAAI,CACzB,CAAC;QACF,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,aAAa,CACtB,yBAAyB,EACzB,8CAA8C,CAC/C,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;;AAhDD,wDAAwD;AACjD,wBAAI,GAAG,qBAAqB,CAAC;AAkDtC;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAoB;IAEpB,OAAO,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,sBAAuB,SAAQ,mBAAmB;IAItD;;;OAGG;IACH,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,cAAc,CAAC,IAAI,CAAC;YACjE,EAAE,YAAY,CAAC;IACnB,CAAC;IA2FD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;QA/F7C;;;;;;;;;;;;WAYG;QACH,aAAQ,GAAG,GAAkB,EAAE;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YAEzB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACtD,CAAC;YAED,kDAAkD;YAClD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;YAED,2BAA2B;YAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACvC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,4CAA4C;YAC5C,MAAM,KAAK,GAAG,gBAAgB,CAAC;YAC/B,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAC5C;gBACE,KAAK;gBACL,OAAO,EAAE,sBAAsB;aAChC,EACD,IAAI,CAAC,UAAU,CAChB,CAAC;YAEF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;qBACnB,IAAI,CAAC,GAAG,EAAE;oBACT,aAAa,EAAE,KAAK,EAAE,CAAC;oBACvB,IAAI,CAAC,eAAe,EAAE,CAAC;oBACvB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBACX,mCAAmC;oBACnC,IAAI,CAAC,KAAK,CAAC,uBAAuB,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;oBAChD,aAAa,EAAE,KAAK,EAAE,CAAC;oBACvB,MAAM,SAAS,GAAmB;wBAChC,WAAW,EAAE,IAAI;wBACjB,OAAO,EAAE,mFAAmF,CAAC,CAAC,OAAO,EAAE;wBACvG,KAAK,EAAE,qBAAqB;qBAC7B,CAAC;oBACF,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;oBACnD,OAAO,EAAE,CAAC,CAAC,oEAAoE;gBACjF,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF;;;;;;WAMG;QACH,oBAAe,GAAG,GAAG,EAAE;YACrB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACvB,OAAO;YACT,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YAED,sDAAsD;YACtD,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACtC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAC5B,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACjC,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,CAAC,CAAC;QAUA,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CACR,sEAAsE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;CACF","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"]}

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

@@ -1,24 +1,91 @@
+/**
+ * EditAppAssetUC.ts
+ *
+ * This use case handles initiating the asset editing workflow by transitioning
+ * the application to editing mode for a specific asset.
+ *
+ * Key Concepts:
+ * - Manages application state transitions for asset editing workflows
+ * - Sets the editing context in AppAssetsEntity for UI components
+ * - Transitions sandbox state to enable editing interfaces
+ * - Validates asset existence before initiating editing
+ * - Provides error handling for missing assets or dependencies
+ *
+ * Usage Patterns:
+ * - Singleton use case accessed through static get() method
+ * - Called with asset ID to initiate editing for specific assets
+ * - Coordinates between asset repository, app assets entity, and sandbox state
+ * - Used by controllers to start editing workflows from UI interactions
+ */
 import { getSingletonComponent, AppObjectUC } from "@vived/core";
 import { AppSandboxEntity, SandboxState } from "../../AppSandbox/Entities/AppSandboxEntity";
 import { AppAssetsEntity, AssetRepo } from "../Entities";
+/**
+ * EditAppAssetUC handles initiating asset editing workflows and state transitions.
+ *
+ * This singleton use case manages the transition from normal asset viewing
+ * to editing mode, setting up the necessary context for editing interfaces.
+ */
 export class EditAppAssetUC extends AppObjectUC {
+    /**
+     * Retrieves the singleton EditAppAssetUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns EditAppAssetUC instance or undefined if not found
+     */
     static get(appObjects) {
         return getSingletonComponent(EditAppAssetUC.type, appObjects);
     }
 }
+/** Static type identifier for component registration */
 EditAppAssetUC.type = "EditAppAssetUC";
+/**
+ * Factory function to create a new EditAppAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case (must have AssetRepo)
+ * @returns A new EditAppAssetUC implementation instance
+ */
 export function makeEditAppAsset(appObject) {
     return new GetAssetUCImp(appObject);
 }
+/**
+ * Private implementation of EditAppAssetUC that handles state transitions for asset editing.
+ *
+ * Key Implementation Details:
+ * - Validates asset existence in repository before initiating editing
+ * - Sets editing context in AppAssetsEntity for UI component access
+ * - Transitions sandbox state to enable editing interfaces
+ * - Provides warning logs for missing assets or invalid operations
+ * - Validates required dependencies during initialization
+ */
 class GetAssetUCImp extends EditAppAssetUC {
+    /** Gets the app assets entity for setting editing context */
     get appAssets() {
         return this.getCachedSingleton(AppAssetsEntity.type);
     }
+    /** Gets the sandbox entity for managing application state transitions */
     get sandbox() {
         return this.getCachedSingleton(AppSandboxEntity.type);
     }
+    /**
+     * Initializes the EditAppAssetUC with required dependencies and validation.
+     *
+     * @param appObject - The AppObject that should contain the AssetRepo for asset lookup
+     */
     constructor(appObject) {
         super(appObject, EditAppAssetUC.type);
+        /**
+         * Initiates asset editing by setting up editing context and transitioning state.
+         *
+         * This method handles the complete editing initiation workflow:
+         * 1. Validates required dependencies are available
+         * 2. Looks up the asset in the repository
+         * 3. Sets the editing context in AppAssetsEntity
+         * 4. Transitions sandbox state to editing mode
+         * 5. Provides appropriate warnings for missing assets
+         *
+         * @param assetID - The unique identifier of the asset to edit
+         */
         this.editAsset = (assetID) => {
             if (!this.assetRepo || !this.appAssets || !this.sandbox)
                 return;
@@ -27,10 +94,12 @@ class GetAssetUCImp extends EditAppAssetUC {
                 this.warn("Unable to find asset by id: " + assetID);
                 return;
             }
+            // Set editing context and transition to editing state
             this.appAssets.editingAsset = asset;
             this.sandbox.state = SandboxState.EDIT_ASSET;
         };
         this.appObjects.registerSingleton(this);
+        // Validate and cache the asset repository dependency
         this.assetRepo = appObject.getComponent(AssetRepo.type);
         if (!this.assetRepo) {
             this.error("UC added to an App Object that does not have AssetRepo");

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

@@ -1 +1 @@
-{"version":3,"file":"EditAppAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/EditAppAssetUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACb,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,OAAgB,cAAe,SAAQ,WAAW;IAKtD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,cAAc,CAAC,IAAI,EACnB,UAAU,CACX,CAAC;IACJ,CAAC;;AATM,mBAAI,GAAG,gBAAgB,CAAC;AAYjC,MAAM,UAAU,gBAAgB,CAAC,SAAoB;IACnD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,cAAc;IAGxC,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAkB,eAAe,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAmB,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAeD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QAdxC,cAAS,GAAG,CAAC,OAAe,EAAQ,EAAE;YACpC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAEhE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC,IAAI,CAAC,8BAA8B,GAAG,OAAO,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC;QAC/C,CAAC,CAAC;QAKA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;IACH,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport {\r\n  AppSandboxEntity,\r\n  SandboxState\r\n} from \"../../AppSandbox/Entities/AppSandboxEntity\";\r\nimport { AppAssetsEntity, AssetRepo } from \"../Entities\";\r\n\r\nexport abstract class EditAppAssetUC extends AppObjectUC {\r\n  static type = \"EditAppAssetUC\";\r\n\r\n  abstract editAsset(assetID: string): void;\r\n\r\n  static get(appObjects: AppObjectRepo): EditAppAssetUC | undefined {\r\n    return getSingletonComponent<EditAppAssetUC>(\r\n      EditAppAssetUC.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeEditAppAsset(appObject: AppObject): EditAppAssetUC {\r\n  return new GetAssetUCImp(appObject);\r\n}\r\n\r\nclass GetAssetUCImp extends EditAppAssetUC {\r\n  private assetRepo?: AssetRepo;\r\n\r\n  private get appAssets() {\r\n    return this.getCachedSingleton<AppAssetsEntity>(AppAssetsEntity.type);\r\n  }\r\n\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  editAsset = (assetID: string): void => {\r\n    if (!this.assetRepo || !this.appAssets || !this.sandbox) return;\r\n\r\n    const asset = this.assetRepo.get(assetID);\r\n    if (!asset) {\r\n      this.warn(\"Unable to find asset by id: \" + assetID);\r\n      return;\r\n    }\r\n\r\n    this.appAssets.editingAsset = asset;\r\n    this.sandbox.state = SandboxState.EDIT_ASSET;\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, EditAppAssetUC.type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.assetRepo = appObject.getComponent<AssetRepo>(AssetRepo.type);\r\n    if (!this.assetRepo) {\r\n      this.error(\"UC added to an App Object that does not have AssetRepo\");\r\n      return;\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"EditAppAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/EditAppAssetUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACb,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,OAAgB,cAAe,SAAQ,WAAW;IAWtD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,cAAc,CAAC,IAAI,EACnB,UAAU,CACX,CAAC;IACJ,CAAC;;AArBD,wDAAwD;AACjD,mBAAI,GAAG,gBAAgB,CAAC;AAuBjC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAoB;IACnD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,aAAc,SAAQ,cAAc;IAIxC,6DAA6D;IAC7D,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAkB,eAAe,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,yEAAyE;IACzE,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAmB,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IA4BD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QAhCxC;;;;;;;;;;;WAWG;QACH,cAAS,GAAG,CAAC,OAAe,EAAQ,EAAE;YACpC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAEhE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC,IAAI,CAAC,8BAA8B,GAAG,OAAO,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,sDAAsD;YACtD,IAAI,CAAC,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC;QAC/C,CAAC,CAAC;QASA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,qDAAqD;QACrD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;IACH,CAAC;CACF","sourcesContent":["/**\r\n * EditAppAssetUC.ts\r\n *\r\n * This use case handles initiating the asset editing workflow by transitioning\r\n * the application to editing mode for a specific asset.\r\n *\r\n * Key Concepts:\r\n * - Manages application state transitions for asset editing workflows\r\n * - Sets the editing context in AppAssetsEntity for UI components\r\n * - Transitions sandbox state to enable editing interfaces\r\n * - Validates asset existence before initiating editing\r\n * - Provides error handling for missing assets or dependencies\r\n *\r\n * Usage Patterns:\r\n * - Singleton use case accessed through static get() method\r\n * - Called with asset ID to initiate editing for specific assets\r\n * - Coordinates between asset repository, app assets entity, and sandbox state\r\n * - Used by controllers to start editing workflows from UI interactions\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport {\r\n  AppSandboxEntity,\r\n  SandboxState\r\n} from \"../../AppSandbox/Entities/AppSandboxEntity\";\r\nimport { AppAssetsEntity, AssetRepo } from \"../Entities\";\r\n\r\n/**\r\n * EditAppAssetUC handles initiating asset editing workflows and state transitions.\r\n *\r\n * This singleton use case manages the transition from normal asset viewing\r\n * to editing mode, setting up the necessary context for editing interfaces.\r\n */\r\nexport abstract class EditAppAssetUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"EditAppAssetUC\";\r\n\r\n  /**\r\n   * Initiates editing mode for the specified asset.\r\n   *\r\n   * @param assetID - The unique identifier of the asset to edit\r\n   */\r\n  abstract editAsset(assetID: string): void;\r\n\r\n  /**\r\n   * Retrieves the singleton EditAppAssetUC instance.\r\n   *\r\n   * @param appObjects - Repository for accessing the singleton component\r\n   * @returns EditAppAssetUC instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): EditAppAssetUC | undefined {\r\n    return getSingletonComponent<EditAppAssetUC>(\r\n      EditAppAssetUC.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new EditAppAssetUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this singleton use case (must have AssetRepo)\r\n * @returns A new EditAppAssetUC implementation instance\r\n */\r\nexport function makeEditAppAsset(appObject: AppObject): EditAppAssetUC {\r\n  return new GetAssetUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of EditAppAssetUC that handles state transitions for asset editing.\r\n *\r\n * Key Implementation Details:\r\n * - Validates asset existence in repository before initiating editing\r\n * - Sets editing context in AppAssetsEntity for UI component access\r\n * - Transitions sandbox state to enable editing interfaces\r\n * - Provides warning logs for missing assets or invalid operations\r\n * - Validates required dependencies during initialization\r\n */\r\nclass GetAssetUCImp extends EditAppAssetUC {\r\n  /** The asset repository for asset lookup and validation */\r\n  private assetRepo?: AssetRepo;\r\n\r\n  /** Gets the app assets entity for setting editing context */\r\n  private get appAssets() {\r\n    return this.getCachedSingleton<AppAssetsEntity>(AppAssetsEntity.type);\r\n  }\r\n\r\n  /** Gets the sandbox entity for managing application state transitions */\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Initiates asset editing by setting up editing context and transitioning state.\r\n   *\r\n   * This method handles the complete editing initiation workflow:\r\n   * 1. Validates required dependencies are available\r\n   * 2. Looks up the asset in the repository\r\n   * 3. Sets the editing context in AppAssetsEntity\r\n   * 4. Transitions sandbox state to editing mode\r\n   * 5. Provides appropriate warnings for missing assets\r\n   *\r\n   * @param assetID - The unique identifier of the asset to edit\r\n   */\r\n  editAsset = (assetID: string): void => {\r\n    if (!this.assetRepo || !this.appAssets || !this.sandbox) return;\r\n\r\n    const asset = this.assetRepo.get(assetID);\r\n    if (!asset) {\r\n      this.warn(\"Unable to find asset by id: \" + assetID);\r\n      return;\r\n    }\r\n\r\n    // Set editing context and transition to editing state\r\n    this.appAssets.editingAsset = asset;\r\n    this.sandbox.state = SandboxState.EDIT_ASSET;\r\n  };\r\n\r\n  /**\r\n   * Initializes the EditAppAssetUC with required dependencies and validation.\r\n   *\r\n   * @param appObject - The AppObject that should contain the AssetRepo for asset lookup\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, EditAppAssetUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    // Validate and cache the asset repository dependency\r\n    this.assetRepo = appObject.getComponent<AssetRepo>(AssetRepo.type);\r\n    if (!this.assetRepo) {\r\n      this.error(\"UC added to an App Object that does not have AssetRepo\");\r\n      return;\r\n    }\r\n  }\r\n}\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"GetAppAssetsUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAppAssetsUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,OAAgB,cAAe,SAAQ,WAAW;IAKtD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,cAAc,CAAC,IAAI,EACnB,UAAU,CACX,CAAC;IACJ,CAAC;;AATM,mBAAI,GAAG,gBAAgB,CAAC;AAYjC,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IACpD,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,iBAAkB,SAAQ,cAAc;IAG5C,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,0BAA0B,CAAC,IAAI,CAChC,EAAE,SAAS,CAAC;IACf,CAAC;IAED,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IA0BD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QAzBxC,iBAAY,GAAG,CAAC,KAAa,EAAiB,EAAE;YAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACrC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAEjC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC7C,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3C,WAAW,CAAC,KAAK,CAAC;qBACf,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACb,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;wBACnB,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;wBAC1B,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACxB,CAAC,CAAC,CAAC;oBACH,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAKA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,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,8DAA8D,CAC/D,CAAC;YACF,OAAO;QACT,CAAC;IACH,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { GetAssetsForOwnerFromAPIUC } from \"../../VivedAPI\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\n\r\nexport abstract class GetAppAssetsUC extends AppObjectUC {\r\n  static type = \"GetAppAssetsUC\";\r\n\r\n  abstract getAppAssets(appID: string): Promise<void>;\r\n\r\n  static get(appObjects: AppObjectRepo): GetAppAssetsUC | undefined {\r\n    return getSingletonComponent<GetAppAssetsUC>(\r\n      GetAppAssetsUC.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeGetAppAssetUC(appObject: AppObject): GetAppAssetsUC {\r\n  return new GetAppAssetsUCImp(appObject);\r\n}\r\n\r\nclass GetAppAssetsUCImp extends GetAppAssetsUC {\r\n  private appAssets?: AppAssetsEntity;\r\n\r\n  private get getAssetsUC() {\r\n    return this.getCachedSingleton<GetAssetsForOwnerFromAPIUC>(\r\n      GetAssetsForOwnerFromAPIUC.type\r\n    )?.getAssets;\r\n  }\r\n\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  getAppAssets = (appID: string): Promise<void> => {\r\n    const appAssets = this.appAssets;\r\n    const getAssetsUC = this.getAssetsUC;\r\n    const assetRepo = this.assetRepo;\r\n\r\n    if (!appAssets || !getAssetsUC || !assetRepo) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    return new Promise<void>((resolve, reject) => {\r\n      getAssetsUC(appID)\r\n        .then((dtos) => {\r\n          dtos.forEach((dto) => {\r\n            assetRepo.addFromDTO(dto);\r\n            appAssets.add(dto.id);\r\n          });\r\n          resolve();\r\n        })\r\n        .catch((e: Error) => {\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, GetAppAssetsUC.type);\r\n\r\n    this.appObjects.registerSingleton(this);\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        \"UC added to an App Object that does not have AppAssetsEntity\"\r\n      );\r\n      return;\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"GetAppAssetsUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAppAssetsUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,OAAgB,cAAe,SAAQ,WAAW;IAKtD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,cAAc,CAAC,IAAI,EACnB,UAAU,CACX,CAAC;IACJ,CAAC;;AATM,mBAAI,GAAG,gBAAgB,CAAC;AAYjC,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IACpD,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,iBAAkB,SAAQ,cAAc;IAG5C,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,0BAA0B,CAAC,IAAI,CAChC,EAAE,SAAS,CAAC;IACf,CAAC;IAED,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IA0BD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QAzBxC,iBAAY,GAAG,CAAC,KAAa,EAAiB,EAAE;YAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACrC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAEjC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC7C,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3C,WAAW,CAAC,KAAK,CAAC;qBACf,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACb,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;wBACnB,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;wBAC1B,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACxB,CAAC,CAAC,CAAC;oBACH,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAKA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,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,8DAA8D,CAC/D,CAAC;YACF,OAAO;QACT,CAAC;IACH,CAAC;CACF","sourcesContent":["import {\n  getSingletonComponent,\n  AppObject,\n  AppObjectRepo,\n  AppObjectUC\n} from \"@vived/core\";\nimport { GetAssetsForOwnerFromAPIUC } from \"../../VivedAPI\";\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\nimport { AssetRepo } from \"../Entities/AssetRepo\";\n\nexport abstract class GetAppAssetsUC extends AppObjectUC {\n  static type = \"GetAppAssetsUC\";\n\n  abstract getAppAssets(appID: string): Promise<void>;\n\n  static get(appObjects: AppObjectRepo): GetAppAssetsUC | undefined {\n    return getSingletonComponent<GetAppAssetsUC>(\n      GetAppAssetsUC.type,\n      appObjects\n    );\n  }\n}\n\nexport function makeGetAppAssetUC(appObject: AppObject): GetAppAssetsUC {\n  return new GetAppAssetsUCImp(appObject);\n}\n\nclass GetAppAssetsUCImp extends GetAppAssetsUC {\n  private appAssets?: AppAssetsEntity;\n\n  private get getAssetsUC() {\n    return this.getCachedSingleton<GetAssetsForOwnerFromAPIUC>(\n      GetAssetsForOwnerFromAPIUC.type\n    )?.getAssets;\n  }\n\n  private get assetRepo() {\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\n  }\n\n  getAppAssets = (appID: string): Promise<void> => {\n    const appAssets = this.appAssets;\n    const getAssetsUC = this.getAssetsUC;\n    const assetRepo = this.assetRepo;\n\n    if (!appAssets || !getAssetsUC || !assetRepo) {\n      return Promise.reject();\n    }\n\n    return new Promise<void>((resolve, reject) => {\n      getAssetsUC(appID)\n        .then((dtos) => {\n          dtos.forEach((dto) => {\n            assetRepo.addFromDTO(dto);\n            appAssets.add(dto.id);\n          });\n          resolve();\n        })\n        .catch((e: Error) => {\n          reject(e);\n        });\n    });\n  };\n\n  constructor(appObject: AppObject) {\n    super(appObject, GetAppAssetsUC.type);\n\n    this.appObjects.registerSingleton(this);\n\n    this.appAssets = appObject.getComponent<AppAssetsEntity>(\n      AppAssetsEntity.type\n    );\n    if (!this.appAssets) {\n      this.error(\n        \"UC added to an App Object that does not have AppAssetsEntity\"\n      );\n      return;\n    }\n  }\n}\n"]}

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

@@ -1,35 +1,109 @@
+/**
+ * GetAssetBlobURLUC.ts
+ *
+ * This use case provides optimized asset file retrieval with caching support,
+ * returning blob URLs for immediate use in web applications.
+ *
+ * Key Concepts:
+ * - Provides blob URLs for asset files with multi-level caching optimization
+ * - Checks memory cache (existing entities) first for immediate access
+ * - Falls back to persistent cache (IndexedDB/localStorage) for faster retrieval
+ * - Finally fetches from remote API when cache misses occur
+ * - Manages fetch state indicators for UI feedback
+ * - Automatically stores fetched files in cache for future access
+ *
+ * Usage Patterns:
+ * - Singleton use case accessed through static get() method
+ * - Called with asset ID to retrieve blob URL for display or download
+ * - Handles async operations with comprehensive error handling
+ * - Optimizes performance through multi-level caching strategy
+ */
 import { getSingletonComponent, AppObjectUC } from "@vived/core";
 import { FetchAssetFileFromAPIUC } from "../../VivedAPI";
 import { GetAssetFromCacheUC, StoreAssetInCacheUC } from "../../Cache";
 import { AssetRepo } from "../Entities/AssetRepo";
 import { GetAssetUC } from "./GetAssetUC";
+/**
+ * GetAssetBlobURLUC handles optimized retrieval of asset files as blob URLs.
+ *
+ * This singleton use case implements a multi-level caching strategy to minimize
+ * network requests and provide fast access to asset files for web applications.
+ */
 export class GetAssetBlobURLUC extends AppObjectUC {
+    /**
+     * Retrieves the singleton GetAssetBlobURLUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns GetAssetBlobURLUC instance or undefined if not found
+     */
     static get(appObjects) {
         return getSingletonComponent(GetAssetBlobURLUC.type, appObjects);
     }
 }
+/** Static type identifier for component registration */
 GetAssetBlobURLUC.type = "GetAssetBlobURLUC";
+/**
+ * Factory function to create a new GetAssetBlobURLUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case
+ * @returns A new GetAssetBlobURLUC implementation instance
+ */
 export function makeGetAssetBlobURLUC(appObject) {
     return new GetAssetBlobURLUCImp(appObject);
 }
+/**
+ * Private implementation of GetAssetBlobURLUC with multi-level caching strategy.
+ *
+ * Key Implementation Details:
+ * - Implements three-tier caching: memory (entities), persistent cache, and remote API
+ * - Manages fetch state indicators for user feedback during operations
+ * - Automatically caches fetched files for future access optimization
+ * - Handles cache failures gracefully with fallback to direct API access
+ * - Converts between Blob and File objects for compatibility
+ * - Provides detailed error handling and logging for debugging
+ */
 class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
+    /** Gets the asset repository for entity management and lookup */
     get assetRepo() {
         return this.getCachedSingleton(AssetRepo.type);
     }
+    /** Gets the API use case for fetching asset files from remote sources */
     get fetchAssetFile() {
         return this.getCachedSingleton(FetchAssetFileFromAPIUC.type)?.doFetch;
     }
+    /** Gets the use case for retrieving asset metadata */
     get getAsset() {
         return this.getCachedSingleton(GetAssetUC.type)?.getAsset;
     }
+    /** Gets the use case for retrieving assets from persistent cache */
     get getAssetFromCache() {
         return this.getCachedSingleton(GetAssetFromCacheUC.type)?.getAsset;
     }
+    /** Gets the use case for storing assets in persistent cache */
     get storeAssetInCache() {
         return this.getCachedSingleton(StoreAssetInCacheUC.type)?.storeAsset;
     }
+    /**
+     * Initializes the GetAssetBlobURLUC and registers it as a singleton.
+     *
+     * @param appObject - The AppObject that will host this singleton use case
+     */
     constructor(appObject) {
         super(appObject, GetAssetBlobURLUC.type);
+        /**
+         * Retrieves an asset blob URL using optimized multi-level caching.
+         *
+         * This method implements a three-tier caching strategy:
+         * 1. Memory cache: Check if asset entity already has a blob URL
+         * 2. Persistent cache: Check IndexedDB/localStorage for cached file
+         * 3. Remote API: Fetch from backend as last resort
+         *
+         * Each level provides progressively better performance, with automatic
+         * population of higher-level caches for future access optimization.
+         *
+         * @param assetID - The unique identifier of the asset
+         * @returns Promise resolving to a blob URL for the asset file
+         */
         this.getAssetBlobURL = (assetID) => {
             const assetRepo = this.assetRepo;
             const getAsset = this.getAsset;
@@ -39,22 +113,21 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
             if (!assetRepo || !getAsset || !fetchAssetFile) {
                 return Promise.reject();
             }
-            // Check if asset already exists in memory with a blob URL
+            // Level 1: Check memory cache (existing entities with blob URLs)
             const existing = assetRepo.get(assetID);
             if (existing && existing.blobURL) {
                 return Promise.resolve(existing.blobURL);
             }
             return new Promise((resolve, reject) => {
                 let fetchedAsset;
-                // First check if the asset exists in cache
+                // Level 2: Check persistent cache
                 if (getAssetFromCache) {
                     getAssetFromCache(assetID)
                         .then((cachedBlob) => {
                         if (cachedBlob) {
-                            // Asset found in cache, get metadata
+                            // Asset found in cache, get metadata and create file
                             return getAsset(assetID).then((asset) => {
                                 fetchedAsset = asset;
-                                // Convert Blob to File
                                 const filename = asset.filename || "cached-asset";
                                 return new File([cachedBlob], filename, {
                                     type: cachedBlob.type
@@ -62,7 +135,7 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
                             });
                         }
                         else {
-                            // Not in cache, get asset and fetch from API
+                            // Level 3: Fetch from remote API
                             return getAsset(assetID).then((asset) => {
                                 asset.isFetchingFile = true;
                                 asset.fetchError = undefined;
@@ -73,9 +146,10 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
                     })
                         .then((file) => {
                         if (fetchedAsset) {
+                            // Create blob URL and update entity
                             fetchedAsset.setFile(file);
                             fetchedAsset.isFetchingFile = false;
-                            // Store the fetched file in cache if not from cache already
+                            // Store in cache for future access (if not from cache already)
                             if (storeAssetInCache) {
                                 storeAssetInCache(assetID, new Blob([file], { type: file.type }), file.type).catch((e) => {
                                     this.warn(`Failed to cache asset: ${e.message}`);
@@ -89,18 +163,28 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
                         reject(new Error("Blob URL is empty"));
                     })
                         .catch((e) => {
-                        // Cache error or fetch error, try normal flow
+                        // Cache error, fallback to normal flow
                         this.warn(`Cache error or fetch error: ${e.message}`);
                         this.fetchAssetNormally(assetID, resolve, reject);
                     });
                 }
                 else {
-                    // No cache available, use normal flow
+                    // No cache available, use direct API access
                     this.fetchAssetNormally(assetID, resolve, reject);
                 }
             });
         };
-        // Helper method for the normal asset fetching flow without cache
+        /**
+         * Helper method for direct asset fetching without cache support.
+         *
+         * This method handles the direct API fetch workflow when caching
+         * is not available or has failed. It still attempts to store the
+         * result in cache for future optimization.
+         *
+         * @param assetID - The unique identifier of the asset
+         * @param resolve - Success callback with blob URL
+         * @param reject - Error callback with error details
+         */
         this.fetchAssetNormally = (assetID, resolve, reject) => {
             const getAsset = this.getAsset;
             const fetchAssetFile = this.fetchAssetFile;
@@ -112,6 +196,7 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
             let fetchedAsset;
             getAsset(assetID)
                 .then((asset) => {
+                // Set loading state for UI feedback
                 asset.isFetchingFile = true;
                 asset.fetchError = undefined;
                 fetchedAsset = asset;
@@ -119,9 +204,10 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
             })
                 .then((file) => {
                 if (fetchedAsset) {
+                    // Create blob URL and update entity
                     fetchedAsset.setFile(file);
                     fetchedAsset.isFetchingFile = false;
-                    // Store the fetched file in cache if caching is available
+                    // Store in cache for future optimization (if available)
                     if (storeAssetInCache) {
                         storeAssetInCache(assetID, new Blob([file], { type: file.type }), file.type).catch((e) => {
                             this.warn(`Failed to cache asset: ${e.message}`);
@@ -135,6 +221,7 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
                 reject(new Error("Blob URL is empty"));
             })
                 .catch((e) => {
+                // Handle fetch errors with proper state cleanup
                 if (fetchedAsset) {
                     fetchedAsset.fetchError = e;
                     fetchedAsset.isFetchingFile = false;

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

@@ -1 +1 @@
-{"version":3,"file":"GetAssetBlobURLUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { FetchAssetFileFromAPIUC } from \"../../VivedAPI\";\r\nimport { GetAssetFromCacheUC, StoreAssetInCacheUC } from \"../../Cache\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\nimport { GetAssetUC } from \"./GetAssetUC\";\r\n\r\nexport abstract class GetAssetBlobURLUC extends AppObjectUC {\r\n  static type = \"GetAssetBlobURLUC\";\r\n\r\n  abstract getAssetBlobURL(assetID: string): Promise<string>;\r\n\r\n  static get(appObjects: AppObjectRepo): GetAssetBlobURLUC | undefined {\r\n    return getSingletonComponent<GetAssetBlobURLUC>(\r\n      GetAssetBlobURLUC.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeGetAssetBlobURLUC(appObject: AppObject): GetAssetBlobURLUC {\r\n  return new GetAssetBlobURLUCImp(appObject);\r\n}\r\n\r\nclass GetAssetBlobURLUCImp extends GetAssetBlobURLUC {\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  private get fetchAssetFile() {\r\n    return this.getCachedSingleton<FetchAssetFileFromAPIUC>(\r\n      FetchAssetFileFromAPIUC.type\r\n    )?.doFetch;\r\n  }\r\n\r\n  private get getAsset() {\r\n    return this.getCachedSingleton<GetAssetUC>(GetAssetUC.type)?.getAsset;\r\n  }\r\n\r\n  private get getAssetFromCache() {\r\n    return this.getCachedSingleton<GetAssetFromCacheUC>(\r\n      GetAssetFromCacheUC.type\r\n    )?.getAsset;\r\n  }\r\n\r\n  private get storeAssetInCache() {\r\n    return this.getCachedSingleton<StoreAssetInCacheUC>(\r\n      StoreAssetInCacheUC.type\r\n    )?.storeAsset;\r\n  }\r\n\r\n  getAssetBlobURL = (assetID: string): Promise<string> => {\r\n    const assetRepo = this.assetRepo;\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n    const getAssetFromCache = this.getAssetFromCache;\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!assetRepo || !getAsset || !fetchAssetFile) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    // Check if asset already exists in memory with a blob URL\r\n    const existing = assetRepo.get(assetID);\r\n    if (existing && existing.blobURL) {\r\n      return Promise.resolve(existing.blobURL);\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      let fetchedAsset: AssetEntity | undefined;\r\n\r\n      // First check if the asset exists in cache\r\n      if (getAssetFromCache) {\r\n        getAssetFromCache(assetID)\r\n          .then((cachedBlob) => {\r\n            if (cachedBlob) {\r\n              // Asset found in cache, get metadata\r\n              return getAsset(assetID).then((asset) => {\r\n                fetchedAsset = asset;\r\n                // Convert Blob to File\r\n                const filename = asset.filename || \"cached-asset\";\r\n                return new File([cachedBlob], filename, {\r\n                  type: cachedBlob.type\r\n                });\r\n              });\r\n            } else {\r\n              // Not in cache, get asset and fetch from API\r\n              return getAsset(assetID).then((asset) => {\r\n                asset.isFetchingFile = true;\r\n                asset.fetchError = undefined;\r\n                fetchedAsset = asset;\r\n                return fetchAssetFile(asset);\r\n              });\r\n            }\r\n          })\r\n          .then((file) => {\r\n            if (fetchedAsset) {\r\n              fetchedAsset.setFile(file);\r\n              fetchedAsset.isFetchingFile = false;\r\n\r\n              // Store the fetched file in cache if not from cache already\r\n              if (storeAssetInCache) {\r\n                storeAssetInCache(\r\n                  assetID,\r\n                  new Blob([file], { type: file.type }),\r\n                  file.type\r\n                ).catch((e) => {\r\n                  this.warn(`Failed to cache asset: ${e.message}`);\r\n                });\r\n              }\r\n\r\n              if (fetchedAsset.blobURL) {\r\n                resolve(fetchedAsset.blobURL);\r\n                return;\r\n              }\r\n            }\r\n            reject(new Error(\"Blob URL is empty\"));\r\n          })\r\n          .catch((e: Error) => {\r\n            // Cache error or fetch error, try normal flow\r\n            this.warn(`Cache error or fetch error: ${e.message}`);\r\n            this.fetchAssetNormally(assetID, resolve, reject);\r\n          });\r\n      } else {\r\n        // No cache available, use normal flow\r\n        this.fetchAssetNormally(assetID, resolve, reject);\r\n      }\r\n    });\r\n  };\r\n\r\n  // Helper method for the normal asset fetching flow without cache\r\n  private fetchAssetNormally = (\r\n    assetID: string,\r\n    resolve: (blobURL: string) => void,\r\n    reject: (error: Error) => void\r\n  ): void => {\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!getAsset || !fetchAssetFile) {\r\n      reject(new Error(\"Required dependencies not found\"));\r\n      return;\r\n    }\r\n\r\n    let fetchedAsset: AssetEntity | undefined;\r\n\r\n    getAsset(assetID)\r\n      .then((asset) => {\r\n        asset.isFetchingFile = true;\r\n        asset.fetchError = undefined;\r\n        fetchedAsset = asset;\r\n        return fetchAssetFile(asset);\r\n      })\r\n      .then((file) => {\r\n        if (fetchedAsset) {\r\n          fetchedAsset.setFile(file);\r\n          fetchedAsset.isFetchingFile = false;\r\n\r\n          // Store the fetched file in cache if caching is available\r\n          if (storeAssetInCache) {\r\n            storeAssetInCache(\r\n              assetID,\r\n              new Blob([file], { type: file.type }),\r\n              file.type\r\n            ).catch((e) => {\r\n              this.warn(`Failed to cache asset: ${e.message}`);\r\n            });\r\n          }\r\n\r\n          if (fetchedAsset.blobURL) {\r\n            resolve(fetchedAsset.blobURL);\r\n            return;\r\n          }\r\n        }\r\n        reject(new Error(\"Blob URL is empty\"));\r\n      })\r\n      .catch((e: Error) => {\r\n        if (fetchedAsset) {\r\n          fetchedAsset.fetchError = e;\r\n          fetchedAsset.isFetchingFile = false;\r\n        }\r\n        reject(e);\r\n      });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, GetAssetBlobURLUC.type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"GetAssetBlobURLUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * GetAssetBlobURLUC.ts\r\n *\r\n * This use case provides optimized asset file retrieval with caching support,\r\n * returning blob URLs for immediate use in web applications.\r\n *\r\n * Key Concepts:\r\n * - Provides blob URLs for asset files with multi-level caching optimization\r\n * - Checks memory cache (existing entities) first for immediate access\r\n * - Falls back to persistent cache (IndexedDB/localStorage) for faster retrieval\r\n * - Finally fetches from remote API when cache misses occur\r\n * - Manages fetch state indicators for UI feedback\r\n * - Automatically stores fetched files in cache for future access\r\n *\r\n * Usage Patterns:\r\n * - Singleton use case accessed through static get() method\r\n * - Called with asset ID to retrieve blob URL for display or download\r\n * - Handles async operations with comprehensive error handling\r\n * - Optimizes performance through multi-level caching strategy\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { FetchAssetFileFromAPIUC } from \"../../VivedAPI\";\r\nimport { GetAssetFromCacheUC, StoreAssetInCacheUC } from \"../../Cache\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\nimport { GetAssetUC } from \"./GetAssetUC\";\r\n\r\n/**\r\n * GetAssetBlobURLUC handles optimized retrieval of asset files as blob URLs.\r\n *\r\n * This singleton use case implements a multi-level caching strategy to minimize\r\n * network requests and provide fast access to asset files for web applications.\r\n */\r\nexport abstract class GetAssetBlobURLUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"GetAssetBlobURLUC\";\r\n\r\n  /**\r\n   * Retrieves a blob URL for the specified asset file.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to a blob URL for immediate use\r\n   */\r\n  abstract getAssetBlobURL(assetID: string): Promise<string>;\r\n\r\n  /**\r\n   * Retrieves the singleton GetAssetBlobURLUC instance.\r\n   *\r\n   * @param appObjects - Repository for accessing the singleton component\r\n   * @returns GetAssetBlobURLUC instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): GetAssetBlobURLUC | undefined {\r\n    return getSingletonComponent<GetAssetBlobURLUC>(\r\n      GetAssetBlobURLUC.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new GetAssetBlobURLUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this singleton use case\r\n * @returns A new GetAssetBlobURLUC implementation instance\r\n */\r\nexport function makeGetAssetBlobURLUC(appObject: AppObject): GetAssetBlobURLUC {\r\n  return new GetAssetBlobURLUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of GetAssetBlobURLUC with multi-level caching strategy.\r\n *\r\n * Key Implementation Details:\r\n * - Implements three-tier caching: memory (entities), persistent cache, and remote API\r\n * - Manages fetch state indicators for user feedback during operations\r\n * - Automatically caches fetched files for future access optimization\r\n * - Handles cache failures gracefully with fallback to direct API access\r\n * - Converts between Blob and File objects for compatibility\r\n * - Provides detailed error handling and logging for debugging\r\n */\r\nclass GetAssetBlobURLUCImp extends GetAssetBlobURLUC {\r\n  /** Gets the asset repository for entity management and lookup */\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  /** Gets the API use case for fetching asset files from remote sources */\r\n  private get fetchAssetFile() {\r\n    return this.getCachedSingleton<FetchAssetFileFromAPIUC>(\r\n      FetchAssetFileFromAPIUC.type\r\n    )?.doFetch;\r\n  }\r\n\r\n  /** Gets the use case for retrieving asset metadata */\r\n  private get getAsset() {\r\n    return this.getCachedSingleton<GetAssetUC>(GetAssetUC.type)?.getAsset;\r\n  }\r\n\r\n  /** Gets the use case for retrieving assets from persistent cache */\r\n  private get getAssetFromCache() {\r\n    return this.getCachedSingleton<GetAssetFromCacheUC>(\r\n      GetAssetFromCacheUC.type\r\n    )?.getAsset;\r\n  }\r\n\r\n  /** Gets the use case for storing assets in persistent cache */\r\n  private get storeAssetInCache() {\r\n    return this.getCachedSingleton<StoreAssetInCacheUC>(\r\n      StoreAssetInCacheUC.type\r\n    )?.storeAsset;\r\n  }\r\n\r\n  /**\r\n   * Retrieves an asset blob URL using optimized multi-level caching.\r\n   *\r\n   * This method implements a three-tier caching strategy:\r\n   * 1. Memory cache: Check if asset entity already has a blob URL\r\n   * 2. Persistent cache: Check IndexedDB/localStorage for cached file\r\n   * 3. Remote API: Fetch from backend as last resort\r\n   *\r\n   * Each level provides progressively better performance, with automatic\r\n   * population of higher-level caches for future access optimization.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to a blob URL for the asset file\r\n   */\r\n  getAssetBlobURL = (assetID: string): Promise<string> => {\r\n    const assetRepo = this.assetRepo;\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n    const getAssetFromCache = this.getAssetFromCache;\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!assetRepo || !getAsset || !fetchAssetFile) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    // Level 1: Check memory cache (existing entities with blob URLs)\r\n    const existing = assetRepo.get(assetID);\r\n    if (existing && existing.blobURL) {\r\n      return Promise.resolve(existing.blobURL);\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      let fetchedAsset: AssetEntity | undefined;\r\n\r\n      // Level 2: Check persistent cache\r\n      if (getAssetFromCache) {\r\n        getAssetFromCache(assetID)\r\n          .then((cachedBlob) => {\r\n            if (cachedBlob) {\r\n              // Asset found in cache, get metadata and create file\r\n              return getAsset(assetID).then((asset) => {\r\n                fetchedAsset = asset;\r\n                const filename = asset.filename || \"cached-asset\";\r\n                return new File([cachedBlob], filename, {\r\n                  type: cachedBlob.type\r\n                });\r\n              });\r\n            } else {\r\n              // Level 3: Fetch from remote API\r\n              return getAsset(assetID).then((asset) => {\r\n                asset.isFetchingFile = true;\r\n                asset.fetchError = undefined;\r\n                fetchedAsset = asset;\r\n                return fetchAssetFile(asset);\r\n              });\r\n            }\r\n          })\r\n          .then((file) => {\r\n            if (fetchedAsset) {\r\n              // Create blob URL and update entity\r\n              fetchedAsset.setFile(file);\r\n              fetchedAsset.isFetchingFile = false;\r\n\r\n              // Store in cache for future access (if not from cache already)\r\n              if (storeAssetInCache) {\r\n                storeAssetInCache(\r\n                  assetID,\r\n                  new Blob([file], { type: file.type }),\r\n                  file.type\r\n                ).catch((e) => {\r\n                  this.warn(`Failed to cache asset: ${e.message}`);\r\n                });\r\n              }\r\n\r\n              if (fetchedAsset.blobURL) {\r\n                resolve(fetchedAsset.blobURL);\r\n                return;\r\n              }\r\n            }\r\n            reject(new Error(\"Blob URL is empty\"));\r\n          })\r\n          .catch((e: Error) => {\r\n            // Cache error, fallback to normal flow\r\n            this.warn(`Cache error or fetch error: ${e.message}`);\r\n            this.fetchAssetNormally(assetID, resolve, reject);\r\n          });\r\n      } else {\r\n        // No cache available, use direct API access\r\n        this.fetchAssetNormally(assetID, resolve, reject);\r\n      }\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Helper method for direct asset fetching without cache support.\r\n   *\r\n   * This method handles the direct API fetch workflow when caching\r\n   * is not available or has failed. It still attempts to store the\r\n   * result in cache for future optimization.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @param resolve - Success callback with blob URL\r\n   * @param reject - Error callback with error details\r\n   */\r\n  private fetchAssetNormally = (\r\n    assetID: string,\r\n    resolve: (blobURL: string) => void,\r\n    reject: (error: Error) => void\r\n  ): void => {\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!getAsset || !fetchAssetFile) {\r\n      reject(new Error(\"Required dependencies not found\"));\r\n      return;\r\n    }\r\n\r\n    let fetchedAsset: AssetEntity | undefined;\r\n\r\n    getAsset(assetID)\r\n      .then((asset) => {\r\n        // Set loading state for UI feedback\r\n        asset.isFetchingFile = true;\r\n        asset.fetchError = undefined;\r\n        fetchedAsset = asset;\r\n        return fetchAssetFile(asset);\r\n      })\r\n      .then((file) => {\r\n        if (fetchedAsset) {\r\n          // Create blob URL and update entity\r\n          fetchedAsset.setFile(file);\r\n          fetchedAsset.isFetchingFile = false;\r\n\r\n          // Store in cache for future optimization (if available)\r\n          if (storeAssetInCache) {\r\n            storeAssetInCache(\r\n              assetID,\r\n              new Blob([file], { type: file.type }),\r\n              file.type\r\n            ).catch((e) => {\r\n              this.warn(`Failed to cache asset: ${e.message}`);\r\n            });\r\n          }\r\n\r\n          if (fetchedAsset.blobURL) {\r\n            resolve(fetchedAsset.blobURL);\r\n            return;\r\n          }\r\n        }\r\n        reject(new Error(\"Blob URL is empty\"));\r\n      })\r\n      .catch((e: Error) => {\r\n        // Handle fetch errors with proper state cleanup\r\n        if (fetchedAsset) {\r\n          fetchedAsset.fetchError = e;\r\n          fetchedAsset.isFetchingFile = false;\r\n        }\r\n        reject(e);\r\n      });\r\n  };\r\n\r\n  /**\r\n   * Initializes the GetAssetBlobURLUC and registers it as a singleton.\r\n   *\r\n   * @param appObject - The AppObject that will host this singleton use case\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, GetAssetBlobURLUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}